Executing Audience(s)

Once the audiences are defined, they can be executed through a job. The job can be run from either the Audience List or the Audience Builder page. This article will cover the following topics:

Before diving into the job execution process, there are a few important points to consider:

  • When you create an audience under a data layer for the first time, an audience app is automatically created in the backend with the name  <data_layer_name>-AudienceBuilder. For example, if the data layer name is OnlineStreaming, the app will be named OnlineStreaming-AudienceBuilder.
  • Jobs executed from the Audience List or Audience Builder are considered ad-hoc jobs, as they do not need to be manually saved.
  • When you run an ad-hoc job for the first time (from the Audience List or Audience Builder), a job named Audience-Run is automatically created under the app where the execution occurs. Subsequent executions will use the same job but with a different execution ID. The execution details and history of ad-hoc jobs can be viewed on the Operations screen.
  • Ad-hoc job execution cannot be scheduled or configured. If a job needs to be scheduled, you can create a new job from the Operations screen and save it with a custom name. Only manually created jobs can be scheduled.
  • Additionally, ad-hoc job execution does not include the 'Drop & Replace' process mode as a safety precaution.
  • When an ad-hoc job (i.e., Audience-Run) is already running, no other audience under the same data layer can be executed until the first job execution is completed.

Executing Audience Group(s) from the Audience List Page

You can execute audience group(s) from the Audience List page by following these steps:

  1. In the Audience Groups list, select the desired audience group(s) by checking their checkboxes.
  2. Click the 'Execute' button. This will open the Execute Audience(s) pop-up window, which displays the selected groups as steps.
  3. Enter the job execution details, such as the execution date Range, Process Mode, Runtime Template, etc.
  4. Click the Execute button.

This will start the job execution. The details of the running job can be viewed by clicking on the 'Activity' icon displayed next to the '+' icon. When the group is unchecked, the activity screen will disappear, but the job will continue running in the background.

If an ad-hoc job is already running and the user selects an additional audience group(s), the 'Execute' button will be disabled, as only one job can run at a time.

Executing Audience Group From the Audience Builder Page

You can execute an audience group from the Audience Builder page by following these steps:

  1. Go to the Audience Group List.
  2. Click the 'Pencil' icon to navigate to the Audience Builder page.
  3. Click the Run button. This will open the Execute <audience_group_name> pop-up window with the selected groups displayed as steps.
  4. Enter the job execution details, such as the execution date Range, Process Mode, Runtime Template, etc.
  5. Click the Execute button.

This will start the job execution. Once the job begins, an activity icon will display a count of one, indicating that a job is in progress. The 'Run' button will remain disabled until the job finishes, as only one job can be executed at a time.

Manual Job Creation and Scheduling Jobs

If you want to create, save, and schedule a job, this can be done from the Operations screen. For more details, refer to the Operations-Audience article. 

Note for Legacy Clients

Legacy clients using Audience (versions prior to 8.0.0) may encounter a scenario where the checkboxes for certain audience groups appear disabled after selecting one or more audience groups. This occurs because the disabled audiences are not part of the same app as the selected audience group(s). Only audiences belonging to the same app can be selected and executed together in a single job.