DocumentaçãoAnalyticsGuia da Coleção de mídia de transmissão

Implementar o complemento de coleção de mídia de streaming usando o Edge Network

Last update: Wed Sep 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Usuário
  • Administrador
  • Desenvolvedor

A rede de borda da Adobe Experience Platform permite enviar dados destinados a vários produtos a um local centralizado. A Experience Edge encaminha as informações apropriadas para os produtos desejados. Esse conceito permite consolidar os esforços de implementação, especialmente abrangendo várias soluções de dados.

O gráfico a seguir ilustra como o Complemento de coleção de mídia de transmissão do Adobe pode ser implementado para usar o Experience Platform Edge para disponibilizar dados no Analysis Workspace, no Adobe Analytics ou no Customer Journey Analytics:

Fluxo de trabalho do CJA

Para obter uma visão geral de todas as opções de implementação, incluindo métodos de implementação que não usam o Experience Platform Edge, consulte Implementar o complemento Coleção de mídia de streaming.

Independentemente de você usar o Adobe Experience Platform Web SDK, o Adobe Experience Platform Mobile SDK, o Adobe Experience Platform Roku SDK ou a API para implementar o complemento de coleção de mídia de transmissão com o Experience Edge, primeiro é necessário concluir as seguintes seções:

Configurar o esquema no Adobe Experience Platform

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

Para criar e configurar um esquema:

  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, ao criar o esquema, escolha Evento de experiência ao escolher a classe base para o 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 novos grupos de campos ao esquema:

    • Adobe Analytics ExperienceEvent Template
    • Implementation Details
    • MediaAnalytics Interaction Details

    Depois de adicionar os grupos de campos, eles devem ser exibidos na seção Grupos de campos, da seguinte maneira:

    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 e a compreensão do schema, mas não é obrigatório. Esses campos se referem apenas àqueles no grupo de campos MediaAnalytics Interaction Details.

Expanda aqui 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, 25}, Unique Time Played e Video Segment.Total Pause Duration

  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, 25}, Total Pause Duration, Unique Time Played e Video Segment.Pev3

    • 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 selecione 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.

  1. (Opcional) É possível adicionar metadados personalizados ao esquema. Isso permite incluir metadados adicionais definidos pelo usuário que podem ser personalizados para necessidades ou contextos específicos. Essa flexibilidade é útil em cenários nos quais os esquemas existentes não abrangem os pontos de dados desejados. (Você também pode trabalhar com metadados personalizados com APIs do Media Edge. Para obter mais informações, consulte Criar metadados personalizados com APIs do Media Edge.)
Expanda aqui para visualizar 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.

    Esses campos personalizados serã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

  1. 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. Na 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 que você criou anteriormente, conforme descrito em Configurar o esquema na Adobe Experience Platform.

  3. Continuar com Configurar um fluxo de dados no Customer Journey Analytics.

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, certifique-se de fazer as seguintes seleções de configuração:

    • No campo Esquema de Evento, ao criar a sequência de dados, selecione o esquema criado em Configurar o esquema na Adobe Experience Platform. Selecione Salvar.

      note important
      IMPORTANT
      Não selecione Salvar e Adicionar Mapeamento porque 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ê estiver usando Adobe Analytics ou 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 a seção "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

  3. Agora você está pronto para implementar a API do Media Edge ou o SDK do Media Edge para começar a coletar dados de análise de mídia.

    Após coletar alguns dados, você pode Criar uma conexão no Customer Journey Analytics.

Criar uma conexão no Customer Journey Analytics

NOTE
O procedimento a seguir é necessário somente se estiver usando o Customer Journey Analytics.

  1. Certifique-se de ter criado uma sequência de dados conforme descrito em Configurar uma sequência de dados no Customer Journey Analytics.

  2. No Customer Journey Analytics, crie uma conexão conforme descrito em Criar uma conexão.

    Ao criar a conexão, as seguintes seleções de configuração são necessárias para implementar o Complemento de coleção de mídia de streaming:

    1. Selecione o conjunto de dados criado anteriormente, conforme descrito em Criar um conjunto de dados no Adobe Experience Platform.

    2. Verifique se a configuração Importar todos os novos dados está habilitada.

  3. Continue com Criar uma exibição de dados no Customer Journey Analytics.

