Anúncios em vídeo

Este guia descreve os requisitos de integração, a configuração e campos relevantes do protocolo OpenRTB que podem ser usados ao dar lances em vídeos inventário. O protocolo RTB do Google foi descontinuado e não será um foco neste guia. Para informações sobre anúncios em vídeo no protocolo RTB do Google, consulte o guia de RTB sobre anúncios em vídeo no Google.

O Google é compatível com anúncios em vídeo in-stream, nativos e intersticiais. Consulte os guias para formatos de anúncio nativo e intersticial para mais detalhes sobre esses formatos.

Requisitos do comprador

Protocolo RTB

Este guia geralmente se refere ao formato Protobuf, mas os nomes e os caminhos dos campos são equivalentes entre ele e o formato JSON, a menos que indicado de outra forma.

Você pode encontrar o proto do OpenRTB e as extensões do OpenRTB específicas do Google na página Protos e dados de referência. Para mais informações sobre o desenvolvimento de um bidder, consulte Processar a solicitação e Criar a resposta.

Revisão de criativo

O Google recomenda que você envie criativos para aprovação antes de fazer lances com eles. É possível usar as APIs de lances em tempo real Recurso de criativos para iniciar o processo de revisão.

Configuração de pré-segmentação

Para receber inventário de vídeo, sua conta do Authorized Buyers precisa crie um configuração de pré-segmentação que inclui inventário de vídeo.

Macros

É possível especificar macros no link do URL do vídeo ou no XML VAST especificado na BidResponse.seatbid.bid.adm: Além disso, se você especificar um também é possível inserir macros no documento XML do VAST vinculado. As seguintes macros são compatíveis com criativos de vídeo:

  • %%CACHEBUSTER%%
  • %%WINNING_PRICE%%
  • %%SITE%%

Macros de cliques como CLICK_URL_ESC não são compatíveis porque O Authorized Buyers inclui os próprios rastreadores de cliques em um wrapper VAST. Para mais informações sobre as macros compatíveis, consulte Especificar macros.

Detalhes da frase de destaque

É possível usar o campo BidRequest.imp.video do OpenRTB para identificar se uma solicitação de lance recebida é para inventário de vídeo in-stream ou intersticial e encontrar outras informações específicas sobre o vídeo na solicitação. Além disso, para o inventário de anúncios nativos, você pode usar BidRequest.imp.native.{request/request_native}.assets.video para informações semelhantes específicas do vídeo.

BidRequest.{app/site}.content.producer.domain

O URL, com os parâmetros removidos, da página que descreve o conteúdo do vídeo. O editor envia esse URL ao Google. Exemplo:

http://www.publisher.com/watchpagelink
banner.vcm
Se definido como true, o anúncio complementar pode ser escolhido para ser renderizado como imagem final (cartão de informações) no espaço do vídeo depois que o anúncio em vídeo termina a reprodução. Caso contrário, o anúncio complementar não será renderizado como uma imagem final.
BidRequest.imp.rwdd
Se definido como true, indica que o usuário recebe uma por assistir ao anúncio em vídeo. As recompensas típicas podem ser ler um artigo extra sem custo, receber uma vida extra em um jogo ou ter uma sessão de música sem anúncios patrocinada.
BidRequest.imp.video.maxduration

A duração máxima permitida em segundos do anúncio que você deve retornar. Quando não definido, não há duração máxima. Quando BidRequest.imp.video.skip é true, isto pode se comportam de maneira diferente. Consulte Duração máxima de vídeos puláveis. para mais detalhes.

BidRequest.imp.video.maxseq

É o número máximo de anúncios no conjunto de vídeos. Se ela for deixada sem definição, o espaço do anúncio não será de um conjunto de vídeos.

O número real de anúncios em vídeo exibidos pode ser menor ou igual a esse valor, mas não pode exceder esse valor.

