Parâmetros de capítulo

Última atualização: 14 de julho de 2025
  • Tópicos:

Criado para:

  • Usuário
  • Administrador
  • Desenvolvedor

Este tópico apresenta uma lista de dados de capítulo e/ou segmento, incluindo valores de dados de contexto, 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.
IMPORTANTE
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.

Metadados de capítulo

Nome do capítulo

ImplementaçãoParâmetros de redeRelatórios
  • Chave de SDK:
    name
  • Chave da API:
    media.chapter.friendlyName
  • Obrigatório:
    Não
  • Tipo:
    sequência de caracteres
  • Enviado com:
    Fechamento do capítulo
  • Versão mín. do SDK: 1.3
  • Exemplo de valor:
     “The Big Bang Capítulo 2 – Dating”
  • Descrição:
    O nome do capítulo e/ou segmento.
  • Adobe Analytics:
    (a.media.chapter.
    friendlyName)
  • Heartbeat:
    (s:stream:chapter_name)
  • Disponível:
    Created by default…
  • Variável reservada:
    Classification
  • Nome do relatório:
    Chapter Name
  • Dados de contexto:
    (a.media.chapter.
    friendlyName)
  • Feed de dados:
    N/D
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    friendlyName)
  • Caminho do campo XDM: (obsoleto)
    media.mediaTimed.mediaChapter.
    chapterAssetReference._dc.title
  • Caminho do campo XDM da coleção:
    mediaCollection.chapterDetails.friendlyName
  • Caminho do campo XDM do relatório:
    mediaReporting.chapterDetails.friendlyName

Posição do capítulo

ImplementaçãoParâmetros de redeRelatórios
  • Chave de SDK:
    position
  • Chave da API:
    media.chapter.index
  • Obrigatório:
    SDK: Não; API: Sim.
  • Tipo:
    número
  • Enviado com:
    Fechamento do capítulo
  • Versão mín. do SDK: 1.3
  • Valor de exemplo:
     2
  • Descrição:
    A posição (índice, número inteiro) do capítulo dentro do conteúdo.
  • Adobe Analytics:
    (a.media.chapter.
    position)
  • Heartbeat:
    (l:stream:chapter_pos)
  • Disponível:
    Sim
  • Variável reservada:
    Classification
  • Nome do relatório:
    Chapter Position
  • Dados de contexto:
    (a.media.chapter.
    position)
  • Feed de dados:
    N/D
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    position)
  • Caminho do campo XDM: (obsoleto)
    media.mediaTimed.mediaChapter.
    chapterAssetViewDetails.index
  • Caminho do campo XDM da coleção:
    mediaCollection.chapterDetails.index
  • Caminho do campo XDM do relatório:
    mediaReporting.chapterDetails.index

Deslocamento do capítulo

ImplementaçãoParâmetros de redeRelatórios
  • Chave de SDK:
    startTime
  • Chave da API:
    media.chapter.offset
  • Obrigatório:
    SDK: Não; API: Sim.
  • Tipo:
    número
  • Enviado com:
    Fechamento do capítulo
  • Versão mín. do SDK: 1.3
  • Valor de exemplo:
     58
  • Descrição:
    O deslocamento do capítulo dentro do conteúdo (em segundos) desde o início.
  • Adobe Analytics:
    (a.media.chapter.
    offset)
  • Heartbeat:
    (l:stream:chapter_offset)
  • Disponível:
    Sim
  • Variável reservada:
    Classification
  • Nome do relatório:
    Chapter Offset
  • Dados de contexto:
    (a.media.chapter.
    offset)
  • Feed de dados:
    N/D
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    offset)
  • Caminho do campo XDM: (obsoleto)
    media.mediaTimed.mediaChapter.
    chapterAssetViewDetails.offset
  • Caminho do campo XDM da coleção:
    mediaCollection.chapterDetails.offset
  • Caminho do campo XDM do relatório:
    mediaReporting.chapterDetails.offset

Extensão do capítulo

ImplementaçãoParâmetros de redeRelatórios
  • Chave de SDK:
  • Chave da API:
    media.chapter.length
  • Obrigatório:
    SDK: Não; API: Sim.
  • Tipo:
    número
  • Enviado com:
    Fechamento do capítulo
  • Versão mín. do SDK: 1.3
  • Valor de exemplo:
     486
  • Descrição:
    O comprimento do capítulo, em segundos.
  • Adobe Analytics:
    (a.media.chapter.
    length)
  • Heartbeat:
    (l:stream:chapter_length))
  • Disponível:
    Sim
  • Variável reservada:
    Classification
  • Nome do relatório:
    Chapter Length
  • Dados de contexto:
    (a.media.chapter.
    length)
  • Feed de dados:
    N/D
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    length)
  • Caminho do campo XDM: (obsoleto)
    media.mediaTimed.mediaChapter.
    chapterAssetReference._xmpDM.duration
  • Caminho do campo XDM da coleção:
    mediaCollection.chapterDetails.length
  • Caminho do campo XDM do relatório:
    mediaReporting.chapterDetails.length

