- Mesurer des médias en flux continu dans Adobe Analytics
- Périphériques et plateformes pris en charge
- Introduction aux médias en flux continu dans Analytics
- SDK Media Analytics
- FAQ sur l’abandon de la prise en charge du SDK Media Analytics
- Téléchargement des SDK
- Installation et configuration
- Suivi de la lecture des médias en flux continu
- Aperçu
- Suivi de la lecture principale des médias en flux continu
- Suivi de la mise en mémoire tampon
- Suivi de la recherche
- Mise en œuvre de métadonnées standard
- Mise en œuvre de métadonnées standard sur Android
- Mise en œuvre de métadonnées standard sur iOS
- Clés de métadonnées iOS
- Mise en œuvre de métadonnées standard sur JavaScript
- Mise en œuvre de métadonnées standard sur Chromecast
- Paramètres des métadonnées standard - Chromecast
- Mise en œuvre de métadonnées standard sur Roku
- Paramètres des métadonnées standard - Roku
- Suivi des publicités
- Aperçu
- Suivi des publicités sur Android
- Suivi des publicités sur iOS
- Suivi des publicités sur JavaScript
- Suivi des publicités sur Chromecast
- Suivi des publicités sur Roku
- Mise en œuvre de métadonnées de publicité standard
- Suivi des chapitres et des segments
- Suivi de la qualité de l’expérience
- Erreurs de suivi
- Exclusion et confidentialité
- Scénarios de suivi
- Lecture VOD sans publicité
- Lecture VOD avec publicités preroll
- Lecture VOD avec saut de publicité
- Lecture VOD avec un chapitre
- Lecture VOD avec saut de chapitre
- Lecture VOD avec recherche dans le contenu principal
- Lecture VOD avec mise en mémoire tampon
- Plusieurs dispositifs de suivi VOD en parallèle
- Un dispositif de suivi VOD pour plusieurs sessions
- Contenu principal en direct
- Contenu principal en direct avec suivi séquentiel
- Validation
- Analytics dans les applications OTT
- Guide pas à pas
- Migration de Media Analytics 1.x vers 2.x
- Migration du SDK Media Analytics vers Launch
- API Media Collection (RESTful)
- Aperçu
- Référence d’API
- Mise en œuvre de l’API
- Démarrage rapide
- Définition du type de requête HTTP dans votre lecteur
- Obtention d’un ID de session
- Mise en œuvre d’une requête events
- Validation des requêtes d’événement
- Envoi d’événements ping
- Envoi de données QoE
- Prise en charge des métadonnées personnalisées
- Conditions d’expiration
- Contrôle de l’ordre des événements
- Événements de mise en file d’attente lorsque la réponse des sessions est lente
- Chronologies du suivi multimédia
- Guide pas à pas
- Mesures et métadonnées
- Rapports et analyses
- Suivi du contenu téléchargé
- Suivi de l’état du lecteur
- Federated Analytics
- Ressources supplémentaires
Migration de Milestone vers Media Analytics
Aperçu
Les concepts de base de la mesure vidéo sont les mêmes pour Milestone et Media Analytics, qui prend les événements du lecteur vidéo et les mappe aux méthodes d’analyse, tout en récupérant les métadonnées et les valeurs du lecteur et en les associant aux variables d’analyse. La solution Media Analytics est basée sur Milestone, donc de nombreuses méthodes et mesures sont identiques. Toutefois, l’approche et le code de configuration ont beaucoup changé. Il devrait être possible de mettre à jour le code des événements du lecteur afin qu’il pointe vers les nouvelles méthodes Media Analytics. Voir Présentation du SDK et Présentation du suivi pour en savoir plus sur l’implémentation de Media Analytics.
Les tableaux suivants fournissent des correspondances entre la solution Milestone et la solution Media Analytics.
Guide de migration
Référence de variables
| Mesure Milestone | Type de variable | Mesure Media Analytics |
|---|---|---|
| Contenu | eVar Délai d’expiration par défaut : Visite |
Contenu |
| Type de contenu | eVar Délai d’expiration par défaut : page vue |
Type de contenu |
| Temps passé sur le contenu | Type d’événement : Compteur |
Temps passé sur le contenu |
| Démarrages de vidéo | Type d’événement : Compteur |
Démarrages de vidéo |
| La vidéo se termine | Type d’événement : Compteur |
Fin de contenu |
Variables du module média
| Milestone | Syntaxe de Milestone | Media Analytics | Syntaxe Media Analytics |
|---|---|---|---|
| Media.trackUsingContextData | s.Media.trackUsingContextData = true; |
S.O. | Toutes les données Media Analytics sont envoyées uniquement à l’aide de données contextuelles. |
| Media.contextDataMapping | s.Media.contextDataMapping = { "a.media.name":"eVar2,prop2", "a.media.segment":"eVar3", "a.contentType":"eVar1", "a.media.timePlayed":"event3", "a.media.view":"event1", "a.media.segmentView":"event2", "a.media.complete":"event7", "a.media.milestones": { 25:"event4", 50:"event5", 75:"event6" } }; |
S.O. | Les données contextuelles Media Analytics sont automatiquement renseignées dans des variables réservées. Le mappage à des eVar, des props et des événements n’est plus nécessaire dans le code de mise en œuvre. Les clients peuvent associer des données contextuelles à des variables à l’aide de règles de traitement. |
| Media.trackVars | s.Media.trackVars = "events, prop2, eVar1, eVar2, eVar3"; |
S.O. | Plus nécessaire, car le mappage se fait via des variables réservées et des règles de traitement. |
| Media.trackEvents | s.Media.trackEvents = "event1, event2, event3, event4, event5, event6, event7" |
S.O. | Plus nécessaire, car le mappage se fait via des variables réservées et des règles de traitement. |
Variables facultatives
| Milestone | Syntaxe de Milestone | Media Analytics | Syntaxe Media Analytics |
|---|---|---|---|
| Media.autoTrack | s.Media.autoTrack = true; |
S.O. | Nous ne fournissons plus de mappages de lecteur préconfigurés. |
| Media.autoTrackNetStreams | s.Media. autoTrackNetStreams = true |
S.O. | Nous ne fournissons plus de mappages de lecteur préconfigurés. |
| Media.completeByCloseOffset | s.Media. completeByCloseOffset = true |
S.O. | La fin du contenu ne prend en charge qu’un marqueur de progression de 100 %. |
| Media.completeCloseOffsetThreshold | s.Media. completeCloseOffsetThreshold = 1 |
S.O. | La fin du contenu ne prend en charge qu’un marqueur de progression de 100 %. |
| Media.playerName | s.Media.playerName = "Custom Player Name" |
Clé SDK : playerName ; Clé API : media.playerName |
MediaHeartbeatConfig. playerName |
| Media.trackSeconds | s.Media. trackSeconds = 15 |
S.O. | Media Analytics est défini sur 10 secondes pour le contenu et 1 seconde pour les publicités. Aucune autre option n’est disponible. |
| Media.trackMilestones | s.Media. trackMilestones = "25,50,75"; |
S.O. | Media Analytics effectue toujours le suivi des marqueurs de progression à 10 %, 25 %, 50 %, 75 % et 95 %. |
| Media.trackOffsetMilestones | s.Media. trackOffsetMilestones = "20,40,60"; |
S.O. | Media Analytics effectue toujours le suivi des marqueurs de progression à 10 %, 25 %, 50 %, 75 % et 95 %. |
| Media.segmentByMilestones | s.Media.segmentByMilestones = true; |
S.O. | Le suivi automatique n’est plus disponible. |
| Media.segmentByOffsetMilestones | s.Media. segmentByOffsetMilestones = true; |
S.O. | Le suivi automatique n’est plus disponible. |
Variables de suivi des publicités
| Milestone | Syntaxe de Milestone | Media Analytics | Syntaxe Media Analytics |
|---|---|---|---|
| Media.adTrackSeconds | s.Media. adTrackSeconds = 15 |
S.O. | Media Analytics est défini sur 10 secondes pour le contenu et 1 seconde pour les publicités. Aucune autre option n’est disponible. |
| Media.adTrackMilestones | s.Media. adTrackMilestones = "25,50,75"; |
S.O. | Les marqueurs de progression ne sont pas fournis par défaut pour les publicités. Utilisez des mesures calculées pour créer des marqueurs de progression des publicités. |
| Media.adTrackOffsetMilestones | s.Media. adTrackOffsetMilestones = "20,40,60"; |
S.O. | Media Analytics est défini sur 1 seconde pour les publicités. Aucune autre option n’est disponible. |
| Media.adSegmentByMilestones | s.Media. adSegmentByMilestones = true; |
S.O. | Le suivi automatique n’est plus disponible. |
| Media.adSegmentByOffsetMilestones | s.Media. adSegmentByOffsetMilestones = true; |
S.O. | Le suivi automatique n’est plus disponible. |
Méthodes du module média
| Milestone | Syntaxe de Milestone | Media Analytics | Syntaxe Media Analytics |
|---|---|---|---|
| Media.open | s.Media.open( mediaName, mediaLength, mediaPlayerName) |
trackSessionStart | trackSessionStart( mediaObject, contextData) |
| mediaName | mediaName : (obligatoire) nom de la vidéo tel que vous souhaitez le voir apparaître dans les rapports vidéo. |
name | createMediaObject( name, mediaId, length, streamType) |
| mediaLength | mediaLength : (obligatoire) durée de la vidéo, en secondes. |
length | createMediaObject( name, mediaId, length, streamType) |
| mediaPlayerName | mediaPlayerName : (obligatoire) nom du lecteur vidéo utilisé pour visionner la vidéo, tel que vous souhaitez le voir apparaître dans les rapports vidéo. |
playerName | MediaHeartbeatConfig. playerName |
| Media.openAd | s.Media.openAd( name, length, playerName, parentName, parentPod, parentPodPosition, CPM) |
trackEvent | mediaHeartbeat.trackEvent( MediaHeartbeat. Event. AdBreakStart, adBreakObject); ... trackEvent( MediaHeartbeat. Event. AdStart, adObject, adCustomMetadata); |
| name | name : (obligatoire) nom ou identifiant de la vidéo. |
name | createAdObject( name, adId, position, length) |
| length | length : (obligatoire) durée de la publicité. |
length | createAdObject( name, adId, position, length) |
| playerName | playerName : (obligatoire) nom du lecteur vidéo utilisé pour visionner la publicité. |
playerName | MediaHeartbeatConfig. playerName |
| parentName | parentName : nom ou identifiant du contenu principal dans lequel la publicité est incorporée. |
S.O. | Hérité automatiquement. |
| parentPod | parentPod : position de lecture de la publicité dans le contenu principal. |
position | createAdBreakObject( name, position, startTime) |
| parentPodPosition | parentPodPosition : position de lecture de la publicité dans la capsule. |
position | createAdObject( name, adId, position, length) |
| CPM | CPM : CPM ou CPM chiffré (précédé du préfixe « ~ ») applicable à la lecture. |
S.O. | Non disponible par défaut dans Media Analytics. |
| Media.click | s.Media.click(name, offset) |
S.O. | Utilisez un appel d’analyse de lien personnalisé pour effectuer le suivi des clics. |
| Media.close | s.Media.close(mediaName) |
trackSessionEnd | trackSessionEnd() |
| Media.complete | s.Media.complete(name, offset) |
trackComplete | trackComplete() |
| Media.play | s.Media.play( name, offset, segmentNum, segment, segmentLength) |
trackPlay | trackPlay() |
| Media.stop | s.Media.stop(mediaName, mediaOffset) |
trackPause ou trackEvent |
trackPause() ou trackEvent( MediaHeartbeat. Event. SeekStart) ou trackEvent( MediaHeartbeat. Event. BufferStart); |
| Media.monitor | s.Media.monitor(s, media) |
Utilisez des métadonnées personnalisées ou standard pour définir des variables supplémentaires. | var customVideoMetadata = { isUserLoggedIn: "false", tvStation: "Sample TV station", programmer: "Sample programmer" }; ... var standardVideoMetadata = {}; standardVideoMetadata [MediaHeartbeat. VideoMetadataKeys. EPISODE] = "Sample Episode"; standardVideoMetadata [MediaHeartbeat. VideoMetadataKeys. SHOW] = "Sample Show"; ... mediaObject.setValue( MediaHeartbeat. MediaObjectKey. StandardVideoMetadata, standardVideoMetadata); |
| Media.track | s.Media.track(mediaName) |
S.O. | La fréquence des appels de suivi est définie automatiquement. |