Ensure that you never serve another irrelevant advertisement with Bing Ads
Supported syncing
| Sync Type | Description | Supported Sync Modes | API reference |
|---|---|---|---|
| Events | Sync offline conversion events with data from any source | Insert | Offline conversion reference |
| Audiences | Create new or use an existing audience to sync users | Add, Remove | Customer list item reference |
Connect to Bing Ads
Go to the Destinations overview page and click the Add destination button. Select Bing Ads and click Continue. You can then authenticate Hightouch to Bing Ads using OAuth.
Click Log in to Microsoft Bing Ads , log in with your Microsoft Ads account, and click Allow. Hightouch requires access to manage your ads account and see your email address. Once successful, you will be redirected back to Hightouch to enter a descriptive name for your destination and complete setup.
Sync configuration
Once you've set up your Bing Ads destination and have a model to pull data from, you can set up your sync configuration to begin syncing data. Go to the Syncs overview page and click the Add sync button to begin. Then, select the relevant model and the Bing Ads destination you want to sync to.
Whether you're syncing events or audiences, begin your configuration by selecting the Microsoft Ads account you want to sync data to.
Syncing events
When syncing offline conversion events, Hightouch treats any records added to your source as new events and sends them to Bing Ads when your sync runs.
Conversion goal name
Select the conversion goal name to associate with the offline conversions. Your options populate depending on the Microsoft Ads account you selected at the beginning of the sync configuration.
Event timestamp
You can optionally select a column that contains timestamps of when events occurred. If this field is empty, Hightouch uses the time the event arrives at the server. Hightouch syncs the timestamp as the ConversionTime parameter the Microsoft Advertising API requires.
The timestamp field must also:
- be in Coordinated Universal Time (UTC)
- be later than the recorded Microsoft Click ID
- be within the conversion goal window
- be within the last 90 days
For more information, see Microsoft Bing Ads' official documentation.
Field mapping
Hightouch lets you sync event fields via field mapping. You can map data from any of your model columns to supported event fields. The Microsoft Ads API requires the Microsoft Click ID field, so you must map it to complete your configuration. Ensure your model columns data types match the data types of the fields you want to sync to.
Syncing audiences
You can use Hightouch to insert and update audience members in a the Bing Ads customer match list audience. Users removed from the model get removed from the audience.
To sync to a customer match list audience, you need to first create a customer list and accept terms and conditions in the Microsoft Advertising UI.
Audience type selection
You can create a new audience or use an existing one. When creating a new audience, you can optionally enter a name; otherwise, Hightouch defaults to the name of the associated model. To use an existing audience, select the desired audience from the dropdown.
Record matching
Bing Ads allows you to match audience members on a valid Email. Bing Ads doesn't support mapping any other fields. For more information, see Microsoft Bing Ads' official documentation.
Handling PII
By default, Hightouch automatically detects if your Email field requires hashing and hashes the value before sending requests to Bing Ads if needed.
Tips and troubleshooting
Delayed syncing
Bing Ads suggests waiting up to 48 hours to confirm Audience Size updates.
Common errors
If you encounter an error or question not listed below and need assistance, don't hesitate to . We're here to help.
8003: CustomerListTermsAndConditionsNotAccepted
To sync to a customer match list audience, you need to first create a customer list and accept terms and conditions in the Microsoft Advertising UI.
For more information, read the Bing Ads documentation.
Error uploading audience XXX, bulk operation failed: - (4835) - InvalidAudienceId in path
Check the Bing Ads UI to make sure the audience from your sync configuration exists. If the audience no longer exists, you need to create a new sync.
For additional errors, read the Bing Ads error codes documentation.
Live debugger
Hightouch provides complete visibility into the API calls made during each of your sync runs. We recommend reading our article on debugging tips and tricks to learn more.
Sync alerts
Hightouch can alert you of sync issues via Slack, PagerDuty, SMS, or email. For details, please visit our article on alerting.