Create an SSAI strategy

SSAI strategies allow you to tailor server-side ad experiences for different viewers by defining logic that determines which ad config is delivered during SSAI stitching.

Using the strategy editor, you can create rules based on request attributes, such as query parameters, or run A/B tests to compare ad performance across different ad configs.

Prerequisites

Create an SSAI strategy

Follow these steps to create an SSAI strategy from your JWX dashboard:

1. On the Advertising page, under the Ad strategy tab, click Create ad strategy. The ad strategy details page appears.

2. Enter a Name for the ad strategy.

3. In the JSON code editor, define your strategy.

4. Click Save. The new SSAI strategy appears in the list on the Ad strategy tab, along with its strategy ID.

5. In the row of a strategy, in the ID column, click (copy icon). The strategy ID is copied to your clipboard.

6. In your SSAI manifest request, add the strategy ID as the value for your ad_config_id. This activates the strategy.

   Example

   https://cdn.jwplayer.com/v2/sites/{site_id}/media/{media_id}/ssai.{manifest_extension}?ad_config_id={strategy_id}
   

   
   

The new SSAI strategy is now ready to be applied to a viewer session.

Define a strategy

A strategy is composed of a JSON rules array. Each rule contains:

• A predicates object, defining the conditions that must be met for a viewer to receive an ad experience
• A weight object, defining the ratio of traffic to direct to the ad experience
• An action object, defining which ad config to deliver under the predicate’s conditions

{
  "rules": [
    {
      "predicates": [
        { "key": "query/example-param", "op": "equals", "value": "true" }
      ],
      "weight": 2,
      "action": {
        "ad_config_id": "example_config_A"
      }
    },
    {
      "predicates": [
        { "key": "query/example-param", "op": "not-equals", "value": "true" }
      ],
      "weight": 1,
      "action": {
        "ad_config_id": "example_config_B"
      }
    }
  ]
}

Predicates

Weight

Action