Batch decisioning deliver
Get started with batch decisioning start
Journey Optimizer allows you to deliver offer decisions to all profiles in a given ۶Ƶ Experience Platform audience.
To do this, you need to create a job request in Journey Optimizer that will contain information on the audience to target and the offer decision to use. The offer content for each profile in the audience is then placed in an ۶Ƶ Experience Platform dataset where it is available for custom batch workflows.
Batch delivery can also be performed using APIs. For more on this, refer to the Batch Decisioning API documentation.
Prerequisites prerequisites
Before configuring a job request, make sure you have created:
-
A dataset in ۶Ƶ Experience Platform. This dataset will be used to store the decision result using the “ODE DecisionEvents” schema. Learn more in the Datasets documentation.
-
An audience in ۶Ƶ Experience Platform. The audience should be evaluated and then updated. Learn how to update audience membership evaluation in the
note note NOTE A batch job runs off of the profile snapshot that occurs once a day. Batch decisioning caps the frequency and always loads profiles from the most recent snapshot. Please expect to wait up to 24 hours after you create an audience before you try the batch decisioning API. -
A decision in ۶Ƶ Journey Optimizer. Learn how to create a decision
Create a job request
To create a new job request, follow the steps below.
-
In the Offers menu, open the Batch decisioning tab then click Create request.
-
Name your job request, then select the dataset where the job data should be sent into.
-
Select the ۶Ƶ Experience Platform audience to target.
-
Select one or multiple offer decision scopes that you want to use to deliver offers to the audience:
- Select a placement from the list.
- The decisions available for the selected placement display. Select the decision of your choice and click Add.
- Repeat the operation to add as many decision scopes as desired.
-
By default, one offer of the decision scope is returned for each profile. You can adjust the number of returned offers using the Request offer per profile option. For example, if you select 2, the best 2 offers will display for the selected decision scope.
note note NOTE You can request up to 30 offers per decision scope. -
If you want to include the offer content in the dataset, toggle the Include content option on. This option is disabled by default.
-
Click Create to execute the job request.
Monitor batch jobs
All requested batch jobs are accessible from the Batch decisioning tab. Additionally, search and filtering tools are available to help you refine the list.
Job requests statuses
Once a job request has been created, the batch job goes through multiple statuses:
-
Queued: The job request has been created and has entered the processing queue. Up to 5 batch jobs can be run at a time per dataset. Any other batch requests with the same output dataset are added to the queue. A queued job is picked up to process once the previous job has finished running.
-
Processing: The job request is being processed
-
Ingesting: The job request has been executed, result data are being ingested in the selected dataset,
-
Completed: The job request has been executed and the result data are now stored into the selected dataset.
note note NOTE You can access the dataset where results of a job are stored by clicking its name in jobs list.
If an error occurs while the job request is being executed, it will get the Error status. Try duplicating the batch job in order to create a new request. Learn how to duplicate a batch job
Batch job processing time
The end-to-end time for every batch job is the duration from the time the workload is created to the time when the decision result is available in the output dataset.
The audience size is the main factor that affects the end-to-end batch decision time. If the eligible offer has a global frequency cap enabled, then batch decisioning takes additional time to complete. Below are some approximations of end-to-end processing time for their respective audience sizes, both with and without frequency capping for eligible offers:
With frequency cap enabled for eligible offers:
Without frequency cap for eligible offers:
Duplicate a job request duplicate
You can reuse information of an existing job to create a new request.
To do this, click the duplicate icon, edit the job information if necessary, then click Create to create the new request.