Enviar dados da Web para a Edge com o SDK da Web da Adobe Experience Platform

A partir da versão 2.20.0, o componente streamingMedia do SDK da Web do Adobe Experience Platform permite que você colete dados relacionados a sessões de mídia no seu site. Os dados coletados podem incluir informações sobre reprodução de mídia, pausas, conclusões e outros eventos relacionados.

Depois que os dados forem coletados, você poderá enviá-los para a Adobe Experience Platform e/ou Adobe Analytics para gerar relatórios. Esse recurso fornece uma solução abrangente para rastrear e entender o comportamento de consumo de mídia no site.

Para clientes que estão usando o SDK do Media JS, o SDK da Web fornece um caminho de migração do SDK do Media JS para o SDK da Web, ao mesmo tempo em que inclui suporte para funcionalidades existentes do Media JS, como manipular eventos de mídia.

Pré-requisitos prerequisites

Para usar o componente streamingMedia do SDK da Web, você deve atender aos seguintes pré-requisitos:

Siga as etapas descritas nesta página para migrar a implementação do complemento Coleção de mídia de transmissão do Media JS para o SDK da Web.

Etapa 1: instalar o SDK da Web do Experience Platform

Consulte a documentação dedicada para saber como instalar o SDK da Web nas suas propriedades da Web.

Etapa 2: configurar o componente streamingMedia do SDK da Web.

Exemplo

O trecho abaixo mostra como configurar a coleção de mídia no 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);

Em vez disso, você deve configurar o componente streamingMedia no SDK da Web, como exemplificado abaixo.

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

Consulte a documentação do componente streamingMedia do SDK da Web para obter detalhes completos sobre como configurá-lo.

Etapa 3: obtenha a instância do rastreador de mídia ao migrar do SDK do Media JS

Para clientes que estão usando o SDK do Media JS, o SDK da Web fornece um caminho de migração do SDK do Media JS para o SDK da Web, ao mesmo tempo em que inclui suporte para funcionalidades existentes do Media JS, como manipular eventos de mídia.

Web SDK inclui um comando para recuperar um Media Analytics Tracker. Você pode usar este comando para criar uma instância de objeto e, em seguida, usar as mesmas APIs que as fornecidas pela biblioteca Media JS, rastrear eventos de mídia.

Consulte a documentação de getMediaAnalyticsTracker para obter detalhes completos sobre os métodos compatíveis.

O trecho abaixo mostra como você recuperaria a instância do rastreador de mídia no Media JS.

var tracker = ADB.Media.getInstance();

Em vez disso, use o comando getMediaAnalyticsTracker no SDK da Web para obter o mesmo resultado, como mostrado abaixo.

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

Todos os métodos auxiliares estarão disponíveis no objeto Media. Os métodos do rastreador estão disponíveis na instância do rastreador, conforme mostrado abaixo.

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