DocumentaçãoAnalyticsGuia de serviços para mídia de streaming

Visão geral da implementação do Edge

Última atualização: 4 de junho de 2026

Criado para:

  • User
  • Admin
  • Developer

O Adobe Experience Platform Edge Network permite enviar dados destinados a vários produtos para um único endpoint, que então encaminha as informações apropriadas para cada produto. Isso consolida o esforço de implementação em várias soluções de dados e é a maneira recomendada de implementar a Coleção de mídia de transmissão para Adobe Analytics e Customer Journey Analytics.

Independentemente da base de código usada, ou seja, o Web SDK, o Mobile SDK (iOS ou Android), o Roku SDK ou a API do Media Edge, primeiro você deve concluir a configuração da plataforma descrita nesta página: criar um esquema, criar um conjunto de dados e configurar um fluxo de dados.

Pré-requisitos

  1. Conclua os pré-requisitos gerais. Consulte os pré-requisitos gerais.

  2. Confirme uma solução Adobe compatível. Você deve ter uma implementação funcional do Customer Journey Analytics, Adobe Analytics, Adobe Journey Optimizer ou Real-Time Customer Data Platform:

Configurar o esquema no Adobe Experience Platform

Para padronizar a coleta de dados entre aplicativos que usam o Adobe Experience Platform, a Adobe criou o padrão aberto e publicamente documentado Experience Data Model (XDM).

  1. No Adobe Experience Platform, comece a criar o esquema conforme descrito em Criar e editar esquemas na interface.

  2. Na página Detalhes do esquema, escolha Evento de experiência como a classe base do esquema.

    Grupos de campos adicionados

  3. Selecione Próximo.

  4. Especifique um nome para exibição de esquema e uma descrição e selecione Concluir.

  5. Na área Composição, na seção Grupos de campos, selecione Adicionar, procure e adicione os seguintes grupos de campos ao esquema:

    • End User ID Details
    • Implementation Details
    • MediaAnalytics Interaction Details

    Após adicionar os grupos de campos, eles são exibidos na seção Grupos de campos:

    Grupos de campos adicionados

  6. Selecione Salvar para salvar suas alterações.

  7. (Opcional) Você pode ocultar determinados campos que não são usados pela API do Media Edge. Ocultar esses campos facilita a leitura do esquema, mas não é obrigatório. Esses campos se referem apenas àqueles no grupo de campos MediaAnalytics Interaction Details.

    accordion
    Expanda para exibir instruções nos campos que você pode ocultar.

    1. Na área Estrutura, selecione o campo Media Collection Details e Gerenciar campos relacionados.

      gerenciar-relacionados-campos

    2. Habilite a opção para Mostrar nomes para exibição para campos e atualize o esquema da seguinte maneira:

      • No campo Media Collection Details > Advertising Details, oculte os seguintes campos de relatório: Ad Completed, Ad Started e Ad Time Played.

      • No campo Media Collection Details > Advertising Pod Details, oculte o seguinte campo de relatório: Ad Break ID

      • No campo Media Collection Details > Chapter Details, oculte os seguintes campos de relatórios: Chapter Completed, Chapter ID, Chapter Started e Chapter Time Played.

      • No campo Media Collection Details, oculte o campo List Of States.

        ocultar estados da coleção de mídia

      • No campo Media Collection Details > List Of States End e Media Collection Details > List Of States Start, oculte os seguintes campos de relatório: Player State Count, Player State Set e Player State Time.

        campos a ocultar

      • No campo Media Collection Details > Qoe Data Details, oculte os seguintes campos de relatórios: Average Bitrate, Average Bitrate Bucket, Bitrate Change Impacted Streams, Bitrate Changes, Buffer Impacted Streams, Buffer Events, Dropped Frame Impacted Streams, Drops Before Starts, Errors, External Error IDs, Error Impacted Streams, Media SDK Error IDs, Player SDK Error IDs, Stalling Impacted Streams, Stalling Events, Total Buffer Duration e Total Stalling Duration.

      • No campo Media Collection Details > Session Details, oculte os seguintes campos de relatórios: 10% Progress Marker, 25% Progress Marker, 50% Progress Marker, 75% Progress Marker, 95% Progress Marker, Ad Count, Average Minute Audience, Content Completes, Chapter Count, Content Starts, Content Time Spent, Estimated Streams, Federated Data, Media Segment Views, Media Downloaded Flag, Media Starts, Media Session ID, Media Session Server Timeout, Media Time Spent, Pause Events, Pause Impacted Streams, Pev3, Pccr, Total Pause Duration, Unique Time Played e Video Segment.

    3. Selecione Confirmar para salvar suas alterações.

    4. Na área Estrutura, habilite a opção para Mostrar nomes para exibição para campos e selecione o campo List Of Media Collection Downloaded Content Events.

    5. Selecione Gerenciar campos relacionados e atualize o esquema da seguinte maneira:

      • No campo List Of Media Collection Downloaded Content Events > Media Details > Advertising Details, oculte os seguintes campos de relatório: Ad Completed, Ad Started e Ad Time Played.

      • No campo List Of Media Collection Downloaded Content Events > Media Details > Advertising Pod Details, oculte o seguinte campo de relatório: Ad Break ID

      • No campo List Of Media Collection Downloaded Content Events > Media Details > Chapter Details, oculte os seguintes campos de relatório: Chapter Completed, Chapter ID, Chapter Started e Chapter Time Played.

      • No campo List Of Media Collection Downloaded Content Events > Media Details, oculte o campo List Of States.

      • No campo List Of Media Collection Downloaded Content Events > Media Details > List Of States End e Media Collection Details > List Of States Start, oculte os seguintes campos de relatórios: Player State Count, Player State Set e Player State Time.

      • No campo List Of Media Collection Downloaded Content Events > Media Details > Qoe Data Details, oculte os seguintes campos de relatórios: Average Bitrate, Average Bitrate Bucket, Bitrate Change Impacted Streams, Bitrate Changes, Buffer Events, Buffer Impacted Streams, Drops Before Starts, Dropped Frame Impacted Streams, Error Impacted Streams, Errors, External Error IDs, Media SDK Error IDs, Player SDK Error IDs, Stalling Events, Stalling Impacted Streams, Total Buffer Duration e Total Stalling Duration.

      • No campo List Of Media Collection Downloaded Content Events > Media Details > Session Details, oculte os seguintes campos de relatórios: 10% Progress Marker, 25% Progress Marker, 50% Progress Marker, 75% Progress Marker, 95% Progress Marker, Ad Count, Average Minute Audience, Chapter Count, Content Completes, Content Starts, Content Time Spent, Estimated Streams, Federated Data, Media Downloaded Flag, Media Segment Views, Media Session ID, Media Session Server Timeout, Media Starts, Media Time Spent, Pause Events, Pause Impacted Streams, Pccr, Pev3, Total Pause Duration, Unique Time Played e Video Segment.

      • No campo List Of Media Collection Downloaded Content Events > Media Details, oculte o campo Media Session ID.

    6. Selecione Confirmar para salvar suas alterações.

    7. Na área Estrutura, selecione o campo Media Reporting Details e Gerenciar campos relacionados.

    8. Habilite a opção para Mostrar nomes para exibição para campos e atualize o esquema da seguinte maneira:

      • No campo Media Reporting Details, oculte os seguintes campos: Error Details, List Of States End, List of States Start e Media Session ID.

    9. Selecione Confirmar > Salvar para salvar as alterações.

  8. (Opcional) É possível adicionar metadados personalizados ao esquema. Isso permite incluir metadados adicionais definidos pelo usuário para necessidades ou contextos específicos. Para obter mais informações sobre metadados personalizados com a API do Media Edge, consulte Suporte a metadados personalizados.

    accordion
    Expanda para exibir instruções sobre como adicionar metadados personalizados ao esquema.

    1. Localize o nome do locatário da organização selecionando Informações da conta > Orgs atribuídas > ​ nome da organização ​ > locatário.

      Campos personalizados são recebidos por meio desse caminho. (Por exemplo, nome do locatário: _dcbl → caminho myCustomField: _dcbl.myCustomField.)

    2. Adicione um grupo de campos personalizado ao esquema de mídia definido.

      adicionar-metadados-personalizados

    3. Adicione campos personalizados que deseja rastrear ao grupo de campos.

      adicionar-metadados-personalizados

    4. Use o caminho gerado para o campo personalizado na carga da sua solicitação.

      adicionar-metadados-personalizados

  9. Continue com Criar um conjunto de dados no Adobe Experience Platform.

