Audiences Anywhere and Profile Anywhere are part of the Enrich Anywhere app family.
Audiences Anywhere enables you to export a list of users in one or more of your audiences to a CSV file, so you can leverage the data gathered and processed by Dynamic Yield in various platforms to analyze or target a set of users.
You'll configure an automatic nightly export of the audiences to be delivered to an allocated AWS S3 bucket. The export is done after the section's nightly job finishes, between 05:00 AM and 09:00 AM, based on the section's local time zone.
Note: Session-based audiences can't be exported because users are kept within an audience only for the duration of their session. After the session ends, the users no longer exist in the audience.
For additional use cases, see this Community post.
Prerequisites to export audiences identified by email or externalID
Provide a list of eligible users. Only users who opted in can be included in the export. This list is stored in dedicated personal-data-compliant storage. You maintain the list outside of Dynamic Yield, and sync a copy of it to Dynamic Yield using one of the following methods:
- An Opted-in Email Addresses feed. These data feeds are built from a CSV file stored in an Amazon S3 bucket.
- Message opt-in and message opt-out events.
Automatically export multiple audiences
Configure a nightly export of users and each audience they belong to. The data is stored in an AWS S3 bucket provided by Dynamic Yield. Only matched users are included in the export.
- Go to Audiences Anywhere and click Export Audiences.
- Specify a name to identify the export job and include it in every exported file name.
- In the Select Identifier field, select the user identifier to export based on how you identify users on the site.
- The identifier list is created dynamically every night.
- You can export at any given time based on 1 identifier only.
- For email addresses and external IDs: Counts the users who belong to the audience and whose identifier was managed for opt-in.
- For all other identifiers: Counts the number of users who match the defined audience conditions.
- Select one or more audiences to export, and then click Export CSV to S3.
- In the File Data dialog click Generate Credentials, copy them, and then click Done.
Important: Copy your S3 bucket and credentials to a secure location. This screen is visible only to users with permission to export audiences (granted by your Customer Success Manager).
If you're an authorized user and need to re-access the credentials, in Audiences Anywhere, for the relevant export, go to Options › Access File Data. You can do this only twice. - Test the integration with your marketing platform by exporting a sample file. The sample file has the same structure as the one you'll export to S3 but contains fake identifiers. In the Audiences Anywhere main screen, go to Options › Export a Sample.
- You can edit the exported file and view the synchronization status at any time in the audience export list (Audiences Anywhere › Export Audience File).
Note: To prevent errors, you cannot rename or delete an audience that is in the process of being exported. If you want to rename or delete an audience, disable the export, change the name, and reconfigure your marketing platform to import the new audience.
File format
Note the following about your CSV file:
- The exported file includes identifiers of matched audience members at the time of the execution of the export job.
- The file is in CSV format, comma-separated, and UTF-8 encoded.
- The S3 path of the output is: s3://dy-audience-export-v2/audExport/{date}/{section}/{export_name} (US) or
s3://dy-eudc-audience-export-v2/{section}/{date}/{export_name} (EU)
- The exported data can be divided into several files depending on the number of entries (maximum 5 million per file).
- The files are named as follows: part-{NNNNN}-{export_id}.csv
- When the export is completed successfully, an empty _SUCCESS file is added to the output folder.
- The first column contains the user identifier and is called “identity”.
- There is one column for each audience included in the export
- For each user (row), the value in each audience column is 1 if the user belongs to the audience and 0 if they do not.
- If a user is not in any audience, even if they were previously in an audience, they are not included in the exported file.
- The users are not listed in any particular order.
- Exported files are saved in S3 for 30 days, after which they are deleted.
Important: The CSV files are not encrypted and may contain sensitive data such as email addresses.
Sample file with 1 exported audience using plain text emails:
identity |
affinity_brand_a |
---|---|
email1@host.com |
1 |
email2@host.com |
1 |
email3@host.com |
1 |
email4@host.com |
1 |
email5@host.com |
1 |
email6@host.com |
1 |
email7@host.com |
1 |
Sample file with 3 exported audiences using plain text emails
identity |
affinity_brand_a |
affinity_on_sale |
purchased_last_30_days |
---|---|---|---|
email1@host.com |
0 |
1 |
0 |
email2@host.com |
0 |
1 |
1 |
email3@host.com |
1 |
1 |
1 |
email4@host.com |
1 |
1 |
1 |
email5@host.com |
1 |
1 |
1 |
email6@host.com |
1 |
0 |
1 |
email7@host.com |
0 |
0 |
1 |
email8@host.com |
0 |
1 |
1 |
email9@host.com |
1 |
0 |
0 |
email10@host.com |
1 |
1 |
1 |
email11@host.com |
1 |
0 |
0 |
email12@host.com |
1 |
1 |
0 |
Frequently Asked Questions
What if I don't see an identifier I want to use the export list?
For an identifier to appear in the list, the following must be true:
- The use is identified in a website/mobile/API context (identity, login, signup APIs).
- At least one audience is defined, and that user is included in it.
- At least 1 night has passed from the time the previous conditions became true (because the list is calculated every night)
Note: If the section has used both email and external ID identifiers types, only 1 of them can be used for export and count. Contact your Customer Success Manager if you need additional assistance.