Track ads on Chromecast track-ads-on-chromecast

The following instructions provide guidance for implementation using the 2.x SDKs.

IMPORTANT
If you are implementing a 1.x version of the SDK, you can download 1.x Developers Guides here: Download SDKs.

Ad tracking constants

Constant name
Description
AdBreakStart
Constant for tracking AdBreak Start event
AdBreakComplete
Constant for tracking AdBreak Complete event
AdStart
Constant for tracking Ad Start event
AdComplete
Constant for tracking Ad Complete event
AdSkip
Constant for tracking Ad Skip event

Implementation steps

  1. Identify when the ad break boundary begins, including pre-roll, and create an AdBreakObject by using the ad break information.

    Ad break object creation: createAdBreakObject

    code language-none
    adBreakInfo = ADBMobile.media.createAdBreakObject("First Ad-Break", 1, AD_BREAK_START_TIME, playerName);
    
  2. Call trackEvent() with AdBreakStart in the MediaHeartbeat instance to begin tracking the ad break: trackEvent

    code language-none
    ADBMobile.media.trackEvent(ADBMobile.media.Event.AdBreakStart, getAdBreakInfo());
    
  3. Identify when the ad asset starts and create an AdObject instance using the ad information.

    Ad object creation: createAdObject

    code language-none
    adInfo = ADBMobile.media.createAdObject("Sample ad", "001", 1, AD_LENGTH);
    
  4. Optionally attach standard and/or ad metadata to the media tracking session through context data variables.

    • Standard ad metadata - For standard ad metadata, create a dictionary of standard ad metadata key value pairs using the keys for your platform:
    • Custom ad metadata - For custom metadata, create a variable object for the custom data variables and populate with the data for the current ad asset:
  5. Call trackEvent() with the AdStart event to begin tracking the ad playback.

    Include a reference to your custom metadata variable (or an empty object) as the third parameter in the event call: trackEvent

    code language-none
    ADBMobile.media.trackEvent(ADBMobile.media.Event.AdStart, getAdInfo(), adContextData);
    
  6. When the ad asset playback reaches the end of the ad, call trackEvent() with the AdComplete event: trackEvent

    code language-none
    ADBMobile.media.trackEvent(ADBMobile.media.Event.AdComplete);
    
  7. If there are any additional ads within the same AdBreak, repeat steps 3 through 6 again.

  8. When the ad break is complete, use the AdBreakComplete event to track: trackEvent

    code language-none
    ADBMobile.media.trackEvent(ADBMobile.media.Event.AdBreakComplete, getAdBreakInfo());
    

See the tracking scenario VOD playback with pre-roll ads for more information.

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb