A implementação de uma solução de vídeo baseada em tags para a demanda do Ad Exchange sem o uso de um SDK do IMA é um recurso em versão Beta e talvez não esteja disponível na sua rede. Entre em contato com seu gerente de contas para mais informações.
Este artigo mostra uma lista de parâmetros obrigatórios e recomendados para tags de anúncios VAST usadas para veicular anúncios em implementações da Web.
Nesta página
- Parâmetros obrigatórios para a veiculação de anúncios
- Parâmetros necessários para a programática
- Parâmetros recomendados para a programática
Confira as listas para outros tipos de implementação ou os requisitos para URL em tags de anúncio VAST.
Parâmetros obrigatórios e recomendados para a Web
Parâmetros obrigatórios para a veiculação de anúncios
correlator (correlator)
Descrição
O parâmetro de correlator (correlator) aceita um valor variável compartilhado por diversas solicitações originadas da mesma visualização de página. Ele é usado para implementar exclusões competitivas, inclusive em ambientes sem cookies.
Exemplos de uso
correlator=4345645667
Requisitos e recomendações
Esse parâmetro é necessário para implementar a veiculação de anúncios na Web, em apps para dispositivos móveis, em smart TVs, em áudio e em mídia digital out of home.
Uso do SDK
- Se o SDK do IMA for usado, o valor de correlação será definido automaticamente. Se o player tentar definir esse valor, o SDK irá substituí-lo pelo próprio valor.
- Se o SDK do IMA não for usado, confirme se você o definiu como um valor verdadeiramente aleatório, positivo e inteiro que não seja reutilizado por várias visualizações de página.
description_url (URL da descrição)
Descrição
O parâmetro de URL da descrição (description_url) aceita um valor variável que descreva o vídeo exibido na página.
O URL de descrição deve ser sobre os vídeos que estão sendo reproduzidos em uma página específica de um app da Web, para dispositivos móveis ou smart TVs. Ele não pode ser o domínio de nível superior de todos os vídeos ou solicitações de anúncios. Por exemplo, se você tiver uma página https://www.sample.com/golf.html para mostrar vídeos sobre golfe, defina como o valor de description_url.
Exemplos de uso
O valor de description_url precisa ser codificado para URL em páginas da Web com vídeos e dispositivos OTT e smart TVs. No entanto, o valor description_url não precisa ser codificado para apps para dispositivos móveis.
Codificado para URL:
description_url=
https%3A%2F%2Fwww.sample.com%2Fgolf.html
Não codificado:
description_url=
https://www.sample.com/golf.html
Requisitos e recomendações
Esse parâmetro é necessário para implementar a veiculação de anúncios na Web e em apps para dispositivos móveis. Ele também é obrigatório se você usa o Ad Exchange ou o Google AdSense para alocação dinâmica.
Esse parâmetro é recomendado para a monetização programática.
Uso do SDK
Esse parâmetro não é definido automaticamente pelo SDK do IMA. Ele precisa ser inserido manualmente.
Consulte os guias do SDK do IMA para sua plataforma.
env (ambiente)
Descrição
O parâmetro de ambiente (env) aceita um valor constante que indica uma solicitação in-stream ou que a solicitação é especificamente de um player de vídeo.
Os valores possíveis são instream, que pode ser usado para anúncios em vídeo e áudio, ou vp, que só pode ser usado para anúncios em vídeo.
Exemplos de uso
Vídeo e/ou áudio:
env=instream
Somente vídeo:
env=vp
Requisitos e recomendações
Esse parâmetro é necessário para implementar a veiculação de anúncios na Web, em apps para dispositivos móveis, em smart TVs, em áudio e em mídia digital out of home.
Esse parâmetro é necessário para gerar relatórios precisos sobre o tipo de solicitação dividido por "Tag de vídeo".
gdfp_req (indicador de esquema)
Descrição
O parâmetro de indicador do esquema do Google Ad Manager (gdfp_req) aceita um valor constante que indica que a solicitação de anúncio é para o inventário do Google Ad Manager.
Exemplos de uso
gdfp_req=1
Requisitos e recomendações
Esse parâmetro é necessário para implementar a veiculação de anúncios na Web, em apps para dispositivos móveis, em smart TVs, em áudio e em mídia digital out of home.
iu (bloco de anúncios)
Descrição
O parâmetro de bloco de anúncios (iu) aceita um valor variável que precisa ser definido como o bloco de anúncios atual, no formato: /network_code/.../ad_unit.
Exemplos de uso
iu=/6062/videodemo
Requisitos e recomendações
Esse parâmetro é necessário para implementar a veiculação de anúncios na Web, em apps para dispositivos móveis, em smart TVs, em áudio e em mídia digital out of home.
output (saída)
Descrição
O parâmetro de formato de saída (output) aceita um valor constante que precisa ser definido como o formato de saída do anúncio.
Exemplos de uso
Use a versão padrão do VAST da sua rede:
output=vast
Use o VAST 4 (é possível definir versões específicas para tags específicas):
output=xml_vast4
Use a configuração padrão do VMAP da sua rede:
output=vmap
Use o VMAP 1:
output=xml_vmap1
Use o VMAP 1, retornando o VAST 4 (se você retornar o VAST no VMAP):
output=xml_vmap1_vast4
Requisitos e recomendações
Esse parâmetro é necessário para implementar a veiculação de anúncios na Web, em apps para dispositivos móveis, em smart TVs, em áudio e em mídia digital out of home. Ele gera o formato correto de resposta de veiculação de anúncios.
Uso do SDK
Caso seu player de vídeo use o SDK do IMA, o parâmetro de resposta da solicitação de anúncio em vídeo sempre será definido como output=xml_vast4. Isso não representa um risco de confiabilidade, porque o SDK é compatível com todas as versões do VAST que podem ser exibidas por qualquer servidor de anúncios de terceiros.
Versão do VAST para Authorized Buyers e Open Bidding
Se você quiser filtrar com base na versão do VAST para o Authorized Buyers e o Open Bidding, ative a configuração "Filtrar a versão do VAST exata" nas configurações de rede.
sz (tamanho)
Descrição
O parâmetro tamanho (sz) aceita valores variáveis que precisam ser definidos como o tamanho do principal espaço do anúncio em vídeo.
Tamanhos diferentes devem ser separados pelo caractere da barra vertical (|).
Não inclua "v" após o tamanho.
Exemplos de uso
Tamanho único:sz=400x300
Vários tamanhos:sz=300x250|400x300
Requisitos e recomendações
Esse parâmetro é necessário para implementar a veiculação de anúncios na Web, em apps para dispositivos móveis, em smart TVs e em mídia OOH digital.
Esse parâmetro é opcional caso apenas ad_type=audio seja solicitado.
unviewed_position_start (impressões atrasadas)
Descrição
O parâmetro impressões atrasadas (unviewed_position_start) aceita um valor constante para indicar impressões atrasadas do vídeo.
Exemplos de uso
unviewed_position_start=1
Requisitos e recomendações
Esse parâmetro é necessário para implementar a veiculação de anúncios na Web e em apps para dispositivos móveis quando há uma oportunidade de impressão atrasada.
url (URL)
Descrição
O parâmetro URL (url) aceita um valor variável que precisa ser definido como o URL completo de onde a solicitação é enviada. Esse valor é necessário para ajudar compradores a identificar e entender o contexto da origem da solicitação. Na medida do possível, esse valor deve ser dinamicamente preenchido na solicitação de anúncio.
- Na Web, é o URL da página que exibe o player de vídeo.
- Em outros ambientes, esse valor precisa ser definido como o URL que representa mais precisamente o inventário de vídeo ou áudio monetizado. Por exemplo, se o usuário está assistindo a um vídeo em um app para dispositivos móveis que também está disponível em um URL equivalente para computador.*
Observação: url é diferente de description_url porque url se refere ao local em que uma solicitação de anúncio foi feita, enquanto description_url é uma página rastreável na Web que descreve o conteúdo do vídeo.
O valor desse parâmetro precisa ser codificado.
Exemplos de uso
url=https%3A%2F%2Fwww.example.com%2Fvideo.html
* Para apps, se não for possível definir esse parâmetro como um valor de URL variável, é recomendável definir com o seguinte padrão: url=https%3A%2F%2F<app/bundleid>.example.com
Requisitos e recomendações
Esse parâmetro só é obrigatório para a monetização programática na Web, em apps para dispositivos móveis, em smart TVs, em áudio e em mídia digital out of home.
Uso do SDK
Se você usa o SDK do IMA, o valor do URL é definido automaticamente. Se o player definir esse valor, o SDK do IMA vai respeitar o valor definido.
Parâmetros necessários para a programática
ott_placement (posição OTT)
Descrição
O parâmetro de posição OTT (ott_placement) aceita um valor constante que indica uma solicitação para um tipo específico de posição.
Definições de posições para os exemplos abaixo:
- Pausa: formato out-stream que aparece como uma sobreposição na parte de cima do conteúdo em vídeo quando um usuário pausa a reprodução.
- Tela inicial: anúncio que aparece na tela inicial de um app OTT ou de dispositivo de smart TV. Isso inclui implementações de masthead, banner e bloco na tela inicial.
- Picture-in-picture: anúncio em vídeo in-stream reproduzido em um player de vídeo de anúncio separado ao lado do conteúdo em vídeo. Normalmente, é necessário reduzir o conteúdo de vídeo e carregar um segundo player de vídeo.
- Banner em L: anúncio de display in-stream que envolve reduzir o conteúdo de vídeo e criar um anúncio ao redor dele. Normalmente, entre outras opções, uma caixa de conteúdo do anúncio em forma de L.
- Sobreposição: qualquer formato de anúncio in-stream que apareça na parte de cima do conteúdo em vídeo, mas não ocupe a tela inteira. Pode ser um anúncio de display ou em vídeo.
Exemplos de uso
Formatos aceitos e os valores correspondentes:
Pausa:
ott_placement=1
Tela inicial:
ott_placement=2
Picture-in-picture:
ott_placement=3
Banner em L:
ott_placement=4
Sobreposição:
ott_placement=5
Personalizado/outro:
ott_placement=99
Requisitos e recomendações
Esse parâmetro é necessário apenas para a monetização programática na Web, em apps para dispositivos móveis e em smart TVs para publishers que monetizam posições não padrão em ambientes de streaming OTT.
plcmt (posição)
Descrição
O parâmetro de posição (plcmt) aceita um valor constante, que é usado para indicar se o inventário in-stream foi declarado como "In-stream" ou "Complementar", de acordo com a orientação nas especificações do IAB.
No caso de solicitações que não são in-stream, esse campo é preenchido automaticamente para compradores com base no formato de inventário declarado, que substitui qualquer declaração de conteúdo in-stream ou complementar.
Exemplos de uso
Solicitação in-stream:
plcmt=1
Solicitação de conteúdo complementar:
plcmt=2
Requisitos e recomendações
Esse parâmetro é obrigatório para a monetização programática na Web, em apps para dispositivos móveis, em smart TVs, em áudio e em mídia digital out of home.
vpa (reprodução automática do vídeo)
Descrição
O parâmetro reprodução de vídeo automática (vpa) aceita um valor constante que indica se o conteúdo do vídeo em um anúncio começa por reprodução automática ou por clique.
Os valores possíveis são click, se a página aguardar uma ação do usuário, ou auto, se o vídeo for reproduzido automaticamente. Esse parâmetro não muda o estado do player de vídeo. O comportamento de reprodução precisa ser processado diretamente pelo player.
Exemplos de uso
Reprodução automática:
vpa=auto
Clique para ver:
vpa=click
Este parâmetro deverá ser deixado indefinido se for desconhecido.
Requisitos e recomendações
Esse parâmetro é obrigatório para a monetização programática na Web, em apps para dispositivos móveis, em smart TVs e em áudio.
Esse parâmetro também é recomendado pelas diretrizes de avaliação de vídeo do Media Rating Council (MRC).
vpmute (reprodução do vídeo com som desativado)
Descrição
O parâmetro de reprodução de vídeo sem som (vpmute) aceita um valor constante que indica se a reprodução do anúncio começa enquanto o player de vídeo está sem som. Esse parâmetro não muda o estado do player de vídeo. O comportamento de reprodução precisa ser processado diretamente pelo player.
Exemplos de uso
A reprodução começa com o som desativado:
vpmute=1
A reprodução começa com o som ativado:
vpmute=0
Requisitos e recomendações
Esse parâmetro é obrigatório para a monetização programática na Web, em apps para dispositivos móveis, em Smart TVs, em áudio e em mídia digital out of home.
Esse parâmetro também é recomendado pelas diretrizes de avaliação de vídeo do Media Rating Council (MRC).
Parâmetros recomendados para a programática
aconp (áudio contínuo)
Descrição
O parâmetro de áudio contínuo (aconp) aceita um valor constante que indica se o player vai exibir conteúdo em áudio continuamente. Isso ajuda o Google Ad Manager a selecionar os anúncios mais adequados para a experiência do usuário.
Exemplos de uso
Áudio contínuo ativado:
aconp=2
Áudio contínuo desativado:
aconp=1
Se você não souber se o áudio é reproduzido continuamente, deixe esse parâmetro indefinido ou defina como aconp=0.
Requisitos e recomendações
Embora esse parâmetro não seja necessário para veicular anúncios em qualquer implementação específica, ele é recomendado para a monetização programática na Web, em apps para dispositivos móveis, em smart TVs, em áudio e em mídia digital out of home.
Esse parâmetro também é recomendado pelas diretrizes de avaliação de áudio do Media Rating Council (MRC).
dth (sugestão de tipo de dispositivo)
Descrição
O parâmetro de sugestão de tipo de dispositivo (dth) aceita um valor constante que ajuda a reduzir a classificação incorreta do dispositivo, especificamente em ambientes de smart TV e conversor.
A classificação incorreta do dispositivo pode resultar de erros involuntários do publisher ou do OEM da smart TV. Esse parâmetro é usado com outros indicadores para que o Google sinalize automaticamente as instâncias em que o inventário de smart TV pode ser reclassificado.
Exemplos de uso
Solicitações de:
- Telefone básico:
dth=1 - Smartphone:
dth=2 - Computador:
dth=3 - Tablet:
dth=4 - Smart TV:
dth=5 - Console de jogos:
dth=6 - Conversor:
dth=7
Requisitos e recomendações
Embora esse parâmetro não seja necessário para veicular anúncios em qualquer implementação específica, ele é recomendado para a monetização programática na Web, em apps para dispositivos móveis, em smart TVs, em áudio e em mídia digital out of home.
Uso do SDK
Esse parâmetro é recomendado para implementações de PAL e PAI (não SDK). Ele não é necessário para o SDK do IMA ou de DAI.
givn (valor de uso único de vídeo)
Descrição
Para integrações que usam a biblioteca de acesso programático (PAL), o parâmetro valor de uso único de vídeo aceita um valor de string variável.
O valor de uso único é seguro para URL. Não é necessário codificar com URL.
Observação: se você já forneceu um valor de uso único com o parâmetro paln legado, é recomendável migrar para o parâmetro givn e parar de enviar paln. Não inclua os dois parâmetros.
Exemplos de uso
Saiba mais sobre o valor transmitido para esse parâmetro nos guias de iniciação da PAL.
Requisitos e recomendações
Embora esse parâmetro não seja necessário para veicular anúncios em qualquer implementação específica, ele é recomendado para a monetização programática na Web, em apps para dispositivos móveis, em smart TVs, em áudio e em mídia digital out-of-home.
hl (idioma)
Descrição
O parâmetro de linguagem (hl) aceita um valor constante usado para solicitar anúncios em um idioma específico e para definir o idioma da seleção de anúncios e da renderização dos anúncios em vídeo na alocação dinâmica para vídeo no Ad Exchange ou no Google AdSense.
Exemplos de uso
Solicitar anúncios em italiano:
hl=it
O valor desse parâmetro pode ser qualquer código ISO 639-1 (duas letras) ou ISO 639-2 (três letras). Veja a lista de códigos válidos.
Se omitido, o valor padrão será qualquer idioma com segmentação de anúncios por idioma no Ad Exchange.
Requisitos e recomendações
Embora esse parâmetro não seja necessário para veicular anúncios em qualquer implementação específica, ele é recomendado para a monetização programática na Web, em apps para dispositivos móveis, em smart TVs, em áudio e em mídia digital out of home.
omid_p (nome do parceiro OMID)
Descrição
O parâmetro do nome do parceiro OMID (omid_p) aceita um valor variável, que indica o nome do parceiro que integra a medição de OMID e a versão do parceiro.
O parâmetro de APIs do SDK com suporte (sdk_apis) aceita valores variáveis, que podem ser uma lista única ou separada por vírgulas de APIs com suporte.
Esses parâmetros fazem parte de um conjunto usado para a visibilidade e a verificação de anúncios.
Exemplos de uso
Quando não estiver usando a PAL:
omid_p=examplepartnername/1.0.0.0&sdk_apis=7
Veja uma lista de possíveis valores de framework da API.
Ao usar a PAL:
request.omidPartnerName = 'examplepartnername'
request.omidPartnerVersion = '1.0.0.0'
Requisitos e recomendações
Embora esse parâmetro não seja necessário para veicular anúncios em qualquer implementação específica, ele é recomendado para a monetização programática na Web, em apps para dispositivos móveis, em smart TVs, em áudio e em mídia digital out-of-home.
Uso do SDK
- Esse parâmetro só é aplicável a publishers que querem impressões mensuráveis do Active View ao usar o SDK do Open Measurement (SDK do OM).
- Para indicar a compatibilidade com OMID ao usar a biblioteca de acesso programático (PAL), é preciso usar
omidPartnerNameeomidPartnerVersionpara definir o nome e a versão do parceiro. Quando não estiver usando a PAL ou o SDK do IMA, defina os parâmetrosomid_pesdk_apis. - Não use com o SDK do IMA, já que a configuração é feita automaticamente.
vconp (vídeo contínuo)
Descrição
O parâmetro reprodução contínua de vídeo (vconp) aceita um valor constante que indica se o player vai exibir conteúdo em vídeo continuamente, como uma transmissão de TV.
Exemplos de uso
Exibição contínua ATIVADA:
vconp=2
Exibição contínua DESATIVADA:
vconp=1
Este parâmetro deverá ser deixado indefinido se for desconhecido.
Requisitos e recomendações
Embora esse parâmetro não seja necessário para veicular anúncios em qualquer implementação específica, ele é recomendado para a monetização programática na Web, em apps para dispositivos móveis, em Smart TVs e em áudio.
Esse parâmetro também é recomendado pelas diretrizes de avaliação de vídeo do Media Rating Council (MRC).
vid_d (duração do vídeo)
Descrição
O parâmetro duração do vídeo (vid_d) aceita um valor variável que especifica a duração do conteúdo, em segundos.
- Os parâmetros
vid_deallcuessão usados para veicular anúncios intermediários sem processamento de conteúdo. - O uso de regras de anúncio é necessário para retornar anúncios intermediários. Se inserções com base em tempo são usadas nas suas regras (por exemplo, "A cada N segundos" ou "Em horários fixos"), então aquelas definidas na regra do anúncio são usadas, e as inserções transmitidas por
allcuessão ignoradas. Os anúncios intermediários exigem duração, então o parâmetrovid_dainda precisa ser transmitido.
Exemplos de uso
Duração do conteúdo do vídeo de 90.000 segundos (25 horas):
vid_d=90000
Requisitos e recomendações
Embora esse parâmetro não seja necessário para veicular anúncios em qualquer implementação específica, ele é recomendado para a monetização programática na Web, em apps para dispositivos móveis e em smart TV.
vpos (posição do vídeo)
Descrição
O parâmetro posição do vídeo (vpos) aceita um valor constante que indica se a solicitação de anúncio é enviada pelo anúncio precedente, intermediário ou final.
Exemplos de uso
Anúncio precedente:
vpos=preroll
Anúncio intermediário:
vpos=midroll
Anúncio final:
vpos=postroll
Requisitos e recomendações
Embora esse parâmetro não seja necessário para veicular anúncios em qualquer implementação específica, ele é recomendado para a monetização programática na Web, em apps para dispositivos móveis, em Smart TVs e em áudio.
Se as regras de anúncio forem usadas, esse parâmetro não será necessário, porque é adicionado automaticamente pelo servidor.
wta (Por que esse anúncio?)
Descrição
O parâmetro "Por que esse anúncio?" (wta) aceita um valor constante que indica a compatibilidade do player de vídeo com a renderização de selos de anúncio.
Exemplos de uso
Se o player precisar renderizar o ícone "Opções de anúncios" fornecido na resposta VAST, use:
wta=1(ou omita o parâmetrowtaou transmitawtasem definir um valor)As solicitações de áudio precisam usar
wta=1se o ícone "Opções de anúncios" fornecido na resposta VAST for renderizado em anúncios complementares ou exibido de outra forma ao usuário.
Se o player não renderizar o ícone "Opções de anúncios" fornecido na resposta VAST, use:
wta=0
Requisitos e recomendações
Embora esse parâmetro não seja necessário para veicular anúncios em qualquer tipo de implementação específica, ele é recomendado para a monetização programática na Web, em apps para dispositivos móveis, em smart TVs e em áudio.
Quando o parâmetro é usado:
- O tráfego com
&wta=0não se qualifica para alguns tipos de personalização da demanda do Google. - O tráfego com
&wta=0do EEE não se qualifica para criativos com selos de anúncio ativados em itens de linha de reserva e da programática garantida gerenciados pelo publisher.
Os anúncios precisam obedecer aos requisitos regulatórios aplicáveis para anúncios veiculados no Espaço Econômico Europeu (EEE). Isso inclui um mecanismo para os usuários denunciarem conteúdo ilegal. Os publishers precisam notificar o Google sobre denúncias de conteúdo ilegal usando o formulário Denunciar conteúdo no Google.
Uso do SDK
A funcionalidade dos selos de anúncio é aceita automaticamente com o SDK do IMA. Quando o SDK do IMA não é usado, os players de vídeo precisam implementar a compatibilidade deIcon e IconClickFallbackImage do VAST, conforme documentado no padrão VAST do IAB.