Updating Audiences
Last updated
Last updated
In this article, you learn how to update audiences you onboarded or activated through digitalAudience.
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.
Select the audience you want to update and click Edit audience.
Click Browse and seleсt the file on your computer. Alternatively, you can drag and drop the file directly.
Choose the Data upload mode you want to use to update the audience.
Data upload modes
‘Add new records’ to add new records to the audience
'Replace entire recordset’ to replace all records in the audience
'Remove matching records’ to remove records from the audience
Continue from Onboard Your Data Through Portal step 4.
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:
Prepare a CSV file with hashed records according to the requirements outlined in the formatting guidelines.
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
We recommend to limit updates for one audience to one file per day.