Com o lançamento do suporte a anúncios em vídeo, os compradores podem comprar inventário de vídeo pelo Authorized Buyers. Este documento descreve os requisitos de integração para compras por meio de RTB usando o protocolo Authorized Buyers. Para obter informações sobre os protocolos disponíveis, consulte a Selecionar um protocolo do Guia de primeiros passos.
Os compradores podem comprar inventário de vídeo em vários canais, in-stream e intersticial atualmente. Consulte Anúncios intersticiais para mais detalhes.
Requisitos do comprador
Novos compradores de RTB devem desenvolver seus proponentes usando o buffer de protocolo mais recente e as informações descritas nas seções a seguir. Para fazer o download do protocolo, consulte a página de dados de referência dos lances em tempo real. Para informações sobre como desenvolver um bidder, consulte Processar a solicitação e Criar a resposta.
Macros com suporte
As macros a seguir são compatíveis com criativos de vídeo in-stream:
%%CACHEBUSTER%%
%%WINNING_PRICE%%
%%SITE%%
Macros de cliques (como CLICK_URL_ESC
) não são necessárias
porque o Authorized Buyers inclui os próprios rastreadores de cliques em um wrapper VAST.
Por isso, as macros de clique não são compatíveis com anúncios em vídeo in-stream.
Para mais informações sobre as macros compatíveis,
consulte Especificar macros.
em Criar a resposta.
Detalhes da frase de destaque
O protocolo de lances em tempo real usa uma mensagem de vídeo, definida no arquivo em tempo real-lances-proto.txt para identificar solicitações de vídeo. e fornecer informações adicionais específicas do vídeo sobre a solicitação.
A seguinte lista de campos na mensagem de vídeo aninhada também fornece descrições e exemplos detalhados:
description_url
-
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
EndCapSupport
-
Quando habilitado, o anúncio complementar pode ser selecionado
para ser renderizado como imagem final (cartão de informações) no slot de vídeo
depois que o anúncio
em vídeo termina de ser reproduzido.
END_CAP_NOT_ENABLED
O anúncio complementar não é processado como imagem final. END_CAP_OPTIONAL
O limite final será renderizado se a resposta tiver um banner complementar, mas ele não é necessário. END_CAP_FORBIDDEN
Uma resposta com um anúncio complementar é filtrada. END_CAP_REQUIRED
Uma resposta sem um anúncio complementar é filtrada. is_embedded_offsite
-
Se ele for definido como
true
, o vídeo é incorporado em páginas fora do domínio do editor. is_rewarded
-
Se definido como
true
, indica que o usuário recebe uma por assistir ao anúncio em vídeo. Os prêmios típicos podem ser ler artigo extra sem custo financeiro, ganhar uma vida extra em um jogo ou uma sessão patrocinada de música sem anúncios. max_ad_duration
-
A duração máxima permitida para o anúncio retornado em milissegundos. Quando definido como
0
, não há duração máxima. max_ads_in_pod
- É o número máximo de anúncios em um conjunto de vídeos do Authorized Buyers. Um valor diferente de zero indica que o espaço de anúncio atual é um conjunto de vídeos que podem exibir vários anúncios em vídeo. O número real de anúncios em vídeo mostrados pode ser menor ou igual a esse valor, mas não pode excedê-lo.
min_ad_duration
- A duração mínima em milissegundos do anúncio que você deve retornar. Se ele não estiver definido ou tiver um valor menor ou igual a zero, não há duração mínima.
Placement
-
Descreve onde o vídeo será reproduzido.
UNKNOWN_PLACEMENT
O canal é desconhecido ou indeterminado. INSTREAM
"In-stream" significa que o anúncio é reproduzido antes, durante ou depois de outros conteúdo em vídeo. É semelhante a um comercial de TV tradicional. O conteúdo de vídeo que o usuário está assistindo não é reproduzido enquanto que o anúncio está sendo reproduzido. INTERSTITIAL
Intersticial significa que o anúncio em vídeo é reproduzido para conteúdo que não é de vídeo (por exemplo, uma notícia ou videogame). O anúncio cobre todo ou quase todo o espaço na tela ocupado pelo conteúdo, e o usuário não pode continuar ao conteúdo até que o anúncio termine ou seja ignorado. IN_FEED
O formato de vídeo In-feed é um criativo de vídeo que mostra quando o usuário é rolar por um feed de conteúdo, normalmente um feed de app social, uma artigos de notícias etc. O vídeo é renderizado no feed principal e no fluxo de leitura e visão. O vídeo não é renderizado na lateral como de vídeo em banner. skippable_max_ad_duration
- A duração máxima do anúncio, em milissegundos. que deve ser retornado se o anúncio for pulável. Geralmente, esse valor é diferente da duração máxima permitidos para anúncios não puláveis. Se esse campo não estiver definido ou tiver um valor menor ou igual a zero, qualquer duração.
VideoPlaybackMethod
-
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
significa que o anúncio é reproduzido automaticamente com o som ligado. AUTO_PLAY_SOUND_OFF
significa que o anúncio é reproduzido automaticamente com o som desligado. CLICK_TO_PLAY
significa que o anúncio não é reproduzido até que seja clicado. video_ad_skippable
- É um valor de
SkippableBidRequestType
que contém um dos seguintes valores:ALLOW_SKIPPABLE
significa que anúncios puláveis e não puláveis são permitidos. REQUIRE_SKIPPABLE
significa que somente anúncios puláveis podem ser retornados. BLOCK_SKIPPABLE
significa que somente anúncios não puláveis podem ser retornados. Se esse campo não estiver definido, o padrão é permitir anúncios puláveis.
videoad_start_delay
-
O tempo em milissegundos desde o início do vídeo até o ponto em que o anúncio é exibido. 0 significa anúncio precedente e -1 significa anúncio final. Quaisquer outros valores positivos indicam o espaço no meio do vídeo.
O valor só será válido se esse parâmetro for definido. Quando não definido, a posição de exibição é desconhecida.
Esses indicadores não são exclusivos dos criativos de vídeo, mas são particularmente valiosos para os proponentes lerem:
advertising_id
- Este campo é um UUID de 16 bytes definido somente ao usar SSL.
É a versão não criptografada de
encrypted_advertising_id
. Para dispositivos iOS, ele contém o identificador para anunciantes (IDFA). Para dispositivos Android, ele contém o identificador Android (ADID). Para dispositivos de smart TV, contém os identificadores exclusivos. Por exemplo, RIDA do Roku. device_type
- Especifica o tipo do dispositivo.
UNKNOWN_DEVICE
é o valor padrão deste campo. HIGHEND_PHONE
inclui telefones celulares com recursos de vídeo. TABLET
inclui tablets. PERSONAL_COMPUTER
inclui computadores e laptops. CONNECTED_TV
inclui as duas smart TVs (ou seja, smart TVs) e dispositivos conectados (como Roku, Apple TV e assim por diante). GAME_CONSOLE
inclui dispositivos dedicados a jogos. brand
- Especifica a marca (como Nokia ou Samsung) do dispositivo. Este campo é opcional. ele não é especificado por padrão.
model
- Especifica o modelo exato (como N70 ou Galaxy) do dispositivo. Este campo é opcional. ele não é especificado por padrão.
screen_orientation
-
Especifica a orientação do dispositivo quando a solicitação de anúncio é enviada.
Os valores válidos são
LANDSCAPE
,PORTRAIT
, eUNKNOWN_ORIENTATION
. viewability
-
Fornece uma estimativa da probabilidade de que este espaço
ficará visível para o usuário final com base na frequência com que
que já estiveram visíveis. Definida como uma porcentagem
intervalo de [0, 100]. O valor padrão
-1
indica que os dados históricos de visibilidade não estão disponíveis. content_attributes.duration_seconds
-
Quantos segundos (por exemplo, 200) o vídeo foi reproduzido.
Isso é declarado na mensagem
ContentAttributes
. Definido como o valor especificado nos 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 indústria, fornecedores permitidos e informações do canal. Todos 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.
allowed_vendor_type
- O fornecedor permitido. Consulte a vendors.txt na documentação técnica para obter uma lista de IDs. Por exemplo, 309 = bloco de vídeo do Campaign Manager.
allowed_video_formats
-
Descreve as tecnologias de vídeo permitidas
para anúncios veiculados em resposta a essa solicitação.
A resposta deve indicar suporte para pelo menos um deles.
Os valores para esse campo repetido são provenientes da enumeração VideoFormat:
VIDEO_FLASH
Permite vídeos usando o formato de vídeo em Flash (FLV). VIDEO_HTML5
Permite vídeos usando o formato de vídeo HTML5. VPAID_FLASH
Permite vídeos usando a veiculação de anúncios no player de vídeo . VPAID_JS
Permite que os vídeos usem o Formato de vídeo JavaScript VPAID. companion_slot
-
Este campo representa uma mensagem CompanionSlot
que inclua os seguintes campos:
height
As alturas disponíveis para este espaço. width
As larguras disponíveis para este espaço. CreativeFormat
O formato do criativo representa os formatos possíveis para o criativo nesse espaço de complementar. url
-
O URL da página de exibição do vídeo ou o URL 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 proponente precisa retornar um URL de redirecionamento VAST
no campo video_url
.
A resposta de lance também deve conter
a declaração adequada para o anúncio em vídeo.
Veja abaixo o trecho de uma resposta de lance de vídeo adequada:
protocol_version: 1 ad { adslot { id: 1 max_cpm_micros: 50000000 } click_through_url: "http://google.com/" video_url: "http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/ B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml" }
Os campos importantes em uma resposta de lance de vídeo são os seguintes:
attribute
-
Todos os atributos dos anúncios que podem ser mostrados a partir desse snippet. Consulte a
comprador-declarable-creative-attributes.txt para a lista de IDs.
Verificamos se nenhum desses atributos está na lista
excluded_attribute
da solicitação de lance. Defina esse campo somente se um snippet HTML ou anúncio em vídeo for retornado. Por exemplo, definir esse campo como30
indica o anúncio exige suporte VPAID para ser renderizado. protocol
-
Descreve as versões do VAST compatíveis com um editor para solicitações de anúncios em vídeo.
permitindo anúncios VAST até a versão fornecida.
Contém uma matriz de protocolos de anúncios em vídeo compatíveis.
Isso corresponde ao comportamento no OpenRTB 2.4.
Os seguintes valores são possíveis:
VAST_2_0
,VAST_3_0
.VAST_2_0_WRAPPER
,VAST_3_0_WRAPPER
,VAST_4_0
eVAST_4_0_WRAPPER
. video_url
-
É 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
- Como os compradores podem incluir vídeos
- Indicadores recomendados do OpenRTB para todos os formatos de vídeo
- Indicadores recomendados de proto do Authorized Buyers para todos os formatos de vídeo
- Como os editores podem permitir/proibir vídeos
- Casos extremos
Pré-segmentação
Para receber inventário de vídeo, os compradores de RTB precisam ter um configuração de pré-segmentação para RTB que inclua inventário de vídeo.
Exemplos de respostas e solicitações de lance
Formatos de vídeo do AdX
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 na Web e em apps para dispositivos móveis, respectivamente.
Web
Criativo de vídeo | In-stream (todos) | In-feed/artigo | Anúncios nativos 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/artigo | Anúncios nativos no feed/artigo | Intersticial | No banner |
---|---|---|---|---|---|
VPAID + VAST |
|
|
|
|
|
VAST |
|||||
MRAID + JS |
|||||
JS personalizado |
|||||
Nativo + VAST |
Chave: | Formato/tecnologia não disponível | É o criativo de vídeo aceito nesta posição, sujeito a bloqueios do editor |
O criativo de vídeo não está disponível nesta posição |
---|
Indicadores recomendados do OpenRTB
As tabelas a seguir ilustram os indicadores recomendados pelo OpenRTB para todos os formatos de vídeo de computador e Web para dispositivos móveis e app 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 de vídeo) |
---|---|---|
In-stream (VPAID) |
Objeto VIDEO presente & |
|
In-stream (sem VPAID) |
Objeto VIDEO presente & |
|
Out-stream |
Objeto VIDEO presente
|
|
In-feed |
Objeto VIDEO presente & |
|
No artigo |
Objeto VIDEO presente & |
|
Nativo |
Objeto NATIVE presente e |
|
No banner |
O objeto de vídeo não está presente & |
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 & |
|
Out-stream |
Objeto VIDEO presente
|
|
In-feed |
Objeto VIDEO presente & |
|
No artigo |
Objeto VIDEO presente & |
|
Nativo |
Objeto NATIVE presente e |
|
Intersticial (VAST) |
Objeto VIDEO presente & |
|
Intersticial (sem VAST) |
Objeto VIDEO presente & |
Filtrado |
Em banner (MRAID) |
O objeto de vídeo não está presente & |
|
No banner (sem MRAID) |
O objeto de vídeo não está presente & |
Indicadores recomendados para protótipos do AdX
As tabelas a seguir ilustram os indicadores recomendados por protótipos do Authorized Buyers para todos os formatos de vídeo de Web para computadores e dispositivos móveis e app para dispositivos móveis.
Web para computadores e dispositivos móveis
Formato de vídeo | Indicadores recomendados relevantes para o vídeo | Indicadores relevantes para o vídeo relacionado |
---|---|---|
In-stream (VPAID) |
Mensagem de VÍDEO presente & |
|
In-stream (sem VPAID) |
Mensagem de VÍDEO presente & |
Allowed_video_formats = VIDEO_HTML5 & |
In-feed |
Mensagem de VÍDEO presente & |
Allowed_video_formats = VIDEO_HTML5 & |
No artigo |
Mensagem de VÍDEO presente & |
|
Nativo |
Mensagem NATIVE presente & |
|
No banner |
|
|
App para dispositivos móveis
As tabelas a seguir ilustram os indicadores recomendados pelo protocolo do AdX para todos os formatos de vídeo de Web para computadores e dispositivos móveis e app para dispositivos móveis.
Formato de vídeo | Detalhes da solicitação de lance relevante para vídeo | Indicadores relacionados relevantes para o vídeo |
---|---|---|
In-stream |
VIDEO mensagem presente |
|
In-feed |
Mensagem de VÍDEO presente & |
|
No artigo |
Mensagem de VÍDEO presente & |
|
Nativo |
Mensagem NATIVE presente & |
|
Intersticial |
Mensagem de VÍDEO presente & |
|
Em banner (MRAID) |
|
|
No banner (sem MRAID) |
|
|
Como os editores podem permitir/proibir a exibição de vídeos
As tabelas a seguir ilustram maneiras pelas quais os editores podem permitir/proibir vídeos em seus canais e como isso se manifesta na solicitação de lance para OpenRTB e Protocolo do AdX.
OpenRTB
Opção de editor | Formatos aplicáveis | Descrita na solicitação de lance como |
---|---|---|
Especificar um bloco de vídeo in-stream |
In-stream (todos) |
Objeto de vídeo presente & |
Ativar o VPAID |
In-stream na Web |
Objeto de vídeo presente & |
Aceitar o IBV |
No banner Intersticial |
|
Ative o out-stream (instruções) |
In-feed No artigo |
Objeto de vídeo presente & |
Ative o out-stream (instruções) |
Nativo |
Há um objeto nativo |
Bloquear intersticial em vídeo |
Aplicativo intersticial |
Objeto VIDEO ausente |
Protocolo do AdX
Opção de editor | Formatos aplicáveis | Descritas na solicitação de lance como (OBSERVAÇÃO: estes são TODOS os indicadores da opção de publicação na solicitação de lance: para indicadores recomendados, consulte a tabela abaixo) | Configuração padrão |
---|---|---|---|
Especificar um bloco de vídeo in-stream |
In-stream (todos) |
Mensagem de vídeo presente e |
N/A |
Ativar o VPAID |
In-stream na Web |
Mensagem de vídeo presente e
|
Desativado |
Aceitar o IBV |
No banner Intersticial |
|
Desativado |
Ative o out-stream (instruções) |
In-feed No artigo |
Mensagem de vídeo presente e |
Desativado |
Ative o out-stream (instruções) |
Nativo |
Mensagem NATIVE presente e
|
Desativado |
Bloquear intersticial em vídeo |
Aplicativo intersticial |
A mensagem de VIDEO não existe e |
Ativada |
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 AdX sempre aparecerá acima de qualquer fechamento personalizado, mesmo se o fechamento personalizado aparece abaixo após cinco segundos |
Glossário
Consulte Glossário de vídeos do Authorized Buyers.
Campos do AdX e OpenRTB nos formatos in-stream e out-stream
Protocolo do AdX
BidRequest.Video. | |||||
---|---|---|---|---|---|
Placement
|
|
||||
videoad_start_delay
|
|
Protocolo do OpenRTB
Consulte OpenRTB 2.5 (a partir da página 47)
BidRequest.Video. | |||||
---|---|---|---|---|---|
Placement
|
|
||||
linearity
|
Indica se a impressão deve ser linear, não linear etc. Se nenhum for especificado, presuma que todos são permitidos.
|
||||
videoad_start_delay
|
|
Origem do valor da solicitação de lance
OpenRTB Objeto | Campos | AdX /Troca Lances Out-stream |
Amostras de valores | Quem a determina? /Onde esse valor deriva de |
---|---|---|---|---|
Objeto | ||||
Vídeo | mímica | sim | ["application/javascript", "vídeo/mp4"]", |
|
minduration | não | Configurado pelo editor | ||
duração máxima | sim | Configurado pelo editor | ||
conjunto de reprodução de Hod |
sim | [6] | Geralmente o editor é Configurado |
|
API (MRAID) | sim | [1,2] | ||
protocolos | sim | [2,3,5,6,7,8] | ||
linearidade | sim | [1] | ||
posição | sim | [1] | ||
largura do player | sim | 400.400.300 | ||
altura do player | sim | 225.300.153 | ||
atraso no início | sim | 0 | Google, padrão 5s | |
pular | sim | 1 | Editor/Google - para intersticial => do Google - para In-stream => Editor decide se permite que puláveis, não puláveis ou ambos. Anúncios premiados, sempre não puláveis |
|
taxa de bits mínima | Não | |||
taxa de bits máxima | não | |||
pos | sim | 1 | ||
Dispositivo | ||||
Proporção Px | sim | 1 | ||
impressão | ||||
Seguro | sim | 1 | do Google o padrão é "true" . porque a tag de anúncio é sempre proteger |