How to import an audience to target specific users?

Importing an audience allows you to target specific users to test an orchestration in real conditions, to test your dynamic content, or to simply target static segments exported from your userbase (e.g. top 500 buyers) or created by third-party tools.

There are two types of audiences: normal audiences or rich audiences. Let's take a look at both!

1. Audiences

An audience allows you to upload a static list of users, which you can then target in your orchestration. To use an audience, follow the steps below.

Add a new audience

To create a new audience, go to Profile > Audiences > click on Add audience:

Upload the audience file

Upload a .txt, or .csv file, with one Custom ID per line only:

Use the audience in your orchestration

Once the audience is uploaded, create your orchestration and use the audience in your targeting.

2. Rich audiences

A rich audience is a static list of users, which you can associate to one or several attributes. You can then call these attributes in your orchestration for personalization purposes.

Rich audience file

The rich audience file should only contain the Custom User IDs and the associated attributes, each in one column.

• For rich audiences uploaded manually on the dashboard, only 1 associated attribute is allowed in the file, and its format should be STRING.

• For rich audiences uploaded through our Audience API, several attributes with different formats can be included.

Personalization

To personalize your orchestration with the values in your rich audience, first add the audience to the targeting.

In the title/body of your message, use the following code to call the attributes:

• For rich audiences uploaded manually on the dashboard:

{{audienceAttribute('audience name', 'att1')}}

• For rich audiences uploaded through the Audience API:

  {{audienceAttribute(<audience name>, <attribute name> ) }}