Riproduzione VOD con annunci pre-scorrimento

In questo scenario, gli annunci pre-roll sono stati inseriti prima del contenuto principale. Se non specificato, le chiamate di rete sono uguali alle chiamate nello scenario VOD playback without ads . Le chiamate di rete si verificano contemporaneamente, ma il payload è diverso.

Attivatore metodo Heartbeat Chiamate di rete Note
L'utente fa clic su Play trackSessionStart Inizio contenuto Analytics, inizio contenuto Heartbeat La libreria di misurazione non sa che è presente un annuncio pre-roll, quindi queste chiamate di rete sono ancora identiche alla riproduzione VOD senza uno scenario di annunci.
L'annuncio inizia.
  • trackEvent:AdBreakStart
  • trackEvent:AdStart
Ad Start di Analytics, Heartbeat Ad Start
Viene riprodotto il fotogramma dell'annuncio numero 1. trackPlay Heartbeat Ad Play Il contenuto dell’annuncio viene riprodotto prima del contenuto principale e gli heartbeat iniziano all’avvio dell’annuncio.
L'annuncio viene suonato. Battiti cardiaci
L'annuncio numero 2 completa la riproduzione. trackEvent:trackAdComplete Annuncio Heartbeat completato Viene raggiunta la fine dell’annuncio.
Viene riprodotto il primo fotogramma dell'annuncio numero 2. trackEvent:AdStart Ad Start di Analytics, Heartbeat Ad Start
L'annuncio suona. Battiti cardiaci
L'annuncio numero 2 completa la riproduzione.
  • trackEvent:trackAdComplete
  • trackEvent:AdBreakComplete
Annuncio Heartbeat completato La fine dell’annuncio e il pod vengono raggiunti.
Il contenuto viene riprodotto. heartbeat di contenuto Questa chiamata di rete è identica alla riproduzione VOD senza scenari di annunci.
Il contenuto è completo. trackComplete Contenuto Heartbeat completato Questa chiamata di rete è identica alla riproduzione VOD senza scenari di annunci.
La sessione è finita trackSessionEnd SessionEnd

Parametri

Quando inizia la riproduzione di un annuncio, viene inviata una chiamata Heartbeat Ad Start . Se l'inizio dell'annuncio non coincide con il timer di 10 secondi, la chiamata Heartbeat Ad Start viene ritardata di alcuni secondi e la chiamata passa al successivo intervallo di 10 secondi. In questo caso, un elemento Content Heartbeat si interrompe nello stesso intervallo ed è possibile distinguere tra le due chiamate osservando il tipo di evento e il tipo di risorsa:

Heartbeat Ad Start

Parametro Valore Note
s:event:type start
s:asset:type ad

Gli annunci seguono lo stesso modello di base di Content Heartbeats, quindi la chiamata Ad Play è simile alla chiamata Content Play .

Chiamata Heartbeat Ad Play

Parametro Valore Note
s:event:type play
s:asset:type ad

Questi parametri sono simili alla chiamata Content Heartbeats , ma la chiamata Ad Heartbeats contiene alcuni parametri aggiuntivi:

Battiti cardiaci

Parametro Valore Note
s:event:type play
s:asset:type ad
s:asset:ad_id <ad ID="">
s:asset:pod_id <ad pod="" ID="">

Simile alle chiamate Heartbeat Content Complete, quando la riproduzione dell'annuncio è stata completata e viene raggiunta la fine dell'indicatore di riproduzione, viene inviata una chiamata Heartbeat Ad Complete . Questa chiamata ha l'aspetto di altre chiamate Heartbeat Ad ma contiene alcuni elementi specifici:

Heartbeat Ad Complete Call

Parametro Valore Note
s:event:type complete
s:asset:type ad

Codice di esempio per un annuncio pre-roll

