Bing Ads Reference
Destination Info
Supports Track calls
Supports HIPAA mode
Refer to this destination as Bing Ads in the Integrations object
Connection Modes:
| Client-side | Server-side (Proxy) | |
|---|---|---|
Web | ||
Mobile | ||
Server |
When using Server-Side connection mode you are using a Proxy Integration for Bing Ads. This destination runs on Freshpaint's servers, but emulates a native installation of the Bing Ads Tag. That means the integration behaves the same as if you did a native installation of Bing Ads, but the data first flows through Freshpaint before it's sent to Bing. See our docs on proxy integrations for more information.
This is a reference document for the Bing Ads destination. For information on how to set up this integration, see the Quick Start guide.
Page Load Events
Freshpaint automatically sends a Page Load event to Bing Ads when a user loads a page on your website.
Track Events
When you send an event to Bing Ads, you can track conversions from your ad campaigns based on those events.
Freshpaint always provides the following parameters to Bing Ads:
Bing Ads parameter | Description |
| Tag ID. This is the UET Tag ID you configured for the Bing Ads destination. |
| Event Action. This will always be |
| Event Label. This will be the name of the Freshpaint event. |
See Bing Ads' reference documentation of all the parameters their API accepts.
Client-side
Freshpaint uses the Bing Ads Universal Event Tag to send events to Bing Ads. You may provide the following additional event properties:
Freshpaint property | Bing Ads parameter | Type | Required? | Description |
|
| string | Optional | Event category defined as you wish. Can be used as an additional filter criterion for conversion goals. |
|
| number | Optional | Value of the conversion in USD. Must be between 0 and 9999999 with up to 3 decimal places. |
Server-side
Freshpaint's servers use the same API as the client-side Bing Ads Universal Event Tag. You may provide the following additional event properties:
Freshpaint property | Bing Ads parameter | Type | Required? | Description |
|
| string | Required | msclkid (Microsoft Click ID) is generated at ad click time and appended to the landing page URL. Freshpaint will automatically capture msclkid for events from your website. If you wish, you may provide |
|
| string | Optional | Event category defined as you wish. Can be used as an additional filter criterion for conversion goals. |
|
| number | Optional | Event value defined as you wish. Can be used as an additional filter criterion for conversion goals. Must be between 0 and 9999999 with up to 3 decimal places. |
|
| number | Optional | Value of the conversion. Must be between 0 and 9999999 with up to 3 decimal places. |
|
| string | Optional | Currency of the conversion value, "USD" by default. See the list of supported currency codes. |
Considerations
Conversions may take up to 2 hours to appear in your Bing Ads Conversion Goals.
Troubleshooting
Conversion events not showing up in Bing Ads Dashboard: For an event to show up as a conversion event it must have a msclkid property. You can validate that events going to bing have this msclkid property using the Freshpaint Liveview.
Last updated
