Envío de datos web a Edge con el SDK web de Adobe Experience Platform

A partir de la versión 2.20.0, la variable streamingMedia componente de Adobe Experience Platform SDK web permite recopilar datos relacionados con las sesiones de contenido del sitio web. Los datos recopilados pueden incluir información sobre reproducciones de contenido, pausas, finalizaciones y otros eventos relacionados.

Una vez recopilados los datos, puede enviarlos a Adobe Experience Platform o Adobe Analytics para generar informes. Esta función proporciona una solución completa para realizar el seguimiento y comprender el comportamiento del consumo de medios en el sitio web.

Para los clientes que utilizan el SDK de Media JS, el SDK web proporciona una ruta de migración para pasar de Media JS SDK a SDK web, a la vez que incluye compatibilidad con las funcionalidades de Media JS existentes, como la administración de eventos de medios.

Requisitos previos prerequisites

Para usar la variable streamingMedia del SDK web, debe cumplir los siguientes requisitos previos:

Siga los pasos descritos en esta página para migrar la implementación del complemento de recopilación de medios de streaming de Media JS al SDK web.

Paso 1: Instalación del SDK web de Experience Platform

Consulte la documentación dedicada para obtener información sobre cómo instalar el SDK web en las propiedades web.

Paso 2: Configuración del SDK web streamingMedia componente.

Ejemplo

El siguiente fragmento muestra cómo configurar la recopilación de medios en 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);

En su lugar, debe configurar la variable streamingMedia en el SDK web como se muestra a continuación.

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

Consulte el SDK web streamingMedia componente documentación para obtener información detallada sobre cómo configurarla.

Paso 3: Obtención de la instancia de rastreador de medios al migrar desde el SDK de Media JS

Para los clientes que utilizan el SDK de Media JS, el SDK web proporciona una ruta de migración para pasar de Media JS SDK a SDK web, a la vez que incluye compatibilidad con las funcionalidades de Media JS existentes, como la administración de eventos de medios.

Web SDK incluye un comando para recuperar un rastreador de Media Analytics. Puede utilizar este comando para crear una instancia de objeto y, a continuación, utilizando las mismas API que las proporcionadas por el Biblioteca de Media JS, rastree eventos de medios.

Consulte la getMediaAnalyticsTracker para obtener información detallada sobre los métodos admitidos.

El siguiente fragmento muestra cómo recuperar la instancia de seguimiento de medios en Media JS.

var tracker = ADB.Media.getInstance();

En su lugar, utilice el getMediaAnalyticsTracker en el SDK web para lograr el mismo resultado, como se muestra a continuación.

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

Todos los métodos de ayuda estarán disponibles en la Media objeto. Los métodos de seguimiento están disponibles en la instancia de seguimiento, como se muestra a continuación.

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);