Show Menu
TÓPICOS×

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. Pode ser um nome de aplicativo móvel ou um nome de site, nome de 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 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
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 - Clip
  • 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 da transmissão
media.qoe.droppedFrames
N
Qualquer
O número de quadros soltos na transmissão
media.qoe.framesPerSecond
N
Qualquer
O número de quadros por segundo
media.qoe.timeToStart
N
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.

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á 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 de EUA, Europa, Ásia). Caso contrário, os dados do usuário serão distribuídos 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 .