dA Docs
Tool
  • 🏠Welcome
  • Documentation
    • CRM Onboarding
      • 1. Prepare CSV File
      • 2. Format Your Data
      • 3. Onboard Your Data through Portal
    • Publisher Onboarding
      • Onboarding Setup
    • Updating Audiences
      • Prepare Your CSV File for Data Updates
    • Data Collaboration
      • How to Collaborate with Other Data Providers Through our Portal
    • SDK Implementation
  • Audience List
    • Adform
      • NL
      • SE
    • DV360
      • NL
      • SE
      • FI
    • P161
      • NL
      • SE
    • Xandr
      • NL
      • SE
      • FI
    • Trade Desk
      • NL
    • Bidtheatre
      • SE
    • Pubmatic
      • NL
      • SE
  • DMP integration
    • Piano segments
Powered by GitBook
On this page
  • Prerequisites
  • Update Audience Data
  1. Documentation

Updating Audiences

PreviousOnboarding SetupNextPrepare Your CSV File for Data Updates

Last updated 3 months ago

In this article, you learn how to update audiences you onboarded or activated through digitalAudience.

Prerequisites

  • You have onboarded your data through digitalAudience Portal. Onboarding your data this way generates an audience id, which will be used within the folder name.

Update Audience Data

First, you need to receive access to a storage:

If the storage is from digitalAudience:

  • If it is a digitalAudience S3 bucket, request an access key, secret key, bucket name and a region name

  • If it is a digitalAudience SFTP, request a server name, port number, and a user name

If the storage is from the Advertiser:

  • If it is a S3 bucket from the Advertiser, provide digitalAudience with an access key, secret key, bucket name and a region name

  • If it is an Azure Blob Storage from the Advertiser, provide digitalAudience with an accountname and an accountKey or a Shared Access (SAS) token

Then follow these steps:

  • From the Audience page in the Portal, retrieve the audience ID that needs to be updated

  • Specify which audience update mode you intend to use.

audience update modes can be:
- *opt-in* to add new records to the audience
- *opt-out* to remove records from the audience
- *replace* to replace records from the audience
  • Create the necessary folders in your S3 bucket or SFTP. Create the root folder called 'onboard', if it doesn't exist yet.

  • Create the audience folder inside the onboard folder with the following format;

audience={audience ID}
  • Create the audience update mode folder, opt-in, opt-out and/or replace.

  • An example of the resulting path would be;

onboard/audience=00001/opt-in/20221107_132117.csv
  • Send the file to S3 or SFTP into the intended folder

In digitalAudience Portal, the audience is updated the next day. On a platform, the time needed for a segment to update varies per platform. The average time is two days.

We recommend to limit updates for one audience to one file per day.

Prepare a CSV file with hashed records according to the requirements outlined in the .

formatting guidelines
Audience id can be found under the name of the audience
Audience id can be found under the name of the audience