Show Menu
TÓPICOS×

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")
The Media Collection API includes two new events that have media.stateName as the required parameter:
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 de estado do player podem ser usadas para qualquer visualização de relatórios disponível na Analysis Workspace ou em um componente (segmento, métricas calculadas) assim que um conjunto de relatórios é ativado para o rastreamento de estado do player. As novas métricas poderiam ser ativadas no Console de administração 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 full screen para visualização dos dados 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 usando os eventos personalizados. Para obter informações adicionais sobre as propriedades de estado padrão, consulte a seção Lista Propriedades para identidades XDM na página Parâmetros de estado do player.