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 completed between 12:00 PM and 02:00 PM, 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.
Prerequisite: Opted-in users
For users identified by hashed email address or external ID, you must 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. Available for users identified by email address.
- Message opt-in and message opt-out events. Available for users identified by either email address or external ID.
If your users are identified by any other type of CUID, such as "crmId" “customerId”, “VIPclub”, there is no need for opt-in, as these are not considered PII.
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 can't rename or delete an audience that's 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.
Offline purchases
Note that exported audiences might include users for whom offline purchases were onboarded, even if these users never visited your website. This is why the numbers in the audience export window can be higher than the number in the Audience report in Experience OS, which only reports about online users.
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 in 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 (identify, 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.