In questo scenario, il VOD è costituito da un annuncio pre-roll, un secondo annuncio pre-roll e quindi il contenuto viene riprodotto.

  • ​AndroidPer visualizzare questo scenario in Android, imposta il seguente codice:

    // Set up  mediaObject 
    MediaObject mediaInfo = MediaHeartbeat.createMediaObject( 
        Configuration.MEDIA_NAME,  
        Configuration.MEDIA_ID,  
        Configuration.MEDIA_LENGTH,  
        MediaHeartbeat.StreamType.VOD 
    ); 
    
    HashMap<String, String> videoMetadata = new HashMap<String, String>(); 
    videoMetadata.put(CUSTOM_KEY_1, CUSTOM_VAL_1); 
    videoMetadata.put(CUSTOM_KEY_2, CUSTOM_VAL_2); 
    
    // 1. Call trackSessionStart() when the user clicks Play or if autoplay is used,  
    //    i.e., there's an intent to start playback.  
    _mediaHeartbeat.trackSessionStart(mediaInfo, videoMetadata); 
    
    ...... 
    ...... 
    
    // Pre-roll 
    MediaObject adBreakInfo =  
      MediaHeartbeat.createAdBreakObject(ADBREAK_NAME,  
                                         ADBREAK_POSITION,  
                                         ADBREAK_START_TIME); 
    MediaObject adInfo =  
      MediaHeartbeat.createAdObject(AD_NAME,  
                                    AD_ID,  
                                    AD_POSITION,  
                                    AD_LENGTH); 
    
    // Context ad data 
    HashMap<String, String> adMetadata = new HashMap<String, String>(); 
    adMetadata.put(CUSTOM_KEY_1, CUSTOM_VAL_1); 
    adMetadata.put(CUSTOM_KEY_2, CUSTOM_VAL_2); 
    
    // 2. Track the MediaHeartbeat.Event.AdBreakStart event when the pre-roll pod starts  
    //    to play. Note that since this is a pre-roll, call must track the 
    //    "MediaHeartbeat.Event.AdBreakStart" event before you call trackPlay().  
    _mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakStart, adBreakInfo, null); 
    
    ....... 
    ....... 
    
    // 3. Track the MediaHeartbeat.Event.AdStart event when the pre-roll pod's ad starts  
    //    to play. Note that since this is a pre-roll, you must track the  
    //    "MediaHeartbeat.Event.AdStart" event before you call trackPlay(). 
    _mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdStart, adInfo, adMetadata); 
    
    ....... 
    ....... 
    
    // 4. Call trackPlay() when the playback actually starts, i.e., when the first frame  
    //    of the ad video is rendered on the screen. 
    _mediaHeartbeat.trackPlay(); 
    
    ....... 
    ....... 
    
    // 5. Track the MediaHeartbeat.Event.AdComplete event when the ad reaches the end,  
    //    i.e., when the ad completes and finishes playing.  
    _mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdComplete, null, null); 
    
    ....... 
    ....... 
    
    // 6. Track the MediaHeartbeat.Event.AdStart event when the pre-roll pod's second ad  
    //    starts to play. 
    _mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdStart, adInfo, adMetadata); 
    
    ....... 
    ....... 
    
    // 7. Track the MediaHeartbeat.Event.AdComplete event when the second ad reaches the  
    //    end, i.e., the second ad completes and finishes playing. 
    _mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdComplete, null, null); 
    
    ....... 
    ....... 
    
    // 8. Track the MediaHeartbeat.Event.AdBreakComplete event when all of the ads in the  
    //    pod finish playing.  
    _mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakComplete, null, null); 
    
    ....... 
    ....... 
    
    // 9. Call trackComplete() when the playback reaches the end, i.e., when the video 
    //    completes and finishes playing. 
    _mediaHeartbeat.trackComplete(); 
    
    ........ 
    ........ 
    
    // 10. Call trackSessionEnd() when the playback session is over. This method must be  
    //     called even if the user does not watch the video to completion.  
    _mediaHeartbeat.trackSessionEnd(); 
    
    ........ 
    ........ 
    
  • iOS: per visualizzare questo scenario in iOS, imposta il seguente codice:

    //  Set up mediaObject 
    ADBMediaObject *mediaObject =  
      [ADBMediaHeartbeat createMediaObjectWithName:MEDIA_NAME  
                         length:MEDIA_LENGTH  
                         streamType:ADBMediaHeartbeatStreamTypeVOD]; 
    
    NSMutableDictionary *videoContextData = [[NSMutableDictionary alloc] init]; 
    [videoContextData setObject:CUSTOM_VAL_1 forKey:CUSTOM_KEY_1]; 
    [videoContextData setObject:CUSTOM_VAL_2 forKey:CUSTOM_KEY_2]; 
    
    // 1. Call trackSessionStart when the user clicks Play or if autoplay is used,  
    //    i.e., there is an intent to start playback. 
    [_mediaHeartbeat trackSessionStart:mediaObject data:videoContextData]; 
    ....... 
    ....... 
    
    // Pre-roll 
    ADBMediaObject *adBreakInfo =  
      [ADBMediaHeartbeat createAdBreakObjectWithName:AD_BREAK_NAME  
                         position:AD_BREAK_POSITION  
                         startTime:AD_BREAK_START_TIME]; 
    ADBMediaObject *adInfo =  
      [ADBMediaHeartbeat createAdObjectWithName:AD_NAME  
                         adId:AD_ID  
                         position:AD_POSITION  
                         length:AD_LENGTH]; 
    
    // context ad data 
    NSMutableDictionary *adDictionary = [[NSMutableDictionary alloc] init]; 
    [adDictionary setObject:@"custom-val1" forKey:@"custom-key1"]; 
    [adDictionary setObject:@"custom-val2" forKey:@"custom-key2"]; 
    
    // 2. Track the ADBMediaHeartbeatEventAdBreakStart event when the pre-roll pod  
    //    starts to play. Note that since this is a pre-roll, you must track the  
    //    "ADBMediaHeartbeatEventAdBreakStart" event before you call trackPlay. 
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdBreakStart  
                     mediaObject:adBreakObject  
                     data:nil]; 
    ....... 
    ....... 
    
    // 3. Track the ADBMediaHeartbeatEventAdStart event when the pre-roll pod's  
    //    ad starts to play. Note that since this is a pre-roll, you must track  
    //    the "ADBMediaHeartbeatEventAdStart" event before you call trackPlay. 
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdStart  
                     mediaObject:adObject  
                     data:adDictionary]; 
    ....... 
    ....... 
    
    // 4. Call trackPlay when the playback actually starts, i.e., when the   
    //    first frame of the main content is rendered on the screen. 
    [_mediaHeartbeat trackPlay]; 
    ....... 
    ....... 
    
    // 5. Track the ADBMediaHeartbeatEventAdComplete event when the ad reaches  
    //    the end, i.e., when the video completes and finishes playing. 
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdComplete  
                     mediaObject:nil  
                     data:nil]; 
    ....... 
    ....... 
    
    // 6. Track the ADBMediaHeartbeatEventAdStart event when the pre-roll pod's  
    //    second ad starts to play. 
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdStart  
                     mediaObject:adBreakObject  
                     data:nil]; 
    ....... 
    ....... 
    
    // 7. Track the ADBMediaHeartbeatEventAdComplete event when the second ad  
    //    reaches the end, i.e., it completes and finishes playing. 
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdComplete  
                     mediaObject:nil  
                     data:nil]; 
    ....... 
    ....... 
    
    // 8. Track the ADBMediaHeartbeatEventAdBreakComplete event when all the  
    //    ads in the pod finish playing. 
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdBreakComplete  
                     mediaObject:adBreakObject  
                     data:nil]; 
    ....... 
    ....... 
    
    // 9. Call trackComplete when the playback reaches the end, i.e., when the  
    //    video completes and finishes playing. 
    [_mediaHeartbeat trackComplete]; 
    ....... 
    ....... 
    
    // 10. Call trackSessionEnd when the playback session is over. This method  
    //     must be called even if the user does not watch the video to completion. 
    [_mediaHeartbeat trackSessionEnd]; 
    ....... 
    ....... 
    
  • ​JavaScriptPer visualizzare questo scenario in JavaScript, immettere il testo seguente:

    // Set up mediaObject 
    var mediaInfo =  
      MediaHeartbeat.createMediaObject(Configuration.MEDIA_NAME,  
                                       Configuration.MEDIA_ID,  
                                       Configuration.MEDIA_LENGTH,MediaHeartbeat.StreamType.VOD); 
    var videoMetadata = { 
        CUSTOM_KEY_1 : CUSTOM_VAL_1,  
        CUSTOM_KEY_2 : CUSTOM_VAL_2, 
        CUSTOM_KEY_3 : CUSTOM_VAL_3 
    }; 
    
    // 1. Call trackSessionStart() when Play is clicked or if autoplay is used,  
    //    i.e., there's an intent to start playback. 
    this._mediaHeartbeat.trackSessionStart(mediaInfo, videoMetadata); 
    
    ...... 
    ...... 
    
    // Preroll 
    var adBreakInfo =  
      MediaHeartbeat.createAdBreakObject(ADBREAK_NAME, ADBREAK_POSITION, ADBREAK_START_TIME); 
    var adInfo =  
      MediaHeartbeat.createAdObject(AD_NAME, AD_ID, AD_POSITION, AD_LENGTH); 
    
    // Custom ad metadata 
    var adMetadata = { 
        CUSTOM_AD_KEY_1 : CUSTOM_AD_VAL_1,  
        CUSTOM_AD_KEY_2 : CUSTOM_AD_VAL_2 
    }; 
    
    // 2. Track the MediaHeartbeat.Event.AdBreakStart event when the preroll pod starts to play.  
    //    Note that since this is a preroll, track the MediaHeartbeat.Event.AdBreakStart  
    //    event before you call trackPlay(). 
    this._mediaheartbeat.trackEvent(MediaHeartbeat.Event.AdBreakStart, adBreakInfo, null); 
    
    ....... 
    ....... 
    
    // 3. Track the MediaHeartbeat.Event.AdStart event when the preroll pod's ad starts to play.  
    //    Note that since this is a preroll, track the MediaHeartbeat.Event.AdStart event before  
    //    you call trackPlay(). 
    this._mediaheartbeat.trackEvent(MediaHeartbeat.Event.AdStart, adInfo, adMetadata); 
    
    ....... 
    ....... 
    
    // 4. Call trackPlay() when the playback actually starts, i.e., the first frame of the  
          main content is rendered on the screen.  
    this._mediaHeartbeat.trackPlay(); 
    
    ....... 
    ....... 
    
    // 5. Track event MediaHeartbeat.Event.AdComplete when the ad reaches the end,  
    //    i.e., when it completes and finishes playing. 
    this._mediaheartbeat.trackEvent(MediaHeartbeat.Event.AdComplete); 
    
    ....... 
    ....... 
    
    // 6. Track the MediaHeartbeat.Event.AdStart event when the preroll pod's second  
    //    ad starts to play. 
    this._mediaheartbeat.trackEvent(MediaHeartbeat.Event.AdStart, adInfo, adMetadata); 
    
    ....... 
    ....... 
    
    // 7. Track the MediaHeartbeat.Event.AdComplete event when the second ad reaches  
    //    the end, i.e., when it completes and finishes playing. 
    this._mediaheartbeat.trackEvent(MediaHeartbeat.Event.AdComplete); 
    
    ....... 
    ....... 
    
    // 8. Track the MediaHeartbeat.Event.AdBreakComplete event when all the ads  
    //    in the pod finish playing. 
    this._mediaheartbeat.trackEvent(MediaHeartbeat.Event.AdBreakComplete); 
    
    ....... 
    ....... 
    
    // 9. Call trackComplete() when the playback reaches the end, i.e., when it 
    //    completes and finishes playing.  
    this._mediaHeartbeat.trackComplete(); 
    
    // 10. Call trackSessionEnd() when the playback session is over. This method must  
    //     be called even if the user does not watch the video to completion. 
    this._mediaHeartbeat.trackSessionEnd(); 
    
    ....... 
    .......
    

