Digital Measurement Interruption Scenarios

Engineering Portal / Digital / DCR & DTVR / Digital Measurement Interruption Scenarios

Interrupt scenarios are use cases that lead to interruption in content (audio / video) playback. App developers should watch for these use cases and implement the Nielsen AppSDK in a way that AppSDK does accurate measurement. There are various interrupt scenarios which app dev should take care of

• Pause / Play
• Network loss (Wi-Fi / Airplane / Cellular)
• Call Interrupt ( SIM or Third party Skype / Hangout call)
• Alarm Interrupt
• Content Buffering
• Lock / Unlock device (Video players only)
• App going Background / Foreground (Only video players without PIP mode support )
• Channel / Station Change Scenario
• Unplugging of headphone

Interrupt scenarios for video

There are various interrupt scenarios which a video app dev should take care of

Pause / Play

• Call stop as soon as video is paused and withhold sending the playhead position.
• Once the video has resumed, call loadMetadata and sendID3 / playheadPosition in that order.

Network loss (Wi-Fi / Airplane / Cellular)

• Call stop as soon as network is lost and withhold sending the playhead position.
• Once the Wi-Fi is ON / Airplane is OFF / Cellular network is ON and the video has resumed, call loadMetadata and sendID3 / playheadPosition in that order.

Call Interrupt ( SIM or Third party Skype / Hangout call)

• Call stop as soon as a SIM or Skype / Hangout call is observed and withhold sending the playhead position.
• Once the SIM or Skype / Hangout call ends and the video has resumed, call loadMetadata and sendID3 / playheadPosition

Alarm Interrupt

• Call stop as soon as a device or an in-app alarm is observed and withhold sending the playhead position.
• Once the device or in-app alarm ends / is acknowledged and the video has resumed, call loadMetadata and sendID3 / playheadPosition in that order.

Content Buffering

• App dev should withhold sending the playhead position as soon as player starts content buffering
• Once the buffering ends and the audio has resumed, call sendID3 / playheadPosition.

Lock / Unlock device

• Call stop as soon as the device is locked and withhold sending the playhead position.
• Once the device is unlocked and the video has resumed, call loadMetadata and sendID3 / playheadPosition in that order.

App going Background / Foreground (when PIP mode is not supported / enabled)

• Call stop as soon as the app goes to background and withhold sending the playhead position.
• Once the app resumes to foreground and the video has resumed, call loadMetadata and sendID3 / playheadPosition in that order.

Channel / Station change from current channel / station to other

• Call stop for the current channel / station as soon as it is changed and withhold sending its playhead position.
• As soon as new channel / station starts, call loadMetadata and sendID3 / playheadPosition for the channel / station in that order.

Unplugging of headphone

• Call stop as soon as the video stops playback because of unplugging of headphone and withhold sending its playhead position.
• As soon as video resumes, call loadMetadata and sendID3 / playheadPosition

Interrupt Scenarios for radio / audio

Radio / audio app dev must trigger / stop the API calls as mentioned below, in the respective interrupt scenario.

Pause / Play

• Call stop as soon as audio is paused and withhold sending the playhead position.
• Once the audio has resumed, call loadMetadata and playheadPosition in that order.

Network loss (Wi-Fi / Airplane / Cellular)

• Call stop as soon as network is lost and withhold sending the playhead position.
• Once the Wi-Fi is ON / Airplane is OFF / Cellular network is ON and the audio has resumed, call loadMetadata and playheadPosition in that order.

Call Interrupt ( SIM or Third party Skype / Hangout call)

• Call stop as soon as a SIM or Skype/Hangout call is observed and withhold sending the playhead position.
• Once the SIM or Skype/Hangout call ends and the audio has resumed, call loadMetadata and playheadPosition in that order.

Alarm Interrupt

• Call stop as soon as a device or an in-app alarm is observed and withhold sending the playhead position.
• Once the device or in-app alarm ends / is acknowledged and the audio has resumed, call loadMetadata and playheadPosition in that order.

Content Buffering

• Withhold sending the playhead position as soon as the player starts content buffering.
• Once the buffering ends and the audio has resumed, call playheadPosition.

Channel / Station Change Scenario

• Call stop for the current channel / station as soon as it is changed and withhold sending its playhead position.
• As soon as new channel / station starts, call loadMetadata and playheadPosition for the channel / station in that order.

Unplugging of headphone

• Call stop when the audio stops playback because of unplugging of headphone and withhold sending its playhead position.
• Once the audio has resumed, call loadMetadata and playheadPosition in that order.

Note: Lock / Unlock device and app going Background / Foreground are not an interrupt scenario for radio / audio clients unless the audio stops.