Criar um conjunto de dados na Adobe Experience Platform

  1. Certifique-se de configurar um esquema conforme descrito em Configurar o esquema no Adobe Experience Platform.

  2. No Adobe Experience Platform, comece a criar o conjunto de dados conforme descrito no guia da interface do usuário de conjuntos de dados.

    Ao selecionar um esquema para seu conjunto de dados, escolha o esquema criado anteriormente.

  3. Continuar com Configurar uma sequência de dados no Adobe Experience Platform.

Configurar um fluxo de dados no Adobe Experience Platform

  1. Certifique-se de ter criado um conjunto de dados conforme descrito em Criar um conjunto de dados no Adobe Experience Platform.

  2. Crie uma nova sequência de dados conforme descrito em Configurar uma sequência de dados.

    Ao criar o fluxo de dados, faça as seguintes seleções:

    • No campo Esquema de Evento, selecione o esquema criado em Configurar o esquema no Adobe Experience Platform. Selecione Salvar.

      note important
      IMPORTANT
      Não selecione Salvar e Adicionar Mapeamento, pois isso resultará em erros de mapeamento para o campo Carimbo de data/hora.

      Criar sequência de dados e selecionar esquema

    • Adicione um dos seguintes serviços ao fluxo de dados, dependendo se você usa o Adobe Analytics ou o Customer Journey Analytics:

      • Adobe Analytics (se estiver usando o Adobe Analytics)

        Se você estiver usando o Adobe Analytics, defina um conjunto de relatórios conforme descrito em Criar um conjunto de relatórios.

      • Adobe Experience Platform (se estiver usando o Customer Journey Analytics)

      Para obter informações sobre como adicionar um serviço a uma sequência de dados, consulte “Adicionar serviços a uma sequência de dados” em Configurar uma sequência de dados.

      Adicionar o serviço Adobe Analytics

    • Expanda Opções Avançadas e habilite a opção Media Analytics.

      Opção do Media Analytics

Escolha seu método de implementação

Com o esquema, o conjunto de dados e o fluxo de dados em vigor, implemente uma das seguintes bases de código para começar a enviar dados de mídia de transmissão para a Edge Network. Cada página aborda a configuração específica de mídia de transmissão; o código por evento e por variável está em Eventos e Variáveis.

Base de código
No código
Através de tags
Web
Web SDK
Extensão de tag do Web SDK
iOS
iOS
iOS (Marcas)
Android
Android
Android (Marcas)
Roku
Roku
—
API
API do Media Edge
—

Próxima etapa

Depois de começar a coletar dados, é possível configurar os relatórios:

Related Articles
recommendation-more-help
media-analytics-help