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

A partir de la versión 2.20.0, el componente streamingMedia del SDK web de Adobe Experience Platform le permite recopilar datos relacionados con las sesiones de contenido en su 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 utilizar el componente 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 aprender a instalar el SDK web en sus propiedades web.

Paso 2: Configurar el componente streamingMedia del SDK web.

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 el componente 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 la documentación del componente del SDK web streamingMedia para obtener información detallada sobre cómo configurarlo.

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, utilizar las mismas API que las proporcionadas por la biblioteca Media JS, realizar un seguimiento de los eventos de medios.

Consulte la documentación de 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 comando getMediaAnalyticsTracker del 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 el objeto Media. 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);