As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Com o recurso de rastreamento de anúncios MediaTailor do lado do cliente, você pode integrar dados detalhados de rastreamento de anúncios do lado do cliente ao seu ambiente de player. As seções a seguir abordam o esquema geral de acompanhamento de anúncios, bem como as propriedades e valores específicos que compõem o esquema.
Sumário
Schema
A tabela a seguir descreve o esquema de acompanhamento de anúncios MediaTailor do lado do cliente. Quando aplicável, a tabela mapeia o esquema para dados VAST.
Chave | Tipo de dados | Chaves infantis | Mapeamento do VAST 2.0/3.0 | Mapeamento a partir do VAST 4.0 | Descrição |
---|---|---|---|---|---|
Resposta JSON | |||||
- | Objeto | avails, nonLinearAvails | |||
/avails
|
Array |
||||
MediaTailor cria um objeto para cada disponibilidade (intervalo publicitário) dentro da janela do manifesto. | ads, Tipo de anúncio,,availID,duration, durationInSeconds startTimestartTimeInSeconds, DateTime | ||||
/ads
|
Array | ||||
MediaTailor cria um objeto para cada anúncio dentro do período de disponibilidade. | Objeto | adID, AdType,,adParameters,adVerifications,,companionAds,duration, ícones durationInSecondsextensions, MediaFile,,, DateTimestartTime, startTimeInSeconds adBreakTrackingEvents | |||
/adId
|
String |
|
|||
/adParameters
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/AdParameters
|
Sequência de parâmetros de anúncio do VAST VPAID que MediaTailor passa para o player |
||
/adVerifications
|
Array |
VAST/Ad/InLine/AdVerifications
|
Contém os recursos e os metadados necessários para executar o código de medição de terceiros a fim de verificar a reprodução criativa |
||
MediaTailor cria um objeto para cada elemento de verificação de anúncios. | Objeto | Recurso executável, fornecedor, parâmetros de verificação javaScriptResource | |||
/executableResource
|
Array |
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource
|
|||
MediaTailor cria um objeto para cada executableResource elemento. |
Objeto | apiFramework, AdType, uri, idioma | |||
/apiFramework
|
String |
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/@apiFramework
|
|||
/type
|
String | ||||
/uri
|
String |
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/#CDATA
|
|||
/language
|
String |
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/@language
|
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/@language
|
||
/javaScriptResource
|
Array |
VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource
|
|||
MediaTailor cria um objeto para cada javaScriptResource elemento. |
Objeto | apiFramework, BrowserOptional, uri | |||
/apiFramework
|
String |
VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource/@apiFramework
|
|||
/browserOptional
|
String |
VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource/@browserOptional
|
|||
/uri
|
String |
VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource/#CDATA
|
|||
/trackingEvents
|
Array |
||||
MediaTailor cria um objeto para cada tipo de evento de rastreamento de elemento de verificação de anúncios. | Objeto | evento, uri | |||
/event
|
String |
VAST/Ad/InLine/AdVerifications/Verification/TrackingEvents/Tracking/@event
|
|||
/uri
|
String |
VAST/Ad/InLine/AdVerifications/Verification/TrackingEvents/Tracking/#CDATA
|
|||
/vendor
|
String |
VAST/Ad/InLine/AdVerifications/Verification/@vendor
|
|||
/verificationParameters
|
String |
VAST/Ad/InLine/AdVerifications/Verification/VerificationParameters
|
|||
/companionAds
|
Array |
Os anúncios complementares, que acompanham a disponibilidade do anúncio, fornecem conteúdo como uma moldura ao redor do anúncio ou um banner para exibição próximo ao vídeo. |
|||
MediaTailor cria um objeto para cada elemento do anúncio complementar. | Objeto | adParameters,,altText,attributes,,companionClickThrough, companionClickTracking htmlResourcesequence, staticResource Rastreamento de eventos |
VAST/Ad/InLine/Creatives/Creative/CompanionAds
|
||
/adParameters
|
String | ||||
/altText
|
String | ||||
/attributes
|
Objeto |
adSlotId,apiFramework, Altura do ativo, Largura do ativo, Altura expandida, Largura expandida,, id, proporção px, Modo de renderização, height width | |||
/adSlotId
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@adSlotId
|
|||
/apiFramework
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@apiFramework
|
|||
/assetHeight
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@assetHeight
|
|||
/assetWidth
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@assetWidth
|
|||
/expandedHeight
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@expandedHeight
|
|||
/expandedWidth
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@expandedWidth
|
|||
/height
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@height
|
|||
/id
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@id |
|||
/pxratio
|
String |
||||
/renderingMode
|
String |
||||
/width
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@width |
|||
/companionClickThrough
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/CompanionClickThrough |
|||
/companionClickTracking
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/CompanionClickTracking |
|||
/htmlResource
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/HTMLResource |
|||
/iFrameResource
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/iFrameResource |
|||
/sequence
|
String |
||||
/staticResource
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/StaticResource |
|||
/trackingEvents
|
Array |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/TrackingEvents |
|||
MediaTailor cria um objeto para cada tipo de evento de rastreamento de elementos do anúncio complementar. |
|||||
/tracking
|
Objeto |
>evento, uri | |||
/event
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/TrackingEvents/Tracking/@event
|
|||
/uri
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/TrackingEvents/Tracking/#CDATA
|
|||
/duration
|
String |
Duração, no formato ISO 8601 segundos |
|||
/durationInSeconds
|
Número |
Duração, em formato de segundos |
|||
/extensions
|
Array |
Os servidores de anúncios podem usar extensões VAST personalizadas |
|||
MediaTailor cria um objeto para cada extensão secundária do |
VAST/Ad/InLine/Extensions
|
||||
/extension
|
Objeto | tipo, conteúdo |
VAST/Ad/InLine/Extensions/Extension
|
||
/type
|
String |
VAST/Ad/InLine/Extensions/Extension/@type
|
|||
/content
|
String | ||||
/icons
|
Array |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons
|
|||
MediaTailor cria um objeto para cada |
Objeto | attributes, DateTime,,, duration durationInSeconds, IconClickshtmlResource,,,, iconViewTracking iFrameResource staticResource startTime startTimeInSeconds |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon
|
||
/attributes
|
Objeto | apiFramework,,duration, offsetheight, programa, pxratio,, xPosition, width yPosition | |||
/apiFramework
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@apiFramework
|
|||
/duration
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@duration
|
|||
/height
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@height
|
|||
/offset
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@offset
|
|||
/program
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@program
|
|||
/pxratio
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@pxratio
|
|||
/width
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@width
|
|||
/xPosition
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@xPosition
|
|||
/yPosition
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@yPosition
|
|||
/dateTime
|
String | ||||
/duration
|
String | ||||
/durationInSeconds
|
Número | ||||
/htmlResource
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/HTMLResource
|
|||
/iconClicks
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks
|
|||
/iconClickThrough
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickThrough
|
|||
/iconClickTracking
|
Objeto | id |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickTracking
|
||
/id
|
String | ||||
/iconClickFallbackImages
|
Array |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages
|
|||
MediaTailor cria um objeto para cada nó de imagem alternativa com clique no ícone. |
|||||
/altText
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/AltText
|
|||
/height
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/@height
|
|||
/width
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/@width
|
|||
/staticResource
|
Objeto | CreativeType, tipo |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/StaticResource
|
||
/creativeType
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/StaticResource/@creativeType
|
|||
/uri
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/StaticResource/#CDATA
|
|||
/iconViewTracking
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconViewTracking
|
|||
/iFrameResource
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/iFrameResource
|
|||
/statidResource
|
Objeto | CreativeType, tipo |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/StaticResource
|
||
/creativeType
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/StaticResource/@type
|
|||
/uri
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/StaticResource/#CDATA
|
|||
/startTime
|
String | ||||
/startTimeInSeconds
|
Número | ||||
/mediaFiles
|
Objeto | adParameters,,duration, durationInSeconds,, mediaFilesList mezzaninestartTime, startTimeInSeconds Rastreamento de eventos |
Vídeo e outros recursos que o player precisa para a disponibilidade do anúncio |
||
/adParameters
|
String | ||||
/duration
|
String | ||||
/durationInSeconds
|
Número | ||||
/mediaFilesList
|
Array | ||||
MediaTailor cria um objeto para cada tipo de evento de rastreamento de elementos do anúncio complementar |
apiFramework, delivery, height, maintainAspectRatio, mediaFileUri, mediaType, scalable, width | ||||
/apiFramework
|
String | ||||
/delivery
|
String | ||||
/height
|
String | ||||
/maintainAspectRatio
|
String | ||||
/mediaFileUri
|
String | ||||
/mediaType
|
String | ||||
/scalable
|
String | ||||
/width
|
String | ||||
/mezzanine
|
String | ||||
/startTime
|
String | ||||
/startTimeInSeconds
|
String | ||||
/trackingEvents
|
Array | ||||
MediaTailor cria um objeto para cada evento de rastreamento para o criativo |
beaconUrls,duration, durationInSeconds, DateTime,,,eventId, eventType startTime startTimeInSeconds | ||||
/beaconUrls
|
Array | ||||
Uma lista separada por vírgulas de todo o rastreamento desse URLs evento |
|||||
/duration
|
String | ||||
/durationInSeconds
|
Número | ||||
/dateTime
|
String | ||||
/eventId
|
String | ||||
/eventType
|
String | ||||
/startTime
|
String | ||||
/startTimeInSeconds
|
Número | ||||
/startTime
|
String |
Posição da hora, no formato ISO 8601 segundos, em relação ao início da sessão de reprodução |
|||
/startTimeInSeconds
|
Número |
Posição da hora, em formato de segundos, em relação ao início da sessão de reprodução |
|||
/dateTime
|
String |
Data e hora do programa, no formato ISO 8601 segundos, para o início da disponibilidade do anúncio |
|||
/trackingEvents
|
Array |
Contém todos os dados do evento de rastreamento que foram recebidos na resposta do VAST, junto com informações de tempo |
|||
/adType
|
String | ||||
/availId
|
String | ||||
/dateTime
|
String | ||||
/duration
|
String | ||||
/durationInSeconds
|
Número | ||||
/startTime
|
String | ||||
/startTimeInSeconds
|
Número |
Propriedades
A tabela a seguir lista as propriedades da API de rastreamento do lado do cliente, suas definições, tipos de valor e exemplos.
Propriedade | Definição | Tipo de valor | Exemplo |
---|---|---|---|
adID
|
|
String | 10 |
adBreakTrackingEvents
|
Uma matriz que transporta eventos de rastreamento do VMAP da resposta VAST. Para obter mais informações, consulte a seção 2.3.3 da especificação VMAP 1.0 |
String |
[]
|
adMarkerDuration
|
A duração do aproveitamento observada no marcador do anúncio no manifesto. |
String |
30
|
adParameters
|
Uma sequência de parâmetros de anúncio, do VAST VPAID, que MediaTailor passa para o player. |
String | |
adProgramDateTime
|
|
String | |
ads
|
Uma matriz contendo os objetos do anúncio que compõem o item. Os anúncios são listados na ordem em que aparecem no manifesto. |
Array |
[]
|
adSystem
|
O nome do sistema que veicula o anúncio. ImportanteCertifique-se de fornecer um valor. Se você não fornecer um valor, podem surgir problemas. |
String |
myADS
|
adTitle
|
O título do anúncio. |
String |
ad1
|
adVerifications
|
Contém os recursos e os metadados necessários para executar o código de medição de terceiros a fim de verificar a reprodução criativa. Para obter mais informações sobre essa propriedade, consulte a seção 3.16 da especificação VAST 4.2 MediaTailor suporta |
Array |
[]
|
altText
|
O texto alternativo para a imagem de um anúncio complementar. Este texto permite que jogadores com suporte de áudio descritivo para deficientes visuais leiam uma descrição da imagem. |
String |
video sequence advertising sneakers
|
attributes
|
Inclui chaves definidas na especificação VAST para anúncios complementares, como |
Objeto |
{}
|
apiFramework
|
Defina como |
String |
VPAID
|
availID
|
|
String |
|
avails
|
Uma matriz contendo objetos ad-break, ou avails, que são apresentados na janela ativa do manifesto. Os itens são listados na ordem em que aparecem no manifesto. |
Array |
[]
|
beaconUrls
|
O URL para o qual MediaTailor envia o sinalizador de anúncios. |
String | |
bitrate
|
A taxa de bits do ativo de vídeo. Essa propriedade normalmente não é incluída em um ativo executável. |
String |
2048
|
companionAds
|
Uma ou mais especificações complementares de conteúdo publicitário, cada uma das quais especifica um arquivo de recurso a ser usado. Os anúncios complementares acompanham a disponibilidade do anúncio e fornecem conteúdo, como uma moldura ao redor do anúncio ou um banner, para exibição próximo ao vídeo. |
Array |
[]
|
companionClickThrough
|
Um URL para a página do anunciante que o media player abre quando o espectador clica no anúncio complementar. |
String |
https://aws.amazon.com/
|
companionClickTracking
|
O URL de rastreamento da |
String |
https://myads.com/beaconing/event=clicktracking
|
creativeId
|
O valor do |
String |
creative-1
|
creativeSequence
|
A sequência na qual um anúncio deve ser reproduzido, de acordo com o |
String |
1
|
dashAvailabilityStartTime
|
Para DASH ao vivo/dinâmico, o manifesto |
String |
2022-10-05T19:38:39.263Z
|
delivery
|
Indica se um |
String |
progressive
|
duration
|
Duração, no formato ISO 8601 segundos. A resposta inclui durações para toda a disponibilidade do anúncio e para cada anúncio e beacon, embora as durações dos beacons sejam sempre zero. |
Número |
15.015
|
eventId
|
|
String |
23
|
eventType
|
O tipo de farol. |
String |
impression
|
extensions
|
Extensões personalizadas do VAST que os servidores de anúncios usam. Para obter mais informações sobre extensões, consulte a seção 3.18 da especificação VAST 4.2 |
Array |
[]
|
height
|
A altura, em pixels, do ativo de vídeo. |
String |
360
|
hlsAnchorMediaSequenceNumber
|
O número da sequência de mídia da primeira/mais antiga sequência de mídia vista no manifesto de origem do HLS. |
String |
77
|
htmlResource
|
O HTML codificado em CDATA que é inserido diretamente na página HTML do provedor de streaming. |
String |
<![CDATA[<!doctype html><html><head><meta
name=\"viewport\" content=\"width=1,
initial-scale=1.0, minimum-scale=1.0,...]]>
|
iFrameResource
|
O URL de um arquivo de recurso HTML que o provedor de streaming carrega em um iframe. |
String | |
maintainAspectRatio
|
Indica se a proporção do vídeo deve ser mantida durante o dimensionamento. |
Booliano |
true
|
mediaFilesList
|
Especifica o vídeo e outros recursos de que o player precisa para que o anúncio seja disponibilizado. |
Array |
[]
|
mediaFileUri
|
URI que aponta para um ativo executável ou um ativo de vídeo. |
String |
https://myad.com/ad/ad134/vpaid.js
|
mediaType
|
O tipo MIME do ativo criativo ou complementar. |
String |
video/mp4
|
meta
|
|||
mezzanine
|
O URL do MP4 ativo mezanino, especificado se o anúncio VPAID incluir um. |
String |
https://gcdn.2mdn.net/videoplayback/id/itag/ck2/file/file.mp4
|
nextToken
|
O valor do token que aponta para a próxima página de resultados, quando esse valor existe. |
String |
UFQzOS44NzNTXzIwMjMtMDctMzFUMTY6NTA6MDYuMzUwNjI2ODQ1Wl8x
|
nonLinearAds
|
Array |
[]
|
|
nonLinearAdsList
|
Array |
[]
|
|
nonLinearAvails
|
Array | ||
scalable
|
Indica se o vídeo deve ser dimensionado para outras dimensões. |
Booliano |
true
|
sequence
|
O valor da sequência especificado para o criativo na resposta VAST. |
String |
1
|
skipOffset
|
O valor do tempo que identifica quando o jogador disponibiliza os controles de salto para o usuário. |
String |
00:00:05
|
startTime
|
A posição da hora, no formato ISO 8601 segundos, em relação ao início da sessão de reprodução. A resposta inclui horários de início de toda a disponibilidade de anúncios e de cada anúncio e beacon. |
String |
PT9.943S
|
startTimeInSeconds
|
A posição da hora, em formato de segundos, em relação ao início da sessão de reprodução. A resposta inclui horários de início de toda a disponibilidade de anúncios e de cada anúncio e beacon. |
Número |
9.943
|
staticResource
|
O URL de um arquivo criativo estático usado para o componente de anúncio. |
String |
https://very-interactive-ads.com/campaign1/file.json?c=1019113602
|
vastAdId
|
O valor do |
String |
ad1
|
width
|
A largura, em pixels, do ativo de vídeo. |
String |
640
|