Parâmetros de estado do player player-state-parameters

Este tópico apresenta uma lista de dados de estado do player que a Adobe coleta por meio de variáveis de solução.

Descrição dos dados da tabela:

  • Implementação: informações sobre valores e requisitos de implementação.

    • Chave - Variável, definida manualmente no aplicativo ou automaticamente pelo SDK do Adobe Media.
    • Obrigatório  - Indica se o parâmetro é necessário para o rastreamento básico de vídeo.
    • Tipo - Especifica o tipo da variável a ser definida, a string ou o número.
    • Enviado com - Indica quando os dados são enviados: Início da mídia é a chamada do Analytics enviada no início da mídia, Início do anúncio é a chamada do Analytics enviada no início do anúncio, e assim por diante; as chamadas de Fechamento são as chamadas compiladas do Analytics enviadas diretamente do servidor do heartbeat para o servidor da Analytics no final da sessão de mídia, ou no final do anúncio, do capítulo, etc. As chamadas de fechamento não estão disponíveis nas chamadas do pacote de rede.
    • Versão mín. do SDK - Indica qual versão do SDK você precisaria para acessar o parâmetro.
    • Valor de exemplo  - Fornece exemplo de uso comum de variável.
  • Parâmetros de rede: exibe os valores passados para os servidores do Adobe Analytics ou Heartbeat. Esta coluna mostra os nomes dos parâmetros que são vistos nas chamadas de rede geradas pelos SDKs do Adobe Media.

  • Relatórios: informações sobre como visualizar e analisar os dados do vídeo.

    • Disponível - Indica se os dados estão disponíveis no relatórios por padrão (Sim) ou se exigem configuração personalizada (Personalizado)
    • Variável reservada  - Indica se os dados são capturados como um evento, eVar, prop ou classificação em uma variável reservada.
    • Nome do relatório  - Nome do relatório do Adobe Analytics para a variável
    • Dados de contexto  - Nome dos dados de contexto do Adobe Analytics passados para o servidor de relatórios e usados nas regras de processamento.
    • Feed de dados  - Nome da coluna para variável encontrada nos feeds de dados da sequência de cliques ou transmissão ao vivo.
    • Audience Manager  - Nome da característica encontrada no Adobe Audience Manager.
IMPORTANT
Não altere os nomes de classificação de nenhuma variável listada abaixo descrita em Relatório/Variável reservada como “classificação”.
As classificações de mídia são definidas quando um conjunto de relatórios é ativado para rastreamento de mídia. Periodicamente, a Adobe adiciona novas propriedades e, quando isso ocorre, os clientes devem reativar seus conjuntos de relatórios para obter acesso às novas propriedades de mídia. Durante o processo de atualização, a Adobe determina se as classificações são ativadas verificando os nomes das variáveis. Se algum deles estiver faltando, a Adobe os adicionará novamente.

Propriedades do estado do player player-state-properties

Os recursos de rastreamento do estado do player podem ser conectados a um fluxo de áudio ou vídeo. As métricas padronizadas de rastreamento do estado do player são armazenadas como variáveis de solução. Os estados padrão são: tela cheia, mudo, legendas ocultas, picture in picture e em foco.

Propriedades da Tela cheia

Fluxos afetados pela Tela cheia

Implementação
Parâmetros de rede
Relatórios
  • Chave de SDK:
     Definida automaticamente
  • Chave de API:
     N/D
  • Obrigatório:
     Não
  • Tipo:
     número
  • Enviado com:
     Fechamento de mídia
  • Versão mín. do SDK:
     3.0
  • Exemplo de valor:
     TRUE
  • Descrição:
     A quantidade de fluxos afetados pela Tela cheia. Essa métrica é definida como 1 se pelo menos um Estado de tela cheia ocorrer durante a sessão de reprodução.
    Importante:
     Se este evento for definido, o único valor possível será TRUE. Se este evento não for definido, nenhum valor será enviado.
  • Adobe Analytics:
    a.media.states.fullscreen.set
  • Heartbeat:
     N/D
  • Disponível:
     Sim
  • Variável reservada:
     event
  • Nome do relatório:
     Fluxos afetados pela Tela cheia
  • Dados de contexto:
     a.media.states.fullscreen.set
  • Feed de dados:
     videostatefullscreen
  • Audience Manager:
     c_contextdata.a.media.states.fullscreen.set
  • Caminho do campo XDM:
    media.mediaTimed.primaryAssetViewDetails.
    fullScreen.playerStateSet
  • Caminho do campo XDM do relatório:
    mediaReporting.playerStateData.isSet

