Configure the Android Player

If you want to use SSP on your Android player, you need to enable and configure it for the individual player or the entire player configuration group. Before you do this, make sure you have read the following prerequisites.

Prerequisites

• You can set an airtime ratio for SSP content on the player to specify how much airtime is used for SSP advertising, just as you can set airtime for DOOH.

• In total, the SSP airtime percentage and the DOOH airtime percentage must not exceed 100%.

• By default, SSP spot filling is enabled and SSP airtime is set to 0%. This means that unused DOOH airtime will be used for SSP when SSP spots are available regardless of SSP airtime.

• You can enable SPP with DOOH or enable SSP without DOOH.

Enable SSP with DOOH

To use both DOOH and SSP, perform the following steps to enable SSP:

1. In the IXM Platform, go to the player configuration or configuration group:

   • For an individual player, go to Channels > Location. Double-click on your player and select Edit next to Configuration in the Edit player window.

   • For a configuration group, go to Administration > Player > Configuration groups and double-click on the configuration group.

2. In the Edit configuration group window, select Display extended modules.

3. Under Modules, select DOOH > SSP.

4. Under Settings, select Enable SPP.
   

   

5. Optionally, change the SSP load timeout (in ms). If loading the SSP spot takes longer than the timeout, the system skips the spot.

6. Optionally, change the SSP playback count. This specifies how many of the last spots are SSP spots (example).

7. Optionally, change the SSP playback look behind. The system looks at the last specified number of spots to analyze whether the playout should be SSP (example).

8. Click Save to save your changes.

9. Restart the player service or reboot the player for your changes to take effect.

Enable SSP without DOOH

To use only SSP without DOOH, perform the following steps to enable SSP:

1. In the IXM Platform, go to the player configuration or configuration group: 

   • For an individual player, go to Channels > Location. Double-click on your player and select Edit next to Configuration in the Edit player dialog. 

   • For a configuration group, go to Administration > Player > Configuration groups and double-click on the configuration group. 

2. In the Edit configuration group window, select Display extended modules. 

3. Under Modules, select Player > SSP. 

4. Under Settings, select Enable SPP.
   

   

5. Optionally, change the SSP load timeout (in ms). If loading the SSP spot takes longer than the timeout, the system skips the spot. 

6. Optionally, change the SSP playback count. This specifies how many of the last spots should be SSP spots (example). 

7. Optionally, change the SSP playback look behind. The system looks at the last specified number of spots to analyze whether the next spot should be SSP (example).

8. Click Save to save your changes. 

9. Restart the player service or reboot the player for your changes to take effect.

Example SSP configuration

To have a maximum of 20% SSP played, specify the following values:

• sspPlaybackCount = 1

• sspPlaybackLookBehind = 5

The player will check if an SSP spot was played among the last four spots. If not, it will try to play an SSP spot.