BidRequest.imp.video.minduration
A duração mínima em segundos do anúncio que você precisa retornar. Quando desativado, não há duração mínima.
BidRequest.imp.video.plcmt
Descreve onde o vídeo será reproduzido.
PLCMT_UNKNOWN O canal é desconhecido ou não determinável.
PLCMT_INSTREAM Anúncios precedentes, intermediários e finais que são reproduzidos antes, durante ou após o streaming de vídeo que o consumidor solicitado. O vídeo in-stream precisa ser definido como "som ativado" por padrão, início do player de vídeo ou têm a intenção explícita do usuário de assistir ao conteúdo em vídeo. Embora possa haver outro conteúdo em torno do player, o conteúdo do vídeo precisa ser o foco da visita do usuário. Ele precisa continuar sendo o conteúdo principal da página e o único player de vídeo em exibição capaz de reproduzir áudio. Se o player for convertido em flutuante/fixo, as chamadas de anúncios subsequentes vão transmitir corretamente o tamanho atualizado do player.
PLCMT_ACCOMPANYING_CONTENT Anúncios precedentes, intermediários e finais que são reproduzidos antes, durante ou após o streaming de conteúdo de vídeo. O player de vídeo carrega e é reproduzido antes, entre ou depois de parágrafos de texto ou conteúdo gráfico e só começa a ser reproduzido quando entra na viewport. O conteúdo complementar só deve iniciar a reprodução ao entrar no janela de visualização. Ele pode ser convertido em um player flutuante/fixo ao rolar a tela. para fora da página.
PLCMT_INTERSTITIAL Anúncios em vídeo que são reproduzidos sem conteúdo de vídeo. Durante a reprodução, ele precisa ser o foco principal da página e ocupar a maior parte da janela de visualização e não podem ser roladas para fora da visualização. Isso pode estar em posições diferentes, como vídeos no app ou apresentações de slides.
PLCMT_NO_CONTENT_STANDALONE Anúncios em vídeo que são reproduzidos sem streaming de conteúdo de vídeo. Isso pode aparecer em canais como apresentações de slides, feeds nativos, no conteúdo ou fixas/flutuantes.
BidRequest.imp.video.playbackmethod
Descreve como reproduzir o anúncio em vídeo. O método de reprodução é determinado como de reprodução automática ou clique para reproduzir com base na melhor medição disponível.
AUTO_PLAY_SOUND_ON É iniciado no carregamento da página com o som ativado.
AUTO_PLAY_SOUND_OFF Inicia no carregamento da página com o som desligado.
CLICK_TO_PLAY Inicia com um clique com som ativado.
MOUSE_OVER É iniciado quando o usuário passa o mouse sobre o anúncio com o som ativado.
ENTER_SOUND_ON Inicia ao entrar na viewport com o som ativado.
ENTER_SOUND_OFF Inicia ao entrar na janela de visualização com o som desativado por padrão.
BidRequest.imp.video.skip
Se true, indica que o player permite que o vídeo ou que os anúncios puláveis sejam permitidos. Caso contrário, indica que os anúncios puláveis não são permitidos.
BidRequest.imp.video.startdelay

O valor 0 significa anúncio precedente, -1 significa anúncio intermediário e -2 significa anúncio final.

Qualquer outro valor positivo é o tempo em segundos a partir do início do vídeo até o ponto em que o anúncio é exibido.

Esses indicadores não são exclusivos dos criativos de vídeo, mas são particularmente valiosos para os proponentes lerem:

