Documentation / Product / Integrations / Microsoft

Microsoft: Export Audience

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

Integration Details

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 Jobs Dashboard documentation for more information.

  1. Select Microsoft from the list of providers.
  2. Select the export job type from the list.
  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. Complete the configuration steps for your job. Microsoft Advertising: Export Audience config
  8. From the Microsoft Account ID input, select select the Ad Account where the Customer List will be created.
  9. In the List Name text box, enter a name for the Customer List in Microsoft.
  10. 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.
  11. (optional) Membership Duration enter the membership duration in days for the users in the list. Enter -1 for no expiration.
  12. Click the Start Export button to start the job.