Os produtos AdSense para vídeos e AdSense para jogos usam uma estrutura de tags muito diferente do AdSense para conteúdo. Eles precisam de uma tag de anúncios de mídia interativos (IMA, na sigla em inglês). Além disso, exibem anúncios apenas quando chamados com um player de vídeo ou inicializador de jogos integrado ao SDK do Google para IMA e/ou compatível com VAST e VPAID (por exemplo, o Adaptador de IMA).
Normalmente, você cria essas tags por meio do gerador de tags do AdSense para jogos. Veja abaixo uma lista abrangente dos diferentes critérios que você pode configurar para essas tags de anúncios. Há apenas alguns parâmetros obrigatórios para que uma tag do AdSense para jogos exiba anúncios. No entanto, você pode alcançar as respostas de anúncio desejadas adicionando parâmetros opcionais, como IDs de canal, duração mínima/máxima do anúncio, idioma etc.
| Parâmetro de tag de anúncios do IMA | Parâmetro obrigatório |
|---|---|
| ad_type | Sim |
| client | Sim |
| description_url | Sim - precisa ter codificação de URL |
| channel | Não - recomendado, se disponível |
| adsafe | Não - recomendado |
| videoad_start_delay | Não - recomendado |
| hl | Não - recomendado |
| max_ad_duration | Não - recomendado |
| min_ad_duration | Não - recomendado |
| sdmax | Não - recomendado |
| adtest | Não |
| cust_age | Não |
| cust_gender | Não |
| host | Não |
| h_ch | Não |
URL de base
O URL a seguir fornece a base para todos os parâmetros de consulta descritos abaixo:
https://googleads.g.doubleclick.net/pagead/ads?
ad_type
(String) Especifica o tipo de anúncio desejado. Eles devem ser concatenados usando um sublinhado ("_").
Valores
- video: todos os anúncios em vídeo (equivalente a "standardvideo_skippablevideo_bumpervideo").
- skippablevideo: apenas anúncios em vídeo puláveis. Isso pode exigir outras permissões de editor para receber anúncios impossíveis pular.
- bumpervideo: permite anúncios em vídeo de seis segundos impossíveis pular.
- standardvideo: apenas anúncios em vídeo impossíveis de pular.
- image: permite anúncios gráficos que caibam no tamanho do espaço não linear especificado.
- text: permite anúncios de texto.
Exemplos
- &ad_type=video_text_image
- Permite todos os formatos.
- &ad_type=video_text
- Permite qualquer formato de vídeo e anúncios de texto.
- &ad_type=standardvideo_image
- Permite apenas anúncios gráficos e em vídeo impossíveis de pular padrão.
client
(String) O ID da propriedade da Web do editor.
Exemplo: &client=ca-games-pub-4968145218643279
description_url
(String) Um URL completo e codificado de uma página HTML que descreve o vídeo. O valor description_url pode ser criado dinamicamente, usando a linguagem de programação no lado do servidor, ou manualmente, usando uma ferramenta de codificação de URL on-line.
Exemplo: &description_url=http%3A%2F%2Fmyurl.com%2Fpage%3Fkey%3Dvalue%26key2%3Dvalue2
Exemplo de URL
Veja a seguir um exemplo de URL que contém os parâmetros mínimos obrigatórios. https://googleads.g.doubleclick.net/pagead/ads?client=ca-video- afvtest&ad_type=video&description_url=http%3A%2F%2Fmyurl.com%2Fpage%3Fkey%3Dvalu e%26key2%3Dvalue2
Solicita anúncios em vídeo para o editor, "ca-video-afvtest", com um URL de descrição de http:// "myurl.com/page?key=value&key2=value2"key=value&key2=value2
channel
(String) Uma lista de canais delimitada usada para segmentação e geração de relatórios do Google AdSense. Até cinco canais podem ser passados por solicitação de anúncio.
Exemplo: &channel=mychannel+otherchannel+targetingchannel
adsafe
(String) Determina a configuração usada para filtrar os anúncios exibidos. O padrão é "high".
Valores:
- high (alto): (padrão) retorna anúncios indicados para menores. Não retorna anúncios não indicados para menores ou com conteúdo sexual e adulto.
- medium (médio): retorna anúncios indicados para menores e não indicados para menores (como anúncios de jogos de azar e de medicamentos que exijam receita médica). Não retorna anúncios com conteúdo sexual e adulto.
Exemplo: &adsafe=high
adtest
(String) Especifica se é uma implementação de teste. Os valores possíveis são "on" ou "off". Se for definido como "on", as impressões e os cliques não serão registrados na conta AFV (Google AdSense para vídeo). É OBRIGATÓRIO usar esse parâmetro durante os testes. Se ele não for definido, o padrão será "off".
Valores:
- off: (padrão) faturamento normal de todos os anúncios. Essa configuração deve ser usada para a produção.
- on: essa configuração garante que nenhum anúncio registre impressões ou cliques para uso durante o teste.
Exemplo: &adtest=on
videoad_start_delay
(Inteiro) O número de milissegundos no vídeo no qual o anúncio será reproduzido. O padrão é um valor de anúncio intermediário, "1", especificamente.
Valores:
- -1: especifica um anúncio in-stream pós-vídeo que será exibido ao final do conteúdo
- 0: especifica um anúncio precedente que será exibido antes da reprodução do conteúdo ser iniciada
- Qualquer número inteiro positivo: especifica um anúncio intermediário que será exibido depois dessa quantidade de milissegundos de reprodução do conteúdo.
Exemplo:
- &videoad_start_delay=-1: pós-vídeo.
- &videoad_start_delay=15000: o anúncio será reproduzido 15 segundos depois do início do conteúdo.
cust_age
(Inteiro) Especifica a idade do usuário. A idade exata é suportada, bem como um grupo de idades definido na com.google.ads.ima.api.Demographics
Exemplo:
- &cust_age=1001: de 18 a 24 anos
- &cust_age=38: exatamente 38 anos
cust_gender
(Inteiro) Especifica o sexo do usuário, conforme definido em com.google.ads.ima.api.Demographics.
Valores:
- 1: masculino
- 2: feminino
Exemplo:
- &cust_gender=1: masculino
- &cust_gender=2: feminino
host
(String) código do host a ser usado para compartilhamento de receita em três formas.
Exemplo: &host=ca-host-test: divide a receita com esse host.
h_ch
(String) Uma lista de strings delimitada que representa os códigos do canal de segmentação/geração de relatórios do Google AdSense para o host.
Exemplo: &h_ch=channel1+channel2+channel3: informa e segmenta esses canais adicionais para o host.
Ht_id
(Número) ID de camada usado para especificar a camada de compartilhamento de receita entre o editor e o host.
Exemplo: &ht_id=2: host de camada 2.
hl
(String) Um código de idioma utilizado para solicitar anúncios no idioma em questão. Pode ser um código ISO 639-1 (duas letras) ou ISO 639-2 (três letras). Lista de códigos válidos.
Exemplo:
- &hl=en: inglês.
- &hl=es: espanhol.
max_ad_duration
(Inteiro) Especifica a duração máxima do vídeo que precisa ser retornada, em milissegundos. O padrão será de cem segundos, se não for definido.
Exemplo: &max_ad_duration=30000: a duração máxima de qualquer anúncio impossível de pular será de 30 segundos.
min_ad_duration
(Inteiro) Especifica a duração mínima do vídeo que precisa ser retornada, em milissegundos. O padrão será de zero segundos, se não for definido.
Exemplo:
- &min_ad_duration=15000: a duração de um anúncio não ignorável retornado precisa ser de 15 segundos ou mais.
- &min_ad_duration=0: a duração será restrita apenas pelo valor "max_ad_duration".
sdmax
(Inteiro) Especifica a duração máxima do vídeo para anúncios puláveis, em milissegundos. O padrão será ilimitado, se não for definido.
Exemplo: &sdmax=120000: a duração do anúncio pulável retornado não pode exceder dois minutos.
