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

A partir da versão 2.20.0, o componente streamingMedia da Web SDK do Adobe Experience Platform permite que você colete dados relacionados às 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 Media JS SDK, o Web SDK fornece um caminho de migração do Media JS SDK para o Web SDK, 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 Web SDK, você deve atender aos seguintes pré-requisitos:

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

Etapa 1: instalar o Experience Platform Web SDK

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

Etapa 2: configurar o componente streamingMedia do Web SDK.

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 Web SDK, 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 Web SDK para obter detalhes completos sobre como configurá-lo.

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

Para clientes que estão usando o Media JS SDK, o Web SDK fornece um caminho de migração do Media JS SDK para o Web SDK, 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 Web SDK para obter o mesmo resultado, conforme 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);