Documentation / Product / Integrations / Amazon Web Services / Amazon DSP

Amazon DSP: Upload Hashed Identifiers

Cloud Connect Users please refer to the Amazon DSP Hashed Email Documentation on Lytics Cloud Connect Community.

Upload Hashed Identifiers creates mappings necessary to sync Lytics audiences to Amazon DSP via a hashed email identifier.

Note: The mapping created by the Hashed Identifier Upload must exist for 7 days before it can be used to sync a user to an audience via the Audience Export workflow.

Integration Details

  • Implementation Type: Server-side
  • Implementation Technique: REST API Audience triggers
  • Frequency: Real-time
  • Resulting data: A mapping in Amazon DSP for each user in the audience that will enable exports via the Audience Export workflow.

This workflow syncs hashed emails to Amazon DSP via the Amazon Advertising Hashed Records API.

When a job is created, the workflow will:

  1. Listen for enter events for the configured audience. Exit events are ignored. If Existing Users is selected in the configuration, enter initial enter events will be produced for each member of the audience.
  2. For each user that enters the audience, the workflow will check whether the user has already been sent to Amazon DSP for hashed ID mapping. If so, the event will be ignored.
  3. If the user profile has an existing value for the configured email field, the workflow will create a SHA256 hash for the email.
  4. Add the hashed email to a batch.
  5. Sync the batches via the /dp/records/hashed endpoint. Batches are synced every minute, or when the batch size reaches 100, whichever happens first.

Fields

By default, Lytics exports the following fields to Amazon DSP:

Lytics User FieldDescriptionAmazon DSP FieldType
email (configurable)Email AddressEmailstring

Configuration

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

  1. Select Amazon DSP from the list of providers.
  2. Select the Upload Hashed Identifiers 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 this 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.
  8. From the Profile ID input, select select the Amazon DSP Profile/region to export to.
  9. (optional) From the Email Field input, select the field that contains the user's email. One of either Email Field or Hashed Email Field is required.
  10. (optional) From the Hashed Email Field input, select the field that contains the user's email, SHA 256 hashed. Make sure to trim whitespace from input email addresses and format them lowercase, with no accents or special characters, per the Amazon documentation. One of either Email Field or Hashed Email Field is required.
  11. (optional) Select the Existing Users checkbox, to select this to immediately push users who currently exist in the selected Lytics audience. Deselecting will only push users as they leave or enter the audience.
  12. (Optional) Toggle Show Advanced Options.
  13. (optional) From the First Name Field input, select the field name that contains the user's first name.
  14. (optional) From the Last Name Field input, select the field name that contains the user's last name.
  15. (optional) From the User Address Field input, select the field name that contains the user's address.
  16. (optional) From the User Phone Number Field input, select the field name that contains the user's phone number.
  17. (optional) From the User City Field input, select the field name that contains the user's city.
  18. (optional) From the User State Field input, select the field name that contains the user's state.
  19. (optional) From the User Zip Field input, select the field name that contains the user's zip code.
  20. Click the Start Export button to start the job Screenshot (12)