Los productos AdSense para vídeo y AdSense para juegos utilizan una estructura de etiquetado muy diferente de la que usa AdSense para contenido. Necesitan una etiqueta de anuncios multimedia interactivos (IMA) y solo devuelven anuncios cuando se les llama con un reproductor de vídeo o una interfaz de inicio de juegos que admitan la integración con el SDK de IMA de Google y sean compatibles con VAST y VPAID (por ejemplo, el Adaptador de IMA).
Normalmente, estas etiquetas se pueden crear con el generador de etiquetas de AdSense para juegos. A continuación se ofrece una lista exhaustiva de los criterios que se pueden configurar para estas etiquetas de anuncio. Si desea que una etiqueta de AdSense para juegos publique anuncios, solo debe usar algunos parámetros de forma obligatoria, pero puede obtener las respuestas de anuncio deseadas agregando parámetros opcionales (como los ID de canal, la duración mínima y máxima del anuncio, el idioma, etc.).
| Parámetro de etiqueta de anuncio de IMA | Parámetro obligatorio |
|---|---|
| ad_type | Sí |
| client | Sí |
| description_url | Sí: debe tener codificación URL |
| channel | No: se recomienda si está disponible |
| adsafe | No: recomendado |
| videoad_start_delay | No: recomendado |
| hl | No: recomendado |
| max_ad_duration | No: recomendado |
| min_ad_duration | No: recomendado |
| sdmax | No: recomendado |
| adtest | No |
| cust_age | No |
| cust_gender | No |
| host | No |
| h_ch | No |
URL base
La siguiente URL ofrece la base de todos los parámetros de consulta que se describen a continuación:
https://googleads.g.doubleclick.net/pagead/ads?
ad_type
(Cadena) Especifica el tipo de anuncio deseado. Debe concatenarse mediante un guion bajo ("_").
Valores
- video: admite todos los anuncios de vídeo. Equivale a standardvideo_skippablevideo_bumpervideo.
- skippablevideo: solo admite anuncios de vídeo saltables. Es posible que se deba disponer de permisos de editor adicionales para recibir anuncios saltables.
- bumpervideo: admite anuncios de vídeo no saltables de seis segundos.
- standardvideo: solo admite anuncios de vídeo no saltables.
- image: admite los anuncios de imagen estáticos que se ajusten al tamaño del espacio no lineal especificado.
- text: admite anuncios de texto.
Ejemplos
- &ad_type=video_text_image
- Admite todos los formatos.
- &ad_type=video_text
- Admite cualquier formato de vídeo y anuncios de texto.
- &ad_type=standardvideo_image
- Solo admite anuncios de imagen y de vídeo estándar no saltables.
client
(Cadena) ID de propiedad web del editor.
Ejemplo: &client=ca-games-pub-4968145218643279
description_url
(Cadena) URL completa con codificación URL de una página HTML que describe el vídeo. El valor description_url se puede crear dinámicamente con su lenguaje de programación en el servidor, o manualmente con una herramienta de codificación de URL online.
Ejemplo: &description_url=http%3A%2F%2Fmyurl.com%2Fpage%3Fkey%3Dvalue%26key2%3Dvalue2
URL de ejemplo
El siguiente ejemplo es una URL que contiene los parámetros mínimos obligatorios. 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 anuncios de vídeo para el editor, ca-video-afvtest, con la URL de descripción http:// myurl.com/page?key=value&key2=value2.
channel
(Cadena) Lista de canales más delimitada que se utiliza para segmentar y crear informes en AdSense. Se pueden transmitir hasta cinco canales por solicitud de anuncio.
Ejemplo: &channel=mychannel+otherchannel+targetingchannel
adsafe
(Cadena) Determina la configuración que se emplea para filtrar los anuncios que se muestran. El valor predeterminado es "high".
Valores:
- high (valor predeterminado): devuelve anuncios aptos para menores. No devuelve anuncios no aptos para menores ni de contenido sexual.
- medium: devuelve anuncios aptos y no aptos para menores (p. ej., anuncios de juegos de apuestas o de medicamentos con receta). No devuelve anuncios de contenido sexual.
Ejemplo: &adsafe=high
adtest
(Cadena) Especifica si se trata de una implementación de prueba. Los valores posibles son "on" u "off". Si el valor se establece en "on", no se registrarán impresiones ni clics en la cuenta de AFV. Este es el parámetro que debe utilizarse durante las pruebas. Si no se define ninguno, el valor predeterminado será "off".
Valores:
- off: (predeterminado) la facturación de los anuncios se realiza de forma normal. Esta es la configuración que debe utilizarse en producción.
- on: esta configuración garantiza que ningún anuncio registre impresiones ni clics para utilizarlos durante las pruebas.
Ejemplo: &adtest=on
videoad_start_delay
(Entero) El momento del vídeo en el que se reproducirá el anuncio, en milésimas de segundo. La configuración predeterminada es la del valor de mid-roll (en concreto, "1").
Valores:
- -1: especifica un anuncio post-roll que se mostrará al final del contenido.
- 0: especifica un anuncio pre-roll que se mostrará antes de que se empiece a reproducir el contenido.
- Cualquier número entero positivo: especifica un mid-roll que se reproducirá en un momento determinado del video, especificado en milésimas de segundo.
Ejemplo:
- &videoad_start_delay=-1: post-roll
- &videoad_start_delay=15000: el anuncio se reproducirá en el contenido con un retraso de 15 segundos.
cust_age
(Entero) Especifica la edad del usuario. Se admite la edad exacta, así como una franja de edad que se haya definido en com.google.ads.ima.api.Demographics.
Ejemplo:
- &cust_age=1001: de 18 a 24 años
- &cust_age=38: 38 exactamente
cust_gender
(Entero) Especifica el sexo del usuario que se ha definido en com.google.ads.ima.api.Demographics.
Valores:
- 1: hombre
- 2: mujer
Ejemplo:
- &cust_gender=1: hombre
- &cust_gender=2: mujer
host
(Cadena) ID del host que debe utilizarse para repartir los ingresos entre tres partes.
Ejemplo: &host=ca-host-test: divide los ingresos con el host especificado.
h_ch
(Cadena) Lista de cadenas más delimitada que representa los ID de canal de segmentación e informes de AdSense para el host.
Ejemplo: &h_ch=channel1+channel2+channel3. Registra los canales adicionales del host y segmenta por ellos.
ht_id
(Número) ID de nivel utilizado para especificar el nivel de reparto de ingresos entre el editor y el host.
Ejemplo: &ht_id=2: host de nivel 2
hl
(Cadena) Código de idioma que se utiliza para solicitar anuncios en dicho idioma. Puede tratarse de un código ISO 639-1 (dos letras) o ISO 639-2 (tres letras). Consulte la lista de códigos válidos.
Ejemplo:
- &hl=en: inglés
- &hl=es: español
max_ad_duration
(Entero) Especifica la duración máxima del vídeo que debe devolverse, en milésimas de segundo. Si no se establece ningún valor, se utilizará el valor de 100 segundos de forma predeterminada.
Ejemplo: &max_ad_duration=30000: la duración máxima de los anuncios no saltables será de 30 segundos.
min_ad_duration
(Entero) Especifica la duración mínima del vídeo que debe devolverse, en milésimas de segundo. El valor predeterminado es 0 segundos, a menos que se indique otro distinto.
Ejemplo:
- &min_ad_duration=15000: la duración de los anuncios devueltos no saltables deberá ser de 15 segundos o más.
- &min_ad_duration=0: la duración solo se verá limitada por el valor max_ad_duration.
sdmax
(Entero) Especifica la duración máxima del vídeo de los anuncios saltables, en milésimas de segundo. Si no se establece ningún valor, el predeterminado es "unlimited".
Ejemplo: &sdmax=120000: la duración de los anuncios saltables devueltos no puede superar los 2 minutos.
