Send your event data from RudderStack to Bing Ads.
5 minute read
Bing Ads is an advertising platform that lets you track and monitor ad campaigns, clicks, CTRs, etc. You can also implement efficient ad retargeting for your customers.
Find the open source JavaScript SDK code for this destination in our Github repository.
RudderStack loads the Bing Ads native SDK from the https://bat.bing.com/ domain in the web device mode integration. Based on your website’s content security policy, you might need to allowlist this domain to load the Bing Ads SDK successfully.
Go to the Overview tab of your source and select Add Destination > Create new destination.
Select Bing Ads from the list of destinations. Then, click Continue.
Connection settings
Setting
Description
Tag ID
Enter the UET tag ID associated with your Bing Ads account.
You can create a UET tag by logging in to your Bing Ads account and navigating to Tools > Conversion Tracking > UET tag > Create UET tag. See Bing Ads documentation for detailed instructions.
Configure the consent management settings for the specified source by choosing the Consent management provider from the dropdown and entering the relevant consent category IDs.
RudderStack prioritizes properties.total over properties.revenue followed by properties.value, before mapping it to the Bing Ads revenue property.
Bing Ads accepts the following values for properties.ecomm_pagetype/properties.pagetype (mapped to ecomm_pagetype):
other (default value)
home
category
searchresults
product
cart
purchase
Bing Ads allows a maximum of 50 characters for the product_id/sku properties (mapped to ecomm_prodid).
You can override the default RudderStack mappings with the Bing Ads UET parameters by passing them directly in the event payload. For example, passing ecomm_totalvalue in the payload overrides the RudderStack properties properties.total/properties.value (mapped to ecomm_totalvalue). However, note that this functionality is not applicable for the items parameter.
With enhanced conversions, you can safely use first-party information like email address or phone number instead of using a third-party cookie. RudderStack includes this information in a pid object and sends it to Bing Ads.
To use this feature while sending events via RudderStack, make sure to toggle on the Enable enhanced conversions dashboard setting. Then, include the email and phone properties in your events.
RudderStack maps the email and phone properties in your event to the below enhanced conversions parameters by default:
em for email address
ph for phone
If you have configured different parameters for email and phone, make sure to provide them in your pid object.
Consent management
If you configure the consent settings for the Bing Ads destination in the RudderStack dashboard, then:
The core SDK prevents the Bing integration from loading unless the user grants the required consent.
If the user changes the consent status mid-session, then a page reload is required for the changes to take effect. This ensures that the SDK re-evaluates the consent settings and does not load the Bing Ads integration if the consent is revoked.
When consent is not configured
If you do not configure the consent settings in the RudderStack dashboard, then the Bing Ads SDK is already loaded and active. In this case, you must inform the Bing SDK explicitly if the user revokes or updates consent mid-session.
An example of a mid-session consent update is shown below:
This site uses cookies to improve your experience while you navigate through the website. Out of
these
cookies, the cookies that are categorized as necessary are stored on your browser as they are as
essential
for the working of basic functionalities of the website. We also use third-party cookies that
help
us
analyze and understand how you use this website. These cookies will be stored in your browser
only
with
your
consent. You also have the option to opt-out of these cookies. But opting out of some of these
cookies
may
have an effect on your browsing experience.
Necessary
Always Enabled
Necessary cookies are absolutely essential for the website to function properly. This
category only includes cookies that ensures basic functionalities and security
features of the website. These cookies do not store any personal information.
This site uses cookies to improve your experience. If you want to
learn more about cookies and why we use them, visit our cookie
policy. We'll assume you're ok with this, but you can opt-out if you wish Cookie Settings.