Flexible audience evaluation guide
Flexible audience evaluation lets you run a batch segmentation job on demand. With flexible audience evaluation, you can run ad-hoc campaign launches, just-in-time communications, or other time-sensitive activities.
Guardrails guardrails
When you run flexible audience evaluation, please keep the following conditions in mind:
- You can only use flexible audience evaluation twice per day per sandbox. This limit resets at midnight (UTC).
- You have a maximum of 50 flexible audience evaluation runs per year per production sandbox.
- A year is defined as one year starting on the date of your Experience Platform contract for flexible audience evaluation. For example, if you contract started on May 18th, your number of flexible audience evaluation runs will reset every May 18th.
- You have a maximum of 100 flexible audience evaluation runs per year per development sandbox.
- A year is defined as one year starting on the date of your Experience Platform contract for flexible audience evaluation. For example, if you contract started on May 18th, your number of flexible audience evaluation runs will reset every May 18th.
- All the audiences must have an origin of “Segmentation Service”.
- All the audiences must be evaluated using batch segmentation.
- All the audiences must be people-based audiences.
- You can only select a maximum of 20 audiences per flexible audience evaluation run.
Access access
In order to use flexible audience evaluation, you must have the following permission:
- Evaluate Segment to an Audience under the Profile Management section.
For more information on role-based access control, please read the access control overview.
Running flexible audience evaluation
You can run flexible audience evaluation by using either the Experience Platform APIs or UI.
To run flexible audience evaluation within the Experience Platform APIs, you’ll need to create a segment job that contains the IDs of all the segment definitions (audiences) you want to evaluate.
| note |
|---|
| NOTE |
| You can only add a maximum of 20 segment definition IDs per segment job API call. |
You can create a new segment job by making a POST request to the /segment/jobs endpoint and including the IDs of the segment definitions in the request body.
| accordion | ||||||||
|---|---|---|---|---|---|---|---|---|
| A sample request for creating a new segment job | ||||||||
|
A successful response returns HTTP status 200 with information about your newly created segment job.
| accordion | ||
|---|---|---|
| A sample response when creating a new segment job. | ||
|
After creating the segment job, you can check on its status by making a GET request to the /segment/jobs endpoint, providing the ID of your newly created segment job in the request path.
| accordion | ||
|---|---|---|
| Sample request to retrieve a segment job | ||
|
A successful response returns HTTP status 200 with detailed information about the specified segment job.
| accordion | ||
|---|---|---|
| A sample response for retrieving a segment job. | ||
|
To run flexible audience evaluation within the Experience Platform UI, select Audiences in the Customers section.
The Audience Portal is displayed, showing a list of all the people audiences for the organization. In Audience Portal, you can choose the audiences you want to have evaluated and select Evaluate audience.
The Evaluate audiences on demand popover appears, displaying the list of audiences that will be evaluated with the on-demand-segment job. If an audience is ineligible to be evaluated on demand, it will automatically be removed from the evaluation job. Confirm that the listed audiences are the ones you want to be evaluated.
After confirming the correct audiences are listed, you can proceed with the request, and the flexible audience evaluation will begin. You can view the status of this audience evaluation in the evaluation job monitoring view.
| note |
|---|
| NOTE |
The status of the segment job may be reported as in the “Queued” state within the monitoring dashboard. You can view the most up-to-date status of the segment job by making a GET request to the /segment/jobs endpoint, providing the ID of the segment job in the request path. More information about using this endpoint can be found in the API tab. |
| If you run flexible audience evaluation and want the evaluation to activate the audience to a destination, you need to ensure the frequency is set to After segment evaluation. Running flexible audience evaluation on audiences which are already set to be activated after segment evaluation, will activate audiences as soon as the flexible audience evaluation job finishes, regardless of any previous daily activation jobs. |
Video video
The following video demonstrates how to access and use flexible audience evaluation in Experience Platform.
Frequently asked questions faq
The following section lists frequently asked questions related to flexible audience evaluation.