Skip to main content

Ad targeting parameters

With the Google DAI Pod Serving, there is the possibility to pass a limited set of ad targeting parameters on your stream request to personalize your streams. In the player you can easily pass these parameters as key-value pairs via the TheoAdDescription.

note

The player will automatically add the custom parameter theoads_slot in the cust_params when requesting an ad. The value of this parameter will be determined by the layout mode.

Web SDK

For the Web SDK, you can set your desired ad tag parameters via adTagParameters in the TheoAdDescription as followed:

player.source = {
sources: {
src: 'PATH-TO-SIGNALING-SERVER/hls/MANIFEST-URI',
type: 'application/x-mpegurl',
hlsDateRange: true,
},
ads: [
{
integration: 'theoads',
networkCode: 'NETWORK-CODE',
customAssetKey: 'CUSTOM-ASSET-KEY',
adTagParameters: {
"YOUR-AD-TAG-PARAMETER-1" : "VALUE-1", // e.g. "cust_params" : "YOUR-CUSTOM-PARAMETERS",
"YOUR-AD-TAG-PARAMETER-2" : "VALUE-2",
...
}
},
],
};

React Native SDK

For the React Native SDK, you can set your desired ad tag parameters via adTagParameters in the TheoAdDescription as followed:

player.source = {
sources: {
src: 'PATH-TO-SIGNALING-SERVER/hls/MANIFEST-URI',
type: 'application/x-mpegurl',
hlsDateRange: true,
},
ads: [
{
integration: 'theoads',
networkCode: 'NETWORK-CODE',
customAssetKey: 'CUSTOM-ASSET-KEY',
adTagParameters: {
"YOUR-AD-TAG-PARAMETER-1" : "VALUE-1", // e.g. "cust_params" : "YOUR-CUSTOM-PARAMETERS",
"YOUR-AD-TAG-PARAMETER-2" : "VALUE-2",
...
}
},
],
};

Android SDK

This API is currently under development and will become available soon.

iOS SDK

This API is currently under development and will become available soon.

More information