Migration du SDK Media autonome vers Adobe Launch : Web (JS)

Différences de fonctionnalités

Launch : Launch offre une interface utilisateur qui vous guide tout au long de l’installation, de la configuration et du déploiement de vos solutions de suivi multimédia en ligne. Launch est une version améliorée de Dynamic Tag Management (DTM).
SDK Media : le SDK Media propose des bibliothèques de suivi multimédia conçues pour des plateformes spécifiques (comme Android, iOS, etc.). Adobe recommande le SDK Media pour le suivi de l’utilisation des médias dans vos applications mobiles.

Configuration

SDK Media autonome

Dans le SDK Media autonome, vous configurez le suivi dans l’application avant de le transmettre
au SDK lorsque vous créez le dispositif de suivi.

//Media Heartbeat initialization
var mediaConfig = new MediaHeartbeatConfig();
mediaConfig.trackingServer = "namespace.hb.omtrdc.net";
mediaConfig.playerName = "html5-player";
mediaConfig.channel = "sample-channel";
mediaConfig.ovp = "video-provider";
mediaConfig.appVersion = "v2.0.0"
mediaConfig.ssl = true;
mediaConfig.debugLogging = true;

En plus de la configuration MediaHeartbeat, la page doit configurer et transmettre
l’instance AppMeasurement et l’instance pour le suivi multimédia VisitorAPI afin
de fonctionner correctement.

Extension de Launch

Dans Experience Platform Launch, cliquez sur l’onglet Extensions pour votre
propriété Web.
Dans l’onglet Catalogue, recherchez l’extension Adobe Media Analytics for Audio and
Video, puis cliquez sur Installer.
Dans la page des paramètres d’extension, configurez les paramètres de suivi. L’extension Media utilisera les paramètres configurés pour le suivi.

Guide de l’utilisateur de Launch : installation et configuration de l’extension média

Différences dans la création du dispositif de suivi

SDK Media

Ajoutez la bibliothèque Media Analytics à votre projet de développement.
Créez un objet de configuration (MediaHeartbeatConfig).
Implémentez le protocole délégué exposant les fonctions getQoSObject() et getCurrentPlaybackTime().
Créez une instance Media Heartbeat (MediaHeartbeat).

// Media Heartbeat initialization
var mediaConfig = new MediaHeartbeatConfig();
...
// Configuration settings
mediaConfig.trackingServer = Configuration.HEARTBEAT.TRACKING_SERVER;
...
// Implement Media Delegate (Quality of Service and Playhead)
var mediaDelegate = new MediaHeartbeatDelegate();
...
mediaDelegate.getQoSObject = function() {
    return MediaHeartbeat.createQoSObject(<bitrate>, <startuptime>, <fps>, <droppedFrames>);
    ...
}
...
// Create your tracker
this.mediaHeartbeat = new MediaHeartbeat(mediaDelegate, mediaConfig, appMeasurement);

Launch

Launch propose deux méthodes pour créer l’infrastructure de suivi. Les deux méthodes utilisent l’extension Media Analytics pour Launch :

Utilisez les API de suivi multimédia d’une page Web.

Dans cette configuration, l’extension Media Analytics exporte les API de suivi multimédia vers une variable configurée dans l’objet « window » global :
```
window["CONFIGURED_VARIABLE_NAME"].MediaHeartbeat.getInstance
```
Utilisez les API de suivi multimédia d’une autre extension de Launch.

Dans cette configuration, vous utilisez les API de suivi multimédia exposées par les modules partagés get-instance et media-heartbeat.

REMARQUE

Les modules partagés ne peuvent pas être utilisés dans des pages Web. Vous pouvez uniquement utiliser des modules partagés à partir d’une autre extension.

Créez une instance MediaHeartbeat à l’aide du module partagé get-instance.
Transmettez un objet délégué à get-instance qui expose les fonctions getQoSObject() et getCurrentPlaybackTime().
```
var getMediaHeartbeatInstance =
turbine.getSharedModule('adobe-video-analytics', 'get-instance');
```
Accédez aux constantes MediaHeartbeat via le module partagé media-heartbeat.