Contagens de Tela cheia

Implementação
Parâmetros de rede
Relatórios
  • Chave de SDK:
     Definida automaticamente
  • Chave de API:
     N/D
  • Obrigatório:
     Não
  • Tipo:
     número
  • Enviado com:
     Fechamento de mídia
  • Versão mín. do SDK:
     3.0
  • Exemplo de valor:
     TRUE
  • Descrição:
     O número de vezes que uma Tela cheia é exibida. Essa métrica é definida como 1 se pelo menos um Estado de tela cheia ocorrer durante a sessão de reprodução.
    Importante:
    Se esse evento estiver definido, a contagem será igual ao número de vezes que o vídeo foi exibido no estado Tela cheia. Se este evento não for definido, nenhum valor será enviado.
  • Adobe Analytics:
    a.media.states.fullscreen.count
  • Heartbeat:
     N/D
  • Disponível:
     Sim
  • Variável reservada:
     event
  • Nome do relatório:
     Contagem de Tela cheia
  • Dados de contexto:
    a.media.states.fullscreen.count
  • Feed de dados:
     videostatefullscreencount
  • Audience Manager:
    c_contextdata.media.states.fullscreen.count
  • Caminho do campo XDM:
    media.mediaTimed.primaryAssetViewDetails.
    fullScreen.playerStateCount
  • Caminho do campo XDM do relatório:
    mediaReporting.playerStateData.count

Duração total da Tela cheia

Implementação
Parâmetros de rede
Relatórios
  • Chave de SDK:
     Definida automaticamente
  • Chave de API:
     N/D
  • Obrigatório:
     Não
  • Tipo:
     número
  • Enviado com:
     Fechamento de mídia
  • Versão mín. do SDK:
     3.0
  • Exemplo de valor:
     TRUE
  • Descrição:
     A duração de tempo em que uma Tela cheia foi exibida. Essa métrica é definida como 1 se pelo menos um Estado de tela cheia ocorrer durante a sessão de reprodução.
    Importante:
    Se este evento estiver definido, o tempo será igual ao tempo em que o vídeo ficou no estado Tela cheia. Se este evento não for definido, nenhum valor será enviado.
  • Adobe Analytics:
    a.media.states.fullscreen.time
  • Heartbeat:
     N/D
  • Disponível:
     Sim
  • Variável reservada:
     event
  • Nome do relatório:
     Duração total da tela cheia
  • Dados de contexto:
    a.media.states.fullscreen.time
  • Feed de dados:
     videostatefullscreentime
  • Audience Manager:
    c_contextdata.media.states.fullscreen.time
  • Caminho do campo XDM:
    media.mediaTimed.primaryAssetViewDetails.
    fullScreen.playerStateTime
  • Caminho do campo XDM do relatório:
    mediaReporting.playerStateData.time

Propriedade das legendas ocultas

Fluxos afetados pelas Legendas ocultas

