Forneça parâmetros de segmentação para a sua stream

O fornecimento de quaisquer dos seguintes parâmetros de segmentação é opcional.

Ao criar ou configurar uma fonte de conteúdo para vídeo a pedido (VOD) ou configurar uma stream em direto para DAI, tem de especificar uma etiqueta do anúncio de vídeo predefinida. Todas as streams DAI utilizam essa etiqueta do anúncio e os respetivos parâmetros por predefinição. Os parâmetros da etiqueta do anúncio aplicam-se às inserções intercalares e inserções iniciais. Se pretender que o seu leitor solicite algo exclusivo para uma determinada stream, estão disponíveis estas opções.

Parâmetros da etiqueta do anúncio do Ad Manager que podem ser substituídos

Avance para um parâmetro específico:

addtl_consent an ciu_szs cust_params description_url gdpr gdpr_consent givn|paln idtype is_lat iu

iu is_lat ltd mpt mpv npa omid_p ppid ptpl ptpln rdid rdid

rdp sdk_apis sid sz tfcd trt vconp vpa vpmute wta

 

Substitua a etiqueta do anúncio predefinida

Se o seu leitor de vídeo solicitar uma stream, a etiqueta do anúncio predefinida é utilizada exatamente como especificado na interface. No entanto, tem a possibilidade de substituir determinados parâmetros dessa etiqueta no pedido de stream. Estes são os únicos parâmetros que podem ser substituídos.

Saiba como substituir a etiqueta do anúncio predefinida através do SDK para IMA ou do SSB.

