Fornecer parâmetros de segmentação ao stream

Todos os seguintes parâmetros de segmentação são opcionais.

Quando você cria ou configura uma origem do conteúdo para vídeo on demand (VOD) ou define uma transmissão ao vivo para a Inserção de anúncios dinâmicos (DAI), é necessário especificar uma tag de anúncio em vídeo padrão. Todos os streams da DAI usam essa tag de anúncio e os parâmetros dela por padrão. Os parâmetros de tag de anúncio se aplicam a anúncios intermediários e precedentes. Se você preferir que o player solicite algo exclusivo a um determinado stream, essas opções estarão disponíveis.

Parâmetros da tag de anúncio do Ad Manager que podem ser modificados

Ir 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

 

Modificar a tag de anúncio padrão

Quando o player de vídeo solicita um stream, a tag de anúncio padrão é usada exatamente como você especificou na interface. No entanto, é possível modificar alguns parâmetros dessa tag na solicitação de stream. Estes são os únicos que podem ser alterados.

Saiba como modificar a tag de anúncio padrão usando o SDK do IMA ou SSB.

Parâmetro	Descrição	Valor de exemplo
iu	Bloco de anúncios atual. Precisa seguir o formato: /network_id/directory/ad_unit	iu=/6062/video/example_unit
cust_params	São pares de chave-valor que precisam ser usados para a segmentação de campanha do Ad Manager. Algumas plataformas exigem a codificação de URL. O requisito de codificação não se aplica ao usar o SDK de DAI do IMA para HTML5, já que o valor é codificado automaticamente. Esse parâmetro não vai funcionar se já estiver codificado em HTML5.	Exemplos com vários pares de chave-valor, como: section=sports  page=golf,tennis   Streams SSB: codifique e concatene todo o valor cust_params, mas não use codificação dupla. cust_params=   "section%3Dsports   %26page%3Dgolf%2Ctennis"   Chromecast: apenas codifique os valores. streamRequest. adTagParameters = {   "cust_params":   "section=sports&   multi=golf%2Ctennis"};   Roku: codifique e concatene todo o valor de cust_params, mas não use codificação dupla. 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	Modifica o parâmetro sz da sua tag de anúncio padrão, o que permite a alteração dinâmica para diferentes dispositivos. Não inclua o v após o tamanho.	sz=400x300
tfcd	Marca uma solicitação de tratamento para direcionamento a crianças. Quando a solicitação DAI inclui tfcd=1, qualquer valor atribuído aos parâmetros rdid, idtype ou is_lat será removido para ficar em conformidade com a COPPA.	tfcd=1
description_url	O valor deve descrever o vídeo sendo exibido na página. Geralmente, é a página que hospeda o player de vídeo, mas também pode ser uma página com texto que descreve o vídeo. Sempre é preciso codificar description_url no URL em streams SSB e ao usar o SDK de DAI do IMA para Roku. Esse requisito não se aplica ao usar o SDK de DAI do IMA para HTML5, já que o valor é codificado automaticamente. Esse parâmetro não vai funcionar se já estiver codificado em HTML5. Esse parâmetro não é definido automaticamente pelo SDK do IMA. Ele precisa ser inserido manualmente. Este campo será obrigatório se você usar 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	Com o identificador fornecido pelo editor (PPID), os editores podem enviar um identificador para ser usado no limite de frequência, na segmentação de audiência e por público-alvo, na rotação sequencial de anúncios e em outros controles de exibição de anúncios com base no público-alvo em vários dispositivos. Saiba mais	ppid= 12JD92J...
ciu_szs	Lista separada por vírgulas de tamanhos de anúncios complementares Os anúncios complementares são compatíveis com a DAI somente quando você usa o SDK HTML5.	ciu_szs=728x90,300x250
mpt	Indica o nome do player do parceiro. Esse parâmetro é usado principalmente por parceiros como JWPlayer, Brightcove e Ooyala, que têm integração com o SDK.	mpt=JWPlayer
mpv	Indica a versão do player do parceiro. Esse parâmetro só deve ser definido se mpt também for definido e representar a versão do player do parceiro que tem integração com o SDK.	mpv=2.1
ptpl	É o ID do modelo de intervalo de anúncio. É possível encontrar esse ID no URL do Ad Manager ao visualizar as configurações do modelo de intervalo na interface do Ad Manager. Ele aparece como o valor do parâmetro break_template_id.	ptpl=1234
ptpln	É o nome do modelo de intervalo de anúncio. Ele corresponde ao campo "Nome" no Ad Manager, e não ao nome de exibição.	ptpln=my_break_template
an	O parâmetro an é o nome do aplicativo. Ele precisa ser aplicado às solicitações enviadas de apps para dispositivos móveis e dispositivos de smart TV, porque a maioria dos anúncios em vídeo programáticos exige esse parâmetro*. O SDK do IMA o preencherá automaticamente, mas ele precisa ser especificado manualmente na API DAI e no SSB (ambientes sem SDK). * Embora o nome do aplicativo seja um nome legível, no iOS e no tvOS o SDK não consegue acessar o ID da App Store de nove dígitos. Nesses casos, o SDK envia o pacote de apps pelo parâmetro an (no formato com.package.publisher).	an=sample%20app
ltd	Indica se é necessário veicular publicidade de maneira limitada na falta de consentimento para o uso de cookies ou outros identificadores locais. Saiba mais	ltd=1
rdid idtype is_lat	Com aplicativos nativos (não na Web ou Web para dispositivos móveis), o SDK transmite identificadores redefiníveis de dispositivo para segmentar os usuários em suas solicitações de stream com os parâmetros para rdid, idtype e is_lat. Em streams SSB, você precisa transmitir esses parâmetros como explícitos, assim como faria em uma solicitação de anúncio de Video Solutions do cliente. A partir do iOS 14.5, a Apple descontinuou o indicador LAT. Como alternativa, o Google conta com a presença de um IDFA diferente de zero para indicar que o usuário consentiu com o rastreamento em versões do iOS compatíveis com o App Tracking Transparency. Assim um UserAgent válido que indique a versão correta do SO é necessário.	Veja exemplos detalhados de identificadores de dispositivo redefiníveis.
trt	Indica se o tráfego é ou não comprado.	Tipo de tráfego indefinido: trt=0 Tráfego comprado: trt=1 Tráfego orgânico: trt=2
vconp	Recomendado por MRCDiretrizes de avaliação de vídeos Indica se o player reproduzirá continuamente os vídeos de conteúdo, um após o outro, de modo semelhante a uma transmissão de TV. Os possíveis valores são 2, se a reprodução contínua estiver ativada, e 1, se esse recurso estiver desativado. Este parâmetro deverá ser deixado indefinido se for desconhecido.	Reprodução contínua ATIVADA: vconp=2   Reprodução contínua desativada: vconp=1
vpa	Recomendado por MRCDiretrizes de avaliação de vídeos Indica se o anúncio começa por reprodução automática ou por clique. Os valores possíveis são click, se a página aguardar uma ação do usuário, ou auto, se o vídeo for reproduzido automaticamente. Este parâmetro deverá ser deixado indefinido se for desconhecido.	Reprodução automática: vpa=auto   Clique: vpa=click
vpmute	Recomendado por MRCDiretrizes de avaliação de vídeos Indica se a reprodução do anúncio começará com o som do player de vídeo desativado. Os possíveis valores são 1 para som desativado e 0 para som ativado. Este parâmetro deverá ser deixado indefinido se for desconhecido.	Som desativado: vpmute=1   Som ativado: vpmute=0
npa	É a configuração de personalização para solicitações de anúncios. É necessário especificar o parâmetro no início da tag para evitar qualquer risco de truncamento. Especifique npa=1 para marcar a solicitação de anúncio como não personalizada. A omissão de parâmetros é definida por padrão para os anúncios personalizados.	npa=1
omid_p	O parâmetro do nome do parceiro 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. Esse parâmetro só é aplicável a editores que querem fazer a medição do Active View ao usar o SDK do Open Measurement (SDK do OM). Ele não deve ser usado com o SDK do IMA, já que é configurado automaticamente. Para indicar a compatibilidade com OMID ao usar a biblioteca de acesso programático (PAL, na sigla em inglês), é preciso usar as APIs omidPartnerName e omidPartnerVersion para definir o nome e a versão do parceiro. Quando você não estiver usando PAL ou IMA, vai ser preciso definir os parâmetros omid_p e sdk_apis (as APIs compatíveis, que também podem incluir outras APIs separadas por vírgula).	Quando estiver usando PAL: request.omidPartnerName = 'examplepartnername' request.omidPartnerVersion = '1.0.0.0' Quando não estiver usando PAL: omid_p=examplepartnername/1.0.0.0&sdk_apis=7
gdpr gdpr_consent	Esses campos são usados para transmitir informações de consentimento do TCF v2.0 para solicitações internas e externas de sincronização de cookies.	Veja as especificações da GDPR.
givn|paln	Para integrações que usam a biblioteca de acesso programático (PAL), o parâmetro valor de uso único de vídeo aceita um valor de string variável. O valor de uso único é seguro para URL. Não é necessário codificar com URL. Observação: se você já forneceu um valor de uso único com o parâmetro paln legado, é recomendável migrar para o parâmetro givn e parar de enviar paln. Não inclua os dois parâmetros.	Saiba mais sobre o valor transmitido para esse parâmetro nos guias de iniciação da PAL.
addtl_consent	É uma lista dos provedores de tecnologia de anúncio do Google que não estão registrados no IAB.	Veja as especificações de consentimento adicional.
rdp	É necessário definir especificamente rdp=1 ou incluir rdp (sem um valor definido) para restringir o processamento de dados. As solicitações de anúncios que não tiverem esse parâmetro ou que forem definidas como rdp=0 não serão restringidas, a menos que a configuração de rede Restringir o processamento de dados esteja ativada.	rdp=1
sdk_apis	O parâmetro de framework da API do SDK aceita uma lista separada por vírgulas de valores inteiros constantes, que indicam todos os frameworks da API compatíveis com o player. Veja uma lista de possíveis valores de framework da API. Esse parâmetro é usado por editores que usam a biblioteca de acesso programático (PAL). Se você tentar definir valores para esse parâmetro enquanto usa o SDK do IMA, eles serão substituídos pelos valores compatíveis com o SDK do IMA.	sdk_apis=2,7,9
sid	É um tipo de identificador de publicidade com proteção de privacidade que só pode ser usado para fins de limite de frequência. De acordo com as diretrizes de identificadores de publicidade (IFA) do IAB (sigla e página em inglês), esse parâmetro precisa ser preenchido no formato UUID. Saiba mais Para desativar a transmissão do ID da sessão, defina sid=0.	sid=123e4567-e89b-12d3 -a456-426614174000
wta	Indica a compatibilidade do player de vídeo com a renderização de Por que esse anúncio?. Isso é compatível automaticamente ao usar o SDK do IMA. Quando o SDK do IMA não é usado, o player de vídeo precisa implementar a compatibilidade de Icon e IconClickFallbackImage do VAST, conforme documentado no guia da API DAI*. WTA não é compatível com SSB. Este campo será obrigatório se você usar o Ad Exchange. Saiba mais *A compatibilidade com IconClickFallbackImage não é obrigatória, a não ser para dispositivos de smart TV.	Compatível: wta=1 Não compatível: wta=0

