Use esta referência para encontrar detalhes técnicos, requisitos e exemplos de implementação de todos os parâmetros de tag de anúncio VAST compatíveis. Este guia ajuda você a configurar com precisão suas tags para ambientes da web, apps para dispositivos móveis e smart TVs.
Navegue rapidamente até qualquer parâmetro VASTNesta página:
- Parâmetros de veiculação de anúncios
- Parâmetros programáticos
- Parâmetros programáticos recomendados
- Outros parâmetros
false/true, recomendamos 0/1 para parâmetros booleanos (por exemplo, vpmute, wta, ad_rule, gdpr e assim por diante).Importante: os URLs de tag de anúncio para streaming de vídeo ao vivo podem incluir /live no caminho para veiculação de anúncios e monetização programática na Web, em apps para dispositivos móveis, smart TVs (CTV) e ambientes de áudio (exceto mídia digital out of home / DOOH).
É altamente recomendável classificar seu inventário dessa forma porque /live é um componente de caminho de URL e não um parâmetro de consulta. Por isso, ele precisa ser integrado diretamente à estrutura do caminho, em vez de ser anexado como um parâmetro padrão delimitado por um E comercial (&). Essa configuração foi criada para ajudar os sistemas a lidar com picos de tráfego em que todos os intervalos de anúncio são veiculados simultaneamente.
Adicionar /live é especificamente para eventos ao vivo de alta simultaneidade, e não para lives gerais em ambientes de produção.
Como é um elemento de caminho e não um parâmetro de consulta, ele não é configurado nem listado nas tabelas de parâmetros abaixo.
Lista de parâmetros por tipo de implementação
Se você usar uma implementação específica, poderá utilizar listas de parâmetros personalizados que descrevem o uso e os requisitos dessa implementação. Use a lista de parâmetros personalizados para os seguintes casos:
Web App para dispositivos móveis Smart TV Áudio Mídia digital out of home
Todos os parâmetros
Parâmetros de veiculação de anúncios
Em geral, esses parâmetros são obrigatórios para a veiculação do anúncio na maioria das implementações. No entanto, há casos em que eles não são necessários. Para uma lista mais precisa, use a lista de parâmetros do seu tipo específico de implementação.
correlator (correlação)
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 de 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 do 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 espaço do anúncio em vídeo principal.
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.
Parâmetros programáticos
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.
1. Não é necessário transmitir esse parâmetro para anúncios in-stream padrã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 em 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 compatíveis 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.
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.
venuetype (tipo de local)
Descrição
O parâmetro de tipo de local (venuetype) é usado para indicar o tipo de local externo. Os valores qualificados são os IDs (números inteiros) aceitos pela taxonomia do tipo de local do IAB OpenOOH 1.1.
Exemplos de uso
Quartos de hotel:
venuetype=80703
Tablet no banco de trás de um táxi:
venuetype=103
Requisitos e recomendações
Esse parâmetro é necessário para a monetização programática em mídia OOH digital.
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 programáticos recomendados
aconp (tocar á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).
an (nome do app)
Descrição
Os parâmetros ID do app (msid) e nome do app (an) aceitam valores variáveis a serem aplicados a solicitações enviadas de apps para dispositivos móveis e dispositivos de smart TV, porque eles são obrigatórios para a maioria dos anúncios em vídeo programáticos.
O nome do app precisa ser legível por humanos.
Exemplos de uso
msid=com.package.publisher&an=sample%20app
Os IDs dos app são nomeados e formatados de maneira diferente em cada app store. Consulte as diretrizes do IAB para a identificação de apps ou exemplos de identificadores exclusivos comuns.
Para plataformas sem app store, o IAB recomenda que os publishers usem o seguinte formato de ID: com.publisher.deviceplatform
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 em apps para dispositivos móveis, smart TV, áudio e mídia digital out of home.
Para brand safety e mais transparência aos compradores, é altamente recomendável incluir as informações do app.
Uso do SDK
Com exceção do iOS e do tvOS, o SDK do IMA preenche automaticamente os dois parâmetros, mas eles precisam ser especificados manualmente em ambientes sem SDK, incluindo chamadas VAST diretas, ou ao usar a biblioteca de acesso programático (PAL) ou o inventário autenticado pelo publisher (PAI).
No iOS e no tvOS, o SDK do IMA ou o PAl não conseguem acessar o ID do app. Nesses casos, o parâmetro msid não é enviado, e o SDK envia o pacote de apps pelo parâmetro an.
Observação: se o SDK do IMA para HTML5 for usado, as informações do app não serão usadas.
ct_ch (canal de conteúdo)
Descrição
O parâmetro de canal de conteúdo aceita um valor variável referente ao canal do conteúdo em que o anúncio será veiculado. Um canal é definido como a entidade que organiza uma biblioteca de conteúdo ou transmite conteúdo em streaming com o nome de uma marca para os espectadores.
Esse parâmetro pode ser usado para oferecer mais transparência aos compradores como parte dos indicadores de programação de vídeos nos indicadores fornecidos pelo publisher.
Confira a definição de canal de conteúdo do IAB.
ct_ch=CNN International
ct_ch=ESPN2
ct_ne (rede de conteúdo)
Descrição
O parâmetro de rede de conteúdo aceita um valor variável referente à rede do conteúdo em que o anúncio será exibido. Uma rede é uma organização de transmissão que possui ou licencia uma grande quantidade de conteúdo e o distribui em uma ampla área.
Esse parâmetro pode ser usado para oferecer mais transparência aos compradores como parte dos indicadores de programação de vídeos nos indicadores fornecidos pelo publisher.
Consulte a definição de rede de conteúdo do IAB.
ct_ne=WarnerMedia
ct_ne=ABCct_se (série de conteúdo)
Descrição
O parâmetro de série do conteúdo aceita um valor variável referente a como o anúncio será exibido.
Esse parâmetro pode ser usado para oferecer mais transparência aos compradores como parte dos indicadores de programação de vídeos nos indicadores fornecidos pelo publisher.
ct_se=game_of_thrones
ct_se=NBA_playoffsct_ti (título do conteúdo)
Descrição
O parâmetro de título do conteúdo aceita um valor variável referente a como o anúncio será exibido.
Esse parâmetro pode ser usado para oferecer mais transparência aos compradores como parte dos indicadores de programação de vídeos nos indicadores fornecidos pelo publisher.
ct_ti=game_of_thrones_s1e2
ct_ti=lakers_vs_celticsdevt (tipo de dispositivo)
Descrição
O parâmetro de tipo de dispositivo aceita um valor constante que permite aos publishers segmentar e gerar relatórios sobre o inventário de conversores. Além disso, ele reduz o risco de classificação incorreta do inventário de conversores pelo Google e pelos compradores. Esse parâmetro só deve ser transmitido para inventário de conversores e em conjunto com dth=7 (dica de tipo de dispositivo).
Exemplos de uso
devt=stb
Requisitos e recomendações
Esse parâmetro é obrigatório para a monetização programática de conversores.
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 feitas em:
- 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 ambientes de smart TVs e conversores, em áudio e em mídia digital out of home.
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.
msid (ID do app)
Descrição
Os parâmetros ID do app (msid) e nome do app (an) aceitam valores variáveis a serem aplicados a solicitações enviadas de apps para dispositivos móveis e dispositivos de smart TV, porque eles são obrigatórios para a maioria dos anúncios em vídeo programáticos.
O nome do app precisa ser legível por humanos.
Exemplos de uso
msid=com.package.publisher&an=sample%20app
Os IDs dos app são nomeados e formatados de maneira diferente em cada app store. Consulte as diretrizes do IAB para a identificação de apps ou exemplos de identificadores exclusivos comuns.
Para plataformas sem app store, o IAB recomenda que os publishers usem o seguinte formato de ID: com.publisher.deviceplatform
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 em apps para dispositivos móveis, smart TV, áudio e mídia digital out of home.
Para brand safety e mais transparência aos compradores, é altamente recomendável incluir as informações do app.
Uso do SDK
Com exceção do iOS e do tvOS, o SDK do IMA preenche automaticamente os dois parâmetros, mas eles precisam ser especificados manualmente em ambientes sem SDK, incluindo chamadas VAST diretas, ou ao usar a biblioteca de acesso programático (PAL) ou o inventário autenticado pelo publisher (PAI).
No iOS e no tvOS, o SDK do IMA ou o PAl não conseguem acessar o ID do app. Nesses casos, o parâmetro msid não é enviado, e o SDK envia o pacote de apps pelo parâmetro an.
Observação: se o SDK do IMA para HTML5 for usado, as informações do app não serão usadas.
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.
rdid (identificador de dispositivo redefinível)
Descrição
Os parâmetros de identificador de dispositivo redefinível (rdid, idtype, is_lat) aceitam valores variáveis. Esse valor também é conhecido como identificador de publicidade (IFA).
Com aplicativos para dispositivos móveis que usam o SDK do IMA para Android ou iOS, o SDK transmite identificadores de dispositivo redefiníveis para segmentação de usuários nas solicitações de stream com os parâmetros para rdid, idtype e is_lat.
Quando o SDK do IMA não é usado ou quando o beacon do lado do servidor (SSB) é usado, é necessário transmitir esses parâmetros como explícitos. Saiba mais sobre os identificadores de dispositivos.
Quase todos os anúncios de vídeo programáticos requerem a presença desses valores.
|
A partir do iOS 14.5, a Apple descontinuou o indicador |
Exemplos de uso
Veja exemplos detalhados de identificadores redefiníveis de dispositivo.
Requisitos e recomendações
Embora esses parâmetros não sejam necessários para veicular anúncios em qualquer implementação específica, eles são obrigatórios para a monetização programática em apps para dispositivos móveis, smart TV, áudio e mídia digital out of home.
Para implementações na Web, os identificadores de dispositivo redefiníveis não são usados.
Uso do SDK
O SDK do IMA vai transmitir esse campo automaticamente, a menos que o idType esteja definido como dpid. Nesse caso, o publisher precisa transmitir manualmente o parâmetro rdid.
Os publishers precisam transmitir esses parâmetros manualmente ao usar o SDK do PAL.
sid (ID da sessão)
Descrição
O parâmetro ID da sessão (sid) aceita um valor variável que é um identificador de publicidade com proteção de privacidade usado apenas para fins de limite de frequência.
O ID de sessão é compatível com solicitações de vídeo in-stream de smart TVs e com o inventário de vídeo in-stream de apps para dispositivos móveis. No momento, ele não é compatível com a Web.
Para desativar a transmissão do ID da sessão, defina sid=0.
Exemplos de uso
sid=123e4567-e89b-12d3-a456-426614174000
Esse parâmetro precisa ser preenchido no formato UUID. Saiba mais sobre identificadores de dispositivos redefiníveis para segmentação de usuários.
Requisitos e recomendações
Embora esse parâmetro não seja necessário para veicular anúncios em qualquer implementação específica, ele é obrigatório para a monetização programática em mídia digital out of home.
Esse parâmetro é recomendado para monetização programática em apps para dispositivos móveis, smart TV e áudio.
Uso do SDK
Esse parâmetro é enviado automaticamente pelo SDK do IMA.
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.Outros parâmetros
Embora não sejam obrigatórios para a veiculação básica de anúncios, esses parâmetros são necessários para recursos específicos ou tipos de implementação.
ad_rule (regra de anúncio)
Descrição
O parâmetro de regra de anúncio (ad_rule) aceita um valor constante que indica se a resposta precisa retornar um criativo VAST ou uma regra de anúncio.
A configuração padrão das regras de anúncio depende de uma configuração de rede do Google Ad Manager que permite que todas as solicitações sejam de regras de anúncio. Se a configuração de rede for usada, não será necessário definir ad_rule na tag de anúncio. Se você quiser desativar com base em uma solicitação de anúncio, transmita ad_rule=0 para substituir a configuração de rede. Além disso, se você não tiver regras de anúncios ativadas por padrão, poderá ativar/desativar passando ad_rule=1 e ad_rule=0, respectivamente.
Exemplos de uso
Se a configuração de regras de anúncio estiver desativada:
- Solicitação de criativo VAST:
ad_rule=0ou sem definição
Se a configuração de regras de anúncios estiver ativada:
- Solicitação de criativo VAST:
ad_rule=0 - Solicitação de regras de anúncio (VMAP):
ad_rule=1ou sem definição
Se você não quiser usar as regras de anúncio, use os parâmetros de tag de anúncio para indicar o intervalo de anúncio e a duração do conjunto das tags VAST usando pmnd, pmxd e pmad.
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 é obrigatório para usar corretamente as regras de anúncios em vídeo.
addtl_consent (consentimento adicional)
Descrição
O parâmetro de consentimento adicional (addtl_consent) aceita valores variáveis e é usado pelos publishers que querem fazer a integração com o TCF v2.0 do IAB e usar um fornecedor que ainda não está registrado na lista de fornecedores globais do IAB Europa, mas que está na lista de provedores de adtech (ATP, na sigla em inglês) do Google.
Saiba mais sobre os valores passados para esse parâmetro na especificação técnica do modo de consentimento adicional.
Exemplo de uso
addtl_consent=1~1.35.41.101
adtest (teste de anúncio)
Descrição
O parâmetro de teste de anúncio (adtest) deve ser usado para garantir que as consultas usadas para testar o inventário de preenchimento (não garantido) não sejam identificadas como tráfego inválido e não tenham impacto na receita.
Ao testar o preenchimento, defina esse parâmetro como ativado para garantir que nenhum anúncio registre impressões ou cliques para uso durante o teste. Defina como desativado em ambientes que não são de teste para faturar normalmente. Se não for definido, o padrão será desativado.
Observação: ao testar itens de linha de venda direta, use itens de linha de teste sem impacto na receita.
Exemplos de uso
Ativado:
adtest=on
Desativado:
adtest=off
ad_type (tipo de anúncio)
Descrição
O parâmetro de tipo de anúncio (ad_type) aceita um valor constante que indica os tipos de anúncio que precisam ser retornados para a solicitação.
Quando ad_type é definido como audio ou audio_video, o parâmetro vpmute precisa ser definido como 0.
Exemplos de uso
Permite apenas anúncios em áudio:
ad_type=audio
Permite anúncios em vídeo puláveis e não puláveis:
ad_type=video
Permite anúncios em áudio e em vídeo:
ad_type=audio_video
Esse valor
audio_videopermite que os dois formatos concorram, mas apenas um será veiculado. Ele tem como finalidade ser usado somente para a veiculação de criativos de vídeo em conteúdo de áudio compatível com a reprodução de anúncios em vídeo ou criativos em áudio em players de vídeo in-stream para conteúdo que possa ser "audível" por natureza, como streaming de esportes, videocasts, notícias etc. Leia sobre áudio em conteúdo de vídeo.
Permite apenas anúncios em vídeo puláveis:
ad_type=skippablevideo
Permite apenas anúncios em vídeo não puláveis:
ad_type=standardvideo
Requisitos e recomendações
- Se o app tiver conteúdo em vídeo, defina esse parâmetro como
video,audio_videoou deixe indefinido. - Se o app tiver apenas conteúdo de áudio (por exemplo, um app de rádio ou de voz), defina esse parâmetro como
audio. Se esse campo não for definido, nenhum anúncio em áudio será retornado.
afvsz (tamanhos de anúncios não lineares)
Descrição
O parâmetro de tamanhos de anúncios não lineares (afvsz) aceita um valor constante que precisa ser uma lista separada por vírgulas de tamanhos de anúncios não lineares que podem ser exibidos no espaço do anúncio em vídeo.
Esses tamanhos precisam ser um dos seguintes:
200 x 200250 x 250300 x 250336 x 280450 x 50468 x 60480 x 90729 x 90
Ao usar o SDK do IMA, esse campo é substituído e preenchido com todos os tamanhos compatíveis que se enquadrem em nonLinearAdSlotWidth e nonLinearAdSlotHeight.
Esse parâmetro poderá ficar vazio ou não ser incluído quando não houver tamanhos não lineares compatíveis.
Exemplos de uso
Todos os tamanhos são compatíveis:
afvsz=200x200,250x250,300x250,336x280,
450x50,468x60,480x90,728x90
A largura máxima é 250:
afvsz=200x200,250x250
A altura máxima é 60:
afvsz=450x50,468x60
A largura máxima é 100:
//empty; no values supported
Requisitos e recomendações
Embora esse parâmetro não seja necessário para veicular anúncios em qualquer implementação ou tipo de transação específico, ele é necessário para veicular anúncios em vídeo não lineares quando o SDK do IMA não é usado.
allcues (todas as inserções)
Descrição
O parâmetro de todas as inserções (allcues) aceita valores variáveis, que são uma lista separada por vírgulas de pontos de inserção, em milissegundos. Para cada valor, o Google Ad Manager retorna um intervalo de anúncio.
- Os parâmetros
vid_deallcuessão usados para veicular anúncios intermediários sem ingestão de conteúdo. - Também são necessárias regras de anúncio 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
Pontos de inserção em 10 e 20 segundos:
allcues=10000,20000
ciu_szs (tamanhos complementares)
Descrição
O parâmetro de tamanhos de complementares (ciu_szs) aceita valores variáveis, que são uma lista separada por vírgulas de tamanhos de complementares.
Valores separados por barra vertical (|) indicam um espaço do anúncio de vários tamanhos.
Exemplos de uso
ciu_szs=728x90,300x250
Tamanhos com um local para vários tamanhos:
ciu_szs=728x90,300x200|300x250
cmsid (ID da origem do conteúdo)
Descrição
Os parâmetros de ID da origem do conteúdo (cmsid) e de ID do vídeo (vid) aceitam valores variáveis.
A fim de segmentar anúncios para conteúdo em vídeo, a tag de vídeo principal precisa incluir ambos.
- O
cmsidé um número exclusivo a cada origem do conteúdo. Para localizar isso no Google Ad Manager, acesse Vídeo, clique em Origens de conteúdo e no nome da origem. - O
vidé uma string ou um número de identificação de um determinado vídeo. Esse ID é atribuído pelo CMS que hospeda seu conteúdo. Para localizar isso no Google Ad Manager, clique em Vídeo, depois em Conteúdo e, por fim, no conteúdo de vídeo específico.
Exemplos de uso
cmsid=[value]&vid=[value]
Se você criar uma tag para vídeo on demand com Inserção de anúncios dinâmicos, use as macros que inserem dinamicamente a origem do conteúdo e o ID do vídeo adequados.
Exemplo: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%
Requisitos e recomendações
Embora esses parâmetros não sejam necessários para veicular anúncios em qualquer implementação ou tipo de transação específico, eles precisam usar a segmentação por conteúdo em vídeo.
cust_params (parâmetros personalizados)
Descrição
Os parâmetros personalizados (cust_params) aceitam valores varáveis que representem pares de chave-valor. Eles possibilitam que você defina uma segmentação específica, como informações demográficas, determinadas posições em uma página ou, ainda, páginas em particular.
Exemplos de uso
Veja exemplos de como adicionar pares de chave-valor.
excl_cat (categoria de exclusão)
Descrição
O parâmetro de categoria de exclusão (excl_cat) aceita valores variáveis e é usado para impedir que os itens de linha com o rótulo de exclusão na solicitação de anúncio sejam qualificados. Use o parâmetro cust_params para definir a categoria e os rótulos de exclusão.
Exemplos de uso
Para definir a categoria de exclusão de dois rótulos de exclusão (airline_excl_label e train_excl_label), use uma vírgula (,) para separar os rótulos:
excl_cat=airline_excl_label%2Ctrain_excl_label
Em seguida, aplique a codificação de URL e use a string codificada em cust_params:
&cust_params=excl_cat%3Dairline_excl_label%2Ctrain_excl_label
gdpr (GDPR)
Descrição
O parâmetro do GDPR (gdpr) aceita valores constantes e é usado por publishers que querem fazer a integração com o TCF v2.0 do IAB. As solicitações VAST diretas não leem automaticamente os valores, mas são aceitas quando adicionadas às tags de anúncio.
Somente 0 e 1 são valores válidos para esse parâmetro, em que 0 significa que o GDPR não se aplica e 1 indica que ele é aplicável. Se o GDPR for aplicável, vai ser necessário fornecer uma string de TC válida usando o parâmetro gdpr_consent.
Saiba mais sobre os valores passados para esse parâmetro nas diretrizes gerais sobre a implementação da estrutura ou na seção string de TC da especificação do TCF v2.0 do IAB.
Exemplos de uso
O GDPR é aplicável:
gdpr=1
O GDPR não se aplica:
gdpr=0
gdpr_consent (consentimento do GDPR)
Descrição
O parâmetro de consentimento do GDPR (gdpr_consent) aceita valores variáveis e é usado por publishers que querem fazer a integração com o TCF v2.0 do IAB. As solicitações VAST diretas não leem automaticamente os valores, mas são aceitas quando adicionadas às tags de anúncio.
Saiba mais sobre os valores passados para esse parâmetro nas diretrizes gerais sobre a implementação da estrutura ou na seção string de TC da especificação do TCF v2.0 do IAB.
Exemplos de uso
gdpr_consent=GDPR_CONSENT_123
iabexcl (URL de exclusão do IAB)
Descrição
O parâmetro de URL de exclusão do IAB (iabexcl) aceita valores variáveis, que são uma lista de categorias separada por vírgulas.
Exemplos de uso
iabexcl=3,14,527 exclui "caminhões comerciais", "veículos off-road" e "Rúgbi".
Faça o download de uma lista de categorias da taxonomia de conteúdo do IAB e os IDs delas.
idtype (tipo de dispositivo)
Descrição
Os parâmetros de identificador de dispositivo redefinível (rdid, idtype, is_lat) aceitam valores variáveis. Esse valor também é conhecido como identificador de publicidade (IFA).
Com aplicativos para dispositivos móveis que usam o SDK do IMA para Android ou iOS, o SDK transmite identificadores de dispositivo redefiníveis para segmentação de usuários nas solicitações de stream com os parâmetros para rdid, idtype e is_lat.
Quando o SDK do IMA não é usado ou quando o beacon do lado do servidor (SSB) é usado, é necessário transmitir esses parâmetros como explícitos. Saiba mais sobre os identificadores de dispositivos.
Quase todos os anúncios de vídeo programáticos requerem a presença desses valores.
|
A partir do iOS 14.5, a Apple descontinuou o indicador |
Exemplos de uso
Veja exemplos detalhados de identificadores redefiníveis de dispositivo.
Requisitos e recomendações
Embora esses parâmetros não sejam necessários para veicular anúncios em qualquer implementação específica, eles são obrigatórios para a monetização programática em apps para dispositivos móveis, smart TV, áudio e mídia digital out of home.
Para implementações na Web, os identificadores de dispositivo redefiníveis não são usados.
Uso do SDK
O SDK do IMA vai transmitir esse campo automaticamente, a menos que o idType esteja definido como dpid. Nesse caso, o publisher precisa transmitir manualmente o parâmetro rdid.
Os publishers precisam transmitir esses parâmetros manualmente ao usar o SDK do PAL.
ipd (domínio do parceiro de inventário)
Descrição
O parâmetro de domínio do parceiro de inventário (ipd) aceita valores variáveis que precisam ser definidos nas declarações de inventorypartnerdomain no arquivo app-ads.txt (ou ads.txt) do publisher.
O parâmetro inventorypartnerdomain é uma especificação do IAB que ajuda os publishers a designar o domínio de um parceiro de compartilhamento de inventário para validação de ads.txt/app-ads.txt.
A declaração IPD é especialmente importante em casos de uso de compartilhamento de inventário em que o inventário de anúncios de origem de uma solicitação pode ser propriedade de outro parceiro (o parceiro de compartilhamento de inventário).
Saiba mais sobre o ads.txt/app-ads.txt e os parceiros de compartilhamento de inventário.
Exemplos de uso
Oinventorypartnerdomain está no arquivo app-ads.txt, que aponta para o arquivo .txt do parceiro que pode gerar receita com o inventário. O valor no parâmetro ipd precisa corresponder a um valor no arquivo app-ads.txt em um dos itens inventorypartnerdomain.Requisitos e recomendações
Esse parâmetro é obrigatório para publishers que geram receita com inventários que não são de sua propriedade.
ipe (entidade da impressão com ping)
Descrição
O parâmetro da entidade da impressão com ping (ipe) aceita um valor constante que é usado para indicar pings de impressão e conversões com origem no servidor, não no cliente.
A entidade de ping de impressão é usada quando um servidor envia pings/beacons de impressão do servidor.
Exemplos de uso
Beacon do lado do servidor (SSB, na sigla em inglês):
ipe=ssb
is_lat (Limitar o rastreamento de anúncios)
Descrição
Os parâmetros de identificador de dispositivo redefinível (rdid, idtype, is_lat) aceitam valores variáveis. Esse valor também é conhecido como identificador de publicidade (IFA).
Com aplicativos para dispositivos móveis que usam o SDK do IMA para Android ou iOS, o SDK transmite identificadores de dispositivo redefiníveis para segmentação de usuários nas solicitações de stream com os parâmetros para rdid, idtype e is_lat.
Quando o SDK do IMA não é usado ou quando o beacon do lado do servidor (SSB) é usado, é necessário transmitir esses parâmetros como explícitos. Saiba mais sobre os identificadores de dispositivos.
Quase todos os anúncios de vídeo programáticos requerem a presença desses valores.
|
A partir do iOS 14.5, a Apple descontinuou o indicador |
Exemplos de uso
Veja exemplos detalhados de identificadores redefiníveis de dispositivo.
Requisitos e recomendações
Embora esses parâmetros não sejam necessários para veicular anúncios em qualquer implementação específica, eles são obrigatórios para a monetização programática em apps para dispositivos móveis, smart TV, áudio e mídia digital out of home.
Para implementações na Web, os identificadores de dispositivo redefiníveis não são usados.
Uso do SDK
O SDK do IMA vai transmitir esse campo automaticamente, a menos que o idType esteja definido como dpid. Nesse caso, o publisher precisa transmitir manualmente o parâmetro rdid.
Os publishers precisam transmitir esses parâmetros manualmente ao usar o SDK do PAL.
lip (última posição no conjunto)
Descrição
O parâmetro de última posição no conjunto (lip) aceita um valor constante para indicar uma solicitação da última posição em um conjunto para segmentação ou geração de relatórios.
Observação: esse parâmetro não se aplica a conjuntos otimizados e será ignorado se usado.
Exemplos de uso
lip=1
ltd (anúncios limitados)
Descrição
O parâmetro de anúncios limitados (ltd) aceita um valor constante que indica a possibilidade de veicular anúncios de forma limitada caso o usuário não autorize o uso de cookies ou de outros identificadores locais. Um publisher pode adicionar esse parâmetro manualmente, e o Google tentará veicular um anúncio limitado qualificado, seja qual for a localização do usuário.
Esse parâmetro é usado para indicar uma solicitação de anúncios limitados e é diferente do parâmetro is_lat. Ele desativa a personalização e o uso de identificadores para esses fins.
ltd=1 muda o comportamento do SDK do IMA para tratar a solicitação como sem ID e não permitir o armazenamento.Se uma solicitação de anúncio incluir
ltd=1 (ou seja, é uma solicitação de anúncios limitados), o domínio vai mudar para pagead2.googlesyndication.com quando os SDKs forem usados. Para integrações sem SDK, os publishers vão precisar mudar manualmente para o domínio pagead2.googlesyndication.com.Exemplos de uso
ltd=1
max_ad_duration (duração máxima do anúncio)
Descrição
O parâmetro de duração mínima do anúncio (min_ad_duration) e o parâmetro de duração máxima do anúncio (max_ad_duration) aceitam valores variáveis que, juntos, especificam o intervalo de duração que um anúncio precisa corresponder em milissegundos.
Esse parâmetro pode ser usado para restringir os criativos a uma duração exigida na tag de anúncio para anúncios únicos ou em solicitações de conjunto otimizado.
Exemplos de uso
min_ad_duration=15000&max_ad_duration=30000
min_ad_duration (Duração mínima do anúncio)
Descrição
O parâmetro de duração mínima do anúncio (min_ad_duration) e o parâmetro de duração máxima do anúncio (max_ad_duration) aceitam valores variáveis que, juntos, especificam o intervalo de duração que um anúncio precisa corresponder em milissegundos.
Esse parâmetro pode ser usado para restringir os criativos a uma duração exigida na tag de anúncio para anúncios únicos ou em solicitações de conjunto otimizado.
Exemplos de uso
min_ad_duration=15000&max_ad_duration=30000
mridx (número do anúncio intermediário)
Descrição
O parâmetro de número do anúncio intermediário (mridx) aceita um valor variável que indica o número ordinal do anúncio intermediário, como "anúncio intermediário 1", "anúncio intermediário 2" etc.
Exemplos de uso
mridx=2
Requisitos e recomendações
Embora esse parâmetro não seja necessário para veicular anúncios em qualquer implementação ou tipo de transação específico, ele é necessário para segmentar um anúncio intermediário específico, gerar relatórios sobre ele e fazer previsões.
nofb (nenhum substituto)
Descrição
O parâmetro sem substituto (nofb) aceita um valor constante para indicar que a solicitação de anúncio não deve retornar uma playlist de anúncios substitutos de vídeo.
Exemplos de uso
Substitutos desativados:
nofb=1
O substituto de anúncio único e o buffet de anúncios do conjunto otimizado podem ser desativados por solicitação de anúncio transmitindo nofb=1.
npa (anúncio não personalizado)
Descrição
O parâmetro de anúncios não personalizados (npa) aceita um valor constante para indicar que a solicitação de anúncio precisa ser tratada como não personalizada.
É necessário definir especificamente npa=1 ou incluir npa (sem um valor definido) para marcar a solicitação como não personalizada. As solicitações de anúncios que não têm esse parâmetro ou estão definidas como npa=0 terão como padrão anúncios personalizados.
Exemplos de uso
Anúncios não personalizados:
npa=1
Requisitos e recomendações
Esse parâmetro só é necessário se o usuário desativar a personalização. Os publishers precisam garantir que representam o estado correto do usuário quando controlam o estado.
paln (valor de uso único da biblioteca de acesso programático – legado)
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.
pmad (máximo de anúncios no conjunto)
Descrição
O parâmetro de anúncio máximo do conjunto (pmad) aceita um valor variável que indica o número máximo de anúncios em um conjunto.
Esse parâmetro limita o número total de anúncios em um conjunto otimizado, que é um recurso disponível para publishers com um pacote de vídeo avançado.
Esse parâmetro não deve ser usado para VMAP (quando ad_rule=1).
Exemplos de uso
pmad=4
pmnd (duração mínima do conjunto)
Descrição
O parâmetro de duração mínima do conjunto (pmnd) e o parâmetro de duração máxima do conjunto (pmxd) aceitam valores variáveis que, juntos, especificam o intervalo de duração a que um conjunto precisa corresponder, em milissegundos.
Esses parâmetros são usados para solicitar vários anúncios em um conjunto otimizado, um recurso disponível para publishers com um pacote de vídeo avançado. Quando as regras de anúncios são usadas, o Google Ad Manager adiciona essas informações automaticamente.
Esse parâmetro não deve ser usado para VMAP (quando ad_rule=1).
Exemplos de uso
pmnd=0&pmxd=60000
pmxd (duração máxima do conjunto)
Descrição
O parâmetro de duração mínima do conjunto (pmnd) e o parâmetro de duração máxima do conjunto (pmxd) aceitam valores variáveis que, juntos, especificam o intervalo de duração a que um conjunto precisa corresponder, em milissegundos.
Esses parâmetros são usados para solicitar vários anúncios em um conjunto otimizado, um recurso disponível para publishers com um pacote de vídeo avançado. Quando as regras de anúncios são usadas, o Google Ad Manager adiciona essas informações automaticamente.
Esse parâmetro não deve ser usado para VMAP (quando ad_rule=1).
Exemplos de uso
pmnd=0&pmxd=60000
pmxfwt (tempo máximo de exibição forçada do conjunto)
Descrição
O parâmetro tempo máximo de exibição forçada do conjunto (pmxfwt) aceita uma variável que especifica a duração máxima não pulável de um conjunto em milissegundos.
Se você oferece suporte a conjuntos com uma combinação de anúncios em vídeo puláveis e não puláveis e quer limitar o tempo de exibição dos anúncios para os usuários, use esse parâmetro para definir o tempo máximo não pulável que um usuário precisa assistir.
Observação: o parâmetro de duração máxima do conjunto (pmxd) substitui esse parâmetro na definição da duração total máxima do conjunto (incluindo a duração total dos anúncios puláveis).
Exemplo de uso
pmxfwt=30000
pod (número do conjunto)
Descrição
O parâmetro de número do conjunto (pod) aceita um valor variável que representa o número ordinal do conjunto em um vídeo, como "conjunto 1", "conjunto 2" etc.
Exemplos de uso
pod=3
Requisitos e recomendações
Embora esse parâmetro não seja necessário para veicular anúncios em qualquer implementação ou tipo de transação específico, ele é necessário para permitir que o mesmo anúncio seja veiculado em conjuntos diferentes e para usar corretamente as exclusões competitivas, o limite de frequência e recursos relacionados.
pp (perfil do criativo)
Descrição
O parâmetro de perfil do criativo (pp) aceita um valor variável que controle quais criativos se qualificam para veiculação com base na configuração definida em um perfil de criativo em áudio e em vídeo.
Exemplos de uso
pp=creative_profile
Requisitos e recomendações
Embora esse parâmetro não seja necessário para veicular anúncios em qualquer implementação específica, ele é necessário para restringir arquivos de mídia em criativos hospedados pelo Google Ad Manager com perfis de criativos em vídeo e áudio. Para redirecionamentos ou anúncios programáticos, isso é usado para garantir que o requisito esteja disponível, mas não restringe os arquivos de mídia aos selecionados no perfil do criativo.
ppt (tratamento de privacidade do publisher)
Descrição
O parâmetro de tratamento de privacidade do publisher (ppt) aceita um valor constante, que é usado para indicar se a personalização de anúncios precisa ser desativada para a solicitação de anúncio.
Esse parâmetro oferece uma maneira de aplicar anúncios não personalizados que podem ser diferentes de npa=1 e rdp=1. Ela afeta as reservas e a demanda programática.
Saiba mais sobre o tratamento de privacidade do publisher.
Exemplos de uso
Desative a personalização de anúncios:
ppt=1
ppid (identificador fornecido pelo publisher)
Descrição
O parâmetro de identificador fornecido pelo publisher (PPID) aceita um valor variável do identificador usado no limite de frequência, na segmentação, na segmentação de público-alvo, na rotação sequencial de anúncios e em outros controles de exibição de anúncios com base no público-alvo em dispositivos.
Saiba mais sobre os identificadores fornecidos pelo publisher.
Exemplos de uso
ppid=12JD92JD8078S8J29SDOAKC0EF230337
Requisitos e recomendações
Embora esse parâmetro não seja necessário para veicular anúncios em qualquer implementação ou tipo de transação específico, ele é necessário para usar um identificador consistente independente da plataforma. Ele pode ser usado quando outros identificadores não estão presentes e pode ser fornecido aos compradores.
ppos (posição no conjunto)
Descrição
O parâmetro de posição no conjunto (ppos) aceita um valor variável que representa a posição em um conjunto, como "posição 1", "posição 2" etc.
Esse parâmetro é válido apenas para conjuntos padrão e só é necessário para o preenchimento automático dos complementares. Quando as regras de anúncios são usadas, o Google Ad Manager adiciona essas informações automaticamente.
Exemplos de uso
ppos=2
Requisitos e recomendações
Embora esse parâmetro não seja necessário para veicular anúncios em qualquer tipo específico de implementação ou transação, ele é obrigatório para conjuntos padrão quando a segmentação por posição é necessária, bem como para estimativa e relatórios sobre pods padrão. Também é necessário usar corretamente as exclusões competitivas, o limite de frequência e recursos relacionados.
ppsj (JSON dos indicadores fornecidos pelo publisher)
Descrição
O parâmetro JSON de indicadores fornecidos pelo publisher (ppsj) aceita um valor variável, que é um objeto JSON codificado em base64 com dados de público-alvo e contextuais fornecidos pelo publisher para melhorar a monetização programática.
Esse parâmetro pode ser usado para enviar determinados indicadores aos compradores/bidders.
Saiba mais sobre os indicadores fornecidos pelo publisher e as taxonomias compatíveis.
Exemplos de uso
Objeto JSON:
{
"PublisherProvidedTaxonomySignals": [{
"taxonomy": "IAB_AUDIENCE_1_1",
"values": ["6", "284"]
}]
}
Aplique o valor codificado em base64:
eyJQdWJsaXNoZXJQcm92aWRlZFRheG9ub215U2l
nbmFscyI6W3sidGF4b25vbXkiOiJJQUJfQVVESUVOQ0V
fMV8xIiwidmFsdWVzIjpbIjEiLCIyODQiXX1dfQ
Confira detalhes dos pares de chave-valor JSON válidos na
amostra do SDK do IMA para HTML5.
ptpl (ID do modelo de intervalo de anúncio)
Descrição
O parâmetro de ID do modelo de intervalo de anúncio (ptpl) e o parâmetro de nome (ptpln) aceitam valores variáveis, que são usados para indicar qual modelo de intervalo de anúncio precisa ser aplicado à solicitação de conjunto otimizado.
Os modelos de intervalo de anúncio permitem configurar quais espaços (personalizados ou não) precisam ser incluídos em um intervalo de anúncio e em que ordem eles serão veiculados.
Apenas um desses parâmetros é obrigatório para solicitar um modelo de intervalo de anúncio.
Exemplos de uso
Saiba como configurar e solicitar modelos de intervalos de anúncio.
Requisitos e recomendações
Esses parâmetros são obrigatórios apenas se você estiver solicitando um modelo de intervalo de anúncio diretamente.
ptpln (nome do modelo de intervalo doe anúncio)
Descrição
O parâmetro de ID do modelo de intervalo de anúncio (ptpl) e o parâmetro de nome (ptpln) aceitam valores variáveis, que são usados para indicar qual modelo de intervalo de anúncio precisa ser aplicado à solicitação de conjunto otimizado.
Os modelos de intervalo de anúncio permitem configurar quais espaços (personalizados ou não) precisam ser incluídos em um intervalo de anúncio e em que ordem eles serão veiculados.
Apenas um desses parâmetros é obrigatório para solicitar um modelo de intervalo de anúncio.
Exemplos de uso
Saiba como configurar e solicitar modelos de intervalos de anúncio.
Requisitos e recomendações
Esses parâmetros são obrigatórios apenas se você estiver solicitando um modelo de intervalo de anúncio diretamente.
pubf (preços mínimos públicos nas tags do Ad Exchange)
Descrição
O parâmetro de preço mínimo público para o Ad Exchange (pubf) e o parâmetro de preço mínimo privado para o Ad Exchange (pvtf) aceitam valores variáveis, que são usados para adicionar preços mínimos às tags do Ad Exchange.
Esses parâmetros são equivalentes a google_ad_public_floor e google_ad_private_floor.
Exemplos de uso
Preço mínimo público:
pubf=123
Preço mínimo privado:
pvtf=123
Requisitos e recomendações
Esses parâmetros estão disponíveis apenas para publishers no Espaço Econômico Europeu ("EEE"), na Suíça ou na África do Sul que foram aprovados para usar o recurso "Preços mínimos".
Saiba como enviar uma solicitação.
pvid (ID do conjunto de apps)
Descrição
O parâmetro de ID do conjunto de apps (pvid) aceita um valor variável que é definido como o ID do conjunto de apps Android, e o parâmetro de escopo do conjunto de apps (pvid_s) aceita um valor constante que representa o escopo do ID do conjunto de apps (scope_app ou scope_developer).
Consulte a documentação do Android sobre como recuperar o ID do conjunto de apps.
Exemplos de uso
pvid=[AppSetID_value]
pvid_s=scope_app
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 em apps para dispositivos móveis em dispositivos Android, incluindo smart TVs com base em apps (Android TV).
Uso do SDK
Embora o SDK do IMA/PAL passe automaticamente esse campo, os publishers com implementações que não são do SDK precisam chamar o SDK do conjunto de apps e transmitir esses parâmetros manualmente na solicitação de anúncio.
pvid_s (escopo do conjunto de apps)
Descrição
O parâmetro de ID do conjunto de apps (pvid) aceita um valor variável que é definido como o ID do conjunto de apps Android, e o parâmetro de escopo do conjunto de apps (pvid_s) aceita um valor constante que representa o escopo do ID do conjunto de apps (scope_app ou scope_developer).
Consulte a documentação do Android sobre como recuperar o ID do conjunto de apps.
Exemplos de uso
pvid=[AppSetID_value]
pvid_s=scope_app
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 em apps para dispositivos móveis em dispositivos Android, incluindo smart TVs com base em apps (Android TV).
Uso do SDK
Embora o SDK do IMA/PAL passe automaticamente esse campo, os publishers com implementações que não são do SDK precisam chamar o SDK do conjunto de apps e transmitir esses parâmetros manualmente na solicitação de anúncio.
pvtf (preços mínimos públicos nas tags do Ad Exchange)
Descrição
O parâmetro de preço mínimo público para o Ad Exchange (pubf) e o parâmetro de preço mínimo privado para o Ad Exchange (pvtf) aceitam valores variáveis, que são usados para adicionar preços mínimos às tags do Ad Exchange.
Esses parâmetros são equivalentes a google_ad_public_floor e google_ad_private_floor.
Exemplos de uso
Preço mínimo público:
pubf=123
Preço mínimo privado:
pvtf=123
Requisitos e recomendações
Esses parâmetros estão disponíveis apenas para publishers no Espaço Econômico Europeu ("EEE"), na Suíça ou na África do Sul que foram aprovados para usar o recurso "Preços mínimos".
Saiba como enviar uma solicitação.
rdp (restringir o tratamento de dados)
Descrição
O parâmetro tratamento de dados restrito (rdp) aceita um valor constante para indicar que a solicitação de anúncio precisa restringir o tratamento de dados.
Para isso, ative a configuração de rede Restringir o tratamento de dados.
Exemplos de uso
Restringir o tratamento de dados:
rdp=1 ou rdp (sem valor definido)
Não restringir o tratamento de dados:
rdp=0
scor (correlator de stream)
Descrição
O parâmetro correlator de stream (scor) aceita um valor variável que precisa ser um número inteiro gerado para cada stream de vídeo.
Os parâmetros scor e correlator não precisam ter o mesmo valor inteiro. No entanto, eles precisam manter seus respectivos valores em cada reprodução de stream de vídeo para identificar uma sessão de visualização única.
Exemplos de uso
scor=17
Requisitos e recomendações
Embora esse parâmetro não seja necessário para veicular anúncios em qualquer implementação ou tipo de transação específico, ele é recomendado para veiculação de anúncios na Web, em apps para dispositivos móveis, em smart TV, em áudio e em mídia OOH digital.
Esse parâmetro é usado para exclusões competitivas, limites de frequência e recursos relacionados quando um usuário assiste vários vídeos na mesma página.
sdk_apis (framework da API do SDK)
Descrição
O parâmetro framework da API do SDK (sdk_apis) aceita uma lista separada por vírgulas de valores inteiros constantes que indicam todos os frameworks da API compatíveis com o player.
Requisitos e recomendações
Uso do SDK
Esse parâmetro é usado por publishers que usam a biblioteca de acesso programático (PAL). Se você tentar definir valores para esse parâmetro enquanto usa o SDK do IMA, eles serão substituídos pelos valores compatíveis com o SDK do IMA.
sdmax (duração máxima de anúncios puláveis)
Descrição
O parâmetro de duração máxima do anúncio pulável (sdmax) aceita um valor variável que permite que os publishers especifiquem a duração máxima desejada para os anúncios puláveis.
A duração em milissegundos representa o limite máximo permitido para a duração dos criativos de vídeo/áudio puláveis nessa solicitação de anúncio específica.
Use sdmax de forma independente em anúncios puláveis ou com o parâmetro max_ad_duration para definir durações máximas diferentes em anúncios puláveis e não puláveis.
Exemplos de uso
Usar as seguintes configurações:
max_ad_duration= 15000 (15 segundos)sdmax= 45000 (45 segundos)
Para os seguintes criativos:
- Criativo A: não pulável; 30 segundos
- Criativo B: pulável; 30 segundos
Resulta em:
- O criativo A será filtrado porque não é pulável e a duração excede o máximo (não pulável).
- O criativo B não será filtrado porque, embora sua duração ultrapasse
max_ad_duration, ele é pulável, e a duração não excede o máximo de puláveis.
ssj (JSON de indicador seguro)
Descrição
O parâmetro SSJ representa o valor JSON codificado de indicadores seguros.
É o valor após a codificação websafe64:
eyJzaWduYWxzIjpbeyJzb3VyY2UiOiJTT1VSQ0UxIiwiZGF0YSI6IkRBVEExIiwiaXNQdWJDcmVhdGVkIjpmYWxzZX0seyJzb3VyY2UiOiIxMjMiLCJkYXRhIjoiREFUQTIiLCJpc1B1YkNyZWF0ZWQiOnRydWV9XX0%3D
Exemplos de uso
JSON, incluindo dois indicadores: um fornecido por um provedor externo de indicadores chamado SOURCE1 e um segundo indicador, que é um indicador seguro personalizado do publisher chamado 123, após o código da rede do publisher. DATA1 é obtido de uma função concedida pelo provedor de indicador SOURCE1, e DATA2 é obtido de uma função criada pelo publisher:
{
"signals": [
{
"source": "SOURCE1",
"data": "DATA1",
"isPubCreated": false
},
{
"source": "123",
"data": "DATA2",
"isPubCreated": true
} ]
}
Requisitos e recomendações
Esse parâmetro não é obrigatório para veicular anúncios em nenhum tipo de implementação específico. O parâmetro ssj é recomendado se você tiver ativado os indicadores seguros na sua rede do Ad Manager.
ssss (origem de agrupamento do lado do servidor)
Descrição
O parâmetro origem do agrupamento do lado do servidor (ssss) aceita um valor constante que precisa ser definido como um valor reconhecido e disponibilizado pelo Google para o fornecedor da tecnologia de agrupamento de vídeos.
Os fornecedores que usam integrações de servidor para servidor com o Google recebem esse valor do Google e podem fornecê-lo a você. Entre em contato com seu gerente de contas do Google em caso de dúvidas sobre o valor a ser definido para esse parâmetro.
Exemplos de uso
ssss=mystitcher
Requisitos e recomendações
Embora esse parâmetro não seja obrigatório para veicular anúncios em qualquer implementação ou tipo de transação específico, ele é necessário para usar implementações do lado do servidor.
tfat (tag para tratamento por idade)
Descrição
O parâmetro de tratamento por idade (tfat) aceita um valor constante que indica que a solicitação recebe proteções de tratamento por idade.
Exemplos de uso
tfat=1 O tratamento por idade para crianças é especificado pelo valor 1.
tfat=2 O tratamento por idade para adolescentes é especificado pelo valor 2.
tfat=0 Nenhum tratamento específico por idade é especificado pelo valor 0.
tfcd (tag para conteúdo feito para crianças) (descontinuada)
Descrição
O parâmetro tratar como feito para crianças (tfcd) aceita um valor constante que indica que a solicitação precisa ser tratada como direcionada a crianças.
Exemplos de uso
tfcd=1
trt (tipo de tráfego)
Descrição
O parâmetro de tipo de tráfego (trt) aceita um valor constante que funciona para solicitar tráfego comprado ou orgânico.
Exemplos de uso
Solicitação de tráfego comprado:
trt=1
Solicitação de tráfego orgânico:
trt=2
Requisitos e recomendações
Uso do SDK
O SDK do IMA não preencherá um valor padrão se o parâmetro do tipo de tráfego não estiver presente em uma solicitação. Nesses casos, o servidor fornece um valor padrão 0 (tráfego indefinido).
us_privacy (privacidade do IAB nos EUA)
Descrição
A stringus_national foi descontinuada pelo IAB em favor da GPP. No entanto, o Ad Manager continua lendo e respeitando a string se ela for transmitida para compatibilidade com versões anteriores. Recomendamos que os publishers revisem a GPP ou outros controles de privacidade e migrem de us_national.
vad_type (tipo de anúncio em vídeo)
Descrição
O parâmetro anúncio em vídeo (vad_type) aceita um valor constante que indica se o retorno será um anúncio linear ou não linear.
Exemplos de uso
Retornar um anúncio linear:
vad_type=linear
Retornar um anúncio não linear:
vad_type=nonlinear
vid (ID do vídeo)
Descrição
Os parâmetros de ID da origem do conteúdo (cmsid) e de ID do vídeo (vid) aceitam valores variáveis.
A fim de segmentar anúncios para conteúdo em vídeo, a tag de vídeo principal precisa incluir ambos.
- O
cmsidé um número exclusivo a cada origem do conteúdo. Para localizar isso no Google Ad Manager, acesse Vídeo, clique em Origens de conteúdo e no nome da origem. - O
vidé uma string ou um número de identificação de um determinado vídeo. Esse ID é atribuído pelo CMS que hospeda seu conteúdo. Para localizar isso no Google Ad Manager, clique em Vídeo, depois em Conteúdo e, por fim, no conteúdo de vídeo específico.
Exemplos de uso
cmsid=[value]&vid=[value]
Se você criar uma tag para vídeo on demand com Inserção de anúncios dinâmicos, use as macros que inserem dinamicamente a origem do conteúdo e o ID do vídeo adequados.
Exemplo: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%
Requisitos e recomendações
Embora esses parâmetros não sejam necessários para veicular anúncios em qualquer implementação ou tipo de transação específico, eles precisam usar a segmentação por conteúdo em vídeo.
vpi (playlist do vídeo inline)
Descrição
O parâmetro playlist de vídeo inline (vpi) aceita um valor constante que indica se é necessário veicular o VMAP inline (retornar o VAST dentro do VMAP).
Esse parâmetro pode ser usado para reduzir a latência e garantir os limites de frequência e exclusões competitivas em um stream de vídeo.
Exemplos de uso
Retornar VAST:
vpi=1
Retornar redirecionamentos:
vpi=0