Send query results to Microsoft Advertising

Microsoft Advertising is a pay-per-click advertising platform that displays ads based on keywords in a user’s search query.

Use the Customer List Record - Bulk API to push customer data to the Microsoft Advertising partner syndication network, which enables multichannel advertising to global audiencess across display, mobile, video, and native channels. This network includes:

  • Bing (and sites owned and operated by Bing, such as Bing Maps,, and

  • Microsoft Audience Network

  • Microsoft News

  • Microsoft Edge


  • Microsoft Start

  • Access to external partners, such as (and sites owned and operated by Yahoo), DuckDuckGo, (and sites owned and operated by AOL), Xandr, and Nine.


This destination uses the Bing Ads API .

Changes to audiences are not immediately available in Microsoft Advertising. Allow for up to 24 hours after the point at which Amperity has finished sending audience updates for them to be available.


Amperity requires access to Microsoft Advertising. This access may expire or be removed periodically, depending on how OAuth is managed at Microsoft Advertising. If Amperity is unable to send data to Microsoft Advertising ask your DataGrid Operator to reauthorize access to Microsoft Advertising.

This topic describes the steps that are required to send customer data to Microsoft Advertising from Amperity:

  1. Build a query

  2. Add orchestration

  3. Run orchestration


Microsoft Advertising must be enabled before you can configure an orchestration to send query results. Ask your DataGrid Operator or Amperity representative to enable Microsoft Advertising for your tenant.

Build query

The default audience list in Microsoft Advertising requires only an email address. This requires a simple SELECT statement that returns only the Amperity ID and its associated email address:

  ,amperity_id AS "Amperity ID"
  ,email AS "Email"
FROM Customer360

Add orchestration

An orchestration defines the relationship between query results and a destination, including the location to which those query results will be sent and the frequency at which the orchestration will be run.

To add an orchestration

  1. From the Destinations tab, click Add Orchestration. This opens the Add Orchestration dialog box.

  2. From the Object Type drop-down, select Query.

  3. From the Object drop-down, select the query for which results will be sent to Microsoft Advertising.

  4. From the Destination drop-down, select a destination that is configured for sending data to Microsoft Advertising.

  5. From the Data Template drop-down, select a data template.

  6. Verify all settings.

  7. Set the workflow to Manual. (You can change this to automatic later, after verifying the end-to-end workflow.)

  8. Click Save.

Run orchestration

Run the orchestration manually to validate that it works.

To run the orchestration

  1. From the Destinations tab, under Orchestrations, open the    menu for the Microsoft Advertising orchestration, and then select Run.

  2. The Status column for the orchestration will update to say “Waiting to start…”, after which the notifications pane will update to include a notification that shows the current status.

  3. When the orchestration has run successfully, the status is updated to “Completed”.