Digital Measurement Interruption Scenarios

From Engineering Client Portal

The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Engineering Portal breadcrumbArrow.png Digital breadcrumbArrow.png US DCR & DTVR breadcrumbArrow.png 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.