Criar uma visualização de dados no Customer Journey Analytics

NOTE
O procedimento a seguir é necessário somente se estiver usando o Customer Journey Analytics.

  1. Certifique-se de que você criou uma conexão no Customer Journey Analytics conforme descrito em Criar uma conexão no Customer Journey Analytics.

  2. No Customer Jornada Analytics, crie uma visualização de dados conforme descrito em Criar ou editar uma visualização de dados.

    Ao criar a visualização de dados, as seguintes seleções de configuração são necessárias para implementar o complemento de coleção de mídia de streaming:

    1. No campo Conexão, selecione a conexão criada anteriormente, conforme descrito em Criar uma conexão no Customer Journey Analytics.

      Pode levar até 15 minutos para que a conexão criada esteja disponível para seleção.

    2. Na guia Componentes, na seção Campos de esquema, procure cada componente listado nas tabelas abaixo e arraste-o para o painel Métricas. Se houver vários campos com o mesmo nome, use o caminho XDM para garantir que seja o campo correto.

      Conteúdo principal - Métricas de conteúdo

      table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2
      Nome do componente Caminho XDM
      Inícios da mídia mediaReporting.sessionDetails.isViewed
      Visualizações do segmento de mídia mediaReporting.sessionDetails.hasSegmentView
      Início do conteúdo mediaReporting.sessionDetails.isPlayed
      Conclusões de conteúdo mediaReporting.sessionDetails.isCompleted
      Tempo gasto no conteúdo mediaReporting.sessionDetails.timePlayed
      Tempo gasto com a mídia mediaReporting.sessionDetails.totalTimePlayed
      Tempo de reprodução exclusivo mediaReporting.sessionDetails.uniqueTimePlayed
      Marcador de progresso 10% mediaReporting.sessionDetails.hasProgress10
      Público-alvo médio por minuto mediaReporting.sessionDetails.averageMinuteAudience

      Capítulo e anúncios - Capítulo e métricas de anúncios

      table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
      Nome do componente Caminho XDM
      Capítulo iniciado mediaReporting.chapterDetails.isStarted
      Capítulo concluído mediaReporting.chapterDetails.isCompleted
      Tempo de reprodução do capítulo mediaReporting.chapterDetails.timePlayed
      Anúncio iniciado mediaReporting.advertisingDetails.isStarted
      Anúncio concluído mediaReporting.advertisingDetails.isCompleted
      Hora de reprodução do anúncio mediaReporting.advertisingDetails.timePlayed

      QoE - métricas de QoE

      table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2
      Nome do componente Caminho XDM
      Hora de início mediaReporting.qoeDataDetails.timeToStart
      Quedas antes de começar mediaReporting.qoeDataDetails.isDroppedBeforeStart
      Fluxos afetados pelo buffer mediaReporting.qoeDataDetails.hasBufferImpactedStreams
      Fluxos afetados pela mudança na taxa de bits mediaReporting.qoeDataDetails.hasBitrateChangeImpactedStreams
      Alterações da taxa de bits mediaReporting.qoeDataDetails.bitrateChangeCount
      Taxa média de bits mediaReporting.qoeDataDetails.bitrateAverage
      Queda de quadros mediaReporting.qoeDataDetails.droppedFrames
      Erros mediaReporting.qoeDataDetails.errorCount
      Fluxos afetados por erros mediaReporting.qoeDataDetails.hasErrorImpactedStreams
      Fluxos afetados pela queda de quadros mediaReporting.qoeDataDetails.hasDroppedFrameImpactedStreams

      Estado do player - Métricas do estado do player

      table 0-row-2 1-row-2 2-row-2 3-row-2
      Nome do componente Caminho XDM
      Conjunto do estado do player mediaReporting.states.isSet
      Contagem do estado do player mediaReporting.states.count
      Tempo do estado do player mediaReporting.states.time

    3. Atualize os rótulos (no menu suspenso Rótulos de contexto) dos componentes na tabela a seguir. Procure e arraste para o painel quaisquer componentes que ainda não estejam no painel métricas.

      table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
      Nome do componente Rótulo do contexto
      Tempo limite do servidor de sessão de mídia Media: Seconds Since Last Call (Mídia: segundos desde a última chamada)
      Tempo gasto com a mídia Mídia: Tempo gasto com a mídia
      Duração total do buffer Media: Total Buffer Duration
      Hora de início Media: Time To Start
      Duração total da pausa Media: Duração Total Da Pausa

    4. Para adicionar detalhamentos ao projeto Customer Journey Analytics, adicione as seguintes dimensões ao painel Dimension:

      table 0-row-2 1-row-2 2-row-2
      Caminho XDM Nome do componente
      mediaReporting.states.name Nome do estado do player
      mediaReporting.sessionDetails.ID ID da sessão de mídia

      Além das dimensões nessa tabela, é possível adicionar outras dimensões que você deseja disponibilizar para filtrar dados por em projetos Customer Journey Analytics.

  3. Selecione Salvar e continuar > Salvar e concluir para salvar as alterações.

  4. Continue com Criar e configurar um projeto no Customer Journey Analytics.