Modificar a tag de anúncio padrão usando o SDK do IMA

Quando um player de vídeo solicita um fluxo de DAI usando o SDK do IMA, ele pode passar em um campo chamado "adTagParameters". Essa estrutura de dicionário pode ser definida com pares de chave-valor, em que as chaves podem ser os parâmetros de tag de anúncio do Ad Manager listados na tabela acima.

Além disso, é possível personalizar seu stream e transmitir parâmetros que não são relacionados à solicitação de anúncio do Ad Manager usando a mesma estrutura. Saiba como solicitar variantes de stream específicas e como configurar um intervalo do anúncio.

A implementação do campo adTagParameters é um pouco diferente dependendo da plataforma ou da linguagem de programação específica. Consulte a documentação de desenvolvimento de iOS, Android, tvOS, Chromecast e HTML5 ou a documentação adicional no guia de desenvolvimento de aplicativo e player da DAI.

 

Definir adTagParameters por meio do SDK

Quando você definir cust_params ou description_url pelo SDK em aplicativos iOS, tvOS e Android, não codifique as strings para URL. É possível transmitir cust_params usando uma string que une os pares de chave-valor com um "&".

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

A estrutura adTagParams usando 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 que usa valores codificados para solicitações 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 que usa valores codificados para solicitações 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"

