Implementação e relatórios

Durante uma sessão de reprodução, cada ocorrência de estado (início ao fim) deve ser rastreada individualmente. O SDK de mídia e a API da coleção de mídia fornecem novos métodos de rastreamento para esse recurso.

O SDK de mídia inclui dois novos métodos para rastreamento de estado personalizado:

trackStateStart("state_name")

trackStateClose("state_name")

A API da coleção de mídia inclui dois novos eventos que têm media.stateName como o parâmetro obrigatório:

stateStart e stateEnd

Implementação do SDK de mídia

Início do estado do player

// StateStart (ex: Mute is switched on)
var stateObject = ADB.Media.createStateObject(ADB.Media.PlayerState.Mute);
tracker.trackEvent(ADB.Media.Event.StateStart, stateObject);

Encerramento do estado do player

// StateEnd (ex: Mute is switched off)
tracker.trackEvent(ADB.Media.Event.StateEnd, stateObject);

Implementação da API da coleção de mídia

Início do estado do player

// StateStart (ex: Mute is switched on)
http(s)://<Analytics_Visitor_Namespace>.hb-api.omtrdc.net/api/v1/sessions/<SID>/events
{
  "eventType": "stateStart",
  "params": {
    "media.state.name": "mute"
  },
  "playerTime": {
    "playhead": 0,
    "ts": 1569999130627
  }
}

Encerramento do estado do player

// StateEnd (ex: Mute is switched off)
http(s)://<Analytics_Visitor_Namespace>.hb-api.omtrdc.net/api/v1/sessions/<SID>/events

{
  "eventType": "stateEnd",
  "params": {
    "media.state.name": "mute"
  },
  "playerTime": {
    "playhead": 600,
    "ts": 1569999730638
  }
}

Métricas de estado

As métricas fornecidas para cada estado individual são computadas e enviadas para o Adobe Analytics como parâmetros de dados de contexto e armazenadas para fins de relatórios. Três métricas estão disponíveis para cada estado:

  • a.media.states.[state.name].set = true — Definido como verdadeiro se o estado foi definido pelo menos uma vez para cada reprodução específica de um fluxo.
  • a.media.states.[state.name].count = 4 — Identifica o número de ocorrências de um estado durante cada reprodução individual de um fluxo
  • a.media.states.[state.name].time = 240 — Identifica a duração total do estado em segundos para cada reprodução individual de um fluxo

Relatórios

Todas as métricas do estado do player podem ser usadas para qualquer visualização de relatórios disponível no Analysis Workspace ou em um componente (segmento, métricas calculadas) assim que um conjunto de relatórios é ativado para o rastreamento do estado do player. As novas métricas podem ser ativadas no Admin Console para cada relatório individual usando a Configuração do relatórios de mídia (Editar configurações > Gerenciamento de mídia > Relatórios de mídia).

No Analytics Workspace, todas as novas propriedades estão localizadas no painel de métricas. Por exemplo, você pode pesquisar por full screen para visualizar os dados do estado de tela cheia no painel de métricas.

Importar métricas declaradas do player para a Adobe Experience Platform

Os dados armazenados no Analytics podem ser usados para qualquer finalidade e as métricas do estado do player podem ser importadas para a Adobe Experience Platform usando o XDM e usadas com o Customer Journey Analytics. As propriedades de estado padrão têm propriedades específicas, enquanto os estados personalizados são propriedades disponíveis por meio dos eventos personalizados. Para obter mais informações sobre as propriedades de estado padrão, consulte a seção Lista de propriedades para identidades XDM na página Parâmetros do estado do player.

Nesta página