Behaviour
This API executes the specified placement ID provided in the request. If the placement ID is valid and found, the API returns the most relevant active asset based on the user's data.
Response Behavior
-
If no active assets are available, or if the user does not meet any targeting criteria, no asset will be returned.
-
If the user's data matches multiple active assets, a rotation policy will be used to determine which asset to serve.
Rotation Policies
The following rotation strategies can be applied when multiple assets qualify:
-
Random – Selects an asset at random.
-
CTR – Prioritises assets with a higher click-through rate.
-
Click Optimized – Favors assets optimised for user clicks, based on historical performance.
Authentication
Authentication is not mandatory to access this API. However, if any promo asset rules rely on SSO data to function correctly, users without an SSO token will not meet the rule criteria and therefore will not match the variant. To utilise SSO-powered rules effectively, provide the user's SSO token, if available.