Summary

When creating or editing a SSAI destination, Playout 2.0 now offers the ability to suppress ad insertions. The suppression of the ad insertions is based on a query parameter implementation. This means that if a predefined query parameter is found in the destination URL and matches a certain condition, then the ad insertion will be suppressed.

Ad Suppression Introduction

When enabling Ad Suppression, there are three components you will need to set:

1. Ad Suppression Trigger Key
2. Ad Suppression Trigger Value
3. Resolution

These three settings will create a condition. If the condition is met, the ad insertions will be suppressed.

Ad Suppression Trigger Key

This will be the query key parameter that must be present in the destination URL. The system will look for the key in the destination URL.

Ad Suppression Trigger Value

This is the value that the "Ad Suppression Trigger Key" can equal or not equal. "Equals" or "Not Equals" are set by the "Resolution" toggle. 

Resolution

This is a toggle that can be set to "Equals" or "Not Equals".

Suppress ALL Ad Insertions 

We set the three variables to the following:

• Ad Suppression Trigger Key: ad_suppression_test
• Ad Suppression Trigger Value: suppress
• Resolution: Equals

If our original destination URL is, https://foo.zype.com/live.m3u8, and you add the query parameter/value pair ad_suppression_test=suppress, the final URL will be https://foo.zype.com/live.m3u8?ad_suppression_test=suppress. 

RESULT: Playout will suppress all ad insertions

Don't Suppress Any Ad Insertions

We set the three variables to the following:

• Ad Suppression Trigger Key: ad_suppression_test
• Ad Suppression Trigger Value: suppress
• Resolution: Not Equals

With the same destination URL, https://foo.zype.com/live.m3u8, if we add the same query parameter ad_suppression_test=suppress, the final URL will be https://foo.zype.com/live.m3u8?ad_suppression_test=suppress.

RESULT: The system will NOT suppress any ad insertions for playback.

Suppress Ad Insertions Except Value

We set the three variables to the following:

• Ad Suppression Trigger Key: ad_suppression_test
• Ad Suppression Trigger Value: {something_else}
• Resolution: Not Equals

RESULT: The final URL, https://foo.zype.com/live.m3u8?ad_suppression_test=something_else, would result in ad requests that don't equal "something_else" being suppressed.

Only Suppress Ad Insertions For Value

We set the three variables to the following:

• Ad Suppression Trigger Key: ad_suppression_test
• Ad Suppression Trigger Value: {something_else}
• Resolution: Equals

RESULT: The final URL, https://foo.zype.com/live.m3u8?ad_suppression_test=something_else, would result in ad requests that equal "something_else" being suppressed