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 de mídia digital out of home.
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 mídia digital out of home
Parâmetros obrigatórios para a veiculação de anúncios
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.
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.
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
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.
is_lat (limitar o acompanhamento de anúncio)
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.
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.
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.
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.
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 (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.
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.