BidRequest.device.ifa
Este campo é um UUID de 36 caracteres definido apenas quando SSL e é sem hash. É a versão não criptografada de BidRequest.device.dpidm5. Para dispositivos iOS, ele contém o O identificador para anunciantes (IDFA) em todos os caracteres maiúsculos. Para dispositivos Android, ele contém o identificador do Android (ADID) em caracteres totalmente em minúsculas. Para dispositivos de TV conectada, ele contém os identificadores exclusivos (por exemplo, RIDA do Roku).
BidRequest.device.devicetype
Especifica o tipo de dispositivo.
MOBILE Um alias obsoleto para HIGHEND_PHONE ou TABLET.
PERSONAL_COMPUTER Inclui dispositivos de computador e laptop.
CONNECTED_TV inclui TVs conectadas (ou seja, smart TVs) e dispositivos conectados (como Roku, Apple TV etc.).
HIGHEND_PHONE Inclui telefones de última geração.
TABLET Inclui tablets.
CONNECTED_DEVICE Inclui dispositivos de jogos dedicados.
SET_TOP_BOX Inclui conversores.
OOH_DEVICE Inclui dispositivos de publicidade externa. por exemplo, mídias digitais outdoors.
BidRequest.device.make
Especifica a marca (como Nokia ou Samsung) do dispositivo.
BidRequest.device.model
Especifica o modelo exato (por exemplo, N70 ou Galaxy) do dispositivo, se disponível. Caso contrário, contém um modelo genérico, como "iphone" ou "ipad".
BidRequest.imp.metric
Quando Metric.type é definido como completion_rate, Metric.value será uma fração no intervalo [0,0, 1,0] que representa a taxa de conclusão histórica para anúncios em vídeo veiculados no anúncio espaço. O valor padrão de -1.0 indica que os dados históricos da taxa de conclusão não estão disponíveis.
BidRequest.imp.video.poddur
O tempo em segundos de todo o intervalo de anúncio, incluindo todos os slots que compõem o conjunto. É definido como o valor especificado no atributo metadados do vídeo fornecidos pelo editor do vídeo.

A solicitação de lance de vídeo também contém informações sobre o inventário, como a vertical, os fornecedores permitidos e as informações do canal. Tudo Outros campos existentes na solicitação de lance também se aplicam ao vídeo.

Os campos de largura e altura na mensagem AdSlot de uma solicitação de vídeo correspondem ao tamanho do player de anúncios em vídeo.

BidRequest.imp.ext.allowed_vendor_type
Os fornecedores permitidos. Consulte o arquivo vendors.txt na documentação técnica para conferir uma lista de IDs. Por exemplo, 309 = unidade de vídeo da DFA.
BidRequest.imp.video.mimes
Uma lista de permissões que descreve os tipos MIME de conteúdo aceitos para anúncios veiculados em resposta à solicitação de lance. Por exemplo, "video/mp4". A resposta do lance precisa indicar compatibilidade com pelo menos uma delas.
BidRequest.imp.video.protocols
Descreve as versões VAST com suporte de um editor para solicitações de anúncios em vídeo. Contém uma matriz de valores de tipo enumerado Protocol, incluindo: VAST_2_0, VAST_3_0, VAST_2_0_WRAPPER, VAST_3_0_WRAPPER, VAST_4_0, VAST_4_0_WRAPPER e muito mais.
BidRequest.imp.video.companionad
Esse campo inclui uma matriz de objetos Banner que representam anúncios complementares, se disponíveis.
BidRequest.site.page

O URL da página de exibição do vídeo ou da página em que o vídeo foi incorporado. Exemplo:

http://www.publisher.com/watchpagelink

Ao responder a uma solicitação de vídeo, o bidder precisa retornar um URL de redirecionamento VAST ou um XML VAST no campo BidResponse.seatbid.bid.adm. A resposta do lance também precisa conter a declaração adequada para o anúncio em vídeo. Confira a seguir um exemplo de resposta de lance de vídeo: 

id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
  bid {
    id: "99862J52T2r9f8n6hzY"
    impid: "1"
    price: 0.2873480215418293
    adid: "test_creative_id_958969"
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    cid: "80831705186"
    crid: "test_creative_id_958969"
    w: 480
    h: 854
  }
  seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"

Os campos importantes em uma resposta de lance de vídeo são os seguintes:

