Overview

Microsoft Advertising is a powerful ad management tool that is designed for advertisers of any experience level.

Connect Microsoft Advertising with Lytics to access predictive user audiences in your Microsoft Advertising account. You can use your rich, behavioral-driven audiences as the target for your ads, or build lookalikes off of these audiences to reach more users who are likely to engage with your brand.

Authorization

If you haven't already done so, you will need to set up a Microsoft Advertising account before you begin the process described below.

📘

Before you begin Make sure you've accepted the Customer Match terms within the Microsoft Advertising UI. If you need help finding the terms, the Microsoft Advertising account team can help. When creating the authorization in Lytics, you need to have the “Super Admin” permission level within Microsoft Advertising. To check user permissions, go to the toolbar within the Microsoft Advertising UI and then Tool > Account Access.

If you are new to creating authorizations in Lytics, see the Authorizations Dashboard documentation for more information.

  1. Select Microsoft from the list of providers.
  2. Select the Microsoft OAuth2 method for authorization.
  3. Enter your Microsoft login credentials in the login popup and accept the prompt to let Lytics have access to write to your Microsoft Advertising account.
  4. After accepting the terms, you will be redirected back to Lytics.
  5. In the Label text box, enter a name for the authorization.
  6. (optional) In the Description text box, enter a description for this authorization
  7. Click Save Authorization.

Export Audience

Sync your Lytics audiences with Microsoft Advertising customer match lists to target those users in the Microsoft Advertising platform.

Integration Details

  • Implementation Type: Server-side Integration.
  • Implementation Technique: SOAP API Integration, File Based Transfer Integration
  • Frequency: Batch Integration hourly.
  • Resulting data: A Microsoft Advertising customer match list populated with users from the Lytics audience selected.

This integration utilizes the Bing Ads API to send user data. Once the export is started the job will:

  1. Request a Bulk Upload URL from Microsoft in the selected Customer Account.
  2. Build up a CSV of emails, hashing non-hashed emails with SHA256 encryption, and after 8 minutes, uploading the file to the supplied bulk upload URL.
  3. Check the status of the upload via the Bulk Upload Status and report any errors.
  4. The first upload will create a new customer match list in Microsoft Advertising with the configured List Name along with a system generated description containing the Lytics audience name and the job ID.
  5. Sleep for the rest of the hour before sending another batch of emails.

Fields

Lytics exports the following required field to Microsoft.

Lytics User FieldDescriptionMicrosoft FieldType
emailEmail AddressEmailstring

Configuration

Follow these steps to set up and configure an export job for Microsoft in the Lytics platform. If you are new to creating jobs in Lytics, see the Destinations documentation for more information.

📘

Before you begin Make sure you've accepted the Customer Match terms within the Microsoft Advertising UI. If you need help finding the terms, the Microsoft Advertising account team can help. When creating the authorization in Lytics, you need to have the “Super Admin” permission level within Microsoft Advertising. To check user permissions, go to the toolbar within the Microsoft Advertising UI and then Tool > Account Access.

  1. Select Microsoft from the list of providers.
  2. Select Export Audience from the list of destinations
  3. Select the Authorization you would like to use or create a new one.
  4. Enter a Label to identify the job you are creating in Lytics.
  5. (Optional) Enter a Description for further context on your job.
  6. Select the Audience to export.
  7. From the Microsoft Account ID input, select the Ad Account where the Customer List will be created. The list will also be associated with the Manager Account of the selected Ad Account.
  8. In the List Name text box, enter a name for the Customer List in Microsoft.
  9. From the Email Field input, select the field that contains email address. If the email address in not SHA256 hashed, the email address will be hashed before sending to Microsoft.
  10. (optional) Membership Duration enter the membership duration in days for the users in the list. Enter -1 for no expiration.
  11. (optional) Select the Scope of the Microsoft audience. If you select Customer, the audience will be available across all accounts. If you select Account, the audience will not be available for association with campaigns and ad groups that are not in that account
  12. Click the Complete button to start the job.