Parâmetro	Descrição	Valor do exemplo
iu	Bloco de anúncios atual. Tem de seguir o formato: /network_id/directory/ad_unit	iu=/6062/video/example_unit
cust_params	Pares de chave-valor que devem ser utilizados para segmentação de campanhas do Ad Manager. Algumas plataformas precisam de codificação URL. O requisito de codificação de URL não se aplica quando usar o SDK de DAI para IMA para HTML5, uma vez que o valor é codificado automaticamente. Este parâmetro não funciona se já estiver codificado em HTML5.	Exemplos com vários pares de chave-valor, tais como: section=sports  page=golf,tennis   Streams SSB: codifique e concatene todo o valor de cust_params, mas não codifique duas vezes. cust_params=   "section%3Dsports   %26page%3Dgolf%2Ctennis"   Chromecast: Codifique apenas os valores. streamRequest. adTagParameters = {   "cust_params":   "section=sports&   multi=golf%2Ctennis"};   Roku: codifique e concatene todo o valor de cust_params, mas não codifique duas vezes. request.adTagParameters =   "cust_params=   section%3Dsports   %26page%3Dgolf%2Ctennis"   iOS e tvOS: não codifique nada. request.adTagParameters = @{   @"cust_params" :   @"section=sports&   multi=golf,tennis"};   Android: não codifique nada. Map<String, String> adTagParams =   new HashMap<>();   adTagParams.put(   "cust_params",   "ge=0&gr=2");
sz	Substitui o parâmetro sz da sua etiqueta do anúncio predefinida, permitindo mudar dinamicamente para dispositivos diferentes. Não inclua "v" depois do tamanho.	sz=400x300
tfcd	Etiquete um pedido para tratamento dirigido a crianças. Quando um pedido de DAI inclui tfcd=1, todos os valores atribuídos aos parâmetros rdid, idtype ou is_lat são removidos para estar em conformidade com a COPPA.	tfcd=1
description_url	O valor deve descrever o vídeo em reprodução na página. Geralmente, é a página que aloja o leitor de vídeo, mas também pode ser uma página com texto descritivo do vídeo. Tem de codificar sempre o URL de description_url nas streams SSB e quando utilizar o SDK de DAI para IMA para o Roku. Este requisito não se aplica ao utilizar o SDK de DAI para IMA para HTML5, uma vez que o valor é codificado automaticamente. Este parâmetro não funciona se já estiver codificado em HTML5. Este parâmetro não é definido automaticamente pelo SDK para IMA. Tem de ser definido manualmente. Este campo é obrigatório se utilizar o Ad Exchange. Saiba mais	Exemplo de URL codificado: description_url= http%3A%2F%2Fwww.sample.com %2Fgolf.html Exemplo não codificado: description_url= http://www.sample.com/ golf.html
ppid	O identificador fornecido pelo publicador (PPID) permite que os publicadores enviem um identificador para ser utilizado para efeitos de limite de frequência, segmentação de público-alvo, rotação sequencial de anúncios e outros controlos de fornecimento de anúncios baseados no público-alvo em vários dispositivos. Saiba mais	ppid= 12JD92J...
ciu_szs	Lista separada por vírgulas de tamanhos de anúncios associados. Os anúncios associados são suportados apenas com DAI quando utiliza o SDK para HTML5.	ciu_szs=728x90,300x250
mpt	Indica o nome do leitor do parceiro. Pode ser usado por parceiros como o JWPlayer, o Brightcove e o Ooyala, que estão a ser integrados com o SDK.	mpt=JWPlayer
mpv	Indica a versão do leitor do parceiro. Só deve ser definido se o mpt também estiver definido e representa a versão do leitor do parceiro que está a ser integrado com o SDK.	mpv=2.1
ptpl	O ID do modelo de pausa para anúncios. Pode encontrar este ID no URL do Ad Manager quando visualizar as definições do modelo de pausa na interface do Ad Manager. É apresentado como o valor do parâmetro break_template_id.	ptpl=1234
ptpln	O nome do modelo de pausa para anúncios. Corresponde ao campo "Nome" no Ad Manager, não ao nome a apresentar.	ptpln=my_break_template
an	O parâmetro an é o nome da app. Deve ser aplicado a pedidos enviados a partir de apps para dispositivos móveis e dispositivos de TV ligada, uma vez que a maioria dos anúncios de vídeo programáticos o exige.* O SDK para IMA preenche isto automaticamente, mas tem de ser especificado manualmente com o SSB e a API de DAI (ambientes não SDK). * Embora o nome da app deva ser um nome legível por humanos, no iOS e tvOS, o SDK não consegue aceder ao ID da App Store de 9 dígitos. Nestes casos, o SDK envia o app bundle através do parâmetro an (no formato com.package.publisher).	an=sample%20app
ltd	Indica se os anúncios devem ser publicados de forma limitada na ausência de consentimento para a utilização de cookies ou outros identificadores locais. Saiba mais	ltd=1
rdid idtype is_lat	Com aplicações nativas (não disponíveis na Web nem na Web para dispositivos móveis), o SDK passa 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. Nas streams SSB, deve transmiti-los como parâmetros explícitos, tal como faria num pedido de anúncio de Soluções de vídeo do lado do cliente. A partir do iOS 14.5, a Apple descontinuou o sinal LAT. Em vez disso, a Google baseia-se na presença de um IDFA diferente de zero para indicar que o utilizador deu o seu consentimento para o acompanhamento em versões do iOS que suportem a App Tracking Transparency. Como tal, é necessário um UserAgent válido que indique a versão correta do SO.	Veja exemplos detalhados de identificadores de dispositivos reajustáveis.
trt	Designa o tráfego como comprado ou de outra forma.	Tipo de tráfego não definido: trt=0 Tráfego comprado: trt=1 Tráfego orgânico: trt=2
vconp	Recomendado de acordo com MRC Diretrizes da medição de vídeo Indica se o leitor pretende reproduzir continuamente os vídeos de conteúdo um após o outro, semelhante a uma transmissão de TV. Os valores possíveis são 2 se a reprodução contínua estiver ATIVADA e 1 se estiver DESATIVADA. Este parâmetro não deve ser definido se for desconhecido.	Reprodução contínua ATIVADA: vconp=2   Reprodução contínua DESATIVADA: vconp=1
vpa	Recomendado de acordo com MRC Diretrizes da medição de vídeo Indica se o anúncio começa por 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 deve ser definido se for desconhecido.	Reprodução automática: vpa=auto   Clique: vpa=click
vpmute	Recomendado de acordo com MRC Diretrizes da medição de vídeo Indica se a reprodução do anúncio começa enquanto o som do leitor de vídeo estiver desativado. Os valores possíveis são 1 para som desativado e 0 para som não desativado. Este parâmetro não deve ser definido se for desconhecido.	Som desativado: vpmute=1   Som reativado: vpmute=0
npa	A definição de personalização para pedidos de anúncios. Deve especificar o parâmetro no início da etiqueta para evitar qualquer risco de truncagem. Especifique npa=1 para marcar o pedido de anúncio como não personalizado. Em caso de omissão do parâmetro, assumem-se os anúncios personalizados como predefinição.	npa=1
omid_p	O parâmetro do nome do parceiro do OMID aceita um valor variável que indica o nome do parceiro que integra a medição de OMID e a versão do parceiro. 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). Isto não deve ser usado com o SDK para IMA, uma vez que é definido automaticamente. Para indicar o suporte de OMID ao usar a Biblioteca de acesso programático (PAL), tem de usar as APIs omidPartnerName e omidPartnerVersion para definir o nome e a versão do parceiro. Quando não estiver a usar a PAL ou a IMA, tem de definir os parâmetros omid_p e sdk_apis (as APIs suportadas, que também podem incluir outras APIs separadas por vírgulas).	Ao usar a PAL: request.omidPartnerName = 'examplepartnername' request.omidPartnerVersion = '1.0.0.0' Quando não usar a PAL: omid_p=examplepartnername/1.0.0.0&sdk_apis=7
gdpr gdpr_consent	Estes campos são usados para transmitir informações de consentimento da TCF (Estrutura de Transparência e Consentimento) v2.0 em pedidos de sincronização de cookies recebidos e enviados.	Veja as especificações do RGPD.
givn|paln	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 URL e não precisa de o codificar em URL. Nota: se forneceu anteriormente um nonce através do parâmetro paln antigo, recomendamos vivamente que migre para o parâmetro givn e deixe de enviar paln. Não inclua ambos os parâmetros.	Pode ler mais acerca do valor transmitido para este parâmetro nos manuais de introdução para a PAL.
addtl_consent	Uma lista de fornecedores de tecnologia de anúncios da Google com consentimento que não estão registados no IAB.	Veja as especificações do Consentimento Adicional.
rdp	Tem de definir especificamente rdp=1 ou incluir simplesmente rdp (sem um valor definido) para restringir o processamento de dados. Os pedidos de anúncios com este parâmetro em falta ou definidos como rdp=0 não serão restringidos, a menos que a definição de rede Restringir processamento de dados esteja ativada.	rdp=1
sdk_apis	O parâmetro da framework da API do SDK aceita uma lista separada por vírgulas de valores inteiros constantes, que indicam todas as frameworks da API que o leitor suporta. Veja uma lista de valores possíveis da framework da API. 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 para IMA, os valores são substituídos pelos valores suportados pelo SDK para IMA.	sdk_apis=2,7,9
sid	Um tipo de identificador de publicidade que preserva a privacidade que pode ser usado apenas para fins de limite de frequência. De acordo com as diretrizes do IFA do IAB, este parâmetro tem de ser preenchido no formato UUID. Saiba mais Pode optar por não transmitir o ID da sessão ao definir sid=0.	sid=123e4567-e89b-12d3 -a456-426614174000
wta	Indica se o leitor de vídeo suporta a renderização de "Porquê este anúncio?". Isto é suportado automaticamente quando utiliza o SDK para IMA. Quando o SDK para IMA não é utilizado, os leitores de vídeo têm de implementar o suporte de Icon e IconClickFallbackImage no VAST, conforme documentado neste guia da API de DAI.*  O WTA não é suportado para o SSB. Este campo é obrigatório se utilizar o Ad Exchange. Saiba mais * O suporte para IconClickFallbackImage não é obrigatório, exceto em dispositivos CTV (smart TV).	Suportado: wta=1 Não suportado: wta=0

