Este artigo mostra uma lista completa de parâmetros que podem ser usados numa etiqueta do anúncio VAST. Pode ser útil se quiser saber mais acerca de um parâmetro específico.
Nesta página
- Parâmetros obrigatórios para a publicação de anúncios
- Parâmetros obrigatórios para programático
- Parâmetros recomendados para anúncios programáticos
- Outros parâmetros
Listas de parâmetros por tipo de implementação
Se estiver a usar uma implementação específica, pode usar listas de parâmetros personalizados que descrevam a utilização e os requisitos dessa implementação. Use a lista de parâmetros personalizados para:
A Web App para dispositivos móveis Smart TV Áudio Anúncios exteriores digitais
Todos os parâmetros
Parâmetros obrigatórios para a publicação de anúncios
Em geral, estes parâmetros são necessários para a publicação de anúncios na maioria das implementações. No entanto, podem existir instâncias em que não são necessárias. Para ver a lista mais precisa, use a lista de parâmetros para o seu tipo de implementação específico.
correlator (Correlator)
Descrição
O parâmetro do correlator (correlator) aceita um valor variável que é partilhado pelos vários pedidos com origem na mesma visualização de página. É utilizado para implementar exclusões competitivas, incluindo aquelas em ambientes sem cookies.
Exemplos de utilização
correlator=4345645667
Requisitos e recomendações
Este parâmetro é necessário para implementar a publicação de anúncios na Web, em apps para dispositivos móveis, em smart TVs, em áudio e em exteriores digitais.
Utilização do SDK
- Se o SDK IMA for utilizado, o valor correlator é definido automaticamente. Se o seu leitor tentar definir este valor, o SDK substitui-o pelo seu próprio valor.
- Se o SDK para IMA (Anúncios Multimédia Interativos) não for usado, certifique-se de que define este valor como um valor inteiro positivo verdadeiramente aleatório que não esteja a ser reutilizado por várias visualizações de página.
description_url (URL da descrição)
Descrição
O parâmetro de URL da descrição (description_url) aceita um valor variável que deve descrever o vídeo em reprodução na página.
O URL da descrição deve ser sobre os vídeos em reprodução numa página específica de uma app Web, uma app para dispositivos móveis ou uma app de TV. Não deve ser o domínio de nível superior de todos os vídeos ou pedidos de anúncios. Por exemplo, se tiver uma página https://www.sample.com/golf.html para apresentar vídeos sobre golfe, defina-a como o valor de description_url.
Exemplos de utilização
O valor description_url tem de ser codificado por URL para páginas Web com vídeos e dispositivos CTV/OTT. No entanto, o valor description_url não pode ser codificado para apps para dispositivos móveis.
URL codificado:
description_url=
https%3A%2F%2Fwww.sample.com%2Fgolf.html
URL não codificado:
description_url=
https://www.sample.com/golf.html
Requisitos e recomendações
Este parâmetro é obrigatório para implementar a publicação de anúncios na Web e em apps para dispositivos móveis. Também é necessário se usar o Ad Exchange ou o AdSense para atribuição dinâmica.
Este parâmetro é recomendado para rentabilização programática.
Utilização do SDK
Este parâmetro não é definido automaticamente pelo SDK IMA. Tem de ser definido manualmente.
Consulte os guias do SDK IMA da sua plataforma.
env (Ambiente)
Descrição
O parâmetro de ambiente (env) aceita um valor constante que indica um pedido in-stream ou que o pedido é especificamente de um leitor de vídeo.
Os valores possíveis são instream, que pode ser utilizado para anúncios de vídeo e áudio, ou vp, que só pode ser utilizado para anúncios de vídeo.
Exemplos de utilização
Vídeo e/ou áudio:
env=instream
Apenas vídeo:
env=vp
Requisitos e recomendações
Este parâmetro é necessário para implementar a publicação de anúncios na Web, em apps para dispositivos móveis, em smart TVs, em áudio e em exteriores digitais.
Este parâmetro é necessário para criar relatórios precisos sobre o tipo de pedido detalhado por "Etiqueta de vídeo".
gdfp_req (Indicador do esquema)
Descrição
O parâmetro do indicador do esquema do Google Ad Manager (gdfp_req) aceita um valor constante que indica que o pedido de anúncio é para o inventário do Google Ad Manager.
Exemplos de utilização
gdfp_req=1
Requisitos e recomendações
Este parâmetro é necessário para implementar a publicação de anúncios na Web, em apps para dispositivos móveis, em smart TVs, em áudio e em exteriores digitais.
iu (Bloco de anúncios)
Descrição
O parâmetro do bloco de anúncios (iu) aceita um valor variável que deve ser definido para o bloco de anúncios atual, no formato: /network_code/.../ad_unit.
Exemplos de utilização
iu=/6062/videodemo
Requisitos e recomendações
Este parâmetro é necessário para implementar a publicação de anúncios na Web, em apps para dispositivos móveis, em smart TVs, em áudio e em exteriores digitais.
output (Saída)
Descrição
O parâmetro de formato de saída (output) aceita um valor constante que deve ser definido para o formato de saída do anúncio.
Exemplos de utilização
Use a versão VAST predefinida da sua rede:
output=vast
Use o VAST 4 (pode definir versões específicas para etiquetas específicas):
output=xml_vast4
Use a predefinição VMAP da sua rede:
output=vmap
Use o VMAP 1:
output=xml_vmap1
Use o VMAP 1, a devolver o VAST 4 (se devolver o VAST no VMAP):
output=xml_vmap1_vast4
Requisitos e recomendações
Este parâmetro é necessário para implementar a publicação de anúncios na Web, em apps para dispositivos móveis, em smart TVs, em áudio e em exteriores digitais. É necessário emitir o formato de resposta da publicação de anúncios correto.
Utilização do SDK
Para o VAST, se o seu leitor de vídeo utilizar o SDK para IMA, o parâmetro de saída de um pedido de anúncio de vídeo será sempre definido como output=xml_vast4. Isto não representa nenhum risco de fiabilidade, uma vez que o SDK é retrocompatível com todas as versões VAST que qualquer servidor de anúncios de terceiros pode fornecer.
sz (Tamanho)
Descrição
O parâmetro de tamanho (sz) aceita um valor variável que deve ser definido para o tamanho do espaço de anúncio de vídeo principal.
Os vários tamanhos devem ser separados pelo caráter de barra vertical (|).
Não inclua "v" depois do tamanho.
Exemplos de utilização
Tamanho único:sz=400x300
Vários tamanhos:sz=300x250|400x300
Requisitos e recomendações
Este parâmetro é necessário para implementar a publicação de anúncios na Web, em apps para dispositivos móveis, em smart TVs e em exteriores digitais.
Este parâmetro é opcional se apenas pedir ad_type=audio.
unviewed_position_start (Impressões atrasadas)
Descrição
O parâmetro de impressões atrasadas (unviewed_position_start) aceita um valor constante para indicar impressões atrasadas para o vídeo.
Exemplos de utilização
unviewed_position_start=1
Requisitos e recomendações
Este parâmetro é necessário para implementar a publicação de anúncios na Web e em apps para dispositivos móveis quando existe uma oportunidade de impressão atrasada.
url (URL)
Descrição
O parâmetro de URL (url) aceita um valor variável que deve ser definido para o URL completo a partir do qual é enviado o pedido. Este valor é necessário para ajudar os compradores a identificar e compreender o contexto da origem deste pedido. Na medida do possível, este valor deve ser preenchido dinamicamente no pedido de anúncio.
- Na Web, este é o URL da página que apresenta o leitor de vídeo.
- Em ambientes não baseado na Web, este valor deve ser definido para um URL que represente da forma mais exata o inventário de áudio ou vídeo a ser rentabilizado. Por exemplo, se o utilizador estiver a ver um vídeo numa app para dispositivos móveis que também está disponível num URL equivalente para computadores.*
Nota: url difere de description_url no sentido de que url refere-se à localização a partir da qual foi feito um pedido de anúncio, enquanto description_url é uma página rastreável pela Web que descreve o conteúdo do vídeo.
O valor deste parâmetro deve ser codificado.
Exemplos de utilização
url=https%3A%2F%2Fwww.example.com%2Fvideo.html
* Para as apps, se não for possível definir este parâmetro para um valor de URL variável, recomendamos o seguinte padrão: url=https%3A%2F%2F<app/bundleid>.example.com
Requisitos e recomendações
Este parâmetro é necessário para implementar a publicação de anúncios na Web, em apps para dispositivos móveis, em smart TVs, em áudio e em exteriores digitais.
Utilização do SDK
Se usar o SDK IMA, o valor do URL é definido automaticamente. Se o seu leitor definir este valor, o SDK IMA respeita o valor que é definido.
vpmute (Desativação do som da reprodução do vídeo)
Descrição
O parâmetro de reprodução de vídeo com o som desativado (vpmute) aceita um valor constante que indica se a reprodução do anúncio deve ser iniciada enquanto o leitor de vídeo tem o som desativado. Este parâmetro não altera o estado do leitor de vídeo. O comportamento de reprodução tem de ser processado diretamente pelo leitor de vídeo.
Exemplos de utilização
A reprodução começa com o som desativado:
vpmute=1
A reprodução começa com o som reativado:
vpmute=0
Requisitos e recomendações
Este parâmetro é necessário para a rentabilização programática na Web, apps para dispositivos móveis, smart TV, áudio e exteriores digitais.
Este parâmetro também é recomendado de acordo com as Diretrizes de medição de vídeo do Media Rating Council (MRC).
Parâmetros obrigatórios para programático
ott_placement (Formatos personalizados)
Descrição
O parâmetro de formatos personalizados (ott_placement) aceita um valor constante que indica um pedido de um posicionamento OTT não in-stream.
Definições de posicionamento para os exemplos abaixo:
- Pausa: formato outstream que aparece através de uma sobreposição sobre o conteúdo de vídeo quando um utilizador pausa a reprodução do conteúdo.
- Ecrã principal: anúncio apresentado no ecrã principal de um dispositivo CTV ou de uma app OTT. Isto inclui implementações de masthead, faixa e mosaico num ecrã principal.
- Ecrã no ecrã: anúncio de vídeo in-stream apresentado num leitor de vídeo de anúncios separado junto ao conteúdo de vídeo. Normalmente, requer a compressão do conteúdo de vídeo e o carregamento de um segundo leitor de vídeo.
- Faixa em L: anúncio de display in-stream que envolve a redução do conteúdo de vídeo e a criação de um anúncio à volta do vídeo. Normalmente, mas não limitado a, uma caixa de conteúdo do anúncio em forma de L.
- Sobreposição: qualquer formato de anúncio in-stream que apareça sobre o conteúdo de vídeo, mas que não ocupe o ecrã inteiro. Pode ser um anúncio de display ou vídeo.
Exemplos de utilização
Formatos compatíveis e os respetivos valores correspondentes:
Pausa:
cust_fmt=1
Ecrã principal:
cust_fmt=2
Ecrã no ecrã:
cust_fmt=3
Faixa L:
cust_fmt=4
Sobreposição:
cust_fmt=5
Personalizado/outro:
cust_fmt=99
Requisitos e recomendações
Este parâmetro só é obrigatório para a rentabilização programática na Web, em apps para dispositivos móveis e em smart TVs para publicadores que rentabilizam posicionamentos não padrão em ambientes de streaming OTT.
plcmt (Posicionamento)
Descrição
O parâmetro de posicionamento (plcmt) aceita um valor constante usado para indicar se o inventário in-stream é ou não declarado como "In-stream" ou "Complementar", de acordo com as orientações nas especificações do IAB.
Para os pedidos não in-stream, este campo é preenchido automaticamente para os compradores com base no formato de inventário declarado, que substitui qualquer declaração in-stream ou complementar.
Exemplos de utilização
Pedido de in-stream:
plcmt=1
Pedido de conteúdo complementar:
plcmt=2
Requisitos e recomendações
Este parâmetro é necessário para a rentabilização programática na Web, apps para dispositivos móveis, smart TV, áudio e exteriores digitais.
venuetype (Tipo de local)
Descrição
O parâmetro de tipo de local (venuetype) é usado para indicar o tipo de local exterior. Os valores elegíveis são os IDs de enumeração de números inteiros compatíveis com a taxonomia do tipo de local OpenOOH 1.1 do IAB.
Exemplos de utilização
Quartos de hotel:
venuetype=80703
Tablet no banco de trás de um táxi:
venuetype:103
Requisitos e recomendações
Este parâmetro é necessário para a rentabilização programática em exteriores digitais.
vpa (Reprodução automática do vídeo)
Descrição
O parâmetro automático de reprodução de vídeo (vpa) aceita um valor constante que indica se o conteúdo de vídeo num anúncio começa através de reprodução automática ou clique.
Os valores possíveis são click se a página aguardar por uma ação do utilizador ou auto se o vídeo for reproduzido automaticamente. Este parâmetro não altera o estado do leitor de vídeo. O comportamento de reprodução tem de ser processado diretamente pelo leitor de vídeo.
Exemplos de utilização
Reprodução automática:
vpa=auto
Clicar para reproduzir:
vpa=click
Este parâmetro não deve ser definido se for desconhecido.
Requisitos e recomendações
Este parâmetro é necessário para a rentabilização programática na Web, em apps para dispositivos móveis, em smart TVs e em áudio.
Este parâmetro também é recomendado de acordo com as Diretrizes de medição de vídeo do Media Rating Council (MRC).
Parâmetros recomendados para programático
aconp (Reprodução contínua do áudio)
Descrição
O parâmetro de reprodução de áudio contínuo (aconp) aceita um valor constante que indica se o leitor pretende reproduzir o conteúdo de áudio continuamente. Isto ajuda o Google Ad Manager a selecionar os anúncios mais adequados à experiência do utilizador.
Exemplos de utilização
Reprodução contínua ativada:
aconp=2
Reprodução contínua desativada:
aconp=1
Se não souber se o áudio é reproduzido continuamente, este parâmetro deve ser deixado indefinido ou definido como aconp=0.
Requisitos e recomendações
Embora este parâmetro não seja necessário para publicar anúncios em nenhuma implementação específica, é recomendado para a rentabilização programática na Web, apps para dispositivos móveis, smart TVs, áudio e exteriores digitais.
Este parâmetro também é recomendado de acordo com as Diretrizes de medição de áudio do Media Rating Council (MRC).
an (Nome da app)
Descrição
O parâmetro do ID da app (msid) e o parâmetro do nome da app (an) aceitam valores variáveis que devem ser aplicados aos pedidos enviados a partir de apps para dispositivos móveis e dispositivos smart TV, uma vez que a maioria dos anúncios de vídeo programáticos os exigem.
Embora o nome da app deva ser um nome legível, no iOS e tvOS, o SDK não consegue aceder ao ID da app. Nestes casos, o parâmetro msid não é enviado e o SDK envia o app bundle através do parâmetro an.
Exemplos de utilização
msid=com.package.publisher&an=sample%20app
Os IDs das apps têm nomes e formatos diferentes nas diferentes lojas de apps. Consulte as diretrizes do IAB para a identificação de apps ou os exemplos de identificadores únicos comuns.
Para plataformas em que não existe uma loja de apps, o IAB recomenda que os publicadores usem o seguinte formato para IDs de loja: com.publisher.deviceplatform
Requisitos e recomendações
Embora este parâmetro não seja necessário para publicar anúncios em nenhuma implementação específica, é recomendado para a rentabilização programática em apps para dispositivos móveis, smart TVs, áudio e exteriores digitais.
Para garantir a segurança da marca e permitir uma maior transparência aos compradores, recomendamos vivamente que inclua as informações da app.
Utilização do SDK
O SDK para IMA preenche automaticamente ambos os parâmetros, mas estes têm de ser especificados manualmente em ambientes não SDK, incluindo chamadas VAST diretas ou quando usar a Biblioteca de acesso programático (PAL) ou o Inventário autenticado pelo publicador (PAI).
Nota: se for usado o SDK IMA HTML5, as informações da app não são usadas.
dth (Instrução de tipo de dispositivo)
Descrição
O parâmetro de sugestão do tipo de dispositivo (dth) aceita um valor constante que ajuda a reduzir a classificação incorreta de dispositivos, especificamente em ambientes de smart TV e caixas descodificadoras.
A classificação incorreta do dispositivo pode resultar de erros não intencionais do publicador ou OEM de smart TV. Este parâmetro seria usado em conjunto com outros sinais para a Google sinalizar automaticamente instâncias em que o inventário de smart TV possa ser reclassificado.
Exemplos de utilização
Pedidos de:
- Telemóvel básico:
dth=1 - Smartphone:
dth=2 - Computador:
dth=3 - Tablet:
dth=4 - Smart TV:
dth=5 - Consola de jogos:
dth=6 - Caixa descodificadora:
dth=7
Requisitos e recomendações
Embora este parâmetro não seja necessário para publicar anúncios em nenhuma implementação específica, é recomendado para a rentabilização programática na Web, apps para dispositivos móveis, smart TVs, áudio e exteriores digitais.
Utilização do SDK
Este parâmetro é recomendado para implementações de PAL e PAI (não SDK). Não é necessário para o SDK IMA nem para o SDK DAI.
givn (Nonce de vídeo)
Descrição
Para integrações que usam a Biblioteca de acesso programático (PAL), o parâmetro nonce do vídeo aceita um valor de string variável.
O nonce é seguro para URLs e não precisa de o codificar em URL.
Nota: se forneceu anteriormente um nonce através do parâmetro antigo paln, recomendamos vivamente que migre para o parâmetro givn e deixe de enviar paln. Não inclua ambos os parâmetros.
Exemplos de utilização
Leia mais acerca do valor transmitido para este parâmetro nos manuais de introdução para a PAL.
Requisitos e recomendações
Embora este parâmetro não seja obrigatório para publicar anúncios em nenhuma implementação específica, é recomendado para a rentabilização programática na Web, apps para dispositivos móveis, smart TVs, áudio e exteriores digitais.
hl (Idioma)
Descrição
O parâmetro de idioma (hl) aceita um valor constante usado para pedir anúncios nesse idioma e para o idioma da seleção de anúncios e a renderização de anúncios de vídeo na atribuição dinâmica para vídeo do Ad Exchange ou do AdSense.
Exemplos de utilização
Pedir anúncios em italiano:
hl=it
O valor do parâmetro pode ser qualquer código ISO 639-1 (duas letras) ou ISO 639-2 (três letras). Consulte uma lista de códigos válidos.
Se estiver omitido, o valor assume a predefinição de qualquer idioma com segmentação de anúncios por idioma no Ad Exchange.
Requisitos e recomendações
Embora este parâmetro não seja necessário para publicar anúncios em nenhuma implementação específica, é recomendado para a rentabilização programática na Web, apps para dispositivos móveis, smart TVs, áudio e exteriores digitais.
msid (ID da app)
Descrição
O parâmetro do ID da app (msid) e o parâmetro do nome da app (an) aceitam valores variáveis que devem ser aplicados aos pedidos enviados a partir de apps para dispositivos móveis e dispositivos smart TV, uma vez que a maioria dos anúncios de vídeo programáticos os exigem.
Embora o nome da app deva ser um nome legível, no iOS e tvOS, o SDK não consegue aceder ao ID da app. Nestes casos, o parâmetro msid não é enviado e o SDK envia o app bundle através do parâmetro an.
Exemplos de utilização
msid=com.package.publisher&an=sample%20app
Os IDs das apps têm nomes e formatos diferentes nas diferentes lojas de apps. Consulte as diretrizes do IAB para a identificação de apps ou os exemplos de identificadores únicos comuns.
Para plataformas em que não existe uma loja de apps, o IAB recomenda que os publicadores usem o seguinte formato para IDs de loja: com.publisher.deviceplatform
Requisitos e recomendações
Embora este parâmetro não seja necessário para publicar anúncios em nenhuma implementação específica, é recomendado para a rentabilização programática em apps para dispositivos móveis, smart TVs, áudio e exteriores digitais.
Para garantir a segurança da marca e permitir uma maior transparência aos compradores, recomendamos vivamente que inclua as informações da app.
Utilização do SDK
O SDK para IMA preenche automaticamente ambos os parâmetros, mas estes têm de ser especificados manualmente em ambientes não SDK, incluindo chamadas VAST diretas ou quando usar a Biblioteca de acesso programático (PAL) ou o Inventário autenticado pelo publicador (PAI).
Nota: se for usado o SDK IMA HTML5, as informações da app não são usadas.
omid_p (Nome do parceiro da OMID)
Descrição
O parâmetro do nome do parceiro da OMID (omid_p) aceita um valor variável que indica o nome do parceiro que integra a medição da OMID e a versão do parceiro.
O parâmetro das APIs do SDK compatíveis (sdk_apis) aceita valores variáveis que podem ser uma lista única ou separada por vírgulas de APIs compatíveis.
Estes parâmetros fazem parte de um conjunto de parâmetros usados para a visibilidade e a validação de anúncios.
Exemplos de utilização
Quando não usar a PAL:
omid_p=examplepartnername/1.0.0.0&sdk_apis=7
Veja uma lista de valores possíveis da framework da API.
Quando usar a PAL:
request.omidPartnerName = 'examplepartnername'
request.omidPartnerVersion = '1.0.0.0'
Requisitos e recomendações
Embora este parâmetro não seja necessário para publicar anúncios em nenhuma implementação específica, é recomendado para a rentabilização programática na Web, apps para dispositivos móveis, smart TVs, áudio e exteriores digitais.
Utilização do SDK
- Este parâmetro aplica-se apenas a publicadores que querem a medição da Vista ativa quando usam o SDK de Open Measurement (SDK OM).
- Para indicar a compatibilidade com a OMID ao usar a Biblioteca de acesso programático (PAL), tem de usar as APIs
omidPartnerNameeomidPartnerVersionpara definir o nome e a versão do parceiro. Quando não estiver a usar o SDK para PAL ou IMA, tem de definir os parâmetrosomid_pesdk_apis. - Isto não deve ser usado com o SDK para IMA, uma vez que é definido automaticamente.
rdid (Identificador de dispositivo reajustável)
Descrição
Os parâmetros do identificador de dispositivo reajustável (rdid, idtype e is_lat) aceitam valores variáveis. Este valor também é conhecido como identificador de publicidade (IFA).
Com aplicações para dispositivos móveis que usam o SDK IMA para Android ou iOS, o SDK IMA transmite identificadores de dispositivos reajustáveis para segmentação de utilizadores nos seus pedidos de stream com os parâmetros para rdid, idtype e is_lat.
Quando o SDK IMA não é usado ou quando são usados beacons do lado do servidor (SSB), tem de transmitir estes parâmetros como parâmetros explícitos. Saiba mais acerca dos identificadores de dispositivos.
Quase todos os anúncios de vídeo programáticos requerem a presença destes valores.
|
A partir do iOS 14.5, a Apple descontinuou o sinal |
Exemplos de utilização
Veja exemplos detalhados de identificadores de dispositivos reajustáveis.
Requisitos e recomendações
Embora estes parâmetros não sejam necessários para publicar anúncios para qualquer implementação específica, são necessários para a rentabilização programática em apps para dispositivos móveis, smart TVs, áudio e exteriores digitais.
Para implementações da Web, não são usados identificadores de dispositivos reajustáveis.
Utilização do SDK
Apesar de o SDK IMA transmitir automaticamente este campo, os publicadores transmitem estes parâmetros manualmente quando usam o SDK PAL.
sid (ID da sessão)
Descrição
O parâmetro do ID da sessão (sid) aceita um valor variável que é um identificador de publicidade que preserva a privacidade usado apenas para limites de frequência.
O ID da sessão é compatível com pedidos de vídeo in-stream de smart TVs e no inventário de vídeo in-stream de dispositivos com apps para dispositivos móveis. Atualmente, não é compatível com a Web.
Pode optar por não transmitir o ID da sessão definindo sid=0.
Exemplos de utilização
sid=123e4567-e89b-12d3-a456-426614174000
De acordo com as diretrizes do IFA do IAB, este parâmetro tem de ser preenchido no formato UUID. Saiba mais acerca dos identificadores de dispositivos reajustáveis para a segmentação de utilizadores.
Requisitos e recomendações
Embora este parâmetro não seja necessário para publicar anúncios para qualquer implementação específica, é necessário para a rentabilização programática em exteriores digitais.
Este parâmetro é recomendado para a rentabilização programática em apps para dispositivos móveis, smart TVs e áudio.
Utilização do SDK
Este parâmetro é enviado automaticamente pelo SDK IMA.
vconp (Reprodução contínua do vídeo)
Descrição
O parâmetro de reprodução contínua de vídeo (vconp) aceita um valor constante que indica se o leitor tenciona reproduzir o conteúdo de vídeo continuamente, de forma semelhante a uma transmissão de TV.
Exemplos de utilização
Reprodução contínua ativada:
vconp=2
Reprodução contínua desativada:
vconp=1
Este parâmetro não deve ser definido se for desconhecido.
Requisitos e recomendações
Embora este parâmetro não seja necessário para publicar anúncios para qualquer implementação específica, é recomendado para a rentabilização programática na Web, em apps para dispositivos móveis, em smart TVs e em áudio.
Este parâmetro também é recomendado de acordo com as Diretrizes de medição de vídeo do Media Rating Council (MRC).
vid_d (Duração do vídeo)
Descrição
O parâmetro de 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 publicar anúncios de inserção intercalar sem carregamento de conteúdos. - É necessária a utilização de regras de anúncios para devolver inserções intercalares. Se forem usados pontos baseados em tempo nas suas regras de anúncios (por exemplo, "A cada N segundos" ou "Em tempos fixos"), são usados aqueles que estão definidos na regra de anúncios e os pontos transmitidos para
allcuessão ignorados. As inserções intercalares ainda precisam de uma duração, por isso, continua a ser necessário transmitir o parâmetrovid_d.
Exemplos de utilização
Duração do conteúdo de vídeo de 90 000 segundos (25 horas):
vid_d=90000
Requisitos e recomendações
Embora este parâmetro não seja necessário para publicar anúncios para qualquer implementação específica, é recomendado para a rentabilização programática na Web, em apps para dispositivos móveis e em smart TVs.
vpos (Posição do vídeo)
Descrição
O parâmetro da posição do vídeo (vpos) aceita um valor constante que indica se o pedido de anúncio está a ser enviado da inserção inicial, inserção intercalar ou inserção final.
Exemplos de utilização
Inserção inicial:
vpos=preroll
Inserção intercalar:
vpos=midroll
Inserção final:
vpos=postroll
Requisitos e recomendações
Embora este parâmetro não seja necessário para publicar anúncios para qualquer tipo de implementação específico, é recomendado para a rentabilização programática na Web, em apps para dispositivos móveis, em smart TVs e em áudio.
Se forem usadas regras de anúncios, este parâmetro não é necessário, uma vez que é adicionado automaticamente pelo servidor de anúncios.
wta (Porquê este anúncio?)
Descrição
O link "Porquê este anúncio?" (wta) aceita um valor constante que indica se o leitor de vídeo é compatível com a renderização de emblemas de anúncios.
Exemplos de utilização
Se o leitor deve renderizar o ícone do AdChoices facultado na resposta VAST, use:
wta=1(ou omita o parâmetrowtaou transmitawtasem um valor definido)Os pedidos de anúncios de áudio devem usar
wta=1se o ícone do AdChoices facultado na resposta VAST for renderizado em associados ou facultado de outra forma ao utilizador.
Se o leitor não deve renderizar o ícone do AdChoices facultado na resposta VAST, use:
wta=0
Requisitos e recomendações
Embora este parâmetro não seja necessário para publicar anúncios para qualquer tipo de implementação específico, é recomendado para a rentabilizaçã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 é elegível para determinados tipos de personalização da procura Google. - O tráfego com
&wta=0do EEE não é elegível para criativos com emblemas de anúncios ativados em elementos publicitários de reserva e Garantidos de forma programática geridos pelo publicador.
Os anúncios têm de estar em conformidade com os requisitos regulamentares aplicáveis para anúncios publicados no Espaço Económico Europeu (EEE). Isto inclui um mecanismo para os utilizadores denunciarem conteúdo ilegal. Os publicadores têm de notificar a Google acerca de quaisquer denúncias de conteúdo ilegal através do formulário Denunciar conteúdo no Google.
Utilização do SDK
A funcionalidade de emblemas de anúncios é admitida automaticamente quando se usa o SDK IMA. Quando o SDK IMA não é usado, os leitores de vídeo têm de implementar a compatibilidade deIcon e IconClickFallbackImage no VAST, conforme documentado na norma VAST do IAB.Outros parâmetros
Em geral, estes parâmetros não são explicitamente necessários para publicar anúncios, mas podem ser necessários para usar determinadas funcionalidades ou para determinados tipos de implementação.
ad_rule (Regra de anúncios)
Descrição
O parâmetro da regra de anúncios (ad_rule) aceita um valor constante que indica se deve ser devolvido um criativo VAST ou uma resposta das regras de anúncios.
A predefinição de regras de anúncios depende de uma definição de rede do Google Ad Manager, que permite que todos os pedidos sejam pedidos de regras de anúncios. Se a definição da rede for usada, não é necessário definir ad_rule na etiqueta do anúncio. Se quiser desativar com base num pedido de anúncio, pode transmitir ad_rule=0 para substituir a definição de rede. Além disso, se não tiver as regras de anúncios ativadas por predefinição, pode ativá-las/desativá-las transmitindo ad_rule=1 e ad_rule=0, respetivamente.
Exemplos de utilização
Se a definição de regras de anúncios estiver desativada:
- Pedido para o criativo VAST:
ad_rule=0ou não definir
Se a definição de regras de anúncios estiver ativada:
- Pedido para o criativo VAST:
ad_rule=0 - Pedido para regras de anúncios (VMAP):
ad_rule=1ou não definir
Se optar por não usar regras de anúncios, pode usar parâmetros da etiqueta do anúncio para indicar a duração da pausa para anúncios e do agrupamento para as etiquetas VAST através de pmnd, pmxd e pmad.
Requisitos e recomendações
Embora este parâmetro não seja necessário para publicar anúncios para qualquer tipo de implementação específico, é necessário para usar corretamente as regras de anúncios de vídeo.
addtl_consent (Consentimento adicional)
Descrição
O parâmetro Consentimento Adicional (addtl_consent) aceita valores variáveis e é uado por publicadores que querem integrar a TCF v2.0 do IAB e usar um fornecedor que ainda não está registado na Lista global de fornecedores do IAB Europe, mas está na lista de fornecedores de tecnologia de anúncios (ATP) da Google.
Pode ler mais acerca dos valores transmitidos para este parâmetro nas Especificações técnicas do Modo de Consentimento Adicional.
Exemplo de utilização
addtl_consent=1~1.35.41.101
adtest (Teste de anúncio)
Descrição
O parâmetro de teste de anúncios (adtest) deve ser usado para garantir que as consultas usadas para testar o inventário de preenchimento automático (não garantido) não são identificadas como tráfego inválido e não têm impacto na receita.
Quando testar o preenchimento automático, defina este parâmetro como on para garantir que os anúncios não registam impressões nem cliques para utilização durante os testes. Defina-o como off em ambientes que não sejam de teste para faturar normalmente. Se não for definido, este parâmetro tem a predefinição off.
Nota: quando testar elementos publicitários de venda direta, deve usar elementos publicitários de teste sem impacto na receita.
Exemplos de utilização
Ativado:
adtest=on
Desativado:
adtest=off
ad_type (Tipo de anúncio)
Descrição
O parâmetro do tipo de anúncio (ad_type) aceita um valor constante que indica os tipos de anúncios que devem ser devolvidos para o pedido.
Quando ad_type está definido como audio ou audio_video, o parâmetro vpmute tem de ser definido como 0.
Exemplos de utilização
Apenas permite anúncios de áudio:
ad_type=audio
Permite anúncios de vídeo ignoráveis e não ignoráveis:
ad_type=video
Permite anúncios de áudio e vídeo:
ad_type=audio_video
Este valor
audio_videopermite que ambos os formatos compitam, mas apenas um é publicado. Destina-se a ser usado apenas para publicar criativos de vídeo em conteúdo de áudio compatível com a reprodução de anúncios de vídeo ou criativos de áudio em leitores de vídeo in-stream para conteúdo que pode ser "audível" por natureza, como streams de desporto, videocasts, notícias, etc. Leia mais sobre o áudio em conteúdo de vídeo.
Apenas permite anúncios de vídeo ignoráveis:
ad_type=skippablevideo
Permite apenas anúncios de vídeo não ignoráveis:
ad_type=standardvideo
Requisitos e recomendações
- Se a sua app tiver conteúdo de vídeo, defina este parâmetro como
video,audio_videoou deixe-o indefinido. - Se a sua app tiver apenas conteúdo de áudio (por exemplo, uma app de rádio ou voz), tem de definir este parâmetro como
audio. Se não a definir, não são devolvidos anúncios de áudio.
afvsz (Tamanhos de anúncios não lineares)
Descrição
O parâmetro dos tamanhos de anúncios não lineares (afvsz) aceita valores constantes que devem ser uma lista separada por vírgulas de tamanhos de anúncios não lineares que podem ser apresentados no espaço do anúncio de vídeo.
Estes tamanhos têm de ser qualquer um dos suportados:
200 x 200250 x 250300 x 250336 x 280450 x 50468 x 60480 x 90729 x 90
Quando usar o SDK IMA, este campo é substituído e preenchido com todos os tamanhos compatíveis que pertençam a nonLinearAdSlotWidth e nonLinearAdSlotHeight.
Este parâmetro pode ser deixado de fora ou vazio quando não são suportados tamanhos não lineares.
Exemplos de utilização
Todos os tamanhos são compatíveis:
afvsz=200x200,250x250,300x250,336x280,
450x50,468x60,480x90,728x90
A largura máxima é de 250:
afvsz=200x200,250x250
A altura máxima é de 60:
afvsz=450x50,468x60
A largura máxima é de 100:
//empty; no values supported
Requisitos e recomendações
Embora este parâmetro não seja necessário para publicar anúncios para qualquer implementação ou tipo de transação específico, é necessário para publicar anúncios de vídeo não lineares quando não estiver a usar o SDK IMA.
allcues (Todos os sinais)
Descrição
O parâmetro all cues (allcues) aceita valores variáveis que são uma lista separada por vírgulas de pontos de anúncios, em milissegundos. Para cada valor, o Google Ad Manager devolve uma pausa para anúncios.
- Os parâmetros
vid_deallcuessão utilizados para publicar anúncios de inserção intercalar sem carregamento de conteúdo. - Também são necessárias regras de anúncios para devolver inserções intercalares. Se forem usados pontos baseados em tempo nas suas regras de anúncios (por exemplo, "A cada N segundos" ou "Em tempos fixos"), são usados aqueles que estão definidos na regra de anúncios e os pontos passados para
allcuessão ignorados. As inserções intercalares ainda precisam de uma duração, por isso, continua a ser necessário transmitir o parâmetrovid_d.
Exemplos de utilização
Pontos de anúncios aos 10 e 20 segundos:
allcues=10000,20000
ciu_szs (Tamanhos associados)
Descrição
O parâmetro de tamanhos associados (ciu_szs) aceita valores variáveis que são uma lista separada por vírgulas de tamanhos associados.
Os valores separados por uma barra vertical (|) indicam um espaço de anúncio com vários tamanhos.
Exemplos de utilização
ciu_szs=728x90,300x250
Tamanhos com um espaço com vários tamanhos:
ciu_szs=728x90,300x200|300x250
cmsid (ID da origem do conteúdo)
Descrição
O parâmetro do ID da origem do conteúdo (cmsid) e o parâmetro do ID do vídeo (vid) aceitam valores variáveis.
Para segmentar anúncios para conteúdo de vídeo, a etiqueta de vídeo principal tem de incluir ambos os parâmetros.
cmsidé um número exclusivo para cada fonte de conteúdo. Para o localizar no Google Ad Manager, clique em Vídeo, Origens de conteúdo e, de seguida, no nome da origem.vidé uma string ou um número que identifica um vídeo específico. Este ID é atribuído pelo CMS que aloja o conteúdo. Para o localizar no Google Ad Manager, clique em Vídeo, Conteúdo e, de seguida, no conteúdo de vídeo específico.
Exemplos de utilização
cmsid=[value]&vid=[value]
Se estiver a criar uma etiqueta para vídeo a pedido com Inserção de anúncios dinâmicos, deve usar as macros que vão inserir dinamicamente a origem do conteúdo e o ID do vídeo corretos.
Por exemplo: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%
Requisitos e recomendações
Embora estes parâmetros não sejam necessários para publicar anúncios para qualquer tipo de implementação ou transação específico, são necessários para usar a segmentação por conteúdo de vídeo.
cust_params (Parâmetros personalizados)
Descrição
O parâmetro de parâmetros personalizados (cust_params) aceita valores variáveis que são pares de chaves-valores que permitem definir uma segmentação específica, como dados demográficos, determinadas posições numa página ou uma página ou páginas específicas.
Exemplos de utilização
Veja exemplos de como adicionar pares de chave-valor.
excl_cat (Categoria de exclusão)
Descrição
O parâmetro da categoria de exclusão (excl_cat) aceita valores variáveis e é usado para bloquear quaisquer elementos publicitários com a etiqueta de exclusão no pedido de anúncio. Use o parâmetro cust_params para definir a categoria de exclusão e as etiquetas de exclusão.
Exemplos de utilização
Para definir a categoria de exclusão para 2 etiquetas de exclusão (airline_excl_label e train_excl_label), use um caráter de barra vertical (|) para separar as etiquetas:
excl_cat=airline_excl_label%7Ctrain_excl_label
Em seguida, aplique a codificação de URL e use a string codificada no parâmetro cust_params:
&cust_params=excl_cat%3Dairline_excl_label%7Ctrain_excl_label
gdpr (RGPD)
Descrição
O parâmetro do RGPD (gdpr) aceita valores constantes e é usado por publicadores que querem integrar a TCF v2.0 do IAB. Os pedidos VAST diretos não leem automaticamente os valores, mas são aceites quando adicionados às etiquetas de anúncios.
Apenas 0 e 1 são valores válidos para este parâmetro, em que 0 significa que o RGPD não se aplica e 1 significa que o RGPD se aplica. Se o RGPD se aplicar, também tem de indicar uma string de TC válida com o parâmetro gdpr_consent.
Pode ler mais acerca dos valores transmitidos para este parâmetro nas orientações gerais para implementar o framework ou na secção String de TC da especificação da TCF v2.0 do IAB.
Exemplos de utilização
Aplica-se o RGPD:
gdpr=1
Não se aplica o RGPD:
gdpr=0
gdpr_consent (Consentimento do RGPD)
Descrição
O parâmetro Consentimento do RGPD (gdpr_consent) aceita valores variáveis e é usado por publicadores que querem integrar a TCF v2.0 do IAB. Os pedidos VAST diretos não leem automaticamente os valores, mas são aceites quando adicionados às etiquetas de anúncios.
Pode ler mais acerca dos valores transmitidos para este parâmetro nas orientações gerais para implementar o framework ou na secção String de TC da especificação da TCF v2.0 do IAB.
Exemplos de utilização
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 separada por vírgulas de categorias.
Exemplos de utilização
iabexcl=3,14,527 exclui "Camiões comerciais", "Veículos todo-o-terreno" e "Râguebi".
Pode transferir uma lista das categorias da Taxonomia de conteúdo do IAB e dos respetivos IDs.
idtype (Tipo de dispositivo)
Descrição
Os parâmetros do identificador de dispositivo reajustável (rdid, idtype e is_lat) aceitam valores variáveis. Este valor também é conhecido como identificador de publicidade (IFA).
Com aplicações para dispositivos móveis que usam o SDK IMA para Android ou iOS, o SDK IMA transmite identificadores de dispositivos reajustáveis para segmentação de utilizadores nos seus pedidos de stream com os parâmetros para rdid, idtype e is_lat.
Quando o SDK IMA não é usado ou quando são usados beacons do lado do servidor (SSB), tem de transmitir estes parâmetros como parâmetros explícitos. Saiba mais acerca dos identificadores de dispositivos.
Quase todos os anúncios de vídeo programáticos requerem a presença destes valores.
|
A partir do iOS 14.5, a Apple descontinuou o sinal |
Exemplos de utilização
Veja exemplos detalhados de identificadores de dispositivos reajustáveis.
Requisitos e recomendações
Embora estes parâmetros não sejam necessários para publicar anúncios para qualquer implementação específica, são necessários para a rentabilização programática em apps para dispositivos móveis, smart TVs, áudio e exteriores digitais.
Para implementações da Web, não são usados identificadores de dispositivos reajustáveis.
Utilização do SDK
Apesar de o SDK IMA transmitir automaticamente este campo, os publicadores transmitem estes parâmetros manualmente quando usam o SDK 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 devem ser definidos como declarações inventorypartnerdomain no ficheiro app-ads.txt (ou ads.txt) do publicador.
O parâmetro inventorypartnerdomain é uma especificação do IAB que ajuda os publicadores a designar um domínio de um parceiro de partilha de inventário para fins de validação do ads.txt/app-ads.txt.
A declaração de IPD é particularmente importante em exemplos de utilização de partilha de inventário nos quais o inventário de anúncios em que um pedido tem origem pode ser propriedade de outro parceiro (o parceiro de partilha de inventário).
Saiba mais acerca do ads.txt/app-ads.txt e dos parceiros de partilha de inventário.
Exemplos de utilização
Oinventorypartnerdomain está no ficheiro app-ads.txt que aponta para o ficheiro .txt do parceiro que pode rentabilizar o inventário. O valor no parâmetro ipd deve corresponder a um valor no ficheiro app-ads.txt num dos itens inventorypartnerdomain.Requisitos e recomendações
Este parâmetro é necessário para publicadores que rentabilizam inventário que não lhes pertence.
ipe (Entidade de pings de impressão)
Descrição
O parâmetro da entidade de pings de impressão (ipe) aceita um valor constante que é usado para indicar conversões e pings de impressão que têm origem no servidor e não no cliente.
A entidade de pings de impressão é usada quando um servidor envia pings/beacons de impressão a partir do servidor.
Exemplos de utilização
Utilização de beacons do lado do servidor (SSB):
ipe=ssb
is_lat (Limitar acompanhamento de anúncios)
Descrição
Os parâmetros do identificador de dispositivo reajustável (rdid, idtype e is_lat) aceitam valores variáveis. Este valor também é conhecido como identificador de publicidade (IFA).
Com aplicações para dispositivos móveis que usam o SDK IMA para Android ou iOS, o SDK IMA transmite identificadores de dispositivos reajustáveis para segmentação de utilizadores nos seus pedidos de stream com os parâmetros para rdid, idtype e is_lat.
Quando o SDK IMA não é usado ou quando são usados beacons do lado do servidor (SSB), tem de transmitir estes parâmetros como parâmetros explícitos. Saiba mais acerca dos identificadores de dispositivos.
Quase todos os anúncios de vídeo programáticos requerem a presença destes valores.
|
A partir do iOS 14.5, a Apple descontinuou o sinal |
Exemplos de utilização
Veja exemplos detalhados de identificadores de dispositivos reajustáveis.
Requisitos e recomendações
Embora estes parâmetros não sejam necessários para publicar anúncios para qualquer implementação específica, são necessários para a rentabilização programática em apps para dispositivos móveis, smart TVs, áudio e exteriores digitais.
Para implementações da Web, não são usados identificadores de dispositivos reajustáveis.
Utilização do SDK
Apesar de o SDK IMA transmitir automaticamente este campo, os publicadores transmitem estes parâmetros manualmente quando usam o SDK PAL.
lip (Última posição no agrupamento)
Descrição
O parâmetro de última posição no agrupamento (lip) aceita um valor constante para indicar um pedido da última posição num agrupamento para segmentação ou relatórios.
Nota: este parâmetro não se aplica a agrupamentos otimizados e é ignorado se for usado.
Exemplos de utilização
lip=1
ltd (Anúncios limitados)
Descrição
O parâmetro de anúncios limitados (ltd) aceita um valor constante que indica se a publicação de anúncios deve ser limitada na ausência de consentimento para a utilização de cookies ou outros identificadores locais.
Este parâmetro é usado para indicar um pedido de anúncios limitados e é diferente do parâmetro is_lat. Desativa a personalização e a utilização de identificadores para esses fins.
ltd=1 altera o comportamento do SDK para IMA para processar o pedido como não tendo ID e não permitir o armazenamento.Exemplos de utilização
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, em conjunto, especificam o intervalo de duração a que um anúncio tem de corresponder, em milissegundos.
Este parâmetro pode ser usado para restringir os criativos a uma duração necessária na etiqueta do anúncio para anúncios únicos ou em pedidos de agrupamentos otimizados.
Exemplos de utilização
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, em conjunto, especificam o intervalo de duração a que um anúncio tem de corresponder, em milissegundos.
Este parâmetro pode ser usado para restringir os criativos a uma duração necessária na etiqueta do anúncio para anúncios únicos ou em pedidos de agrupamentos otimizados.
Exemplos de utilização
min_ad_duration=15000&max_ad_duration=30000
mridx (Número de inserção intercalar)
Descrição
O parâmetro do número da inserção intercalar (mridx) aceita um valor variável que indica o número ordinal da inserção intercalar (por exemplo, inserção intercalar 1, inserção intercalar 2, etc.).
Exemplos de utilização
mridx=2
Requisitos e recomendações
Embora este parâmetro não seja necessário para publicar anúncios para qualquer implementação ou tipo de transação específico, é necessário para segmentar uma inserção intercalar específica, criar relatórios sobre a inserção intercalar e fazer previsões sobre a inserção intercalar.
nofb (Sem alternativo)
Descrição
O parâmetro sem alternativo (nofb) aceita um valor constante para indicar que o pedido de anúncio não deve devolver uma playlist de anúncios de alternativo de vídeo.
Exemplos de utilização
Alternativo desativado:
nofb=1
O alternativo de anúncio único e o buffet de anúncios de agrupamento otimizado podem ser desativados por pedido de anúncio transmitindo nofb=1.
npa (Anúncio não personalizado)
Descrição
O parâmetro dos anúncios não personalizados (npa) aceita um valor constante para indicar que o pedido de anúncio deve ser tratado como não personalizado.
Tem de definir especificamente npa=1 ou incluir simplesmente npa (sem um valor definido) para etiquetar o pedido como não personalizado. Em pedidos de anúncio sem este parâmetro, ou definidos como npa=0, a predefinição será anúncios personalizados.
Exemplos de utilização
Anúncios não personalizados:
npa=1
Requisitos e recomendações
Este parâmetro só é necessário se o utilizador desativar a personalização. Os publicadores devem garantir que representam o estado exato do utilizador quando controlam o estado.
paln (Nonce da Biblioteca de acesso programático – antigo)
Descrição
Para integrações que usam a Biblioteca de acesso programático (PAL), o parâmetro nonce do vídeo aceita um valor de string variável.
O nonce é seguro para URLs e não precisa de o codificar em URL.
Nota: se forneceu anteriormente um nonce através do parâmetro antigo paln, recomendamos vivamente que migre para o parâmetro givn e deixe de enviar paln. Não inclua ambos os parâmetros.
Exemplos de utilização
Leia mais acerca do valor transmitido para este parâmetro nos manuais de introdução para a PAL.
Requisitos e recomendações
Embora este parâmetro não seja obrigatório para publicar anúncios em nenhuma implementação específica, é recomendado para a rentabilização programática na Web, apps para dispositivos móveis, smart TVs, áudio e exteriores digitais.
pmad (Máximo de anúncios num agrupamento)
Descrição
O parâmetro de número máximo de anúncios no agrupamento (pmad) aceita um valor variável que indica o número máximo de anúncios num agrupamento.
Este parâmetro limita o número total de anúncios num agrupamento otimizado, que é uma funcionalidade disponível para publicadores com um pacote de vídeo avançado.
Este parâmetro não deve ser usado para VMAP (quando ad_rule=1).
Exemplos de utilização
pmad=4
pmnd (Duração mínima do agrupamento)
Descrição
O parâmetro de duração mínima do agrupamento (pmnd) e o parâmetro de duração máxima do agrupamento (pmxd) aceitam valores variáveis que, em conjunto, especificam o intervalo de duração a que um agrupamento tem de corresponder, em milissegundos.
Estes parâmetros são usados para pedir vários anúncios num agrupamento otimizado, que é uma funcionalidade disponível para publicadores com um pacote de vídeo avançado. Quando são usadas regras de anúncios, o Google Ad Manager adiciona automaticamente estas informações.
Este parâmetro não deve ser usado para VMAP (quando ad_rule=1).
Exemplos de utilização
pmnd=0&pmxd=60000
pmxd (Duração máxima do agrupamento)
Descrição
O parâmetro de duração mínima do agrupamento (pmnd) e o parâmetro de duração máxima do agrupamento (pmxd) aceitam valores variáveis que, em conjunto, especificam o intervalo de duração a que um agrupamento tem de corresponder, em milissegundos.
Estes parâmetros são usados para pedir vários anúncios num agrupamento otimizado, que é uma funcionalidade disponível para publicadores com um pacote de vídeo avançado. Quando são usadas regras de anúncios, o Google Ad Manager adiciona automaticamente estas informações.
Este parâmetro não deve ser usado para VMAP (quando ad_rule=1).
Exemplos de utilização
pmnd=0&pmxd=60000
pmxfwt (Tempo de visualização forçado máximo do agrupamento)
Descrição
O parâmetro de tempo de visualização forçado máximo do agrupamento (pmxfwt) aceita um valor variável que especifica a duração máxima não ignorável de um agrupamento em milissegundos.
Se for compatível com agrupamentos com uma mistura de anúncios de vídeo não ignoráveis e ignoráveis, e quiser limitar o tempo de anúncios para os utilizadores, use este parâmetro para definir o tempo máximo de anúncios não ignoráveis que um utilizador tem de ver.
Nota: o parâmetro de duração máxima do agrupamento (pmxd) substitui este parâmetro na definição da duração total máxima do agrupamento (incluindo a duração total para anúncios ignoráveis).
Exemplo de utilização
pmxfwt=30000
pod (Número do agrupamento)
Descrição
O parâmetro do número do agrupamento (pod) aceita um valor variável que representa o número ordinal do agrupamento num vídeo (por exemplo, agrupamento 1, agrupamento 2, etc.).
Exemplos de utilização
pod=3
Requisitos e recomendações
Embora este parâmetro não seja necessário para publicar anúncios para qualquer implementação ou tipo de transação específico, é necessário para permitir a publicação do mesmo anúncio em diferentes agrupamentos e usar corretamente as exclusões competitivas, o limite de frequência e as funcionalidades relacionadas.
pp (Perfil do criativo)
Descrição
O parâmetro do perfil de criativo (pp) aceita um valor variável que controla os criativos elegíveis para serem publicados com base na configuração definida num perfil de criativo de vídeo e áudio.
Exemplos de utilização
pp=creative_profile
Requisitos e recomendações
Embora este parâmetro não seja necessário para publicar anúncios para qualquer implementação específica, é necessário para restringir os ficheiros multimédia para criativos alojados no Google Ad Manager com perfis de criativos de vídeo e áudio. Para redirecionamentos ou anúncios programáticos, isto é usado para garantir que o requisito está disponível, mas não restringe os ficheiros multimédia aos selecionados no perfil do criativo.
ppt (Publisher Privacy Treatment)
Descrição
O parâmetro de Tratamento de Privacidade do Publicador (ppt) aceita um valor constante que é usado para indicar se deve ser desativada a personalização de anúncios para o pedido de anúncio.
Este parâmetro oferece uma forma de aplicar anúncios não personalizados que podem ser diferentes de npa=1 e rdp=1. Afeta as reservas e a procura programática.
Saiba mais acerca do Tratamento de Privacidade para Publicadores.
Exemplos de utilização
Desative a personalização de anúncios:
ppt=1
ppid (Identificador fornecido pelo publicador)
Descrição
O parâmetro do identificador fornecido pelo publicador (ppid) aceita um valor variável do identificador usado no limite de frequência e na segmentação de público-alvo, bem como na segmentação, na rotação de anúncios sequencial e noutros controlos de fornecimento de anúncios baseados no público-alvo nos dispositivos.
Saiba mais acerca dos identificadores fornecidos pelo publicador.
Exemplos de utilização
ppid=12JD92JD8078S8J29SDOAKC0EF230337
Requisitos e recomendações
Embora este parâmetro não seja necessário para publicar anúncios para qualquer tipo de implementação ou transação específico, é necessário usar um identificador independente da plataforma consistente. Pode ser usado quando não estão presentes outros identificadores e pode ser facultado aos compradores.
ppos (Posição no agrupamento)
Descrição
O parâmetro de posição no agrupamento (ppos) aceita um valor variável que representa a posição num agrupamento (por exemplo, posição 1, posição 2, etc.).
Este parâmetro destina-se apenas a agrupamentos padrão e é necessário para o preenchimento automático associado. Quando são usadas regras de anúncios, o Google Ad Manager adiciona automaticamente estas informações.
Exemplos de utilização
ppos=2
Requisitos e recomendações
Embora este parâmetro não seja necessário para publicar anúncios para qualquer implementação ou tipo de transação específico, é necessário para agrupamentos padrão quando é necessária a segmentação por posição e para a previsão e os relatórios sobre agrupamentos padrão. Também é necessário usar corretamente as exclusões competitivas, o limite de frequência e as funcionalidades relacionadas.
ppsj (JSON de sinais fornecidos pelo publicador)
Descrição
O parâmetro JSON de sinais fornecidos pelo publicador (ppsj) aceita um valor variável, que é um objeto JSON codificado em base64 que contém dados de público-alvo e contextuais fornecidos pelo publicador para melhorar a rentabilização programática.
Este parâmetro pode ser usado para enviar determinados sinais aos compradores/licitadores.
Saiba mais sobre os sinais fornecidos pelo publicador e as taxonomias compatíveis.
Exemplos de utilização
Objeto JSON:
{
"PublisherProvidedTaxonomySignals": [{
"taxonomy": "IAB_AUDIENCE_1_1",
"values": ["6", "284"]
}]
}
Aplique o valor codificado em Base64:
eyJQdWJsaXNoZXJQcm92aWRlZFRheG9ub215U2l
nbmFscyI6W3sidGF4b25vbXkiOiJJQUJfQVVESUVOQ0V
fMV8xIiwidmFsdWVzIjpbIjEiLCIyODQiXX1dfQ
Veja os detalhes dos pares de chave-valor JSON válidos na
amostra do SDK IMA HTML5.
ptpl (ID do modelo de pausa para anúncios)
Descrição
O parâmetro de ID do modelo de pausa para anúncios (ptpl) e o parâmetro de nome (ptpln) aceitam valores variáveis que são usados para indicar o modelo de pausa para anúncios que deve ser aplicado ao pedido de agrupamento otimizado.
Os modelos de pausas para anúncios permitem configurar as posições de anúncios ou as posições de anúncios personalizadas que devem ser incluídas numa pausa para anúncios, bem como a ordem pela qual devem ser publicadas.
Apenas um destes parâmetros é necessário para pedir um modelo de pausa para anúncios.
Exemplos de utilização
Saiba como configurar e pedir modelos de pausas para anúncios.
Requisitos e recomendações
Estes parâmetros só são necessários se estiver a pedir diretamente um modelo de pausa para anúncios.
ptpln (Nome do modelo de pausa para anúncios)
Descrição
O parâmetro de ID do modelo de pausa para anúncios (ptpl) e o parâmetro de nome (ptpln) aceitam valores variáveis que são usados para indicar o modelo de pausa para anúncios que deve ser aplicado ao pedido de agrupamento otimizado.
Os modelos de pausas para anúncios permitem configurar as posições de anúncios ou as posições de anúncios personalizadas que devem ser incluídas numa pausa para anúncios, bem como a ordem pela qual devem ser publicadas.
Apenas um destes parâmetros é necessário para pedir um modelo de pausa para anúncios.
Exemplos de utilização
Saiba como configurar e pedir modelos de pausas para anúncios.
Requisitos e recomendações
Estes parâmetros só são necessários se estiver a pedir diretamente um modelo de pausa para anúncios.
pubf (Preços mínimos públicos em etiquetas do Ad Exchange)
Descrição
O preço mínimo público para o parâmetro do Ad Exchange (pubf) e o preço mínimo privado para o parâmetro do Ad Exchange (pvtf) aceitam valores de variáveis que são usados para adicionar preços mínimos às etiquetas do Ad Exchange.
Estes parâmetros são equivalentes a google_ad_public_floor e google_ad_private_floor.
Exemplos de utilização
Limite mínimo público:
pubf=123
Limite mínimo privado:
pvtf=123
Requisitos e recomendações
Estes parâmetros só estão disponíveis para publicadores no Espaço Económico Europeu ("EEE") ou na Suíça que tenham sido aprovados para usar a funcionalidade "Preço mínimo".
Saiba como enviar um pedido.
pvid (ID do conjunto de apps)
Descrição
O parâmetro do ID do conjunto de apps (pvid) aceita um valor variável definido como o ID do conjunto de apps Android e o parâmetro de âmbito do conjunto de apps (pvid_s) aceita um valor constante que representa o âmbito do ID do conjunto de apps (scope_app ou scope_developer).
Consulte a documentação do Android sobre como obter o ID do conjunto de apps.
Exemplos de utilização
pvid=[AppSetID_value]
pvid_s=scope_app
Requisitos e recomendações
Embora este parâmetro não seja necessário para publicar anúncios em nenhuma implementação específica, é recomendado para a rentabilização programática em apps para dispositivos móveis em dispositivos Android.
Utilização do SDK
Apesar de o SDK para IMA/PAL passar automaticamente este campo, os publicadores com implementações que não sejam do SDK têm de chamar o SDK do conjunto de apps e passar estes parâmetros manualmente no pedido do anúncio.
pvid_s (Âmbito do conjunto de apps)
Descrição
O parâmetro do ID do conjunto de apps (pvid) aceita um valor variável definido como o ID do conjunto de apps Android e o parâmetro de âmbito do conjunto de apps (pvid_s) aceita um valor constante que representa o âmbito do ID do conjunto de apps (scope_app ou scope_developer).
Consulte a documentação do Android sobre como obter o ID do conjunto de apps.
Exemplos de utilização
pvid=[AppSetID_value]
pvid_s=scope_app
Requisitos e recomendações
Embora este parâmetro não seja necessário para publicar anúncios em nenhuma implementação específica, é recomendado para a rentabilização programática em apps para dispositivos móveis em dispositivos Android.
Utilização do SDK
Apesar de o SDK para IMA/PAL passar automaticamente este campo, os publicadores com implementações que não sejam do SDK têm de chamar o SDK do conjunto de apps e passar estes parâmetros manualmente no pedido do anúncio.
pvtf (Preços mínimos privados em etiquetas do Ad Exchange)
Descrição
O preço mínimo público para o parâmetro do Ad Exchange (pubf) e o preço mínimo privado para o parâmetro do Ad Exchange (pvtf) aceitam valores de variáveis que são usados para adicionar preços mínimos às etiquetas do Ad Exchange.
Estes parâmetros são equivalentes a google_ad_public_floor e google_ad_private_floor.
Exemplos de utilização
Limite mínimo público:
pubf=123
Limite mínimo privado:
pvtf=123
Requisitos e recomendações
Estes parâmetros só estão disponíveis para publicadores no Espaço Económico Europeu ("EEE") ou na Suíça que tenham sido aprovados para usar a funcionalidade "Preço mínimo".
Saiba como enviar um pedido.
rdp (Tratamento de dados restrito)
Descrição
O parâmetro de tratamento de dados restrito (rdp) aceita um valor constante para indicar que o pedido de anúncio deve restringir o tratamento de dados.
Pode restringir o tratamento de dados ao nível da rede ativando a definição de rede Restringir o tratamento de dados.
Exemplos de utilização
Restringir o tratamento de dados:
rdp=1 ou rdp (sem um valor definido)
Não restringir o tratamento de dados:
rdp=0
schain (Cadeia de abastecimento)
Descrição
O parâmetro da cadeia de abastecimento (schain) aceita um valor variável que deve ser serializado como objeto SupplyChain. Quando este parâmetro está incluído, a Google anexa um nó a todos os objetos schain recebidos antes de os enviar aos compradores.
Consulte a documentação completa do IAB para comunicar informações do objeto SupplyChain através de uma etiqueta (em vez do OpenRTB).
Consulte os requisitos para que oschain seja analisado corretamente
Com base na documentação do IAB, o seguinte define a serialização do objeto SupplyChain:
{SupplyChainObject}!{SupplyChainNode array}. As propriedades do SupplyChainObjecte doSupplyChainNodesão delimitadas por vírgulas, de modo a que os campos opcionais possam ser omitidos e os separadores de vírgulas possam ser excluídos opcionalmente.- Cada elemento
SupplyChainNodeé separado por um "!". - Se o valor de qualquer propriedade contiver carateres que requerem codificação por URL (por exemplo, "
," ou "!"), o valor deve ser codificado por URL antes da serialização.
Ordem de serialização
As propriedades do SupplyChainObject são serializadas nesta ordem:
ver,complete
As propriedades do SupplyChainNode são serializadas nesta ordem:
asi,sid,hp,rid,name,domain,ext
ext é específico da troca. O Google Ad Manager não analisa esta propriedade.Exemplos de como serializar o objeto SupplyChain
Seguem-se 2 exemplos de formas de serializar o objeto SupplyChain acima:
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
Exemplos de utilização
schain=1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
Se o valor de asi fosse exchange,1, a serialização com carateres de escape teria o seguinte aspeto:
1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
Requisitos e recomendações
Embora este parâmetro não seja necessário para publicar anúncios para qualquer tipo de implementação ou transação específico, é necessário para publicadores que usam intermediários de pagamento upstream do pedido para o Google Ad Manager. Isto inclui publicadores que usam tecnologia de servidores de anúncios de terceiros.
scor (Correlator de streams)
Descrição
O parâmetro do correlator de streams (scor) aceita um valor variável que deve ser um número inteiro gerado para cada stream de vídeo.
Os parâmetros score e correlator não têm de ter o mesmo valor inteiro. No entanto, devem manter os respetivos valores ao longo de cada reprodução da stream de vídeo para identificar uma sessão de visualização única.
Exemplos de utilização
scor=17
Requisitos e recomendações
Embora este parâmetro não seja necessário para publicar anúncios para qualquer tipo de implementação ou transação específico, é recomendado para a publicação de anúncios na Web, em apps para dispositivos móveis, em smart TVs, em áudio e em exteriores digitais.
Este parâmetro é usado para exclusões competitivas, limites de frequência e funcionalidades relacionadas quando um utilizador está a ver vários vídeos na mesma página.
sdk_apis (Framework da API do SDK)
Descrição
O parâmetro da framework da API do SDK (sdk_apis) aceita uma lista separada por vírgulas de valores inteiros constantes, que indicam todas as frameworks da API com as quais o leitor é compatível.
Requisitos e recomendações
Utilização do SDK
Este parâmetro é usado por publicadores que usam a Biblioteca de acesso programático (PAL). Se tentar definir valores para este parâmetro enquanto usa o SDK IMA, os valores são substituídos pelos valores compatíveis com o SDK IMA.
sdmax (Duração máx. do anúncio ignorável)
Descrição
O parâmetro de duração máxima de anúncios ignoráveis (sdmax) aceita um valor variável que permite aos publicadores especificar a duração máxima de anúncios pretendida para os anúncios ignoráveis.
Tem uma duração em milissegundos que representa o limite superior que deve ser permitido para a duração dos criativos de vídeo/áudio ignoráveis para esse pedido de anúncio específico.
Use sdmax de forma independente para anúncios ignoráveis ou em combinação com o parâmetro max_ad_duration existente para indicar diferentes durações máximas para anúncios ignoráveis e não ignoráveis.
Exemplos de utilização
Através das seguintes definições:
max_ad_duration= 15000 (15 segundos)sdmax= 45000 (45 segundos)
Para os seguintes criativos:
- Criativo A: não ignorável; 30 s
- Criativo B: ignorável; 30 s
Ocorre o seguinte:
- O criativo A é filtrado porque não é ignorável e a respetiva duração excede o máximo (não ignorável).
- O criativo B não é filtrado porque, embora a respetiva duração exceda o parâmetro
max_ad_duration, é ignorável e a respetiva duração não excede o máximo ignorável.
ssss (Origem da edição do lado do servidor)
Descrição
O parâmetro de origem da edição do lado do servidor (ssss) aceita um valor constante que deve ser definido como um valor reconhecido fornecido pela Google para o fornecedor da tecnologia de edição de vídeos.
Os fornecedores de tecnologia de edição de vídeo que usam integrações servidor a servidor com a Google recebem este valor da Google e podem fornecê-lo a si. Pode contactar o seu gestor de contas da Google para esclarecer quaisquer dúvidas sobre o valor a definir para este parâmetro.
Exemplos de utilização
ssss=mystitcher
Requisitos e recomendações
Embora este parâmetro não seja necessário para publicar anúncios para qualquer tipo de implementação ou transação específico, é necessário para usar implementações do lado do servidor.
tfcd (Etiqueta para tratamento dirigido a crianças)
Descrição
O parâmetro de tratamento dirigido a crianças (tfcd) aceita um valor constante que indica que o pedido deve ser tratado como dirigido a crianças.
Exemplos de utilização
tfcd=1
trt (Tipo de tráfego)
Descrição
O parâmetro do tipo de tráfego (trt) aceita um valor constante que funciona para pedir tráfego comprado ou orgânico.
Exemplos de utilização
Pedido de tráfego comprado:
trt=1
Pedido de tráfego orgânico:
trt=2
Requisitos e recomendações
Utilização do SDK
O SDK IMA não preenche um valor predefinido se o parâmetro do tipo de tráfego estiver em falta num pedido. Nestes casos, o servidor fornece um valor predefinido de 0 (tráfego não definido).
us_privacy (Privacidade dos EUA do IAB)
Descrição
A stringus_national foi descontinuada pelo IAB a favor da GPP. No entanto, o Ad Manager continua a ler e respeitar a string se for transmitida para fins de retrocompatibilidade. Recomendamos que os publicadores revejam a GPP ou outros controlos de privacidade e migrem de us_national.
vad_type (Tipo de anúncio de vídeo)
Descrição
O parâmetro do tipo de anúncio de vídeo (vad_type) aceita um valor constante que indica se deve ser devolvido um anúncio linear ou não linear.
Exemplos de utilização
Devolver um anúncio linear:
vad_type=linear
Devolver um anúncio não linear:
vad_type=nonlinear
vid (ID do vídeo)
Descrição
O parâmetro do ID da origem do conteúdo (cmsid) e o parâmetro do ID do vídeo (vid) aceitam valores variáveis.
Para segmentar anúncios para conteúdo de vídeo, a etiqueta de vídeo principal tem de incluir ambos os parâmetros.
cmsidé um número exclusivo para cada fonte de conteúdo. Para o localizar no Google Ad Manager, clique em Vídeo, Origens de conteúdo e, de seguida, no nome da origem.vidé uma string ou um número que identifica um vídeo específico. Este ID é atribuído pelo CMS que aloja o conteúdo. Para o localizar no Google Ad Manager, clique em Vídeo, Conteúdo e, de seguida, no conteúdo de vídeo específico.
Exemplos de utilização
cmsid=[value]&vid=[value]
Se estiver a criar uma etiqueta para vídeo a pedido com Inserção de anúncios dinâmicos, deve usar as macros que vão inserir dinamicamente a origem do conteúdo e o ID do vídeo corretos.
Por exemplo: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%
Requisitos e recomendações
Embora estes parâmetros não sejam necessários para publicar anúncios para qualquer tipo de implementação ou transação específico, são necessários para usar a segmentação por conteúdo de vídeo.
vpi (Playlist de vídeo inline)
Descrição
O parâmetro inline da playlist de vídeo (vpi) aceita um valor constante que indica se deve publicar o VMAP inline (devolver o VAST no VMAP).
Este parâmetro pode ser usado para reduzir a latência e garantir limites de frequência e exclusões competitivas numa stream de vídeo.
Exemplos de utilização
Devolver o VAST:
vpi=1
Devolver redirecionamentos:
vpi=0