Implementação
Parâmetros de rede
Relatórios
  • Chave de SDK:
     Definida automaticamente
  • Chave de API:
     N/D
  • Obrigatório:
     Não
  • Tipo:
     número
  • Enviado com:
     Fechamento de mídia
  • Versão mín. do SDK:
     3.0
  • Exemplo de valor:
     TRUE
  • Descrição:
     A quantidade de fluxos afetados pelas Legendas ocultas. Essa métrica é definida como 1 se pelo menos um Estado de legendas ocultas ocorrer durante a sessão de reprodução.
    Importante:
     Se este evento for definido, o único valor possível será TRUE. Se este evento não for definido, nenhum valor será enviado.
  • Adobe Analytics:
    a.media.states.closedcaptioning.set
  • Heartbeat:
     N/D
  • Disponível:
     Sim
  • Variável reservada:
     event
  • Nome do relatório:
     Fluxos afetados pelas Legendas ocultas.
  • Dados de contexto:
     a.media.states.closedcaptioning.set
  • Feed de dados:
     videostateclosedcaptioning
  • Audience Manager:
    c_contextdata.a.media.states.
    closedcaptioning.set
  • Caminho do campo XDM:
    media.mediaTimed.primaryAssetViewDetails.
    closeCaption.playerStateSet
  • Caminho do campo XDM do relatório:
    mediaReporting.playerStateData.isSet

Contagens de Legendas ocultas

Implementação
Parâmetros de rede
Relatórios
  • Chave de SDK:
     Definida automaticamente
  • Chave de API:
     N/D
  • Obrigatório:
     Não
  • Tipo:
     número
  • Enviado com:
     Fechamento de mídia
  • Versão mín. do SDK:
     3.0
  • Exemplo de valor:
     TRUE
  • Descrição:
     O número de vezes que as legendas ocultas foram exibidas. Essa métrica é definida como 1 se pelo menos um Estado de legendas ocultas ocorrer durante a sessão de reprodução.
    Importante:
    Se esse evento estiver definido, a contagem será igual ao número de vezes que o vídeo foi exibido no estado de Legendas ocultas. Se este evento não for definido, nenhum valor será enviado.
  • Adobe Analytics:
    a.media.states.closedcaptioning.count
  • Heartbeat:
     N/D
  • Disponível:
     Sim
  • Variável reservada:
     event
  • Nome do relatório:
     Contagem de Legendas ocultas
  • Dados de contexto:
    a.media.states.closedcaptioning.count
  • Feed de dados:
     videostateclosedcaptioningcount
  • Audience Manager:
    c_contextdata.media.states.
    closedcaptioning.count
  • Caminho do campo XDM:
    media.mediaTimed.primaryAssetViewDetails.
    closeCaption.playerStateCount
  • Caminho do campo XDM do relatório:
    mediaReporting.playerStateData.count

Duração total das Legendas ocultas

Implementação
Parâmetros de rede
Relatórios
  • Chave de SDK:
     Definida automaticamente
  • Chave de API:
     N/D
  • Obrigatório:
     Não
  • Tipo:
     número
  • Enviado com:
     Fechamento de mídia
  • Versão mín. do SDK:
     3.0
  • Exemplo de valor:
     TRUE
  • Descrição:
     A duração de tempo em que as Legendas ocultas foram exibidas. Essa métrica é definida como 1 se pelo menos um Estado de tela cheia ocorrer durante a sessão de reprodução.
    Importante:
    Se esse evento estiver definido, o tempo será igual ao tempo em que o vídeo ficou no estado de Legendas ocultas. Se este evento não for definido, nenhum valor será enviado.
  • Adobe Analytics:
    a.media.states.closedcaptioning.time
  • Heartbeat:
     N/D
  • Disponível:
     Sim
  • Variável reservada:
     event
  • Nome do relatório:
     Duração total das Legendas ocultas
  • Dados de contexto:
    a.media.states.closedcaptioning.time
  • Feed de dados:
    videostateclosedcaptioningtime
  • Audience Manager:
    c_contextdata.media.states.
    closedcaptioning.time
  • Caminho do campo XDM:
    media.mediaTimed.primaryAssetViewDetails.
    closeCaption.playerStateTime
  • Caminho do campo XDM do relatório:
    mediaReporting.playerStateData.time

Propriedades da função Mudo

Fluxos afetados pela função Mudo

