Chave da solicitação | Obrigatório | Chave de tipo de solicitação | Definir em… | Descrição |
---|---|---|---|---|
analytics.trackingServer |
S | string | sessionStart |
O URL do servidor do Adobe Analytics. |
analytics.reportSuite |
S | string | sessionStart |
A ID que identifica os dados de relatórios do Analytics |
analytics.enableSSL |
N | booleano | sessionStart |
True ou false para habilitar o SSL |
analytics.visitorId |
N | string | 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 |
Chave da solicitação | Obrigatório | Chave de tipo de solicitação | Definir em… | Descrição |
---|---|---|---|---|
visitor.marketingCloudOrgId |
S | string | sessionStart |
A ID da organização da Experience Cloud identifica sua organização no sistema da Adobe Experience Cloud |
visitor.marketingCloudUserId |
N | string | 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 | inteiro | sessionStart |
Fornece dados de borda do Adobe Audience Manager. Se um valor não for inserido, ele será nulo. |
appInstallationId |
N | string | sessionStart |
O appInstallationId identifica exclusivamente o aplicativo e o dispositivo |
Chave da solicitação | Obrigatório | Chave de tipo de solicitação | Definir em… | Descrição |
---|---|---|---|---|
media.id |
S | string | sessionStart |
Identificador exclusivo para o conteúdo |
media.name |
N | string | sessionStart |
Nome legível para o conteúdo |
media.length |
S | number | sessionStart |
Duração do conteúdo (segundos) |
media.contentType |
S | string | sessionStart |
Formato do fluxo (pode ser qualquer sequência de caracteres. Alguns valores recomendados são "Live", "VOD" ou "Linear") |
media.playerName |
S | string | sessionStart |
O nome do reprodutor responsável pela renderização do conteúdo |
media.channel |
S | string | sessionStart |
O canal de distribuição do conteúdo. Pode ser um nome de aplicativo móvel ou um nome de site, nome de propriedade |
media.resume |
N | booleano | 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 | string | sessionStart |
A versão de SDK usada pelo reprodutor |
Chave da solicitação | Obrigatório | Chave de tipo de solicitação | Definir em… | Descrição |
---|---|---|---|---|
media.streamFormat |
N | string | sessionStart |
Formato do streaming; por exemplo, “HD” |
media.show |
N | string | sessionStart |
O nome do programa ou da série |
media.season |
N | string | sessionStart |
O número da temporada do programa ou da série |
media.episode |
N | string | sessionStart |
O número do episódio |
media.assetId |
N | string | sessionStart |
O identificador exclusivo para o conteúdo do material de vídeo, como o identificador de episódio da série de TV, identificador de material de filme ou identificador de evento ao vivo. 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 | string | sessionStart |
O tipo de conteúdo conforme definido pelo produtor do conteúdo |
media.firstAirDate |
N | string | sessionStart |
A data quando o conteúdo foi exibido na televisão pela primeira vez |
media.firstDigitalDate |
N | string | sessionStart |
A data quando o conteúdo foi exibido em qualquer plataforma digital pela primeira vez |
media.rating |
N | string | sessionStart |
A classificação conforme definido pelas Diretrizes de controle parental da TV |
media.originator |
N | string | sessionStart |
O criador do conteúdo |
media.network |
N | string | sessionStart |
O nome da rede/canal |
media.showType |
N | string | sessionStart |
O tipo de conteúdo, expresso como um número inteiro entre 0 e 3:
|
media.adLoad |
N | string | sessionStart |
O tipo de anúncio carregado |
media.pass.mvpd |
N | string | sessionStart |
O MVPD fornecido pela autenticação da Adobe |
media.pass.auth |
N | string | sessionStart |
Indica que o usuário foi autorizado pela autenticação da Adobe (só pode ser true se estiver definido) |
media.dayPart |
N | string | sessionStart |
A hora do dia em que o conteúdo foi transmitido |
media.feed |
N | string | sessionStart |
O tipo de feed, por exemplo, "West-HD" |
Chave da solicitação | Obrigatório | Chave de tipo de solicitação | Definir em… | Descrição |
---|---|---|---|---|
media.ad.podFriendlyName |
N | string | adBreakStart |
O nome amigável do ad break |
media.ad.podIndex |
S | inteiro | adBreakStart |
O índice do pod de anúncios no vídeo |
media.ad.podSecond |
S | number | adBreakStart |
O segundo em que o pod iniciou |
media.ad.podPosition |
S | inteiro | adStart |
O índice do anúncio dentro do ad break que começa em 1 |
media.ad.name |
N | string | adStart |
Nome amigável do anúncio |
media.ad.id |
S | string | adStart |
O nome do anúncio |
media.ad.length |
S | number | adStart |
A duração do anúncio de vídeo em segundos |
media.ad.playerName |
S | string | adStart |
O nome do reprodutor responsável pela renderização do anúncio |
Chave da solicitação | Obrigatório | Chave de tipo de solicitação | Definir em… | Descrição |
---|---|---|---|---|
media.ad.advertiser |
N | string | adStart |
A empresa ou marca cujo produto aparece no anúncio |
media.ad.campaignId |
N | string | adStart |
A ID da campanha publicitária |
media.ad.creativeId |
N | string | adStart |
A ID de criação do anúncio |
media.ad.siteId |
N | string | adStart |
A ID do site do anúncio |
media.ad.creativeURL |
N | string | adStart |
O URL da arte do anúncio |
media.ad.placementId |
N | string | adStart |
A ID de posicionamento do anúncio |
Chave da solicitação | Obrigatório | Chave de tipo de solicitação | Definir em… | Descrição |
---|---|---|---|---|
media.chapter.index |
S | inteiro | chapterStart |
Identifica a posição do capítulo no conteúdo |
media.chapter.offset |
S | number | chapterStart |
O segundo na reprodução em que o capítulo inicia |
media.chapter.length |
S | number | chapterStart |
A duração do capítulo em segundos. |
media.chapter.friendlyName |
N | string | chapterStart |
O nome amigável do capítulo |
Chave da solicitação | Obrigatório | Chave de tipo de solicitação | Definir em… | Descrição |
---|---|---|---|---|
media.qoe.bitrate |
N | inteiro | Qualquer | A taxa média de bits (em bps). A taxa média de bits é calculada como uma média ponderada de todos os valores de taxa de bits relacionados à duração da reprodução ocorridos durante a sessão de reprodução. |
media.qoe.droppedFrames |
N | inteiro | Qualquer | O número de quadros soltos na transmissão |
media.qoe.framesPerSecond |
N | inteiro | Qualquer | O número de quadros por segundo |
media.qoe.timeToStart |
N | inteiro | Qualquer | O tempo (em milissegundos) decorrido entre o momento em que o usuário aperta o play e o conteúdo é carregado e começa a ser reproduzido. |
Chave da solicitação | Obrigatório | Chave de tipo de solicitação | Definir em… | Descrição |
---|---|---|---|---|
analytics.optOutServerSideForwarding |
N | booleano | sessionStart |
Definido como true 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 | booleano | sessionStart |
Definido como true quando o usuário final optou por não ter seus dados federados (por exemplo, para outros clientes do Adobe Analytics). |
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.
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.
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.)
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.
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 um valor não for inserido, ele será nulo. Isso é particularmente importante quando os usuários finais tendem a usar seus dispositivos em locais geograficamente distantes (por exemplo, Leste dos EUA, Oeste de EUA, Europa, Ásia). Caso contrário, os dados do usuário serão distribuídos por várias bordas do AAM.
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
.