Digital Measurement Interruption Scenarios

From Engineering Client Portal

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.