Lecture VOD sans publicité vod-playback-with-no-ads

Scénario scenario

Ce scénario comporte une ressource VOD, sans publicité, qui est lue une fois du début à la fin.

Déclencheur
Méthode Heartbeat
Appels réseau
Remarques
L’utilisateur clique sur Lecture.
trackSessionStart
Analytics Content Start, Heartbeat Content Start
Il peut s’agir d’un utilisateur qui clique sur Lecture ou d’un événement de lecture automatique.
Première image du média
trackPlay
Heartbeat Content Play
Cette méthode déclenche le minuteur. À partir de ce moment, des pulsations sont envoyées toutes les 10 secondes pendant la durée de la lecture.
Le contenu est lu
Content Heartbeats
Contenu terminé
trackComplete
Heartbeat Content Complete
Complete signifie que le curseur de lecture a atteint la fin de sa course.

Paramètres parameters

Un grand nombre de ces valeurs que vous pouvez voir dans les appels Heartbeat est également présent dans les appels Content StartContent Start d’Adobe Analytics. Adobe utilise de nombreux paramètres pour remplir les différents rapports multimédia, mais seuls les plus importants sont présents dans la liste ci-dessous :

Heartbeat Content Start

Paramètre
Valeur
Remarques
s:sc:rsid
<Identifiant de votre suite de rapports Adobe>
s:sc:tracking_server
<URL de votre serveur de suivi Analytics>
s:user:mid
à définir
Doit correspondre à la valeur intermédiaire de l’appel Adobe Analytics Content Start.
s:event:type
"start"
s:asset:type
"main"
s:asset:media_id
<Nom de votre média>
s:meta:*
facultatif
Métadonnées personnalisées définies sur le média.

Heartbeat Content Play heartbeat-content-play

Ces paramètres semblent en tout point identiques à l’appel Heartbeat Content Start, mais la différence majeure réside dans le paramètre s:event:type. Tous les paramètres doivent rester en place.

Paramètre
Valeur
Remarques
s:event:type
"play"
s:asset:type
"main"

Content Heartbeats content-heartbeats

Lors de la lecture du média, un minuteur envoie au moins une pulsation toutes les 10 secondes. Ces pulsations contiennent des informations concernant entre autres la lecture, les publicités et la mise en mémoire tampon. Le présent document ne traite pas du contenu exact de chaque pulsation, mais il faut retenir ici que celles-ci sont déclenchées de façon continue au fil de la lecture.

Dans les pulsations du contenu, recherchez les paramètres suivants :

Paramètres
Valeur
Remarques
s:event:type
"play"
l:event:playhead
<position du curseur de lecture> par exemple, 50,60,70
Ce paramètre indique la position actuelle du curseur de lecture.

Heartbeat Content Complete heartbeat-content-complete

Une fois la lecture terminée, c’est-à-dire lorsque le curseur de lecture a atteint la fin de sa course, un appel Heartbeat Content Complete est envoyé. Cet appel ressemble à d’autres appels Heartbeat, mais se différencie par certains éléments spécifiques :

Paramètres
Valeur
Remarques
s:event:type
"complete"
s:asset:type
"main"

Exemple de code sample-code

Dans ce scénario, le contenu dure 40 secondes. Il est lu jusqu’à la fin sans interruption.

Android

// Set up  mediaObject
MediaObject mediaInfo = MediaHeartbeat.createMediaObject(
  Configuration.MEDIA_NAME,
  Configuration.MEDIA_ID,
  Configuration.MEDIA_LENGTH,
  MediaHeartbeat.StreamType.VOD
);

HashMap<String, String> mediaMetadata = new HashMap<String, String>();
mediaMetadata.put(CUSTOM_VAL_1, CUSTOM_KEY_1);
mediaMetadata.put(CUSTOM_VAL_2, CUSTOM_KEY_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, mediaMetadata);

......
......

// 2. Call trackPlay() when the playback actually starts,
//    i.e., the first frame of media is rendered on the screen.
_mediaHeartbeat.trackPlay();

.......
.......

// 3. Call trackSessionEnd() when the playback session ends prior to the
//    media completing to the finish. This method must be called when
//    playback ends if the user does not watch the media to completion. When trackSessionEnd is used, trackComplete should not be called.
_mediaHeartbeat.trackSessionEnd();

........
........

// 4. Call trackComplete() when the playback reaches the end and
//    completes, i.e., when the media finishes because it is played to completion. When trackComplete is used, trackSessionEnd does not need to be called.
_mediaHeartbeat.trackComplete();

........
........

iOS

when the user clicks Play
ADBMediaObject *mediaObject =
[ADBMediaHeartbeat createMediaObjectWithName:MEDIA_NAME
                   length:MEDIA_LENGTH
                   streamType:ADBMediaHeartbeatStreamTypeVOD];

NSMutableDictionary *mediaContextData = [[NSMutableDictionary alloc] init];
[mediaContextData setObject:CUSTOM_VAL_1 forKey:CUSTOM_KEY_1];
[mediaContextData setObject:CUSTOM_VAL_2 forKey:CUSTOM_KEY_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:mediaObject data:mediaContextData];
......
......

// 2. Call trackPlay when the playback actually starts, i.e., when the
//    first frame of main content is rendered on the screen.
[_mediaHeartbeat trackPlay];
.......
.......

// 3. Call trackComplete when the playback reaches the end, i.e.,
//    when the media completes and finishes playing.
[_mediaHeartbeat trackComplete];
........
........

// 4. Call trackSessionEnd when the playback session is over. This method
//    must be called even if the user does not watch the media to completion.
[_mediaHeartbeat trackSessionEnd];
........
........

JavaScript

// Set up mediaObject

var mediaInfo = MediaHeartbeat.createMediaObject(Configuration.MEDIA_NAME, Configuration.MEDIA_ID,
Configuration.MEDIA_LENGTH,MediaHeartbeat.StreamType.VOD);
var mediaMetadata = {
  CUSTOM_KEY_1 : CUSTOM_VAL_1,
  CUSTOM_KEY_2 : CUSTOM_VAL_2,
  CUSTOM_KEY_3 : CUSTOM_VAL_3

};

// 1. Call trackSessionStart() when the user clicks play, or when autoplay is used,
//    i.e., there's an intent to start playback.
this._mediaHeartbeat.trackSessionStart(mediaInfo, mediaMetadata);

......
......

// 2. Call trackPlay() when the main content starts, i.e.,
//    the first frame of the media content is rendered on the screen.
this._mediaHeartbeat.trackPlay();

.......
.......

// 3. Call trackComplete() when the playback reaches the end,
    i.e., the media completes and finishes playing.
this._mediaHeartbeat.trackComplete();

........
........

// 4. Call trackSessionEnd() when the playback session is over.
//    This method must be called even if the user does not
//    watch the media to completion.
this._mediaHeartbeat.trackSessionEnd();

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