Cargar código de creatividades mediante solicitudes sin etiquetas

Puede solicitar código sin formato de creatividades cuyo traficado se haya hecho en Ad Manager mediante solicitudes sin etiquetas de anuncios. Por lo general, estas solicitudes se usan cuando hace falta personalizar el análisis y la visualización de las creatividades, por ejemplo, en decodificadores o en otros entornos que no admiten etiquetas ni SDKs de Google.

Al enviar solicitudes sin etiquetas a Ad Manager, esta plataforma solo devuelve el código sin formato de una creatividad tal como se ha traficado, sin ejecutar ni mostrar el anuncio. Si no se encuentra un anuncio, se devuelve un estado 200/OK con una respuesta vacía.

Su aplicación, reproductor o sitio debe ejecutar el código para mostrar el anuncio y activar el registro de impresiones.

Las solicitudes sin etiquetas no deben utilizarse para servir anuncios en correos electrónicos. Consulte todas las funciones que no se admiten.

Crear manualmente solicitudes sin etiquetas

Para crear solicitudes sin etiquetas, tiene que partir de una URL básica y, a continuación, ir incluyendo en ella todos los parámetros obligatorios, seguidos de cualquier parámetro opcional que tenga. En esos parámetros se indican varios elementos, como el bloque de anuncios, el tamaño de la creatividad, los pares clave-valor y otros datos de la solicitud.

