Show Menu
TOPICS×

Parâmetros da solicitação

Dados do Analytics

Chave da solicitação 
Obrigatório
Definir em...
 Descrição 
analytics.trackingServer
S
sessionStart
O URL do servidor do Adobe Analytics.
analytics.reportSuite
S
sessionStart
A ID que identifica os dados de relatórios do Analytics
analytics.enableSSL
N
sessionStart
Verdadeiro ou falso para habilitar o SSL
analytics.visitorId
N
sessionStart
A ID de visitante da Adobe é uma ID personalizada que você pode usar em vários aplicativos da Adobe. O
visitorId
do Heartbeat é igual ao
VID.
do Analytics

Dados do visitante

Chave da solicitação 
Obrigatório
Definir em...
 Descrição 
visitor.marketingCloudOrgId
S
sessionStart
A ID da organização da Experience Cloud identifica sua organização no sistema da Adobe Experience Cloud
visitor.marketingCloudUserId
N
sessionStart
Esta é a ID de usuário da Experience Cloud (ECID). Na maioria dos casos, essa é a ID que você deve usar para identificar um usuário. O
marketingCloudUserId
do Heartbeat é igual ao
MID
no Adobe Analytics. Embora não seja tecnicamente necessário, esse parâmetro é necessário para acessar a família de aplicativos da Experience Cloud.
visitor.aamLocationHint
N
sessionStart
Fornece os dados da borda do Adobe Audience Manager
appInstallationId
N
sessionStart
O appInstallationId identifica exclusivamente o aplicativo e o dispositivo

Dados de conteúdo

Chave da solicitação 
Obrigatório
Definir em...
 Descrição 
media.id
S
sessionStart
Identificador exclusivo para o conteúdo
media.name
N
sessionStart
Nome legível para o conteúdo
media.length
S
sessionStart
Duração do conteúdo (segundos)
media.contentType
S
sessionStart
Formato do fluxo (pode ser qualquer sequência de caracteres. Alguns valores recomendados são "Live", "VOD" ou "Linear")
media.playerName
S
sessionStart
O nome do reprodutor responsável pela renderização do conteúdo
media.channel
S
sessionStart
O canal de distribuição do conteúdo. Isso pode ser um nome de aplicativo móvel, de site ou da propriedade
media.resume
N
sessionStart
Indica se um usuário está ou não retomando uma sessão anterior (em vez de iniciar uma nova sessão)
media.sdkVersion
N
sessionStart
A versão de SDK usada pelo reprodutor

Metadados padrão de conteúdo

Chave da solicitação 
Obrigatório
Definir em...
 Descrição 
media.show
N
sessionStart
O nome do programa ou da série
media.season
N
sessionStart
O número da temporada do programa ou da série
media.episode
N
sessionStart
O número do episódio
media.assetId
N
sessionStart
O identificador exclusivo de conteúdo do ativo de vídeo, como o identificador de episódio da série de TV, o identificador de ativo do filme ou o identificador de evento em tempo real. Normalmente, essas IDs são derivadas de autoridades de metadados, como EIDR, TMS/Gracenote ou Rovi. Esses identificadores também podem ser de outros sistemas proprietários ou internos.
media.genre
N
sessionStart
O tipo de conteúdo conforme definido pelo produtor do conteúdo
media.firstAirDate
N
sessionStart
A data quando o conteúdo foi exibido na televisão pela primeira vez
media.firstDigitalDate
N
sessionStart
A data quando o conteúdo foi exibido em qualquer plataforma digital pela primeira vez
media.rating
N
sessionStart
A classificação conforme definido pelas Diretrizes de controle parental da TV
media.originator
N
sessionStart
O criador do conteúdo
media.network
N
sessionStart
O nome da rede/canal
media.showType
N
sessionStart
O tipo de conteúdo, expresso como um número inteiro entre 0 e 3:
  • 0 - Episódio completo
  • 1 - Visualização
  • 2 - Clipe
  • 3 - Outro
media.adLoad
N
sessionStart
O tipo de anúncio carregado
media.pass.mvpd
N
sessionStart
O MVPD fornecido pela autenticação da Adobe
media.pass.auth
N
sessionStart
Indica que o usuário foi autorizado pela autenticação da Adobe (só pode ser verdadeiro se estiver definido)
media.dayPart
N
sessionStart
A hora do dia em que o conteúdo foi transmitido
media.feed
N
sessionStart
O tipo de feed, por exemplo, "West-HD"

Dados de publicidade

Chave da solicitação 
Obrigatório
Definir em...
 Descrição 
media.ad.podFriendlyName
N
adBreakStart
O nome amigável do ad break
media.ad.podIndex
S
adBreakStart
O índice do pod de anúncios no vídeo
media.ad.podSecond
S
adBreakStart
O segundo em que o pod iniciou
media.ad.podPosition
S
adStart
O índice do anúncio dentro do ad break que começa em 1
media.ad.name
N
adStart
Nome amigável do anúncio
media.ad.id
S
adStart
O nome do anúncio
media.ad.length
S
adStart
A duração do anúncio de vídeo em segundos
media.ad.playerName
S
adStart
O nome do reprodutor responsável pela renderização do anúncio

Metadados de publicidade padrão

Chave da solicitação 
Obrigatório
Definir em...
 Descrição 