Substitua a etiqueta do anúncio predefinida com o SDK para IMA

Quando um leitor de vídeo pede uma stream DAI através do SDK para IMA, pode transmitir um campo denominado "adTagParameters". Esta estrutura tipo dicionário pode ser definida com pares de chaves-valores, onde as chaves podem ser os parâmetros da etiqueta do anúncio do Ad Manager indicados na tabela anterior.

Pode personalizar a sua stream e transmitir parâmetros que não estejam relacionados com o pedido de anúncio do Ad Manager com esta mesma estrutura. Saiba como solicitar variantes de stream específicas e como configurar uma pausa de anúncios.

A implementação do campo adTagParameters é ligeiramente diferente, consoante a plataforma ou a linguagem de programação específica. Consulte a documentação de programação para iOS, Android, tvOS, Chromecast, HTML5 ou documentação adicional no Guia de programação de leitores e apps para DAI.

 

Defina adTagParameters através do SDK

Quando define cust_params ou description_url através do SDK, em apps para iOS, tvOS e Android, não deve codificar o URL das strings. Pode transmitir os cust_params como uma única string que concatena os pares de chaves-valores com um "&".

Por exemplo, se pretender definir cust_params para o valor sport=football&city=newyork:

A estrutura de adTagParams utilizando valores não codificados seria:

{
  "tfcd": 1,
  "iu": "/987654321/path/to/adunit",
  "cust_params": "sport=football&city=newyork",
  "description_url": "http://www.sample.com/golf.html",
  "ppid": "12JD92JD8078S8J29SDOAKC0EF230337"
}
 

A estrutura adTagParameters utilizando valores codificados para pedidos de stream HTML5 seria:

{
  "tfcd": 1,
  "iu": "/987654321/path/to/adunit",
  "cust_params": "sport%3Dfootball%26city%3Dnewyork",
  "description_url": "http%3A%2F%2Fwww.sample.com%2Fgolf.html",
  "ppid": "12JD92JD8078S8J29SDOAKC0EF230337"
}
 

A estrutura adTagParams utilizando valores codificados para pedidos de stream Roku seria:

request.adTagParams="tfcd=1&iu=/987654321/path/to/adunit&cust_params=sport%3Dfootball%26city%3Dnewyork&description_url=http%3A%2F%2Fwww.sample.com%2Fgolf.html&ppid=12JD92JD8078S8J29SDOAKC0EF230337"

Substitua a etiqueta do anúncio predefinida com a API de DAI ^(Beta) 

Quando um leitor de vídeo solicita uma stream DAI através da API de DAI, pode transmitir opcionalmente pares de chaves-valores, onde as chaves podem ser os parâmetros da etiqueta do anúncio do Ad Manager indicados na tabela anterior.

Estes parâmetros devem ser enviados como parte do corpo do pedido HTTP POST, do tipo de formulário application/x‑www‑form‑urlencoded para linear/em direto e VOD.

Pode personalizar a sua stream e transmitir parâmetros que não estejam relacionados com o pedido de anúncio do Ad Manager com esta mesma estrutura. Saiba como solicitar parâmetros das variantes da stream específicos e a autenticação HMAC.

Consulte uma implementação de exemplo da API DAI.

Substitua a etiqueta do anúncio predefinida através do SSB

Seguem-se exemplos de como modificar uma etiqueta do anúncio VOD (vídeo a pedido) predefinida com o SSB. Os parâmetros substituídos transmitidos pelo leitor ou pela app estão realçados.

Exemplos de vídeo a pedido

	Exemplo
URL de transmissão em fluxo contínuo VOD base	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8
(com um bloco de anúncios especificado)	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8?iu=/9876/ path/to/adunit
(com chaves-valores substituídos)	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8& cust_params=sport%3Dgolf%26section%3Dblog %26anotherKey%3Dvalue1%2Cvalue2
(com uma declaração de conteúdo dirigido a crianças)	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8?tfcd=1
(com um bloco de anúncios E chaves-valores substituídos E um description_url personalizado E uma declaração de conteúdo dirigido a crianças)	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8& iu=/9876/path/to/adunit& cust_params=sport%3Dgolf%26section %3Dblog%26anotherKey%3Dvalue1%2Cvalue2& description_url=https://mysite.com/description.html& tfcd=1

 

Exemplos de stream linear em direto

	Exemplo
URL de transmissão em fluxo contínuo linear em direto base	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8
(com um bloco de anúncios especificado)	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?iu=/9876/path/to/adunit
(com chaves-valores substituídos)	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?cust_params=sport%3Dgolf%26section %3Dblog%26otherKey%3Dvalue1%2Cvalue2
(com uma declaração de conteúdo dirigido a crianças)	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?tfcd=1
(com um bloco de anúncios E chaves-valores substituídos E um description_url personalizado E uma declaração de conteúdo dirigido a crianças)	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8& iu=/9876/path/to/adunit& cust_params=sport%3Dgolf%26section%3Dblog%26otherKey %3Dvalue1%2Cvalue2& description_url=https://mysite.com/description.html& tfcd=1

Atualize dinamicamente os parâmetros de segmentação durante uma stream em direto específica

Pode atualizar dinamicamente os dados de segmentação de um utilizador específico durante a visualização da stream através do método replaceAdTagParameters no SDK de DAI para IMA.

Para problemas relacionados com as indisponibilidades ou a resolução de problemas da DAI, contacte o apoio técnico para publicadores.