Show Menu
SUJETS×

Adobe Media Analytics (SDK 3.x) pour l’extension audio et vidéo

Utilisez cette documentation pour plus d’informations sur l’installation, la configuration et la mise en oeuvre d’Adobe Media Analytics (SDK 3.x) pour l’extension Audio et vidéo (extension Media Analytics). Les options disponibles lors de l’utilisation de cette extension pour créer une règle, ainsi que des exemples et des liens vers des exemples, sont inclus.
L’extension Media Analytics (MA) ajoute le SDK principal JavaScript Media (Media 3.x SDK). Cette extension permet d’ajouter l’instance Media de suivi à un site ou à un projet Launch. L’extension MA requiert deux extensions supplémentaires :
Cette extension est déployée avec le SDK Media 3.x, qui n’est pas rétrocompatible avec le SDK Media 2.x. Si votre page utilise déjà le SDK Media 2.x, utilisez Adobe Media Analytics pour l’extension audio et vidéo au lieu de cette extension.
Après avoir inclus les trois extensions mentionnées ci-dessus dans votre projet Launch, vous pouvez procéder de deux façons :
  • Utiliser les API Media de votre application web
  • Inclure ou créer une extension spécifique au lecteur qui associe des événements de lecteur multimédia spécifiques aux API sur l’instance de suivi Media . Cette instance est exposée via l’extension MA.

Installation et configuration de l’extension MA

  • Installer : Pour installer l'extension MA, ouvrez la propriété de l'extension, cliquez sur Extensions > Catalog , passez la souris sur l' Adobe Media Analytics (3.x SDK) for Audio and Video extension, puis cliquez sur Install .
  • Configurer : Pour configurer l’extension MA, ouvrez l’ Extensions onglet, passez la souris sur l’extension, puis cliquez sur Configure :

Options de configuration :

Option
Description
Serveur API de collecte
Définit le serveur d’API de collecte de médias (contactez votre représentant Adobe pour obtenir ce serveur).
Version de l’application
La version de l’application/du SDK du lecteur multimédia
Nom du lecteur
Le nom du lecteur multimédia en cours d’utilisation (par exemple, « AVPlayer », « Lecteur HTML5 », « Mon lecteur personnalisé »)
Canal
Propriété du nom de canal
Journalisation de débogage
Activation ou désactivation de la journalisation
Activer SSL
Activation ou désactivation de l’envoi de pings via HTTPS
Exporter les API vers l’objet Window
Activer ou désactiver l’exportation des API Media Analytics vers la portée globale
Nom de variable
Une variable utilisée pour exporter les API de Media Analytics sous l’objet window
Rappel : l’extension MA requiert les extensions Analytics et Experience Cloud ID . Vous devez également ajouter ces extensions à la propriété de votre extension et les configurer.

Utilisation de l’extension MA

Utilisation depuis une page web/application JavaScript

The MA extension exports the Media APIs in the global window object by enabling the "Export APIs to Window Object" setting in the Configuration page. Il exporte les API sous le nom de variable configuré. For example, if the variable name is configured to be ADB , then Media APIs can be accessed by window.ADB.Media .
L’extension MA exporte les API uniquement lorsque window["CONFIGURED_VARIABLE_NAME"] n’est pas défini et ne remplace pas les variables existantes.
  1. API Media :   window["CONFIGURED_VARIABLE_NAME"].Media
    Ceci expose toutes les API et constantes du SDK multimédia : https://adobe-marketing-cloud.github.io/media-sdks/reference/javascript_3x/APIReference.html
  2. Créer une instance de suivi des médias :   window["CONFIGURED_VARIABLE_NAME"].Media.getInstance
    Valeur renvoyée : Instance de Media suivi pour le suivi d'une session de média.
    var Media = window["CONFIGURED_VARIABLE_NAME"].Media;
    
    var tracker = Media.getInstance();
    
    
  3. A l’aide de l’instance de suivi des médias, suivez la documentation de l’API JS pour mettre en oeuvre le suivi des médias.
Vous pouvez obtenir l’exemple de lecteur ici : MA Sample Player . Le lecteur d’exemple fait office de référence pour expliquer comment utiliser l’extension MA pour prendre en charge directement Media Analytics à partir d’une application web.

Utilisation à partir d’autres extensions

L'extension MA expose media en tant que module partagé à d'autres extensions. (Pour plus d’informations sur les modules partagés, voir la documentation sur les modules partagés .)
Les modules partagés ne sont accessibles que depuis d’autres extensions. That is, a webpage/JavaScript app cannot access the shared modules, or use turbine (see code sample below) outside of an extension.
  1. API Media :   media Module partagé
    Ceci expose toutes les API et constantes du SDK multimédia : https://adobe-marketing-cloud.github.io/media-sdks/reference/javascript_3x/APIReference.html
  2. Créez l’instance de suivi des médias comme suit :
    Valeur renvoyée : Instance de Media suivi pour le suivi d'une session de média.
    var Media =
      turbine.getSharedModule('adobe-media-analytics', 'media');
    
    var tracker = Media.getInstance();
    
    
  3. A l’aide de l’instance de suivi des médias, suivez la documentation de l’API JS pour mettre en oeuvre le suivi des médias.
Tests :  pour tester votre extension dans cette version, vous devez télécharger votre extension sur  Adobe Experience Platform Launch , où vous avez accès à toutes les extensions dépendantes.