Parâmetros obrigatórios e recomendados para a programática

A implementação de uma solução de vídeo baseada em tags para a demanda do Ad Exchange sem o uso de um SDK do IMA é um recurso em versão Beta e talvez não esteja disponível na sua rede. Entre em contato com seu gerente de contas para mais informações.

A lista a seguir é um subconjunto dos parâmetros de URL da tag de anúncio VAST. Esses parâmetros são para soluções de vídeo para a programática baseadas em tags em caso de não integração ao SDK do IMA.

Veja a lista de parâmetros obrigatórios e recomendados para a Web ou os parâmetros obrigatórios para apps.

 Ir para um parâmetro específico na lista

an description_url hl idtype is_lat

msid plcmt pp rdid sid url

vpa vpmute vpos wta

 

Parâmetro	Detalhes
hl (idioma)	O parâmetro aceita um valor constante usado para solicitar anúncios em um idioma específico e para definir o idioma da seleção de anúncios e da renderização dos anúncios em vídeo na alocação dinâmica para vídeo no Ad Exchange ou no Google AdSense. O valor desse parâmetro pode ser qualquer código ISO 639-1 (duas letras) ou ISO 639-2 (três letras). Veja a lista de códigos válidos. Se omitido, o valor padrão será qualquer idioma com segmentação de anúncios por idioma no Ad Exchange. Exemplo de uso hl=it Requisito Recomendado para monetização programática
description_url (URL de descrição)	O parâmetro de URL da descrição aceita um valor variável que descreva o vídeo exibido na página. Geralmente, é a página com o player, mas também pode ser uma com a descrição em texto do vídeo. O valor de description_url precisa ser codificado para URL nos players de vídeo de páginas da Web e dispositivos OTT e smart TVs. Já no caso dos players em apps para dispositivos móveis, ele não pode ter essa codificação. Esse parâmetro não é definido automaticamente pelo SDK do IMA. Ele precisa ser inserido manualmente. Exemplo de uso Codificado para URL: description_url= https%3A%2F%2Fwww.sample.com%2Fgolf.html Não codificado: description_url= https://www.sample.com/golf.html Requisito Obrigatório para Web, apps e Ad Exchange Recomendado para monetização programática
msid (ID do app) an (nome do app)	Os parâmetros ID e nome do app aceitam valores variáveis a serem aplicados a solicitações enviadas de apps para dispositivos móveis e dispositivos de smart TV, porque eles são obrigatórios para a maioria dos anúncios em vídeo programáticos. O SDK do IMA vai preencher automaticamente os dois parâmetros, mas eles precisarão ser especificados manualmente em chamadas VAST diretas (ambientes sem SDK). Embora o nome do app seja legível por humanos, o SDK não consegue acessar o ID do app no iOS e no tvOS. Nesses casos, o parâmetro msid não é enviado, e o SDK envia o pacote de apps pelo parâmetro an. Exemplo de uso msid=com.package.publisher&an=sample%20app Os IDs dos app são nomeados e formatados de maneira diferente em cada app store. Consulte as diretrizes do IAB para a identificação de apps ou exemplos de identificadores exclusivos comuns. Para plataformas sem app store, o IAB recomenda que os editores usem o seguinte formato de ID: com.publisher.deviceplatform Requisito Os dois parâmetros são obrigatórios para apps Recomendado para monetização programática
plcmt (posição)	O parâmetro de posição aceita um valor constante que é usado para indicar se o inventário in-stream foi declarado como in-stream ou complementar, de acordo com a orientação nas especificações do IAB. No caso de solicitações que não são in-stream, esse campo é preenchido automaticamente para compradores com base no formato de inventário declarado e substitui qualquer declaração de conteúdo in-stream ou complementar. Exemplo de uso Solicitação in-stream: plcmt=1 Solicitação de conteúdo complementar: plcmt=2 Requisito Obrigatório para Web e monetização programática
pp (perfil do criativo)	O parâmetro perfil do criativo aceita um valor variável que controle quais criativos se qualificam para veiculação com base na configuração definida em um perfil de criativo em áudio e em vídeo. Exemplo de uso pp=creative_profile Requisito Recomendado para monetização programática
rdid idtype is_lat (identificadores de dispositivo redefiníveis)	Os identificadores redefiníveis de dispositivo aceitam valores variáveis. Com aplicativos integrados (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, é necessário transmitir esses parâmetros como explícitos, assim como faria em uma solicitação de anúncio do lado do cliente. Saiba mais sobre os identificadores de dispositivos. Quase todos os anúncios de vídeo programáticos requerem a presença desses valores. 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. Exemplo de uso Veja exemplos detalhados de identificadores redefiníveis de dispositivo. Requisito Obrigatório para apps Recomendado para monetização programática
sid (ID da sessão)	O parâmetro ID da sessão aceita um valor variável que é um identificador de publicidade com proteção de privacidade usado apenas para fins de limite de frequência. O ID de sessão é compatível com solicitações de vídeo in-stream de smart TVs e inventário de vídeo in-stream de dispositivos móveis de apps. No momento, ele não é compatível com a Web. 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 sobre identificadores de dispositivos redefiníveis para segmentação de usuários. Para desativar a transmissão do ID da sessão, defina sid=0. Exemplo de uso 123e4567-e89b-12d3-a456-426614174000 Requisito Recomendado para monetização programática
url (URL)	O parâmetro URL aceita um valor variável que precisa ser definido como o URL completo de que a solicitação é enviada. Esse valor é necessário para ajudar compradores a identificar e entender o contexto da origem da solicitação. Na medida do possível, esse valor deve ser dinamicamente preenchido na solicitação de anúncio. Em uma página da Web, é o URL da página que exibe o player de vídeo. Se você usa o SDK do IMA, o valor do URL é definido automaticamente. Se o player definir esse valor, o SDK do IMA vai respeitar o valor definido. Em um app (para dispositivos móveis ou smart TV), esse valor precisa ser definido como um URL que representa mais precisamente o inventário de vídeo ou áudio monetizado. Por exemplo, se o usuário está assistindo a um vídeo em um app para dispositivos móveis que também está disponível em um URL equivalente para computador.* O valor desse parâmetro precisa ser codificado. Exemplo de uso url=https%3A%2F%2Fwww.videoad.com%2Fgolf.html * Para apps, se não for possível definir esse parâmetro como um valor de URL variável, é recomendável definir com o seguinte padrão: url=https%3A%2F%2F<app/bundleid>.adsenseformobileapps.com Requisito Obrigatório para Web e apps Recomendado para monetização programática
vpa (reprodução de vídeo automática)	Recomendado por MRC Diretrizes de avaliação de vídeos O parâmetro reprodução de vídeo automática aceita um valor constante que indica se o conteúdo do vídeo em um 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. Esse parâmetro deverá ser deixado indefinido se for desconhecido. Exemplo de uso Reprodução automática: vpa=auto Clique para ver: vpa=click Requisito Recomendado para monetização programática
vpmute (reprodução de vídeo com som desativado)	Recomendado por MRC Diretrizes de avaliação de vídeos O parâmetro vídeo sem som aceita um valor constante que indica se o anúncio exibe ou não o vídeo quando o player está sem som. Exemplo de uso Som desativado: vpmute=1 Som ativado: vpmute=0 Requisito Obrigatório para Web e monetização programática
vpos (posição de vídeo)	O parâmetro posição do vídeo aceita um valor constante que indica se a solicitação de anúncio é enviada pelo anúncio precedente, pelo anúncio intermediário ou pelo anúncio final. Exemplo de uso Anúncio precedente: vpos=preroll Anúncio intermediário: vpos=midroll Anúncio final: vpos=postroll Requisito Recomendado para monetização programática
wta (Por que esse anúncio?)	O parâmetro "Por que esse anúncio?" aceita um valor constante que indica a compatibilidade do player de vídeo com a renderização de "Por que esse anúncio?". A funcionalidade "Por que esse anúncio?" é compatível automaticamente com o SDK do IMA. Quando o SDK do IMA não é usado, os players de vídeo precisam implementar a compatibilidade de Icon e IconClickFallbackImage do VAST, conforme documentado no padrão VAST do IAB. As solicitações de anúncios em áudio precisarão enviar wta=1 se o ícone "Opções de anúncios", conforme indicado na resposta VAST, for renderizado em complementares ou outra forma fornecida ao usuário. Para estarem qualificadas para a Demanda do Google e o tráfego de reservas hospedado pelo Google no EEE, as solicitações de anúncios precisam enviar wta=1 para indicar que o ícone "Opções de anúncios", conforme fornecido na resposta VAST, é renderizado no anúncio em vídeo, nos complementares ou em outra forma fornecida ao usuário para todos os criativos de anúncios. Exemplo de uso Compatível: wta=1 Não compatível: wta=0 Requisito Obrigatório para o Ad Exchange Obrigatório para o tráfego da Web e de apps no EEE Recomendado para monetização programática