Codice di esempio per più interruzioni pubblicitarie

In questo scenario, il contenuto VOD viene riprodotto con un annuncio pre-roll, il contenuto, un annuncio mid-roll, il contenuto e un annuncio post-roll.

  • ​AndroidPer visualizzare questo scenario in Android, imposta il seguente codice:

    // Set up mediaObject 
    MediaObject mediaInfo = MediaHeartbeat.createMediaObject( 
        Configuration.MEDIA_NAME,  
        Configuration.MEDIA_ID,  
        Configuration.MEDIA_LENGTH,  
        MediaHeartbeat.StreamType.VOD 
    ); 
    
    HashMap<String, String> videoMetadata = new HashMap<String, String>(); 
    videoMetadata.put(CUSTOM_KEY_1, CUSTOM_VAL_1); 
    videoMetadata.put(CUSTOM_KEY_2, CUSTOM_VAL_2); 
    
    // 1. Call trackSessionStart() when the user clicks Play or if autoplay is used,  
    //   i.e., there's an intent to start playback. 
    _mediaHeartbeat.trackSessionStart(mediaInfo, videoMetadata); 
    
    ...... 
    ...... 
    
    // Pre-roll 
    MediaObject adBreakInfo =  
      MediaHeartbeat.createAdBreakObject(ADBREAK_NAME,  
                                         ADBREAK_POSITION,  
                                         ADBREAK_START_TIME); 
    MediaObject adInfo = MediaHeartbeat.createAdObject(AD_NAME,  
                                                       AD_ID,  
                                                       AD_POSITION,  
                                                       AD_LENGTH); 
    
    // Context ad data 
    HashMap<String, String> adMetadata = new HashMap<String, String>(); 
    adMetadata.put(CUSTOM_KEY_1, CUSTOM_VAL_1); 
    adMetadata.put(CUSTOM_KEY_2, CUSTOM_VAL_2); 
    
    // 2. Track the MediaHeartbeat.Event.AdBreakStart event when the pre-roll pod  
    //    starts to play. Note that since this is a pre-roll, you must track the  
    //    "MediaHeartbeat.Event.AdBreakStart" event before you call trackPlay().  
    _mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakStart, adBreakInfo, null); 
    
    ....... 
    ....... 
    
    // 3. Track the MediaHeartbeat.Event.AdStart event when the pre-roll pod's ad  
    //    starts to play. Note that since this is a pre-roll, you must track the  
    //    "MediaHeartbeat.Event.AdStart" event before you call trackPlay().  
    _mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdStart, adInfo, adMetadata); 
    
    ....... 
    ....... 
    
    // 4. Call trackPlay() when the playback actually starts, i.e., when the first  
    //    frame of the main content is rendered on the screen.  
    _mediaHeartbeat.trackPlay(); 
    
    ....... 
    ....... 
    
    // 5. Track the MediaHeartbeat.Event.AdComplete event when the ad reaches the end,  
    //    i.e., when the ad completes and finishes playing.  
    _mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdComplete, null, null); 
    
    ....... 
    ....... 
    
    // 6. Track the MediaHeartbeat.Event.AdBreakComplete event when all of the ads in  
    //;    the pod finish playing. 
    _mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakComplete, null, null); 
    
    ....... 
    ....... 
    
    // Mid-roll 
    MediaObject adBreakInfo =  
      MediaHeartbeat.createAdBreakObject(mid-roll_BREAK_NAME,  
                                         mid-roll_BREAK_POSITION,  
                                         mid-roll_BREAK_START_TIME); 
    MediaObject adInfo =  
      MediaHeartbeat.createAdObject(mid-roll_AD_NAME,  
                                    mid-roll_AD_ID,  
                                    mid-roll_AD_POSITION,  
                                    mid-roll_AD_LENGTH); 
    
    // Context ad data 
    HashMap<String, String> adMetadata = new HashMap<String, String>(); 
    adMetadata.put(CUSTOM_KEY_1, CUSTOM_VAL_1); 
    adMetadata.put(CUSTOM_KEY_2, CUSTOM_VAL_2); 
    
    // 7. Track the MediaHeartbeat.Event.AdBreakStart event when the mid-roll pod  
    //    starts to play.  
    _mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakStart, adBreakInfo, null); 
    
    ....... 
    ....... 
    
    // 8. Track the MediaHeartbeat.Event.AdStart event when the mid-roll pod's ad  
    //    starts to play.  
    _mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdStart, adInfo, adMetadata); 
    
    ....... 
    ....... 
    
    // 9. Track the MediaHeartbeat.Event.AdComplete event when the ad reaches the end,  
    //    i.e., when the adcompletes and finishes playing.  
    _mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdComplete, null, null); 
    
    ....... 
    ....... 
    
    // 10. Track the MediaHeartbeat.Event.AdBreakComplete event when all the ads in the  
    //      mid-roll pod finish playing.  
    _mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakComplete, null, null); 
    
    ....... 
    ....... 
    
    // Post-roll 
    MediaObject adBreakInfo =  
      MediaHeartbeat.createAdBreakObject(POSTROLL_BREAK_NAME,  
                                         POSTROLL_BREAK_POSITION,  
                                         POSTROLL_BREAK_START_TIME); 
    MediaObject adInfo =  
      MediaHeartbeat.createAdObject(POSTROLL_AD_NAME,  
                                    POSTROLL_AD_ID,  
                                    POSTROLL_AD_POSITION,  
                                    POSTROLL_AD_LENGTH); 
    
    // Context ad data 
    HashMap<String, String> adMetadata = new HashMap<String, String>(); 
    adMetadata.put(CUSTOM_KEY_1, CUSTOM_VAL_1); 
    adMetadata.put(CUSTOM_KEY_2, CUSTOM_VAL_2); 
    
    // 11. Track the MediaHeartbeat.Event.AdBreakStart event when the post-roll pod  
    //     starts to play.  
    _mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakStart, adBreakInfo, null); 
    
    ....... 
    ....... 
    
    // 12. Track the MediaHeartbeat.Event.AdStart event when the post-roll pod's  
    //     ad starts to play.  
    _mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdStart, adInfo, adMetadata); 
    
    ....... 
    ....... 
    
    // 13. Track the MediaHeartbeat.Event.AdComplete event when the ad reaches the  
    //     end, i.e., when the ad completes and finishes playing. 
    _mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdComplete, null, null); 
    
    ....... 
    ....... 
    
    // 14. Track the MediaHeartbeat.Event.AdBreakComplete event when all the ads in  
    //     the post-roll pod finish playing.  
    _mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakComplete, null, null); 
    
    ....... 
    ....... 
    
    // 15. Call trackComplete() when the playback reaches the end, i.e., when the 
    //     video completes and finishes playing. 
    _mediaHeartbeat.trackComplete(); 
    
    ........ 
    ........ 
    
    // 16. Call trackSessionEnd() when the playback session is over. This method  
    //     must be called even if the user does not watch the video to completion.  
    _mediaHeartbeat.trackSessionEnd(); 
    
    ........ 
    ........ 
    
  • ​iOSTper visualizzare questo scenario in iOS, imposta il seguente codice:

    //  Set up mediaObject 
    ADBMediaObject *mediaObject =  
      [ADBMediaHeartbeat createMediaObjectWithName:MEDIA_NAME  
                         length:MEDIA_LENGTH  
                         streamType:ADBMediaHeartbeatStreamTypeVOD]; 
    
    NSMutableDictionary *videoContextData =  
      [[NSMutableDictionary alloc] init]; 
    [videoContextData setObject:CUSTOM_VAL_1 forKey:CUSTOM_KEY_1]; 
    [videoContextData setObject:CUSTOM_VAL_2 forKey:CUSTOM_KEY_2]; 
    
    // 1. Call trackSessionStart when the user clicks Play or if autoplay is used,  
    //    i.e., there is an intent to start playback. 
    [_mediaHeartbeat trackSessionStart:mediaObject data:videoContextData]; 
    ....... 
    ....... 
    
    // Pre-roll 
    ADBMediaObject *adBreakInfo =  
      [ADBMediaHeartbeat createAdBreakObjectWithName:AD_BREAK_NAME  
                         position:AD_BREAK_POSITION  
                         startTime:AD_BREAK_START_TIME]; 
    ADBMediaObject *adInfo =  
      [ADBMediaHeartbeat createAdObjectWithName:AD_NAME  
                         adId:AD_ID  
                         position:AD_POSITION  
                         length:AD_LENGTH]; 
    
    // Context ad data 
    NSMutableDictionary *adDictionary =  
      [[NSMutableDictionary alloc] init]; 
    [adDictionary setObject:@"custom-val1" forKey:@"custom-key1"]; 
    [adDictionary setObject:@"custom-val2" forKey:@"custom-key2"]; 
    
    // 2. Track the ADBMediaHeartbeatEventAdBreakStart event when the  
    //    pre-roll pod starts to play. Note that since this is a pre-roll,  
    //    you must track the ADBMediaHeartbeatEventAdBreakStart event  
    //    before you call trackPlay. 
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdBreakStart  
                     mediaObject:adBreakObject  
                     data:adDictionary]; 
    ....... 
    ....... 
    
    // 3. Track the ADBMediaHeartbeatEventAdStart when the pre-roll  
    //    pod's ad starts to play. Note that since this is a pre-roll,  
    //    you must track the ADBMediaHeartbeatEventAdStart before you 
    //    call trackPlay. 
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdStart  
                      mediaObject:adObject  
                      data:adDictionary]; 
    ....... 
    ....... 
    
    // 4. Call trackPlay when the playback actually starts, i.e., when 
    //    the first frame of the main content is rendered on the screen. 
    [_mediaHeartbeat trackPlay]; 
    ....... 
    ....... 
    
    // 5. Track the ADBMediaHeartbeatEventAdComplete event when the ad  
    //    reaches the end, i.e., when it completes and finishes playing. 
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdComplete  
                      mediaObject:nil  
                      data:nil]; 
    ....... 
    ....... 
    
    // 6. Track the ADBMediaHeartbeatEventAdBreakComplete event when all  
    //    of the ads in the pod finish playing. 
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdBreakComplete  
                      mediaObject:nil  
                      data:nil]; 
    ....... 
    ....... 
    
    // Mid-roll 
    ADBMediaObject *adBreakInfo =  
      [ADBMediaHeartbeat createAdBreakObjectWithName:MIDROLL_BREAK_NAME  
                         position:MIDROLL_BREAK_POSITION  
                         startTime:MIDROLL_BREAK_START_TIME]; 
    ADBMediaObject *adInfo =  
      [ADBMediaHeartbeat createAdObjectWithName:MIDROLL_AD_NAME  
                         adId:MIDROLL_AD_ID position:MIDROLL_AD_POSITION  
                         length:MIDROLL_AD_LENGTH]; 
    
    // context ad data 
    NSMutableDictionary *midrollAdDictionary = [[NSMutableDictionary alloc] init]; 
    [midrollAdDictionary setObject:@"custom-val1" forKey:@"custom-key1"]; 
    [midrollAdDictionary setObject:@"custom-val2" forKey:@"custom-key2"]; 
    
    // 7. Track the ADBMediaHeartbeatEventAdBreakStart event when the mid-roll pod  
    //    starts to play. 
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdBreakStart  
                      mediaObject:adBreakObject  
                      data:nil]; 
    ....... 
    ....... 
    
    // 8. Track the ADBMediaHeartbeatEventAdStart event when the mid-roll pod's  
    //    ad starts to play. 
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdStart  
                     mediaObject:adObject  
                     data:midrollAdDictionary]; 
    ....... 
    ....... 
    
    // 9. Track the ADBMediaHeartbeatEventAdComplete event when the ad reaches  
    //    the end, i.e., when it completes and finishes playing. 
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdComplete  
                     mediaObject:nil  
                     data:nil]; 
    ....... 
    ....... 
    
    // 10. Track the ADBMediaHeartbeatEventAdBreakComplete event when all the  
    //     ads in the mid-roll pod finish playing. 
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdBreakComplete  
                     mediaObject:nil  
                     data:nil]; 
    ....... 
    ....... 
    
    // Post-roll 
    ADBMediaObject *postrollBreakInfo =  
      [ADBMediaHeartbeat createAdBreakObjectWithName:POSTROLL_BREAK_NAME  
                         position:POSTROLL_BREAK_POSITION  
                         startTime:POSTROLL_BREAK_START_TIME]; 
    ADBMediaObject *adInfo =  
      [ADBMediaHeartbeat createAdObjectWithName:POSTROLL_AD_NAME  
                         adId:POSTROLL_AD_ID  
                         position:POSTROLL_AD_POSITION  
                         length:POSTROLL_AD_LENGTH]; 
    
    // Context ad data 
    NSMutableDictionary *postrollAdDictionary =  
      [[NSMutableDictionary alloc] init]; 
    [postrollAdDictionary setObject:@"custom-val1" forKey:@"custom-key1"]; 
    [postrollAdDictionary setObject:@"custom-val2" forKey:@"custom-key2"]; 
    
    // 11. Track the ADBMediaHeartbeatEventAdBreakStart event when the  
    //     post-roll pod starts to play. 
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdBreakStart  
                     mediaObject:adBreakObject  
                     data:nil]; 
    ....... 
    ....... 
    
    // 12. Track the ADBMediaHeartbeatEventAdStart event when the  
    //     post-roll pod's ad starts to play. 
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdStart  
                     mediaObject:adObject  
                     data:postrollAdDictionary]; 
    ....... 
    ....... 
    
    // 13. Track the ADBMediaHeartbeatEventAdComplete event when the  
    //     post-roll pod's ad finishes playing. 
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdComplete  
                     mediaObject:nil  
                     data:nil]; 
    ....... 
    ....... 
    
    // 14. Track the ADBMediaHeartbeatEventAdBreakComplete event when  
    //     all the ads in the post-roll pod finish playing. 
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdBreakComplete  
                     mediaObject:nil data:nil]; 
    ....... 
    ....... 
    
    // 15. Call trackComplete when the playback reaches the end,  
    //     i.e., when the video completes and finishes playing. 
    [_mediaHeartbeat trackComplete]; 
    ....... 
    ....... 
    
    // 16. Call trackSessionEnd when the playback session is over. This method  
    //     must be called even if the user does not watch the video to completion. 
    [_mediaHeartbeat trackSessionEnd]; 
    ....... 
    ....... 
    
  • ​JavaScriptPer visualizzare questo scenario in JavaScript, immettere il testo seguente:

    // Set up mediaObject 
    MediaObject mediaInfo = MediaHeartbeat.createMediaObject( 
        Configuration.MEDIA_NAME,  
        Configuration.MEDIA_ID,  
        Configuration.MEDIA_LENGTH,  
        MediaHeartbeat.StreamType.VOD 
    ); 
    
    var videoMetadata = { 
        CUSTOM_KEY_1 : CUSTOM_VAL_1,  
        CUSTOM_KEY_2 : CUSTOM_VAL_2,  
        CUSTOM_KEY_3 : CUSTOM_VAL_ 
    }; 
    
    // 1. Call trackSessionStart() when Play is clicked or if autoplay is used,  
    //    i.e., when there's an intent to start playback.  
    this._mediaHeartbeat.trackSessionStart(mediaInfo, videoMetadata); 
    
    ...... 
    ...... 
    
    // Preroll 
    var adBreakInfo =  
      MediaHeartbeat.createAdBreakObject(ADBREAK_NAME,  
                                         ADBREAK_POSITION,  
                                         ADBREAK_START_TIME); 
    var adInfo =  
      MediaHeartbeat.createAdObject(AD_NAME,  
                                    AD_ID,  
                                    AD_POSITION,  
                                    AD_LENGTH); 
    
    // Custom ad metadata 
    var adMetadata = { 
        CUSTOM_KEY_1 : CUSTOM_VAL_1,  
        CUSTOM_KEY_2 : CUSTOM_VAL_2 
    
    }; 
    
    // 2. Track the MediaHeartbeat.Event.AdBreakStart event when the preroll pod  
    //    starts to play. Note that since this is a preroll, you must track the  
    //    MediaHeartbeat.Event.AdBreakStart event before you call trackPlay().  
    this._trackEvent(MediaHeartbeat.Event.AdBreakStart, adBreakInfo, null); 
    
    ....... 
    ....... 
    
    // 3. Track the MediaHeartbeat.Event.AdStart event when the preroll pod's ad  
    //    starts to play. Note that since this is a preroll, you must track the 
    //    MediaHeartbeat.Event.AdStart event before you call trackPlay().  
    this._heartbeat.trackEvent(MediaHeartbeat.Event.AdStart, adInfo, adMetadata); 
    
    ....... 
    ....... 
    
    // 4. Call trackPlay() when the main content actually starts, i.e., when the  
    //    first frame of the video content is rendered on the screen.  
    this._mediaHeartbeat.trackPlay(); 
    
    ....... 
    ....... 
    
    // 5. Track the MediaHeartbeat.Event.AdComplete event when the ad reaches the end,  
    //    i.e., when the ad completes and finishes playing. 
    this._heartbeat.trackEvent(MediaHeartbeat.Event.AdComplete, null, null); 
    
    ....... 
    ....... 
    
    // 6. Track the MediaHeartbeat.Event.AdBreakComplete event when all of the ads in  
    //    the pod finish playing. 
    this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakComplete); 
    
    ....... 
    ....... 
    
    // Midroll 
    var adBreakInfo =  
      MediaHeartbeat.createAdBreakObject(MIDROLL_BREAK_NAME,  
                                         MIDROLL_BREAK_POSITION,  
                                         MIDROLL_BREAK_START_TIME); 
    var adInfo =  
      MediaHeartbeat.createAdObject(MIDROLL_AD_NAME,  
                                    MIDROLL_AD_ID, 
                                    MIDROLL_AD_POSITION,  
                                    MIDROLL_AD_LENGTH); 
    
    // Custom ad metadata 
    var adMetadata = { 
        CUSTOM_KEY_1 : CUSTOM_VAL_1,  
        CUSTOM_KEY_2 : CUSTOM_VAL_2 
    
    }; 
    
    // 7. Track the MediaHeartbeat.Event.AdBreakStart event when the  
    //    midroll pod starts to play. 
    this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakStart, adBreakInfo); 
    
    ....... 
    ....... 
    
    // 8. Track the MediaHeartbeat.Event.AdStart event when the midroll  
    //    pod's ad starts to play. 
    this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdStart,  
                                    adInfo,  
                                    adMetadata); 
    
    ....... 
    ....... 
    
    // 9. Track the MediaHeartbeat.Event.AdComplete event when the ad  
    //    reaches the end, i.e., when the ad completes and finishes playing.  
    this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdComplete); 
    
    ....... 
    ....... 
    
    // 10. Track the MediaHeartbeat.Event.AdBreakComplete event when all of  
    //     the ads in the midroll pod finish playing. 
    this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakComplete); 
    
    ....... 
    ....... 
    
    // Set up mediaObject 
    var mediaInfo = MediaHeartbeat.createMediaObject( 
        Configuration.MEDIA_NAME,  
        Configuration.MEDIA_ID,  
        Configuration.MEDIA_LENGTH,  
        MediaHeartbeat.StreamType.VOD 
    
    ); 
    
    var videoMetadata = { 
        CUSTOM_KEY_1 : CUSTOM_VAL_1,  
        CUSTOM_KEY_2 : CUSTOM_VAL_2,  
        CUSTOM_KEY_3 : CUSTOM_VAL_3 
    
    }; 
    
    // 1. Call trackSessionStart() when Play is clicked or if autoplay  
    //    is used, i.e., when there's an intent to start playback. 
    this._mediaHeartbeat.trackSessionStart(mediaInfo, videoMetadata); 
    
    ...... 
    ...... 
    
    // Preroll 
    var adBreakInfo =  
      MediaHeartbeat.createAdBreakObject(ADBREAK_NAME,  
                                         ADBREAK_POSITION,  
                                         ADBREAK_START_TIME); 
    var adInfo =  
      MediaHeartbeat.createAdObject(AD_NAME,  
                                    AD_ID,  
                                    AD_POSITION,  
                                    AD_LENGTH); 
    
    // Custom ad metadata 
    var adMetadata = { 
       CUSTOM_KEY_1 : CUSTOM_VAL_1,  
       CUSTOM_KEY_2 : CUSTOM_VAL_2 
    
    }; 
    
    // 2. Track the MediaHeartbeat.Event.AdBreakStart event when the preroll pod  
    //    starts to play. Note that since this is a preroll, you must track the   
    //    MediaHeartbeat.Event.AdBreakStart event before you call trackPlay(). 
    this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakStart, adBreakInfo); 
    
    ....... 
    ....... 
    
    // 3. Track the MediaHeartbeat.Event.AdStart event when the preroll pod's  
    //    ad starts to play. Note that since this is a preroll, you must track   
    //    the MediaHeartbeat.Event.AdStart event before you call trackPlay(). 
    this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdStart, adInfo, adMetadata); 
    
    ....... 
    ....... 
    
    // 4. Call trackPlay() when the playback actually starts, i.e., when the first  
    //    frame of the main content is rendered on the screen.  
    _mediaHeartbeat.trackPlay(); 
    
    ....... 
    ....... 
    
    // 5. Track the MediaHeartbeat.Event.AdComplete event when the ad reaches  
    //    the end, i.e., when the ad completes and finishes playing. 
    this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdComplete); 
    
    ....... 
    ....... 
    
    // 6. Track the MediaHeartbeat.Event.AdBreakComplete event when all  
    //    of the ads in the pod finish playing. 
    this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakComplete); 
    
    ....... 
    ....... 
    
    // Mid-roll 
    var adBreakInfo =  
      MediaHeartbeat.createAdBreakObject(MIDROLL_BREAK_NAME, 
                                         MIDROLL_BREAK_POSITION,  
                                         MIDROLL_BREAK_START_TIME); 
    var adInfo =  
      MediaHeartbeat.createAdObject(MIDROLL_AD_NAME,  
                                    MIDROLL_AD_ID,  
                                    MIDROLL_AD_POSITION,  
                                    MIDROLL_AD_LENGTH); 
    
    // Custom ad metadata 
    var adMetadata = { 
       CUSTOM_KEY_1 : CUSTOM_VAL_1,  
       CUSTOM_KEY_2 : CUSTOM_VAL_2 
    
    }; 
    
    // 7. Track the MediaHeartbeat.Event.AdBreakStart event when the midroll  
    //    pod starts to play. 
    this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakStart, adBreakInfo); 
    
    ....... 
    ....... 
    
    // 8. Track the MediaHeartbeat.Event.AdStart event when the midroll pod's  
    //    ad starts to play. 
    this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdStart, adInfo, adMetadata); 
    
    ....... 
    ....... 
    
    // 9. Track the MediaHeartbeat.Event.AdComplete event when the ad reaches  
    //    the end, i.e., when the ad completes and finishes playing. 
    this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdComplete); 
    
    ....... 
    ....... 
    
    // 10. Track the MediaHeartbeat.Event.AdBreakComplete event when all  
    //     of the ads in the midroll pod finish playing. 
    this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakComplete); 
    
    ....... 
    ....... 
    
    // Postroll 
    var adBreakInfo = MediaHeartbeat.createAdBreakObject(POSTROLL_BREAK_NAME,  
    POSTROLL_BREAK_POSITION, POSTROLL_BREAK_START_TIME); 
    var adInfo = MediaHeartbeat.createAdObject(POSTROLL_AD_NAME, POSTROLL_AD_ID,  
    POSTROLL_AD_POSITION, POSTROLL_AD_LENGTH); 
    
    // Custom ad metadata 
    var adMetadata = { 
       CUSTOM_KEY_1 : CUSTOM_VAL_1,  
       CUSTOM_KEY_2 : CUSTOM_VAL_2 
    
    }; 
    
    // 11. Track the MediaHeartbeat.Event.AdBreakStart event when the postroll  
    //     pod starts to play. 
    this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakStart, adBreakInfo); 
    
    ....... 
    ....... 
    
    // 12. Track the MediaHeartbeat.Event.AdStart event when the postroll pod's ad  
    //     starts to play. 
    this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdStart, adInfo, adMetadata); 
    
    ....... 
    ....... 
    
    // 13. Track the MediaHeartbeat.Event.AdComplete event when the ad reaches   
    //     the end, i.e., when the ad completes and finishes playing. 
    this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdComplete); 
    
    ....... 
    ....... 
    
    // 14. Track the MediaHeartbeat.Event.AdBreakComplete event when all of  
    //     the ads in the postroll pod finish playing. 
    this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakComplete); 
    
    ....... 
    ....... 
    
    // 15. Call trackComplete() when the playback reaches the end, i.e., when playback 
    //     completes and finishes playing. 
    this._mediaHeartbeat.trackComplete(); 
    
    ........ 
    ........ 
    
    // 16. Call trackSessionEnd() when the playback session is over. This method must be called  
    //     even if the user does 
    not watch the video to completion. 
    this._mediaHeartbeat.trackSessionEnd(); 
    
    ........ 
    ........ 
    

In questa pagina