BidResponse.seatbid.bid.ext.attribute
Atributos dos anúncios que podem ser mostrados a partir desse snippet. Consulte a buyer-declarable-creative-attributes.txt para a lista de IDs. Verificamos se nenhum desses atributos corresponde aos que foram proibidos pelo editor na solicitação de lance. Por exemplo, definir se um dos campos inclui 30, isso seria indicam que o anúncio exige suporte VPAID para ser renderizado.
BidResponse.seatbid.bid.adm

Para anúncios em vídeo, é o URL de redirecionamento VAST do anúncio em vídeo. Por exemplo:

http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml

Ou pode ser um XML VAST bruto.

Exemplos de solicitações e respostas de lances

Formatos de vídeo

Como os compradores podem incluir vídeos

As tabelas a seguir ilustram maneiras pelas quais os compradores podem incluir vídeo em seus criativos e posições em que podem ser veiculados para Web e app para dispositivos móveis, respectivamente.

Web

Criativo de vídeo In-stream (todos) In-feed/article Nativo no feed/artigo Intersticial No banner

VPAID + VAST

 

VAST

 

MRAID + JS

 

 

 

 

 

JS personalizado

 

Nativo + VAST

 

App para dispositivos móveis

Criativo de vídeo In-stream (todos) In-feed/article Nativo no feed/artigo Intersticial No banner

VPAID + VAST

 

 

 

 

 

VAST

MRAID + JS

JS personalizado

Nativo + VAST

Chave: Formato/tecnologia não disponível

Criativo em vídeo aceito nesta posição, sujeito a bloqueios do editor

Criativo de vídeo não disponível nesta posição

Indicadores recomendados do OpenRTB

As tabelas a seguir ilustram os indicadores recomendados do OpenRTB para todos os formatos de vídeo em Web para computadores e dispositivos móveis e apps para dispositivos móveis.

Web para computadores e dispositivos móveis

Formato de vídeo Indicadores recomendados (somente indicadores relevantes de vídeo) Indicadores relacionados (somente indicadores relevantes para vídeos)

In-stream (VPAID)

Objeto VIDEO presente   &
video.placement = INSTREAM   &

In-stream (sem VPAID)

Objeto VIDEO presente   &
video.placement = INSTREAM    &
video.api = 1 VPAID 1.0 or 2:VPAID 2.0

Não in-stream

Objeto VIDEO presente

A posição video.linearity: linear
depende da posição
real, os valores são como abaixo
Video.startdelay = 0

In-feed

Objeto VIDEO presente   &
video.placement = IN-FEED

No artigo

Objeto VIDEO presente   &
video.placement = IN-ARTICLE

Nativo

Objeto NATIVE presente e

No banner

O objeto de vídeo não está presente &
banner.battr ≠ 6 Vídeo em banner (reprodução automática) &
banner.battr ≠ 7 Vídeo em banner (iniciado pelo usuário)

App para dispositivos móveis

Formato de vídeo Detalhes da solicitação de lance (somente o vídeo relevante)

In-stream

Objeto VIDEO presente   &
video.placement = INSTREAM    &

video.api = 1 VPAID 1.0 ou 2: VPAID 2.0

Não in-stream

Objeto VIDEO presente

A posição video.linearity: linear
depende da posição
real, os valores são como abaixo
Video.startdelay = 0

In-feed

Objeto VIDEO presente   &
video.placement = IN-FEED

No artigo

Objeto VIDEO presente   &
video.placement = IN-ARTICLE

Nativo

Objeto NATIVE presente e

Intersticial (VAST)

Objeto VIDEO presente   &
video.placement = INTERSTITIAL

Intersticial (sem VAST)

Objeto VIDEO presente   &
video.placement = INTERSTITIAL

Filtrado

Em banner (MRAID)

O objeto de vídeo não está presente &
banner.battr ≠ 6 Vídeo em banner (reprodução automática) e
banner.battr ≠ 7 Vídeo em banner (iniciado pelo usuário)