Las solicitudes sin etiquetas se deben hacer de forma segura mediante SSL (https://).

Empezar con una URL básica

Utilice esta URL básica:  https://securepubads.g.doubleclick.net/gampad/adx?

Especificar los parámetros de la solicitud de anuncio

Parámetros obligatorios

Parámetro	Descripción
iu	Código de bloque de anuncios de Google Ad Manager que incluye el código de red de Google Ad Manager. Para incluir varios niveles, utilice una barra (/) como separador. Ejemplo iu=/123/paginaprincipal iu=/456/deportes/beisbol Cuando utilice Administración de Múltiples Clientes (MCM) con las solicitudes sin etiquetas, utilice la estructura principal,secundaria para el código de red. Ejemplo (MCM) iu=/123,456/paginaprincipal
sz	Tamaño de la creatividad. Para incluir varios tamaños, utilice una barra vertical (|) como separador. Ejemplo sz=320x50 para un tamaño sz=320x50|300x50 para varios tamaños Recomendamos que en las solicitudes sin etiquetas codifique las barras verticales (|) con %7c. Ejemplo &sz=216x36|300x50|320x50 se convierte en &sz=216x36%7c300x50%7c320x50.
url	URL del dominio que aloja la solicitud de anuncio inicial. Solo es obligatorio en las solicitudes de MCM. Ejemplo url=www.example.com
c	Valor de correlacionador (o de almacenamiento en memoria caché). Debe ser un número aleatorio generado por un editor para asegurar que se produzca una nueva llamada al servidor de anuncios cada vez que se cargue la página, para evitar discrepancias de recuento de impresiones. No se pueden usar letras. Ejemplo c=8362527364
tile	Posición de la etiqueta en una página web. El valor debe ser un número entero único. Le recomendamos que, para facilitar la implementación, utilice los valores en orden ascendente. Solo es necesario si varias etiquetas de anuncio usan los mismos valores de código de bloque de anuncios (iu=) y correlacionador (c=) en la misma página. Ejemplo https://securepubads.g.doubleclick.net/gampad/adx?iu=/1234/paginaprincipal&sz=320x50&c=54631&tile=1 https://securepubads.g.doubleclick.net/gampad/adx?iu=/1234/paginaprincipal&sz=320x50&c=54631&tile=2

Parámetros opcionales

Parámetro	Descripción
d_imp	Habilita o inhabilita las impresiones retrasadas. Si se incluye este parámetro, se dejan de contar impresiones en cuanto se envía la solicitud y se registran con la macro de impresiones vistas incluida en la creatividad devuelta o con la información del parámetro d_imp_hdr. Ejemplo d_imp=1 d_imp=0. Este es el valor predeterminado del recuento de impresiones de Google Ad Manager.
d_imp_hdr	Habilita o inhabilita la información del encabezado de impresiones retrasadas. Si se incluye, la URL de visualización que se utiliza en el recuento de impresiones se devuelve en el encabezado HTTP. De forma predeterminada, la información de este encabezado no está definida, por lo que el editor debe hacer ping manualmente en esta URL de visualización para contar impresiones. Más información sobre el recuento de impresiones y las solicitudes sin etiqueta En el encabezado Google-Delayed-Impression se incluye la URL de impresión de Google Ad Manager. El encabezado Google-3rdParty-Delayed-Impression contiene la URL de impresión de terceros, si está presente en la creatividad. Ejemplo d_imp_hdr=1 d_imp_hdr=0. Inhabilita la información del encabezado de impresiones retrasadas.
t	Pares clave-valor en el nivel de espacio publicitario. Las claves y los valores se separan con el signo = (igual). Los pares clave-valor, por su parte, se separan con el signo & (et). Cada clave y valor debe tener una codificación de URL individual y, además, se debe aplicar a toda la cadena. Todas las claves que haya en un conjunto de pares clave-valor deben ser únicas. Si proporciona la misma clave más de una vez, solo se tendrá en cuenta uno de los valores asociados. Ejemplo El parámetro t=genre%3Daction%26movie%3DMr+%2526+Mrs+Smith asigna la clave "genre" al valor "action" y la clave "movie" a "Mr & Mrs Smith". Tenga en cuenta que el carácter "&" entre asignaciones de pares clave-valor se codifica de forma única (%26), pero se codifica de forma doble (%2526) cuando aparece en un valor. Utilice excl_cat como clave especial para exclusiones de competencia. Ejemplo t=excl_cat%3Dairlines t=interest%3Dsports%2Cnews%26excl_cat%3Dairlines Los siguientes caracteres no están permitidos en claves ni en valores: " ' ! + # * ~ ; ^ ( ) < > [ ] =. Se permiten espacios en los valores (con caracteres de escape como %20 o +), pero no en las claves. Ejemplo Si quiere asignar el valor "b+c" a la clave "a", no puede utilizar t=a%3Db%252Bc, porque no funcionará.
m	Valor tipo MIME en el encabezado HTTP. Ejemplo m=text/wml
mob	Indicador de solicitud de anuncio para móviles. Ejemplo mob=js. Este es el único valor que se acepta.
u_w	Anchura de la pantalla del dispositivo móvil, que anula la detección automática que hace el servidor de anuncios. Ejemplo u_w=1024
u_h	Altura de la pantalla del dispositivo móvil, que anula la detección automática que hace el servidor de anuncios. Ejemplo u_h=768
submodel	Información de hardware del dispositivo móvil, que anula la detección automática que hace el servidor de anuncios. Ejemplo submodel=iPhone4%2C1. Se codifica la coma que delimita el valor submodelo. Valores de los submodelos: iPhone (primera generación): iphone1,1 iPhone 3G: iphone1,2 iPhone 3GS: iphone2,1 iPhone 4 (GSM): iphone3,1 iPhone 4 (GSM): iphone3,2 iPhone 4 (CDMA): iphone3,3 iPhone 4S: iPhone4,1 iPhone 5 (GSM y LTE): iPhone5,1 iPhone 5 (CDMA y LTE): iPhone5,2 iPhone 5c: (GSM y CDMA): iPhone5,3 iPhone 5c (GSM y CDMA): iPhone5,4 iPhone 5s (GSM y CDMA): iPhone6,1 iPhone 5s (GSM y CDMA): iPhone6,2 iPhone 6: iPhone7,2 iPhone 6 Plus: iPhone7,1 iPhone 6s: iPhone8,1 iPhone 6s Plus: iPhone8,2 iPhone SE: iPhone8,4 iPhone 7: iPhone9,1 iPhone 7 Plus: iPhone9,2  iPod de primera generación: iPod1,1 iPod de segunda generación: iPod2,1 iPod de tercera generación: iPod3,1 iPod de cuarta generación: iPod4,1 iPod de quinta generación: iPod5,1 iPad de primera generación (Wi-Fi): iPad1,1 iPad de primera generación (AT&T): iPad1,2 iPad de segunda generación (Wi-Fi): iPad2,1 iPad de segunda generación (AT&T): iPad2,2 iPad de segunda generación (Verizon): iPad2,3 iPad de segunda generación (Wi-Fi): iPad2,4 iPad de tercera generación (Wi-Fi): iPad3,1 iPad de tercera generación (Verizon): iPad3,2 iPad de tercera generación (AT&T): iPad3,3 iPad de cuarta generación (Wi-Fi): iPad3,4 iPad de cuarta generación (AT&T): iPad3,5 iPad de cuarta generación (Verizon): iPad3,6 iPad Mini (Wi-Fi): iPad2,5 iPad Mini (AT&T-US; GSM y LTE 4, 17): iPad2,6 iPad Mini (Verizon-World; GSM, DMA y LTE 1,3,5,13,25): iPad2,7 iPad Mini Retina (Wi-Fi): iPad4,4 iPad Mini Retina (LTE): iPad4,5 iPad Air (Wi-Fi): iPad4,1 iPad Air (LTE): iPad4,2

 

Puede utilizar un ID de dispositivo que se puede cambiar (RDID) para limitar la frecuencia y segmentar por audiencia. Más información sobre cómo configurar RDID en solicitudes sin etiqueta

Activar registro de impresiones

Ad Manager puede registrar impresiones descargadas (también denominadas "impresiones retrasadas") en las solicitudes sin etiquetas. Puede utilizar cualquiera de las opciones que se detallan a continuación, pero no todas a la vez, ya que es posible que algunas impresiones se contabilicen dos o tres veces si lo hace.

Le recomendamos que elija la opción 1, aunque para hacerlo debe tener acceso a encabezados de respuesta HTTP e implementar un protocolo basado en encabezados.

Opción 1: Leer el encabezado de respuesta HTTP para controlar el recuento de impresiones

Añada los parámetros d_imp=1 y d_imp_hdr=1 a sus solicitudes sin etiquetas para que Google Ad Manager no registre ninguna impresión ni ninguna impresión descargada hasta que active manualmente un ping de impresiones que incluya la URL de encabezado HTTP Google-Delayed-Impression. En ese momento, Google Ad Manager registrará tanto una impresión del servidor de anuncios como una impresión descargada del servidor de anuncios.

Para que no se contabilicen impresiones dos veces, no incluya la macro de impresiones vistas en las creatividades que se devuelvan en solicitudes sin etiquetas.

Opción 2: Incluir la macro de impresiones vistas

Si no puede acceder a los encabezados de respuesta HTTP, segmente su inventario y añada la macro de impresiones vistas al fragmento de código de todas las creatividades que se devuelvan en solicitudes sin etiquetas. Esta macro se expande a una URL que la creatividad debe enviar cuando se renderiza.

Hacer una solicitud sin etiquetas para obtener el código de creatividades

Contenido web

Por lo general, las solicitudes sin etiquetas se utilizan en entornos que no admiten etiquetas ni SDKs de Google. Si quiere hacer una solicitud sin etiquetas en la Web, debe cargarla en un <iframe> para ejecutar el código sin formato que se devuelve.

Entornos personalizados sin un SDK de Google

Para obtener el código sin formato de creatividades en entornos que no admiten etiquetas ni SDKs de Google, como los decodificadores que no son de Google, siga estas directrices:

• Defina un user-agent válido en el encabezado de solicitud User-Agent para comprobar que la segmentación funcione correctamente.
• Compruebe que su entorno admite comportamientos de rich media, incluida la expansión de creatividades y JavaScript.
• Envíe una solicitud HTTPS a Google Ad Manager.
• Revise el estado de la respuesta para ver si aparece "HTTP 200/OK", que indica que la solicitud está bien formada.

Funciones no compatibles con las solicitudes sin etiquetas

• Active View
• Ad Exchange
• Las cookies o los identificadores de aplicaciones móviles que se utilizan para hacer el seguimiento
• Envoltorios de creatividades
• La asignación dinámica de AdSense, Ad Exchange o AdMob
• El inventario nativo
• Los acuerdos preferentes
• La vista previa de creatividades

En las solicitudes sin etiqueta que usan gampad/ad en etiquetas de imagen HTML (<img>), no se puede usar el código de seguimiento de JavaScript ni se pueden contar impresiones descargadas.

Los datos de estos anuncios se registran en la métrica Total de códigos servidos de los informes de Ad Manager.