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 smart TVs.
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
Pode rever as listas para outros tipos de implementações ou os requisitos de URL para etiquetas dos anúncios VAST.
Parâmetros obrigatórios e recomendados para smart TVs
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.
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 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, devolvendo 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 gerar o formato de resposta de 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.
Versão VAST para o Authorized Buyers e o Open Bidding
Se quiser filtrar rigorosamente com base na versão VAST do Authorized Buyers e do Open Bidding, pode ativar a definição "Filtrar rigorosamente a versão VAST" nas definições de rede.
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.
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 é apenas necessário para a rentabilização programática na Web, apps para dispositivos móveis, smart TV, áudio e publicidade digital no exterior.
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.
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
O SDK IMA transmite automaticamente este campo, a menos que o idType esteja definido como dpid. Neste caso, o publicador tem de transmitir manualmente o parâmetro rdid.
Os publicadores têm de transmitir 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
O SDK IMA transmite automaticamente este campo, a menos que o idType esteja definido como dpid. Neste caso, o publicador tem de transmitir manualmente o parâmetro rdid.
Os publicadores têm de transmitir estes parâmetros manualmente quando usam o SDK PAL.
ott_placement (Posicionamento OTT)
Descrição
O parâmetro de posicionamento OTT (ott_placement) aceita um valor constante que indica um pedido de um tipo específico de posicionamento.
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 reproduzido num leitor de vídeo de anúncios separado junto ao conteúdo de vídeo. Normalmente, requer a redução do conteúdo de vídeo e o carregamento de um segundo leitor de vídeo.
- Banner em forma de L: anúncio de display in-stream que envolve reduzir o conteúdo de vídeo e criar um anúncio em torno 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 apresentado sobre o conteúdo de vídeo, mas que não ocupa o ecrã inteiro. Pode ser um anúncio de display ou de vídeo.
Exemplos de utilização
Formatos compatíveis e os respetivos valores correspondentes:
Pausa:
ott_placement=1
Ecrã principal:
ott_placement=2
Ecrã no ecrã:
ott_placement=3
Faixa em L:
ott_placement=4
Sobreposição:
ott_placement=5
Personalizado/outro:
ott_placement=99
Requisitos e recomendações
Este parâmetro é apenas necessá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
O SDK IMA transmite automaticamente este campo, a menos que o idType esteja definido como dpid. Neste caso, o publicador tem de transmitir manualmente o parâmetro rdid.
Os publicadores têm de transmitir 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).
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 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.
O nome da app deve ser um nome legível.
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 a segurança da marca e para permitir uma maior transparência aos compradores, é altamente recomendável incluir as informações da app.
Utilização do SDK
Com exceção do iOS e tvOS, o SDK 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).
No iOS e tvOS, o SDK IMA ou o PAL não conseguem 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.
Nota: se for usado o SDK IMA HTML5, as informações da app não são usadas.
ct_ch (canal de conteúdo)
Descrição
O parâmetro do canal de conteúdo aceita um valor variável relativo ao canal do conteúdo no qual o anúncio vai ser apresentado. Um canal é definido como a entidade que organiza uma biblioteca de conteúdo ou uma stream com o nome de uma marca para os visitantes.
Este parâmetro pode ser usado para expor mais transparência aos compradores como parte dos sinais de programação de vídeo nos sinais fornecidos pelo publicador.
Veja a definição do IAB de canal de conteúdo.
ct_ch=CNN International
ct_ch=ESPN2
ct_ne (rede de conteúdo)
Descrição
O parâmetro da rede de conteúdo aceita um valor variável relativo à rede do conteúdo no qual o anúncio vai ser apresentado. Uma rede é uma organização de transmissão que detém ou licencia uma grande quantidade de conteúdo e distribui-o numa área alargada.
Este parâmetro pode ser usado para expor mais transparência aos compradores como parte dos sinais de programação de vídeo nos sinais fornecidos pelo publicador.
Veja a definição de rede de conteúdo do IAB.
ct_ne=WarnerMedia
ct_ne=ABCct_se (série de conteúdo)
Descrição
O parâmetro da série de conteúdo aceita um valor variável relativo à série do conteúdo no qual o anúncio vai ser apresentado.
Este parâmetro pode ser usado para expor mais transparência aos compradores como parte dos sinais de programação de vídeo nos sinais fornecidos pelo publicador.
ct_se=game_of_thrones
ct_se=NBA_playoffsct_ti (título do conteúdo)
Descrição
O parâmetro do título do conteúdo aceita um valor variável relativo ao título do conteúdo no qual o anúncio vai ser apresentado.
Este parâmetro pode ser usado para expor mais transparência aos compradores como parte dos sinais de programação de vídeo nos sinais fornecidos pelo publicador.
ct_ti=game_of_thrones_s1e2
ct_ti=lakers_vs_celticsdth (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, em apps para dispositivos móveis, em ambientes de smart TVs e caixas descodificadoras, em áudio e em publicidade digital no exterior.
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.
O nome da app deve ser um nome legível.
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 a segurança da marca e para permitir uma maior transparência aos compradores, é altamente recomendável incluir as informações da app.
Utilização do SDK
Com exceção do iOS e tvOS, o SDK 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).
No iOS e tvOS, o SDK IMA ou o PAL não conseguem 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.
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 do â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 para qualquer implementação específica, é recomendado para a rentabilização programática em apps para dispositivos móveis em dispositivos Android, incluindo CTVs (Android TV) baseadas em apps.
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 do â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 para qualquer implementação específica, é recomendado para a rentabilização programática em apps para dispositivos móveis em dispositivos Android, incluindo CTVs (Android TV) baseadas em apps.
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
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 publicidade digital no exterior.
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.