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()etgetCurrentPlaybackTime(). - 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 :
code language-none 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-instanceetmedia-heartbeat.note note NOTE 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-instancequi expose les fonctionsgetQoSObject()etgetCurrentPlaybackTime().code language-none var getMediaHeartbeatInstance = turbine.getSharedModule('adobe-video-analytics', 'get-instance');Accédez aux constantes
MediaHeartbeatvia le module partagémedia-heartbeat.