Una macro es un comando corto o abreviatura para una instrucción y normalmente sigue el formato ${MACRO_NAME}
. Las macros incluidas en el código creativo o en las URL de pulsación se expanden en una cadena de código más larga que el servidor de publicidad pueda comprender. El servidor de publicidad de DSP ejecuta macros cuando se presenta o se hace clic en el anuncio.
Las macros del servidor de publicidad son útiles para pasar información importante a DSP o a servidores de publicidad de terceros. Las macros se utilizan habitualmente durante el tráfico de metadatos o código creativo personalizado o de terceros (como píxeles de terceros).
Puede insertar manualmente una macro en cualquier lugar, como en una etiqueta VAST, en cualquier URL o en un DSP o en un píxel de evento de terceros. Sin embargo, cada cliente DSP y socio tiene un formato de etiqueta de publicidad diferente, y las macros deben insertarse en diferentes puntos de la etiqueta en consecuencia. Cada vez que trabaje con un cliente o socio nuevo, pídale documentación sobre dónde insertar las macros en sus etiquetas de publicidad que DSP los traficantes.
Utilice macros de seguimiento generales en todos los tipos de anuncios y etiquetas para devolver datos específicos, según sea necesario.
Macro | Descripción de reemplazo | Tipo |
---|---|---|
${TM_ACCOUNT_ID} |
El ID de cuenta. | integer |
${TM_AD_ID} |
La clave de anuncio (adKey). | string |
${TM_AD_ID_NUM} |
El ID de anuncio. | integer |
${TM_ADVERTISER_ID} |
El ID del anunciante. | integer |
${TM_CAMPAIGN_ID} |
La clave de campaña. | string |
${TM_CAMPAIGN_ID_NUM} |
El ID de campaña. | integer |
${TM_CLICK_URL} |
La dirección URL de redireccionamiento, que permite a los servidores de publicidad rastrear y contar clics de publicidad. Cuando se presenta la publicidad, si el usuario hace clic en ella, la macro se activa y el clic se registra y se cuenta para los informes. | string |
${TM_CLICK_URL_URLENC} |
La dirección URL de redireccionamiento codificada, que permite a los servidores de publicidad rastrear y contar clics de publicidad. Cuando se presenta la publicidad, si el usuario hace clic en ella, la macro se activa y el clic se registra y se cuenta para los informes. No utilice esta macro a menos que esté creando publicidades de terceros y que el proveedor requiera codificación de URL. | string |
${TM_FEED_ID} |
La clave para la colocación de contenido (feedKey). | string |
${TM_FEED_ID_NUM} |
ID de la ubicación del contenido. | integer |
${TM_MACRO_PLACEMENT_SITE_KEY |
La clave del sitio para la ubicación. Requerido para AppsFlyer rastreadores de clics para anuncios de instalación de aplicaciones móviles. | string |
${TM_PLACEMENT_ID} |
La clave de colocación (cpKey). | string |
${TM_PLACEMENT_ID_NUM} |
El ID de colocación. | integer |
${TM_RANDOM} |
Cachebuster: un número aleatorio entre 1 y 100000. | long |
${TM_SESSION_ID} |
El ID de la sesión, que corresponde a una sola recuperación de la etiqueta de publicidad. | string |
${TM_SITE_DOMAIN_URLENC} |
El subdominio de página analizado desde la dirección URL en la solicitud de oferta; Con codificación de dirección URL. No es compatible con los anuncios en banners y clics para reproducir. | string |
${TM_SITE_NAME} |
El nombre del sitio para la ubicación. | string |
${TM_SITE_URL_URLENC} |
La URL pasada en la solicitud de oferta; Con codificación de dirección URL. No es compatible con los anuncios en banners y clics para reproducir. | string |
${TM_SITE_ID_NUM} |
ID del sitio para la ubicación. | integer |
${TM_TIMESTAMP} |
Marca de tiempo Unix que indica el número de segundos transcurridos desde la medianoche (00:00 UTC) el 1 de enero de 1970. | long |
${TM_VIDEO_DURATION} |
Duración del vídeo del anuncio en segundos. | integer |
Macro | Descripción de reemplazo | Tipo |
---|---|---|
${CS_PLATFORM_ID} |
(ComScore) El ID de plataforma, que corresponde al sistema operativo del dispositivo:
|
varchar(50) |
${CS_DEVICE_MODEL} |
(ComScore) El nombre del modelo de dispositivo, con codificación URL. | string |
${CS_IMPLEMENTATION_TYPE} |
(ComScore) El entorno en el que se publicó el anuncio:
|
cadena (a o b ) |
${NS_PLATFORM_ID} |
(Nielsen) El ID de plataforma, que corresponde al sistema operativo del dispositivo:
|
string |
${NS_DEVICE_GROUPING} |
(Nielsen) El tipo de dispositivo en el que se vio el anuncio:
|
string |
${UOO} |
(Nielsen) Indica si el usuario ha excluido o no el seguimiento de anuncios:
|
integer (0 o 1 ) |
${TM_BUNDLE} |
La variable iOS o Android ID del paquete de la tienda de aplicaciones. Ejemplos: com.zynga.www2.free o id804379658 | string |
gdpr=${GDPR_ENFORCED}&gdpr_consent=${GDPR_CONSENT} |
gdpr=${GDPR_ENFORCED} indica si el ofertante determina que la solicitud de oferta procede del origen de la Unión Europea y requiere la aplicación del RGPD:
gdpr_consent=${GDPR_CONSENT} es el valor de consentimiento pasado del socio de suministro en la solicitud de oferta entrante:
|
daisybit o integer |
Para rastrear con precisión los clics de los anuncios que utilizan etiquetas de visualización de terceros, DSP requiere una macro de clic en pantalla. Solo se requiere una versión de la macro; la macro correspondiente depende del tipo de etiqueta.
Macro | Descripción de reemplazo | Tipo |
---|---|---|
${TM_CLICK_URL} |
Dirección URL de redireccionamiento que permite a los servidores de publicidad rastrear y contar los clics de publicidad en la plataforma. | string |
${TM_CLICK_URL_URLENC} |
Dirección URL de redireccionamiento que permite a los servidores de publicidad que requieren codificación de dirección URL rastrear y contar los clics de publicidad en la plataforma. | string |
DSP inserta automáticamente las macros de clics de visualización en una etiqueta de visualización de terceros al:
Si falta una macro de clic al crear un anuncio en pantalla, DSP muestra un mensaje de advertencia en el que se le pide que inserte manualmente la macro de clic en pantalla adecuada en el área correcta de la etiqueta.
Cuando agregue macros al código, asegúrese de utilizar la sintaxis exacta de la macro. Al validar las macros, DSP comprueba que la macro coincida exactamente con una de las macros válidas.
Los errores se generan si faltan caracteres desde el principio o el final del nombre de la macro. Por ejemplo, verá un mensaje de error si:
${
. Si no se incluye la sintaxis completa, la entrada no se reconoce como una macro válida.}
.