Usar a API DAI para modificar a tag de anúncio default  ^(Beta) 

Quando um player de vídeo usa a API DAI para solicitar um fluxo de DAI, ele pode passar pares de chave-valor, em que as chaves podem ser os parâmetros de tag de anúncio do Ad Manager listados na tabela acima.

Esses parâmetros precisam ser enviados como parte do corpo da solicitação POST HTTP, do tipo application/x‑www‑form‑urlencoded para linear/ao vivo e VOD.

Além disso, é possível personalizar seu stream e transmitir parâmetros que não são relacionados à solicitação de anúncio do Ad Manager usando a mesma estrutura. Saiba como solicitar parâmetros de variantes de stream específicos e a autenticação HMAC.

Veja um exemplo de implementação da API DAI.

Modificar a tag de anúncio padrão usando SSB

Os seguintes exemplos são relativos à modificação de uma tag de anúncio VOD SSB padrão. Os parâmetros modificados que passaram pelo player ou aplicativo estão destacados.

Exemplos de vídeo on demand

	Exemplo
URL de stream de VOD básico	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-valor modificadas)	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 feito para crianças)	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8?tfcd=1
(com um bloco de anúncios E chaves-valor modificados E um description_url personalizado E uma declaração de conteúdo feito para 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 transmissão linear ao vivo

	Exemplo
URL de transmissão linear ao vivo básico	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-valor modificadas)	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 feito para crianças)	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?tfcd=1
(com um bloco de anúncios E chaves-valor modificados E um description_url personalizado E uma declaração de conteúdo feito para 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

Atualizar dinamicamente os parâmetros de segmentação durante uma transmissão ao vivo específica

Você pode atualizar dinamicamente os dados de segmentação de um usuário específico no meio da transmissão usando o método replaceAdTagParameters no SDK de DAI do IMA.

No caso de problemas relacionados à solução de problemas ou interrupções da DAI, entre em contato com o suporte ao editor.