Setup Guide

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
Source	Cloud mode	Device mode	Hybrid mode
Cloud
Shopify
Warehouse

Supported message types
Source	Identify	Page	Track	Screen	Group	Alias
Cloud mode
Supported sources

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.

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.

Turn off this setting if you are already sending a hashed email in your event.

• Consent management provider: Configure the consent management settings for the specified source by choosing the consent management provider from the dropdown. If you choose Custom, make sure to pass the custom consent data to SDK.

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:

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.

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

How to create an audience in Bing Ads?

1. Go to Tools > Audiences.

2. Click Create to create the new audience.

3. Name the audience, select Customer match list as the audience type and click Next.

4. Choose hashed file, download a specimen template and upload the same by clicking on Browse.

5. Accept the terms and conditions, choose membership duration as No expiration and sharing field according to your access levels.

6. Finally, click Apply changes to create the audience successfully.

Questions? Contact us by email or on Slack