Envoyer des données web à Edge avec Adobe Experience Platform Web SDK

À partir de la version 2.20.0, le composant streamingMedia de Adobe Experience Platform Web SDK vous permet de collecter des données relatives aux sessions multimédia sur votre site Web. Les données collectées peuvent inclure des informations sur les lectures de médias, les pauses, les terminaisons et d’autres événements associés.

Une fois les données collectées, vous pouvez les envoyer à Adobe Experience Platform et/ou Adobe Analytics pour générer des rapports. Cette fonctionnalité fournit une solution complète pour suivre et comprendre le comportement de consommation des médias sur votre site web.

Pour les clients qui utilisent le SDK Media JS, Web SDK fournit un chemin de migration permettant de passer de Media JS SDK à Web SDK, tout en incluant la prise en charge des fonctionnalités Media JS existantes, telles que la gestion des événements multimédia.

Conditions préalables prerequisites

Pour utiliser le composant streamingMedia de Web SDK, les conditions préalables suivantes doivent être remplies :

Suivez les étapes décrites dans cette page pour migrer votre implémentation de Streaming Media Collection de Media JS vers Web SDK.

Étape 1 : installer Experience Platform Web SDK

Consultez la documentation dédiée pour savoir comment installer Web SDK sur vos propriétés web.

Étape 2 : configurer le composant streamingMedia de Web SDK.

Exemple

L’extrait de code ci-dessous indique comment configurer la collecte de médias dans Media JS.

var mediaConfig = new ADB.MediaConfig();
mediaConfig.trackingServer = "company.hb-api.omtrdc.net";
mediaConfig.playerName = "player_name";
mediaConfig.channel = "sample_channel";
mediaConfig.appVersion = "app_version";
mediaConfig.debugLogging = true;
mediaConfig.ssl = true;

ADB.Media.configure(mediaConfig, appMeasurement);

Vous devez plutôt configurer le composant streamingMedia dans le SDK Web, comme illustré ci-dessous.

alloy("configure", {
  streamingMedia: {
    channel: "sample_channel",
    playerName: "player_name",
    appVersion: "app_version",
    mainPingInterval: 10,
    adPingInterval: 10
  }
});

Consultez le composant streamingMedia de Web SDK documentation pour obtenir des informations complètes sur sa configuration.

Étape 3 : obtenir l’instance de suivi multimédia lors de la migration depuis Media JS SDK

Pour les clients qui utilisent le SDK Media JS, Web SDK fournit un chemin de migration permettant de passer de Media JS SDK à Web SDK, tout en incluant la prise en charge des fonctionnalités Media JS existantes, telles que la gestion des événements multimédia.

Web SDK comprend une commande permettant de récupérer un dispositif de suivi Media Analytics. Vous pouvez utiliser cette commande pour créer une instance d’objet, puis, à l’aide des mêmes API que celles fournies par la bibliothèque JS Media, effectuer le suivi des événements multimédia.

Consultez la documentation getMediaAnalyticsTracker pour plus d’informations sur les méthodes prises en charge.

Le fragment de code ci-dessous indique comment récupérer l’instance de suivi multimédia dans Media JS.

var tracker = ADB.Media.getInstance();

Utilisez plutôt la commande getMediaAnalyticsTracker dans Web SDK pour obtenir le même résultat, comme illustré ci-dessous.

// aquire Media Analytics APIs
const Media = await window.alloy("getMediaAnalyticsTracker", {});
// create a media tracker instance
const trackerInstance = Media.getInstance();

Toutes les méthodes d'assistance seront disponibles sur l'objet Media. Les méthodes de suivi sont disponibles sur l’instance de suivi, comme illustré ci-dessous.

const mediaInfo = Media.createMediaObject(
  "video name",
  "player video",
  60,
  Media.StreamType.VOD,
  Media.MediaType.Video
);

const contextData = {
  isUserLoggedIn: "false",
  tvStation: "Sample TV station",
  programmer: "Sample programmer",
  assetID: "/uri-reference"
};

// Set standard Video Metadata
contextData[Media.VideoMetadataKeys.Episode] = "Sample Episode";
contextData[Media.VideoMetadataKeys.Show] = "Sample Show";

trackerInstance.trackSessionStart(mediaInfo, contextData);