No banner

(sem MRAID)

O objeto de vídeo não está presente &
banner.battr ≠ 6 Vídeo em banner (reprodução automática) &
banner.battr ≠ 7 Vídeo em banner (iniciado pelo usuário)

Como os editores podem permitir/proibir a exibição de vídeos

A tabela a seguir ilustra como os editores podem permitir/proibir vídeos nas posições.

Opção de pub Formatos aplicáveis Descrita na solicitação de lance como

Especificar uma unidade de vídeo In-stream

In-stream (todos)

Objeto de vídeo presente &
video.placement = INSTREAM

Ativar o VPAID

In-stream na Web

Objeto de vídeo presente e
video.api = 1 (VPAID 1.0) ou 2 (VPAID 2.0)

Aceitar o IBV

No banner

Intersticial

banner.battr ≠ 6 Vídeo em banner (reprodução automática) e/ou 7 Vídeo em banner (iniciado pelo usuário)

Ativar (instruções)

In-feed

No artigo

Objeto de vídeo presente &
video.placement = IN-FEED ou IN-ARTICLE

Ativar os anúncios não in-stream (instruções)

Nativo

Objeto nativo presente

Intersticial em vídeo de bloqueio

Aplicativo intersticial

Objeto VIDEO ausente

Casos extremos

# Descrição do caso Comentários Solicitação de lance

1

Fechamento personalizado atrasado usando MRAID

Em intersticiais, fechar o anúncio pode enviar uma notificação ao Comprador usando MRAID, mesmo que não usem o fechamento personalizado.


O X aplicado do Authorized Buyers sempre aparecerá acima de fechamento personalizado, mesmo se o fechamento personalizado aparecer abaixo após cinco segundos

Glossário

Consulte Glossário de vídeos do Authorized Buyers.

Campos relevantes para formatos in-stream e não in-stream

Consulte OpenRTB 2.5 (a partir da página 47)

BidRequest.Video.
Placement
In-stream mWeb

1: In-stream
2: In-banner

mApp

1: In-stream
2: In-banner
Não in-stream mApp Interstitial

5: intersticial

Native

3: no artigo
4: in-feed

Rewarded

is_rewarded_inventory: booleano da extensão do OpenRTB
linearity

Indica se a impressão precisa ser linear, não linear etc. Se nenhuma for especificada, considere que todas são permitidas.

In-stream mWeb

1: LINEAR (in-stream)

mApp

1: LINEAR (in-stream)
Não in-stream mApp Interstitial

2: INTERSTITIAL

Native

3: IN_FEED
5: IN_ARTICLE
videoad_start_delay
In-stream mWeb

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

mApp

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL
Não in-stream Rewarded

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

Origem do valor da solicitação de lance

OpenRTB
Objeto		 Campos Authorized Buyers
/Troca
Lances
Não in-stream		 Amostras de valores Quem a determina?
/De onde vem esse valor
?
Objeto
Vídeo mimes sim ["application/javascript",
"video/mp4"]",		 Google
minduration não Editor configurado
duração máxima sim Configurado pelo editor
playbackmet
hod		 sim [6] Normalmente, o editor
Configurado
API (MRAID) sim [1,2] Google
protocolos sim [2,3,5,6,7,8] Google
linearidade sim [1] Google
posição sim [1] Google
largura do player sim 400.400.300 Google
altura do player sim 225.300.153 Google
início do atraso sim 0 Google, padrão 5s
pular sim 1
do editor/Google - para intersticiais =>
do Google - para in-stream =>
do editor decide se permite
pulável, não pulável ou ambos.
Anúncios premiados, sempre não puláveis
taxa de bits mínima Não Google
taxa de bits máxima não Google
pos sim 1 Google
Dispositivo
Px ratio sim 1 Google
impressão
Seguro sim 1 O Google
é padrão verdadeiro
porque a adtag é sempre
segura