A implementação de uma solução de vídeo baseada em etiquetas para a procura do Ad Exchange sem a utilização do SDK para IMA é uma oferta beta e pode não estar disponível para a sua rede. Pode contactar o seu gestor de conta para obter mais informações.
Este artigo mostra uma lista de parâmetros obrigatórios e recomendados para etiquetas dos anúncios VAST usadas para publicar anúncios em implementações de apps para dispositivos móveis.
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 programático
Parâmetros obrigatórios e recomendados para a app para dispositivos móveis
Parâmetros obrigatórios para a publicação de anúncios
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
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.
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.
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.
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.
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 de á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.
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.
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.