Capítulo

ImplementaçãoParâmetros de redeRelatórios
  • Chave de SDK:
    Definida automaticamente
  • Chave da API:
    N/D
  • Obrigatório:
    Não
  • Tipo:
    sequência de caracteres
  • Enviado com:
    Fechamento do capítulo
  • Versão mín. do SDK: 1.3
  • Valor de exemplo:
  • Descrição:
    A ID gerada automaticamente do capítulo.
  • Adobe Analytics:
    (a.media.chapter.
    name)
  • Heartbeat:
    (s:stream:chapter_id)
  • Disponível:
    Sim
  • Variável reservada:
    eVar
  • Expiração:
    No HIT
  • Nome do relatório:
    Chapter
  • Dados de contexto:
    (a.media.chapter.
    name)
  • Feed de dados:
    videochapter
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    name)
  • Caminho do campo XDM: (obsoleto)
    media.mediaTimed.mediaChapter.
    chapterAssetReference._id
  • Caminho do campo XDM do relatório:
    mediaReporting.chapterDetails.ID

Métricas de capítulo

Início do capítulo

ImplementaçãoParâmetros de redeRelatórios
  • Chave de SDK:
    Definida automaticamente
  • Chave da API:
    N/D
  • Obrigatório:
    Sim
  • Tipo:
    sequência de caracteres
  • Enviado com:
    Fechamento do capítulo
  • Versão mín. do SDK: 1.3
  • Exemplo de valor:
     TRUE
  • Descrição:
    O número de inícios de capítulo. 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.chapter.
    view)
  • Heartbeat:
    (s:event:
    type=chapter_start)
  • Disponível:
    Sim
  • Variável reservada:
    event
  • Nome do relatório:
    Chapter Starts
  • Dados de contexto:
    (a.media.chapter.
    view)
  • Feed de dados:
    videochapterstart
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    view)
  • Caminho do campo XDM: (obsoleto)
    media.mediaTimed.mediaChapter.
    impressões.value > 0 => "TRUE"
  • Caminho do campo XDM do relatório:
    mediaReporting.chapterDetails.isStarted

Capítulo concluído

ImplementaçãoParâmetros de redeRelatórios
  • Chave de SDK:
    Definida automaticamente
  • Chave da API:
    N/D
  • Obrigatório:
    Sim
  • Tipo:
    sequência de caracteres
  • Enviado com:
    Fechamento do capítulo
  • Versão mín. do SDK: 1.3
  • Exemplo de valor:
     TRUE
  • Descrição:
    O número de conclusões de capítulo. 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.chapter.
    complete)
  • Heartbeat:
    (s:event:
    type=chapter_complete)
  • Disponível:
    Sim
  • Variável reservada:
    event
  • Nome do relatório:
    Chapter Completes
  • Dados de contexto:
    (a.media.chapter.
    complete)
  • Feed de dados:
    videochaptercomplete
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    complete)
  • Caminho do campo XDM: (obsoleto)
    media.mediaTimed.mediaChapter.
    completes.value
  • Caminho do campo XDM do relatório:
    mediaReporting.chapterDetails.isCompleted

Tempo gasto com capítulo

ImplementaçãoParâmetros de redeRelatórios
  • Chave de SDK:
    Definida automaticamente
  • Chave da API:
    N/D
  • Obrigatório:
    Sim
  • Tipo:
    número
  • Enviado com:
    Fechamento do capítulo
  • Versão mín. do SDK: 1.3
  • Valor de exemplo:
  • Descrição:
    O tempo gasto com capítulo. O valor será exibido no formato de hora (HH:MM:SS) no Analysis Workspace. Nos Feeds de dados, Data Warehouse e APIs de relatórios, os valores serão exibidos em segundos.
  • Adobe Analytics:
    (a.media.chapter.
    timePlayed)
  • Heartbeat:
  • Disponível:
    Sim
  • Variável reservada:
    event
  • Nome do relatório:
    Tempo gasto com capítulo
  • Dados de contexto:
    (a.media.chapter.
    timePlayed)
  • Feed de dados:
    videochaptertime
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    timePlayed)
  • Caminho do campo XDM: (obsoleto)
    media.mediaTimed.mediaChapter.
    timePlayed.value
  • Caminho do campo XDM do relatório:
    mediaReporting.chapterDetails.timePlayed