media.ad.advertiser
N
adStart
A empresa ou marca cujo produto aparece no anúncio
media.ad.campaignId
N
adStart
A ID da campanha publicitária
media.ad.creativeId
N
adStart
A ID de criação do anúncio
media.ad.siteId
N
adStart
A ID do site do anúncio
media.ad.creativeURL
N
adStart
O URL da arte do anúncio
media.ad.placementId
N
adStart
A ID de posicionamento do anúncio

Dados do capítulo

Chave da solicitação 
Obrigatório
Definir em...
 Descrição 
media.chapter.index
S
chapterStart
Identifica a posição do capítulo no conteúdo
media.chapter.offset
S
chapterStart
O segundo na reprodução em que o capítulo inicia
media.chapter.length
S
chapterStart
A duração do capítulo em segundos.
media.chapter.friendlyName
N
chapterStart
O nome amigável do capítulo

Dados de qualidade

Chave da solicitação 
Obrigatório
Definir em...
 Descrição 
media.qoe.bitrate
N
Qualquer
A taxa de bits do fluxo
media.qoe.droppedFrames
N
Qualquer
O número de quadros ignorados no fluxo
media.qoe.framesPerSecond
N
Qualquer
O número de quadros por segundo
media.qoe.timeToStart
N
Qualquer
O tempo (em milissegundos) passado entre quando o usuário aperta Reproduzir e o conteúdo é carregado e começa a reproduzir

Parâmetros da Lei de Privacidade do Consumidor da Califórnia (CCPA)

Chave da solicitação 
Obrigatório
Definir em...
 Descrição 
analytics.optOutServerSideForwarding
N
sessionStart
Definido como verdadeiro quando o usuário final optou por não ter os dados compartilhados entre o Adobe Analytics e outras soluções da Experience Cloud (por exemplo, Audience Manager)
analytics.optOutShare
N
sessionStart
Definido como verdadeiro quando o usuário final optou por não ter seus dados federados (por exemplo, para outros clientes do Adobe Analytics).

Detalhes adicionais

visitor.marketingCloudUserId

Passe a ID de usuário da Experience Cloud (também conhecida como
MID
ou
MCID
) na chamada de
sessionStart
, ao inclui-la no mapa
params
usando a seguinte chave:
visitor.marketingCloudUserId
. Esse é um recurso útil se você já estiver integrado a outros produtos da Experience Cloud e tiver obtido o MCID.
O Media Analytics (MA) é integrado à família de aplicativos da Experience Cloud (Adobe Analytics, Audience Manager, Target, etc.). Você precisa de uma Experience Cloud ID para acessar esses aplicativos.
A ECID é o que você deve usar para identificar os usuários na maioria dos cenários.

appInstallationId

  • Se você​
    não
    passar um
    appInstallationId
    valor -
    O back-end do MA não gerará mais um MCID, mas dependerá do Adobe Analytics para fazer isso. A recomendação da Adobe é enviar um MCID, se disponível, ou um
    appInstallationId
    (juntamente com o
    marketingCloudOrgId
    ainda obrigatório), para que a API da coleção de mídia gere o MCID e o envie em todas as chamadas.
  • Se você​
    passar
    o
    appInstallationId
    valor -
    O MCID
    pode ser
    gerado pelo back-end do MA, se você passar valores para os parâmetros
    appInstallationId
    e o
    marketingCloudOrgId
    (obrigatório). Se você passar
    appInstallationId
    , deverá manter o seu valor no lado do cliente. Ele deve ser exclusivo para o aplicativo em um dispositivo e ser mantido enquanto o aplicativo não for reinstalado.
O
appInstallationId
identifica exclusivamente o aplicativo
e o dispositivo
. Ele precisa ser exclusivo para cada aplicativo em cada dispositivo, ou seja, dois usuários usando a mesma versão do mesmo aplicativo em diferentes dispositivos devem enviar um
appInstallationId
diferente (exclusivo), separadamente.

visitor.marketingCloudOrgId

Além de ser necessário para a geração do MCID quando isso não for fornecido, esse parâmetro também será usado como o valor da ID do publicador (baseado na forma como ao Media Analytics realiza a correspondência de regras de federação. )

ID do usuário herdada do Analytics (aid) e IDs do usuário declaradas (customerIDs)

  • analytics.aid:
    o valor dessa chave deve ser uma sequência de caracteres que representa ID do usuário herdada do Analytics
  • visitor.customerIDs:
    o valor dessa chave deve ser um objeto com o seguinte formato:
    "<<insert your ID name here>>": { "id": " <<insert your id here>>", "authState": <<insert one of 0, 1, 2>> }
Observe que o valor
visitor.customerIDs
pode ter qualquer número de objetos no formato apresentado.

visitor.aamLocationHint

Este parâmetro indica qual a borda do Adobe Audience Manager (AAM) terá uma ocorrência quando o Adobe Analytics enviar os dados do cliente para o Audience Manager. Se você não passar esse parâmetro, a Adobe codificará permanentemente para 1. Isso é particularmente importante quando os usuários finais tendem a usar seus dispositivos em locais geograficamente distantes (por exemplo, Leste dos EUA, Oeste dos EUA, Europa, Ásia). Caso contrário, os dados do usuário serão espalhados por várias bordas do AAM.

media.resume

Se o aplicativo determinar que uma sessão foi encerrada e retomada posteriormente (por exemplo, o usuário saiu do vídeo, mas eventualmente voltou e o reprodutor retomou o vídeo do indicador de reprodução em que parou), você poderá enviar um parâmetro booleano
media.resume
opcional no recipiente de parâmetros da chamada
sessionStart
.