Implementação
Parâmetros de rede
Relatórios
  • Chave de SDK:
     Definida automaticamente
  • Chave de API:
     N/D
  • Obrigatório:
     Não
  • Tipo:
     número
  • Enviado com:
     Fechamento de mídia
  • Versão mín. do SDK:
     3.0
  • Exemplo de valor:
     TRUE
  • Descrição:
     A quantidade de fluxos afetados pela função Mudo. Essa métrica é definida como 1 se pelo menos um Estado da função Mudo ocorrer durante a sessão de reprodução.
    Importante:
     Se este evento for definido, o único valor possível será TRUE. Se este evento não for definido, nenhum valor será enviado.
  • Adobe Analytics:
    a.media.states.mute.set
  • Heartbeat:
     N/D
  • Disponível:
     Sim
  • Variável reservada:
     event
  • Nome do relatório:
     Fluxos afetados pela função Mudo
  • Dados de contexto:
     a.media.states.mute.set
  • Feed de dados:
     videostatemute
  • Audience Manager:
     c_contextdata.a.media.states.mute.set
  • Caminho do campo XDM:
    media.mediaTimed.primaryAssetViewDetails.
    mute.playerStateSet
  • < Caminho do campo XDM do relatório:
    mediaReporting.playerStateData.isSet

Contagens da função Mudo

Implementação
Parâmetros de rede
Relatórios
  • Chave de SDK:
     Definida automaticamente
  • Chave de API:
     N/D
  • Obrigatório:
     Não
  • Tipo:
     número
  • Enviado com:
     Fechamento de mídia
  • Versão mín. do SDK:
     3.0
  • Exemplo de valor:
     TRUE
  • Descrição:
     O número de vezes que a função Mudo foi exibida. Essa métrica é definida como 1 se pelo menos um Estado da função Mudo ocorrer durante a sessão de reprodução.
    Importante:
    Se esse evento estiver definido, a contagem será igual ao número de vezes que o vídeo foi colocado no estado Mudo. Se este evento não for definido, nenhum valor será enviado.
  • Adobe Analytics:
    a.media.states.mute.count
  • Heartbeat:
     N/D
  • Disponível:
     Sim
  • Variável reservada:
     event
  • Nome do relatório:
     Contagem da função Mudo
  • Dados de contexto:
    a.media.states.mute.count
  • Feed de dados:
     videostatemutecount
  • Audience Manager:
    c_contextdata.media.states.mute.count
  • Caminho do campo XDM:
    media.mediaTimed.primaryAssetViewDetails.mute.playerStateCount
  • Caminho do campo XDM do relatório:
    mediaReporting.playerStateData.count

Duração total da função Mudo

Implementação
Parâmetros de rede
Relatórios
  • Chave de SDK:
     Definida automaticamente
  • Chave de API:
     N/D
  • Obrigatório:
     Não
  • Tipo:
     número
  • Enviado com:
     Fechamento de mídia
  • Versão mín. do SDK:
     3.0
  • Exemplo de valor:
     TRUE
  • Descrição:
     A duração de tempo em que a função Mudo foi exibida. Essa métrica é definida como 1 se pelo menos um Estado da função Mudo ocorrer durante a sessão de reprodução.
    Importante:
    Se este evento estiver definido, o tempo será igual ao tempo em que o vídeo ficou no estado Mudo. Se este evento não for definido, nenhum valor será enviado.
  • Adobe Analytics:
    a.media.states.mute.time
  • Heartbeat:
     N/D
  • Disponível:
     Sim
  • Variável reservada:
     event
  • Nome do relatório:
     Duração total da função Mudo
  • Dados de contexto:
    a.media.states.mute.time
  • Feed de dados:
     videostatemutetime
  • Audience Manager:
    c_contextdata.media.states.mute.time
  • Caminho do campo XDM:
    media.mediaTimed.primaryAssetViewDetails.
    mute.playerStateTime
  • Caminho do campo XDM do relatório:
    mediaReporting.playerStateData.time

Propriedades do Picture in Picture

Fluxos afetados pelo Picture in Picture

Implementação
Parâmetros de rede
Relatórios
  • Chave de SDK:
     Definida automaticamente
  • Chave de API:
     N/D
  • Obrigatório:
     Não
  • Tipo:
     número
  • Enviado com:
     Fechamento de mídia
  • Versão mín. do SDK:
     3.0
  • Exemplo de valor:
     TRUE
  • Descrição:
     O número de fluxos afetados pelo Picture in Picture. Essa métrica é definida como 1 se pelo menos um Estado de Picture in Picture ocorrer durante a sessão de reprodução.
    Importante:
     Se este evento for definido, o único valor possível será TRUE. Se este evento não for definido, nenhum valor será enviado.
  • Adobe Analytics:
    a.media.states.pictureinpicture.set
  • Heartbeat:
     N/D
  • Disponível:
     Sim
  • Variável reservada:
     event
  • Nome do relatório:
     Fluxos afetados pelo Picture in Picture
  • Dados de contexto:
     a.media.states.pictureinpicture.set
  • Feed de dados:
     videostatepictureinpicture
  • Audience Manager:
    c_contextdata.a.media.states.
    pictureinpicture.set
  • Caminho do campo XDM:
    media.mediaTimed.primaryAssetViewDetails.
    pictureInPicture.playerStateSet
  • Caminho do campo XDM do relatório:
    mediaReporting.playerStateData.isSet

Contagens de Picture in Picture

Implementação
Parâmetros de rede
Relatórios
  • Chave de SDK:
     Definida automaticamente
  • Chave de API:
     N/D
  • Obrigatório:
     Não
  • Tipo:
     número
  • Enviado com:
     Fechamento de mídia
  • Versão mín. do SDK:
     3.0
  • Exemplo de valor:
     TRUE
  • Descrição:
     O número de vezes que o Picture in Picture foi exibido. Essa métrica é definida como 1 se pelo menos um Estado de Picture in Picture ocorrer durante a sessão de reprodução.
    Importante:
    Se este evento estiver definido, a contagem é igual ao número de vezes que o vídeo esteve no estado Picture in Picture. Se este evento não for definido, nenhum valor será enviado.
  • Adobe Analytics:
    a.media.states.pictureinpicture.count
  • Heartbeat:
     N/D
  • Disponível:
     Sim
  • Variável reservada:
     event
  • Nome do relatório:
     Contagem de Picture in Picture
  • Dados de contexto:
    a.media.states.pictureinpicture.count
  • Feed de dados:
     videostatepictureinpicturecount
  • Audience Manager:
    c_contextdata.media.states.
    pictureinpicture.count
  • Caminho do campo XDM:
    media.mediaTimed.primaryAssetViewDetails.
    pictureInPicture.playerStateCount
  • Caminho do campo XDM do relatório:
    mediaReporting.playerStateData.count

Duração total do Picture in Picture

Implementação
Parâmetros de rede
Relatórios
  • Chave de SDK:
     Definida automaticamente
  • Chave de API:
     N/D
  • Obrigatório:
     Não
  • Tipo:
     número
  • Enviado com:
     Fechamento de mídia
  • Versão mín. do SDK:
     3.0
  • Exemplo de valor:
     TRUE
  • Descrição:
     A duração de tempo em que o Picture in Picture foi exibido. Essa métrica é definida como 1 se pelo menos um Estado de Picture in Picture ocorrer durante a sessão de reprodução.
    Importante:
    Se este evento estiver definido, o tempo é igual à duração do vídeo no estado Picture in Picture. Se este evento não for definido, nenhum valor será enviado…
  • Adobe Analytics:
    a.media.states.pictureinpicture.time
  • Heartbeat:
     N/D
  • Disponível:
     Sim
  • Variável reservada:
     event
  • Nome do relatório:
     Duração total do Picture in Picture
  • Dados de contexto:
    a.media.states.pictureinpicture.time
  • Feed de dados:
     videostatepictureinpicturetime
  • Audience Manager:
    c_contextdata.media.states.
    pictureinpicture.time
  • Caminho do campo XDM:
    media.mediaTimed.primaryAssetViewDetails.
    pictureInPicture.playerStateTime
  • Caminho do campo XDM do relatório:
    mediaReporting.playerStateData.time

Propriedades da função Em foco

Fluxos afetados pela função Em foco

Implementação
Parâmetros de rede
Relatórios
  • Chave de SDK:
     Definida automaticamente
  • Chave de API:
     N/D
  • Obrigatório:
     Não
  • Tipo:
     número
  • Enviado com:
     Fechamento de mídia
  • Versão mín. do SDK:
     3.0
  • Exemplo de valor:
     TRUE
  • Descrição:
     A quantidade de fluxos afetados pela função Em foco. Essa métrica é definida como 1 se pelo menos um Estado da função Em foco ocorrer durante a sessão de reprodução.
    Importante:
     Se este evento for definido, o único valor possível será TRUE. Se este evento não for definido, nenhum valor será enviado.
  • Adobe Analytics:
    a.media.states.infocus.set
  • Heartbeat:
     N/D
  • Disponível:
     Sim
  • Variável reservada:
     event
  • Nome do relatório:
     Fluxos afetados pela função Em foco
  • Dados de contexto:
     a.media.states.infocus.set
  • Feed de dados:
     videostateinfocus
  • Audience Manager:
     c_contextdata.a.media.states.infocus.set
  • Caminho do campo XDM:
    media.mediaTimed.primaryAssetViewDetails.inFocus.playerStateSet
  • Caminho do campo XDM do relatório:
    mediaReporting.playerStateData.isSet

Contagens da função Em foco

Implementação
Parâmetros de rede
Relatórios
  • Chave de SDK:
     Definida automaticamente
  • Chave de API:
     N/D
  • Obrigatório:
     Não
  • Tipo:
     número
  • Enviado com:
     Fechamento de mídia
  • Versão mín. do SDK:
     3.0
  • Exemplo de valor:
     TRUE
  • Descrição:
     O número de vezes que a função Em foco foi exibida. Essa métrica é definida como 1 se pelo menos um Estado da função Em foco ocorrer durante a sessão de reprodução.
    Importante:
    Se esse evento estiver definido, a contagem será igual ao número de vezes que o vídeo foi exibido no estado Em foco. Se este evento não for definido, nenhum valor será enviado.
  • Adobe Analytics:
    a.media.states.infocus.count
  • Heartbeat:
     N/D
  • Disponível:
     Sim
  • Variável reservada:
     event
  • Nome do relatório:
     Contagem da função Em foco
  • Dados de contexto:
    a.media.states.infocus.count
  • Feed de dados:
     videostateinfocuscount
  • Audience Manager:
    c_contextdata.media.states.infocus.count
  • Caminho do campo XDM:
    media.mediaTimed.primaryAssetViewDetails.
    inFocus.playerStateCount
  • Caminho do campo XDM do relatório:
    mediaReporting.playerStateData.count

Duração total da função Em foco

Implementação
Parâmetros de rede
Relatórios
  • Chave de SDK:
     Definida automaticamente
  • Chave de API:
     N/D
  • Obrigatório:
     Não
  • Tipo:
     número
  • Enviado com:
     Fechamento de mídia
  • Versão mín. do SDK:
     3.0
  • Exemplo de valor:
     TRUE
  • Descrição:
     A duração de tempo em que a função Em foco foi exibida. Essa métrica é definida como 1 se pelo menos um Estado da função Em foco ocorrer durante a sessão de reprodução.
    Importante:
    Se esse evento estiver definido, o tempo será igual ao tempo em que o vídeo ficou no estado Em foco. Se este evento não for definido, nenhum valor será enviado.
  • Adobe Analytics:
    a.media.states.infocus.time
  • Heartbeat:
     N/D
  • Disponível:
     Sim
  • Variável reservada:
     event
  • Nome do relatório:
     Duração total da função Em foco
  • Dados de contexto:
    a.media.states.infocus.time
  • Feed de dados:
     videostateinfocustime
  • Audience Manager:
    c_contextdata.media.states.infocus.time
  • Caminho do campo XDM:
    media.mediaTimed.primaryAssetViewDetails.
    inFocus.playerStateTime
  • Caminho do campo XDM do relatório:
    mediaReporting.playerStateData.time

APIs relacionadas related_apis_section

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