Criar e configurar um projeto no Customer Journey Analytics

  1. Certifique-se de ter criado uma visualização de dados no Customer Journey Analytics, conforme descrito em Criar uma visualização de dados no Customer Journey Analytics.

  2. No Customer Journey Analytics, na guia Workspace, na área Projetos, selecione Criar projeto.

  3. Selecione Projeto em branco > Criar.

  4. No novo projeto, selecione a visualização de dados criada anteriormente.

    Ao criar painéis em seu projeto, você pode usar quaisquer componentes adicionados à sua visualização de dados, conforme descrito em Criar uma visualização de dados no Customer Journey Analytics.

    Os 4 painéis a seguir são exemplos de painéis que você pode criar:

    Painel Conteúdo principal

    Painel de capítulos e anúncios

    Painel de QoE

    Painel de estado do platter

  5. Selecione o ícone Painéis no painel à esquerda e arraste o painel Visualizadores simultâneos de mídia e o painel Tempo gasto com a reprodução da mídia.

    Os 2 painéis devem ter esta aparência:

    Painel de visualizadores simultâneos de mídia

    Painel Tempo gasto com a reprodução da mídia

  6. (Condicional) Se você adicionou metadados personalizados ao esquema, conforme descrito na Etapa 8 de Configurar o esquema no Adobe Experience Platform, será necessário definir a persistência para os campos personalizados, conforme descrito em Configurações do componente de Persistência no guia Customer Journey Analytics.

    Quando os dados chegarem no Customer Journey Analytics, a dimensão ID de usuário personalizada estará disponível.

    setup-custom-metadata

    note note
    NOTE
    Se você configurar o Adobe Analytics como um upstream para seu fluxo de dados, os metadados personalizados também estarão presentes em ContextData, com o nome definido no esquema (sem o prefixo do locatário, por exemplo, myCustomField). Isso permite usar todos os recursos do Adobe Analytics disponíveis para ContextData, como criação de uma regra de processamento.

  7. Compartilhe o projeto conforme descrito em Compartilhar projetos.

    note note
    NOTE
    Se os usuários com os quais você deseja compartilhar não estiverem disponíveis, verifique se eles têm acesso de usuário e administrador ao Customer Journey Analytics na Adobe Admin Console.

  8. Continue com Enviar dados para o Experience Platform Edge.

Enviar dados para o Experience Platform Edge

Dependendo do tipo de dados que você deseja enviar para o Experience Platform Edge, é possível usar qualquer um dos seguintes métodos:

Web: usar o SDK da Web do Adobe Experience Platform

Dispositivo móvel: usar o SDK móvel da Adobe Experience Platform

Use os seguintes recursos de documentação para concluir a implementação para o iOS e o Android:

Roku: SDK Roku do Adobe Experience Platform

API: Web e outros

No momento, a API é a única maneira compatível de enviar dados da Web para o Experience Platform Edge.

A API também está disponível se você quiser usar uma implementação personalizada das APIs do Edge.

Para obter mais informações sobre a API do Media Edge, consulte os seguintes recursos:

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb