Skip to Content
SourcesMicrosoft AdsExport Conversions

Export Conversions to Microsoft Ads

Vendo can export offline conversion events back to Microsoft Ads, enabling better campaign optimization and ROAS measurement.

How It Works

  1. Vendo reads conversion events from your analytics data
  2. An attribution model matches conversions to Microsoft Ads clicks using the msclkid (Microsoft Click ID)
  3. Attributed conversions are sent to the Microsoft Ads Offline Conversions API

Prerequisites

Before exporting conversions, ensure you have:

  1. A conversion goal created in your Microsoft Ads account
  2. OAuth2 credentials authorized with your Microsoft Ads account
  3. Website tracking that captures and stores the msclkid parameter

Configuration

SettingDescriptionDefault
Account IDMicrosoft Ads account IDRequired
Access TokenOAuth2 access tokenRequired
Developer TokenMicrosoft Ads developer tokenRequired
Conversion Goal IDName of the conversion goal in Microsoft AdsRequired
Mixpanel Conversion EventSource event to trackRequired
Conversion Event PropertyProperty containing the conversion valueRequired
Lookback WindowDays to look back for click matching7 days
Attribution ModelHow to distribute credit across touchpointsParticipation
Only First ConversionCount only the first conversion per userYes

Attribution Models

Choose how conversion credit is distributed. See Attribution Models for details on each model.

Click ID Tracking

Microsoft Ads automatically appends the msclkid parameter to landing page URLs. Ensure your website captures and stores this parameter so Vendo can match conversions to clicks.

https://yoursite.com/product?msclkid=3bd2dffd8f9e11ec9f58fa163e7897b4

Conversion Payload

Each offline conversion sent to Microsoft includes:

FieldDescription
MicrosoftClickIdThe msclkid from the original click
ConversionNameYour conversion goal name
ConversionTimeISO 8601 timestamp with timezone
ConversionValueAttributed conversion value
ConversionCurrencyCodeCurrency code (e.g., USD)

Troubleshooting

ErrorCauseSolution
Authentication error (401)Access token expiredRe-authorize your Microsoft Ads account in the Vendo app
Conversion goal not foundGoal doesn’t existCreate the conversion goal in Microsoft Ads first

Sync Details

  • Conversions are exported on a schedule and honor your lookback window
  • Status and recent sync activity are visible in the Vendo integration settings

Verify Setup

  1. Trigger a conversion event in your analytics source
  2. Check Vendo integration logs for a successful export
  3. Confirm the conversion appears in Microsoft Ads after processing time
Last updated on
UTM TrackingOverview