Skip to contentSkip to navigationSkip to topbar
On this page
Looking for more inspiration?Visit the
(information)
You're in the right place! Segment documentation is now part of Twilio Docs. The content you are used to is still here—just in a new home with a refreshed look.

Bing Ads Destination


Destination Info
  • Accepts Page and Track calls.
  • Refer to it as Bing Ads in the Integrations object
Connection Modes
Device-modeCloud-mode
Web Web
Mobile Mobile
Server Server

Bing Ads(link takes you to an external page) enables Marketers to track and monitor campaigns, clicks, CTRs, spend and budget. Bing Ads lets you place cross-device product ads in front of Bing, Yahoo, and MSN customers and support imported pay-per-click ad campaigns from third-party platforms like Google AdWords. With Bing Ads you can also retarget ads to customers after they complete an action like leaving a shopping cart or viewing a product without purchasing. To learn more, see Bing Ads(link takes you to an external page). You can also browse the code on GitHub(link takes you to an external page).


Getting started

getting-started page anchor

Before you can track conversions or target audiences, create a UET tag in Bing Ads and then add it to the destination settings. Follow the steps within the Bing Ads documentation to create a UET tag(link takes you to an external page).

After you have created the Tag ID, follow the steps below:

  1. From the Segment web app, click Catalog.
  2. Search for "Bing Ads" in the Catalog, select it, and choose which of your sources to connect to the destination. Note that the source must be sending events using Segment's JavaScript library Analytics.js.
  3. In the destination settings, enter your Tag Id.

Your changes will appear in the Segment CDN in about 45 minutes, and then Analytics.js starts asynchronously loading Bing Ads snippets on your page and sending data.

Note: You'll only be able to include one Tag ID per source so make sure to associate the conversion goals to the correct Tag ID that is included in your settings.


If you're not familiar with the Segment Specs, take a look to understand what the Page method does. An example call looks like:

1
// name and properties are optional
2
analytics.page();

Page events will be sent to Bing Ads as a Page Load event where name and properties are optional.


If you're not familiar with the Segment Specs, take a look to understand what the Track method does.

For Segment to map your track events to a Conversion Goal, first create the goal on your Bing Ads account:

  1. Click the Campaigns tab, and then on the left pane, click Conversion Tracking.
  2. Under Conversion Tracking, click Conversion Goals.
  3. On the conversion goals page, click Create conversion goal.
  4. Enter a name for your goal in the Goal name box. When naming your goal, use a descriptive name that makes sense to you. (For example, "Checkout page")
  5. Choose the Event type of conversion and click Next.
  6. Fill in the appropriate values. Make sure to add the Segment event name as the label field and to associate the goal to the correct Tag (UET Tag) that is set up in your Segment source.

Setting up Custom Events:

setting-up-custom-events page anchor

Step 1: Add the UET Tag Tracking Code to Your Website

step-1-add-the-uet-tag-tracking-code-to-your-website page anchor
  1. Copy the UET tag from Microsoft Advertising.
  2. Paste the tag into the head or body section of your website's code.

Step 2: Create a Conversion Goal or Remarketing List

step-2-create-a-conversion-goal-or-remarketing-list page anchor

Creating a conversion goal for a custom event:

  1. From the top menu, select Tools > Conversion goals.
  2. Select the type of conversion you want to track.
  3. Enter a descriptive name for your goal.
  4. Fill in the appropriate values for your selected goal type.
  5. Fine-tune your conversion goal with advanced settings.
  6. Associate the UET tag with the conversion goal.

Creating a remarketing list for a custom event:

In Microsoft Advertising, click Shared Library > Audiences. Click Create audience > Remarketing list. For Whom to add to your audience, select Custom events. Choose the parameters to report when logging custom events. Set the membership duration. Associate the UET tag with the remarketing list.

Step 3: Modify the UET Tag Tracking Code in Your Website

step-3-modify-the-uet-tag-tracking-code-in-your-website page anchor
  1. Add the code for the custom event to the UET tag tracking code.
  2. Follow the instructions provided to set up the event tag on your website.

For Segment to map your track events to a Conversion Goal, create the goal in your Bing Ads account:

For information about tracking custom events, see Microsoft's article How to track custom events with UET(link takes you to an external page)

Only the event name is required - other properties are optional. An example track call is shown below:

1
// Segment event
2
analytics.track('Order Completed', {
3
category: 'tools'
4
revenue: 25,
5
... // additional properties
6
});
PropertyDescription
LabelEvent Name ('Order Completed' in this case)
Valuerevenue property
Categorycategory property
ActionAlways set to track

Script unverified or undetected by third-party tool

script-unverified-or-undetected-by-third-party-tool page anchor

Many times this is a limitation on the tool's detection process, where the detector is looking for a specific HTML element on your page. Our client side analytics.js library asynchronously loads the tool's library or pixel onto the page. As such, the detection fails.

In order to confirm that the tool's library or pixel is actually loaded onto the page, you can open up the JavaScript console and go to the network tab when the page is loading.

Checking network tab to see if script loads.

If the script isn't loading, check that any form of ad blocker is disabled.


Segment lets you change these destination settings from the Segment app without having to touch any code.

Property nameTypeRequiredDescription
Ad Storage Consent Defaultselect

Optional

The default value for ad storage consent state. This is only used if Enable Consent Mode is on.


Ad Storage Consent Categorystring

Optional

[For Segment Consent Management users] The consent category to look up for Ad Storage consent value. This is only used if Enable Consent Mode is on.


Ad Storage Property Mappingstring

Optional

The property to lookup Ad Storage consent state from track or page events. Accepted values are granted or denied. This is only used if Enable Consent Mode is on.


Enable Consent Modeboolean

Optional

Set to true to enable Bing Ad's consent mode(link takes you to an external page).

Default: false

Tag IDstring
required

Your Bing Universal Event Tracking Tag ID