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:
- Ad Suppression Trigger Key
- Ad Suppression Trigger Value
- 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