Setup Guide

Send your event data from RudderStack to Bing Ads Audience.

This guide will help you set up Bing Ads Audience as a destination in the RudderStack dashboard. It also lists the configuration settings required to correctly send data from the supported sources to Bing Ads.

Connection compatibility

Destination info
  • Status: Beta
  • Supported sources: Cloud, Warehouse, Shopify
  • Refer to it as BINGADS_AUDIENCE in the Integrations object.

Connection modes
SourceCloud modeDevice modeHybrid mode
Cloudsupportednot supportednot supported
Shopifysupportednot supportednot supported
Warehousesupportednot supportednot supported
Supported message types
SourceIdentifyPageTrackScreenGroupAlias
Cloud mode
Supported sourcesnot supportednot supportednot supportednot supportednot supportednot supported

Get started

Once you have confirmed that the source platform supports sending events to Bing Ads Audience, follow these steps:

  1. From your RudderStack dashboard, add the source. Then, from the list of destinations, select Bing Ads Audience.
  2. Assign a name to the destination and click Continue.

Connection settings

To successfully configure Bing Ads Audience as a destination, you need to configure the following settings:

  • Account Settings: Click Create Account > Connect with Bing Ads Audience and give RudderStack the required permissions to access to your Bing Ads account.
  • Customer Account ID: Enter your Bing Ads account identifier.
  • Customer ID: Enter your Bing Ads customer ID.
  • Audience ID: Enter your Bing Ads audience ID for which you want to sync the data.
info
See FAQ for more information on obtaining these credentials.
  • Hash Email: This setting is on by default and hash-encrypts the email present in your event.
warning
Turn off this setting if you are already sending a hashed email in your event.

audienceList event structure

You can add or remove users from an audience by sending the audienceList call to Bing Ads.

{
  "anonymousId": "2234232hK4el9Z",
  "channel": "sources",
  "properties": {
    "listData": {
      "add": [{
          "email": "alex@example.com"
        },
        {
          "email": "julie@example.com"
        },
        {
          "email": "peter@example.com"
        },
        {
          "email": "russell@example.com"
        },
        {
          "email": "john@example.com"
        }
      ],
    }
  },
  "type": "audienceList",
  "userId": "1hKOmRA4el9Z"
}

RudderStack maps the following properties to Bing Ads’ properties:

RudderStack propertyData typeBing Ads property
properties.listData.add[i].email
Required
Stringemail
properties.listData.remove[i].email
Required
Stringemail

FAQ

Where can I find my Bing Ads customer ID and customer account ID?

To get your Bing Ads customer ID and account ID, sign in to your Microsoft Advertising web app and click the Campaigns tab. The URL contains a cid key/value pair in the query string that contains the customer ID and an aid key/value pair that identifies your account ID.

A sample URL is shown:

https://ui.ads.microsoft.com/campaign/Campaigns.m?cid=<CUSTOMER_ID>&aid=
<ACCOUNT_ID>#/customer/<CUSTOMER_ID>/account/<ACCOUNT_ID>/campaign.

Where can I find the Bing Ads audience ID?

To get your Bing Ads audience, go to Tools > Audiences.

Audiences option

You will see the list of audiences with their corresponding Audience ID.

Audience ID

How to create an audience in Bing Ads?

  1. Go to Tools > Audiences.
Create BingAds audience
  1. Click Create to create the new audience.
Create BingAds audience
  1. Name the audience, select Customer match list as the audience type and click Next.
Create BingAds audience
  1. Choose hashed file, download a specimen template and upload the same by clicking on Browse.
Create BingAds audience
  1. Accept the terms and conditions, choose membership duration as No expiration and sharing field according to your access levels.
Create BingAds audience
  1. Finally, click Apply changes to create the audience successfully.
Create BingAds audience

Questions? Contact us by email or on Slack