Sube código de la creatividad con una solicitud sin etiqueta

En lugar de una etiqueta de anuncio, puedes usar una solicitud sin etiqueta para solicitar el código de la creatividad sin formato cuyos anuncios se coordinaron en Ad Manager. Por lo general, las solicitudes sin etiqueta se usan cuando se requieren una visualización y un análisis personalizados, como en decodificadores y otros entornos que no admiten SDK o etiquetado de Google.

Cuando realizas una solicitud sin etiqueta, Ad Manager solo muestra el código de la creatividad sin formato, tal como se envió con coordinación de anuncios, sin ejecutar ni mostrar el anuncio. Si no se encuentra un anuncio, se muestra un código 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 seguimiento de impresiones.

No debería utilizarse una solicitud sin etiqueta para publicar anuncios en correo electrónico. Consulte todas las funciones no admitidas.

Crea una solicitud sin etiqueta manualmente

Para crear una solicitud sin etiqueta, comienza con la URL base, incluye todos los parámetros requeridos y cualquier parámetro opcional adicional. Estos parámetros especifican elementos como la unidad de anuncios, el tamaño de la creatividad, los pares clave-valor y otros datos sobre la solicitud.

Las solicitudes sin etiqueta deben realizarse de forma segura mediante SSL (https://).

Comience con una URL base

Use esta URL base:  https://securepubads.g.doubleclick.net/gampad/adx?

Especifique los parámetros de su solicitud de anuncio

Parámetros obligatorios

Parámetro	Descripción
iu	Código de la unidad de anuncios de Google Ad Manager que incluye el código de su red de Google Ad Manager. Para incluir varios niveles, utilice el carácter de barra oblicua (/) como separador. Ejemplo iu=/123/homepage iu=/456/sports/baseball Cuando uses la Administración de varios clientes (MCM) con solicitudes sin etiqueta, usa la estructura parent,child para el código de red. Ejemplo (MCM) iu=/123,456/homepage
sz	Tamaño de creatividad. Para incluir varios tamaños, utilice el carácter de barra vertical (|) como separador. Ejemplo sz=320x50 para un tamaño único sz=320x50|300x50 para varios tamaños Recomendamos que codifiques los caracteres de barra vertical (|) en solicitudes sin etiqueta con %7c. Ejemplo &sz=216x36|300x50|320x50 se convierte en &sz=216x36%7c300x50%7c320x50.
url	Es la URL del dominio que aloja la solicitud de anuncio inicial. Solo se requiere para las solicitudes de MCM. Ejemplo url=www.example.com
c	Valor de correlator (o de almacenamiento en memoria caché). Debe ser un número al azar (no se admiten letras) generado por un publicador para garantizar que se produzca una nueva llamada al servidor de anuncios cada vez que se cargue la página. De este modo, se evitan discrepancias en el recuento de impresiones. Ejemplo c=8362527364
tile	Posición de la etiqueta en una página web. El valor debe ser un número entero único. Para facilitar la implementación, recomendamos el uso de valores en orden ascendente. Solo es necesario si varias etiquetas de anuncio usan los mismos valores de código de unidad de anuncios (iu=) y correlator (c=) en la misma página. Ejemplo https://securepubads.g.doubleclick.net/gampad/adx?iu=/1234/homepage&sz=320x50&c=54631&tile=1 https://securepubads.g.doubleclick.net/gampad/adx?iu=/1234/homepage&sz=320x50&c=54631&tile=2

Parámetros opcionales

Parámetro	Descripción
d_imp	Activa o desactiva las impresiones retrasadas. Si se utiliza, se desactiva el recuento de impresiones al solicitarlo y se usa la macro de impresión vista en la creatividad mostrada o bien la información del parámetro d_imp_hdr para registrar una impresión. Ejemplo d_imp=1 d_imp=0 (Este es el valor predeterminado para el recuento de impresiones de Google Ad Manager).
d_imp_hdr	Activa o desactiva la información del encabezado de impresiones retrasadas. Si se activa, la URL de visualización que se utiliza en el recuento de impresiones se muestra en el encabezado HTTP. De forma predeterminada, la información de este encabezado no está definida. A continuación, el publicador debe hacer ping en esta URL de visualización para contar una impresión. Obtén más información sobre el recuento de impresiones y las solicitudes sin etiqueta. El encabezado Google-Delayed-Impression contiene la URL de impresión de Google Ad Manager. El encabezado Google-3rdParty-Delayed-Impression contiene la URL de la impresión de terceros si se encuentra en la creatividad. Ejemplo d_imp_hdr=1 d_imp_hdr=0 (Inhabilita de manera explícita la información del encabezado de las impresiones retrasadas).
t	Pares clave-valor a nivel de espacio publicitario. Las claves y los valores se separan con el signo = (igual). Los pares clave-valor se separan con el signo & (et). Cada clave y valor debe tener una codificación de URL individual y, después, se debe aplicar una codificación URL a toda la cadena. Cada clave dentro de un conjunto de pares clave-valor debe ser única. 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 "género" al valor "acción" y la clave "película" a "Sr. y Sra. Smith". Tenga en cuenta que el carácter "&" entre asignaciones de par clave-valor se codifica de forma única (%26), pero se codifica de forma doble (%2526) cuando aparece en un valor. Use excl_cat como clave especial para las exclusiones de competencia. Ejemplo t=excl_cat%3Dairlines t=interest%3Dsports%2Cnews%26excl_cat%3Dairlines No se permiten los siguientes caracteres en claves ni en valores: " ' ! + # * ~ ; ^ ( ) < > [ ] = . Se permite el uso de espacios en los valores, con caracteres de escape como %20 o +, pero no en las claves. Ejemplo Si define la clave "a" para el valor "b+c" con t=a%3Db%252Bc, no funcionará.
m	Valor de tipo MIME en el encabezado HTTP. Ejemplo m=text/wml
mob	Indicador de solicitud de anuncio para dispositivos móviles. Ejemplo mob=js (Este es el único valor que se acepta).
ppid	El parámetro de identificador proporcionado por el publicador (PPID) te permite enviar a Google Ad Manager un identificador para usar en la limitación de frecuencia, la rotación secuencial de anuncios, la segmentación y orientación por público, y otros controles de publicación de anuncios basados en el público en todos los dispositivos. Ejemplo ppid=12JD92JD8078S8J29SDOAKC0EF230337
u_w	Ancho de la pantalla del dispositivo móvil, que anula la detección automática que realiza 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 realiza 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 realiza el servidor de anuncios. Ejemplo submodel=iPhone4%2C1 (La coma para delimitar el valor del submodelo se codifica). Valores de 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 usar un ID de dispositivo que el usuario puede restablecer (RDID) para la limitación de frecuencia y la segmentación por público. Obtén más información sobre la configuración del RDID para solicitudes sin etiqueta.

Active el seguimiento de impresiones

Ad Manager puede realizar un seguimiento de las impresiones descargadas, también conocidas como impresiones "retrasadas", para solicitudes sin etiqueta. Use una de las siguientes opciones, no las dos juntas, ya que esto podría duplicar (o triplicar) el recuento de las impresiones.

Recomendamos usar la opción 1, pero para ello debe tener acceso a encabezados de respuesta HTTP y poder implementar un protocolo basado en encabezados.

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

Agrega los parámetros d_imp=1 y d_imp_hdr=1 a tu solicitud sin etiqueta para que Google Ad Manager no registre una impresión o una impresión descargada hasta que actives de forma manual un ping de la impresión con la URL del encabezado HTTP Google-Delayed-Impression. Cuando se activa el ping de la impresión, Google Ad Manager registra una "impresión del servidor de anuncios" y una "impresión descargada del servidor de anuncios".

Para no contar una impresión dos veces, no incluyas la macro de impresión vista para las creatividades que devuelven las solicitudes sin etiqueta.

Opción 2: usar la macro de impresión vista

Si no puedes acceder a los encabezados de respuesta HTTP, debes segmentar el inventario y agregar la macro de impresión vista al fragmento de código de cada creatividad que devuelva una etiqueta de URL simplificada. Esta macro se expande a una URL que envía una creatividad cuando se procesa.

Realiza una solicitud sin etiqueta para recuperar el código de la creatividad

Contenido web

Las solicitudes sin etiqueta se usan generalmente en entornos sin compatibilidad con SDK o etiquetado de Google. Si cargas una solicitud sin etiqueta en la Web, debes hacerlo en un <iframe> para poder ejecutar el código sin formato que se muestra.

Entornos personalizados sin un SDK de Google

Para recuperar el código de la creatividad sin formato en entornos sin etiquetado de Google o compatibilidad con SDK (por ejemplo, un decodificador que no sea de Google), consulte los siguientes lineamientos:

• Establezca un usuario-agente válido en el encabezado de la solicitud de Usuario-agente para verificar que la segmentación funciona como corresponde.
• Asegúrese de que su entorno admita comportamientos de Rich Media, incluida la expansión de la creatividad y JavaScript.
• Realice una solicitud HTTPS a Google Ad Manager.
• Revise el estado de la respuesta para encontrar "HTTP 200/OK", que indica que la solicitud está bien formada.

Funciones no admitidas con solicitudes sin etiqueta

• Vista activa
• Ad Exchange
• Identificadores de aplicaciones para dispositivos móviles o cookies que se utilizan para el seguimiento
• Envoltorios de creatividad
• Asignación dinámica con AdSense, Ad Exchange o AdMob
• Inventario nativo
• Acuerdos preferidos
• Vistas previas de las creatividades

Las solicitudes sin etiqueta que usan gampad/ad en etiquetas de imágenes HTML (<img>) no admiten código de seguimiento de JavaScript ni son compatibles para el recuento de impresiones descargadas.

Para generar informes de estos anuncios, use la métrica "Recuento total de veces en las que se publicó el código" en los informes de Ad Manager.