Macros de Xandr

Las macros se usan para rellenar las URL (como las que se encuentran en las creatividades) con información útil. Son esencialmente variables que nuestro servidor de anuncios expande con cualquiera que sea su valor real en el momento de la llamada al anuncio.

Esta página contiene información sobre todas las macros que se admiten. Para cada macro, mostramos la información con la que se reemplaza esa macro durante la llamada del anuncio.

Sugerencia

Para tener más control sobre la codificación y descodificación de direcciones URL, consulte la sección sobre macros de función.

Para obtener ejemplos adicionales sobre cómo se > pueden utilizar las macros al cargar creatividades, consulta la página Servicio de creatividades .

Macros creativas

Advertencia

Las macros OpenRTB (como ${AUCTION_PRICE}) no son compatibles cuando se añaden creatividades mediante el servicio creativo. Solo se admiten en la respuesta a la oferta.

Xandr admite las siguientes macros creativas al añadir creatividades mediante el servicio creativo.

Macro	Descripción
`${CLICK_URL}`	La URL de seguimiento de clics.
`${CLICK_URL_ENC}`	La URL de seguimiento de clics codificada (solo necesaria para algunos servidores de anuncios de terceros)
`${AUCTION_ID}`	Un identificador único de 64 bits para la subasta específica que produjo la impresión. Cada `placement_id` uno en una solicitud de oferta tendrá su propio identificador de subasta único, que también coincidirá con las respuestas de oferta correspondientes para esa ubicación. Esta macro se recomienda para la conciliación y el seguimiento de discrepancias.
`${TAG_ID}`	El id. de Xandr TinyTag que originó la solicitud de puja
`${EXT_APP_ID}`	El identificador externo de la aplicación que solicita la impresión. Esto es muy útil para las impresiones de aplicaciones móviles.
`${CREATIVE_ID}`	El id. creativo que ganó la impresión.
`${DEAL_ID}`	El id. de oferta de Xandr asociado a la oferta ganadora, si procede. Si no hay trato, devolverá 0.
`${ECP}`	El lado del publicador Precio claro estimado para la subasta.
`${RESERVE_PRICE}`	El precio de reserva establecido por el editor.
`${SESSION_FREQ}`	La frecuencia de sesión del usuario.
`${AGE}`	La edad del usuario (si está disponible). Entero (por ejemplo, 26) o 0.
`${GENDER}`	El sexo del usuario (si está disponible). Los valores son "f", "m", "u".
`${CACHEBUSTER}`	Una cadena generada aleatoriamente que se usa para evitar el almacenamiento en caché de direcciones URL. El valor se genera una vez por respuesta a la oferta, por lo que si una solicitud de oferta contiene varios `placement_id` valores, se utilizará el mismo valor de Cachebuster en ellos. Para la conciliación y el seguimiento de las discrepancias, se recomienda usar `${AUCTION_ID}` en su lugar.
`${PRICE_PAID}`	El precio pagado por esta impresión. (A diferencia de la oferta de precio, antes de la reducción de precio).
`${SECOND_PRICE}`	El precio que representa la segunda puja más alta en una subasta. Expresado en formato de número de punto flotante (por ejemplo, 1,23)
`${REFERER_URL}`	Si está disponible, la dirección URL de referencia para este inventario. Nota: Este campo está en desuso (a partir de mayo de 2016). Use ${REFERER_URL_ENC} en su lugar.
`${REFERER_URL_ENC}`	La URL de referencia codificada.
`${BID_PRICE}`	El precio ofertado por esta impresión en comparación con el precio pagado después de la reducción de precio.
`${TAG_CODE1}`	Código de integración establecido en el emplazamiento.
`${TAG_CODE2}`	Código de integración adicional establecido en la ubicación.
`${INV_SOURCE_ID}`	En desuso.
`${USER_ID}`	La cadena de caracteres de 64 bits de Xandr que representa al usuario para la impresión.
`${USER_IP}`	La dirección IP del usuario.
`${IS_PREVIEW}`	Si estamos "previsualizando" la creatividad, podemos pasar una bandera al servidor de terceros para que no la cuente como una impresión de producción. Si es cierto, pasamos un "1"; Si es false, pasamos un "0".
`${SELLER_MEMBER_ID}`	El miembro propietario del editor donde se origina la impresión.
`${SEG_IDS}`	Identificadores de los segmentos pertenecientes al comprador ganador en la cookie de este usuario (en orden de hora de visto por última vez). Tenga en cuenta que esta macro no funciona para segmentos compartidos (como los que son propiedad de un proveedor de datos de terceros).
`${SEG_CODES}`	Códigos para los segmentos pertenecientes al comprador ganador en la cookie de este usuario (en orden de hora de la última vez). Tenga en cuenta que esta macro no funciona para segmentos compartidos (como los que son propiedad de un proveedor de datos de terceros).
`${DATACENTER}`	Id. del centro de datos (1 = NYM, 2 = LAX, 3 = AMS)
`${USER_CITY}`	Cadena de caracteres de la ciudad del usuario
`${USER_STATE}`	Cadena de caracteres del estado del usuario (abreviatura de 2 letras. FIPS 10-4 fuera de EE. UU. y Canadá)
`${SITE_ID}`	Id. del sitio en el que se está sirviendo la impresión
`${PUBLISHER_ID}`	Id. del editor que vende la impresión
`${PUBLISHER_CODE}`	Código del editor que vende la impresión (si está disponible)
`${CREATIVE_CODE}`	Código de la creatividad servida (si está disponible)
`${CREATIVE_SIZE}`	Ancho x Alto del creativo servido (por ejemplo, `"300x250"`)
`${WIDTH}`	Ancho del creativo servido
`${HEIGHT}`	Alto de la creatividad servida
`${SUPPLY_TYPE}`	Esta macro se rellenará con un valor numérico que denota el tipo de suministro de la impresión. Los valores permitidos incluyen: 0: web 1: Web móvil 2: aplicación móvil 4: barra de herramientas
`${TIMESTAMP}`	La marca de tiempo UNIX para la subasta.
`${USER_AGENT}`	La cadena de agente de usuario del encabezado HTTP de la solicitud. El agente de usuario suele identificar dicha información como la aplicación, el sistema operativo y el proveedor de software que actúa en nombre del usuario (por ejemplo, "Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv: 1.9.0.4) Gecko / 2008102920 Firefox / 3.0.4").
`${USER_AGENT_ENC}`	La cadena de agente de usuario codificada del encabezado HTTP de la solicitud.
`${EXTENDED_IDS}`	Los identificadores (ID del sector e ID proporcionados por el editor) representan el usuario de la impresión. Estos se pasarían tal como se recibieron en la solicitud, con múltiples identificadores admitidos siguiendo el formato: `…&extended_ids=<source_1>,<id_1>\ <source_2>,<id_2>\ …` Los separadores propuestos son comas entre el origen y el valor, y un símbolo de barra vertical entre diferentes tipos de identificadores y pares de valores.

Inventario de anuncios europeos y notificación, transparencia y elección

Advertencia

Para que nuestros clientes cumplan con sus requisitos de transparencia, notificación y elección/consentimiento según la ley de privacidad estatal de EE. UU., el GDPR y la Directiva de privacidad electrónica existente, Xandr admite el Marco de Transparencia & Consentimiento de IAB Europe (el "Marco").

Esta es una referencia para los editores que utilizan las macros para mostrar aviso, transparencia y elección a los usuarios finales ubicados en los estados de EE. UU. aplicables y el EEE y a los proveedores aprobados por la señal y, cuando sea necesario, pasar el consentimiento y/o las señales de No compartir/vender a Xandr y las fuentes de demanda y sus proveedores a través de la plataforma de Xandr.

Este recurso no debe interpretarse como asesoramiento legal y Xandr no garantiza el cumplimiento de ninguna ley o reglamento. Tenga en cuenta que, dado que cada empresa y su recopilación, uso y almacenamiento de datos personales son diferentes, también debe buscar asesoramiento legal independiente en relación con las obligaciones derivadas de la legislación estatal de EE. UU. y las normativas europeas, incluido el RGPD y la Directiva de privacidad electrónica existente. Solo un abogado puede brindarle asesoramiento legal específicamente adaptado a su situación. Nada de lo dispuesto en esta guía pretende proporcionarte ni sustituirte asesoramiento jurídico adaptado a tu empresa.

Tenga en cuenta que nuestras Directivas de Parte del Servicio (para Comprar, Vender y Proveedores de Datos) incluyen obligaciones específicas de privacidad que debe tener en cuenta. Estas directivas de servicio se han actualizado a partir del 1 de enero de 2023.

Macro	Descripción
`${GDPR_APPLIES}`	Designa si se aplican las regulaciones de GDPR. En concreto, indica si el usuario se encuentra en un país o región afectado por RGPD, o si tenemos una señal requerida por RGPD pasada con la solicitud. 1 si es así, 0 si no.
`${GDPR}`	Ofrece la misma funcionalidad que `${GDPR_APPLIES}`.
`${GDPR_CONSENT_STRING}`	Esta es la cadena de consentimiento del RGPD de la IAB. Si se aplica el RGPD, tendrá una lista de proveedores aprobados por el usuario basada en el Marco de Transparencia y Consentimiento del RGPD de la IAB.
`${GDPR_CONSENT}`	Esta es la cadena de consentimiento del RGPD de la IAB según la especificación oficial del TCF 1.0. Se incluye para mantener la compatibilidad con versiones anteriores para comodidad del cliente.
`${GDPR_CONSENT_[0-9]+}`	Por ejemplo, GDPR_CONSENT_1, GDPR_CONSENT_12345 etc. Todos estos se resuelven en la misma cadena de consentimiento de GDPR que se explicó anteriormente en `'${GDPR_CONSENT_STRING}'`.
`${GPP_SID}`	Designa si se debe aplicar una sección (es decir, el marco normativo) de la Plataforma de privacidad global . En concreto, indica si el usuario se encuentra en un país o región afectado por la legislación cubierta por el GPP.
`${GPP_STRING_XXXXX*}`	Esta es la cadena de la Plataforma de privacidad global (GPP) de la IAB. Si se aplica una sección del GPP, contendrá información dependiente del marco que refleje las elecciones de consentimiento del usuario. Nota: * XXXXX puede representar cualquier identificación numérica

La siguiente tabla contiene nombres de macros reservados que no deben utilizar los clientes ofertantes. Causarán conflictos con otras tecnologías de Xandr y no se deben usar para macros personalizadas.

Nombre de macro reservado
`${ADV_CODE}`
`${ANCOST}`
`${BASE64_UID_ENC}`
`${BASE64_UID}`
`${BIDPRICE}`
`${CND}`
`${CONTENT}`
`${CREATIVE_HEIGHT}`
`${CREATIVE_WIDTH}`
`${FLASH_BACKUP_URL}`
`${FLASHVARS}`
`${IE7_FLASH_JS_URL}`
`${IF_CALLBACK_URL}`
`${IO_CODE}`
`${IO_ID}`
`${IS_PREVIEW_COL}`
`${IT_CALLBACK_URL}`
`${MATCHED_PROFILE_CODE}`
`${MATCHED_PROFILE_ID}`
`${MEDIA_SUBTYPE}`
`${MEDIA_TYPE}`
`${MEDIA_URL_ENC}`
`${MEDIA_URL}`
`${PMT_RULE_CODE}`
`${POP_CALLBACK_URL}`
`${POP_CREATIVE_MAXIMIZED}`
`${POP_IS_PREPOP}`
`${POP_IS_TAG_INITIATED}`
`${POP_WINDOW_LOCATION}`
`${POP_WINDOW_MENUBAR}`
`${POP_WINDOW_RESIZABLE}`
`${POP_WINDOW_SCROLLBARS}`
`${POP_WINDOW_STATUSBAR}`
`${POP_WINDOW_TITLE}`
`${POP_WINDOW_TOOLBARS}`
`${PRICE_PAID_ENCR}`
`${PT1}`
`${PT2}`
`${PT3}`
`${PT4}`
`${PT5}`
`${SECOND_LEVEL_CATEGORY_ID}`
`${SEG_CODES_COL}`
`${SITE_CODE}`
`${SSP_DATA}`
`${TAG_HEIGHT}`
`${TAG_WIDTH}`
`${TOP_LEVEL_CATEGORY_ID}`
`${TRACKER_ID}`
`${UID}`
`${USER_COUNTRY}`
`${VENUE_ID}`

Macros móviles

Macro	Descripción
`${GEO_LAT}`	La latitud de la ubicación del usuario, cuando los datos GPS están disponibles desde un dispositivo móvil. Expresado en el formato "snn.ddd,snn.ddd" (por ejemplo, `+12.345` o `-45.123`), donde sur se representa como negativo. Puede haber un máximo de 5 decimales de precisión.
`${GEO_LON}`	La longitud de la ubicación del usuario, cuando los datos GPS están disponibles desde un dispositivo móvil. Expresado en el formato "snn.ddd,snn.ddd" (por ejemplo, `+12.345` o `-45.123`), donde oeste se representa como negativo. Puede haber un máximo de 5 decimales de precisión.
`${EXT_APP_ID}`	El identificador externo de la aplicación que solicita la impresión. Esto solo es útil para las impresiones de aplicaciones móviles.
`${DEVICE_MD5}`	El identificador único cifrado MD5 que representa el dispositivo móvil.
`${DEVICE_SHA1}`	Identificador único cifrado SHA1 que representa el dispositivo móvil.
`${DEVICE_OPENUDID}`	El identificador único cifrado con OPENUDID que representa el dispositivo móvil.
`${DEVICE_ODIN}`	El identificador único cifrado con ODIN que representa el dispositivo móvil.
`${DEVICE_AAID}`	El identificador de publicidad de Android, cuando la impresión procede de un dispositivo Android.
`${DEVICE_APPLE_IDA}`	El identificador de publicidad de Apple, cuando la impresión procede de un dispositivo Apple.
`${DEVICE_MAKE_ID}`	El entero Xandr que representa el ID de la marca del dispositivo móvil (por ejemplo, `26`). Para obtener una lista completa de los ID de marcas de dispositivos móviles, consulte el servicio Device Make.
`${DEVICE_MODEL_ID}`	El entero Xandr que representa el id. del modelo de dispositivo móvil (por ejemplo, 301). Para obtener una lista completa de los identificadores de modelo de dispositivo móvil, consulte el Servicio de modelo de dispositivo.
`${DEVICE_WIN_ID}`	El id. de Windows AD del dispositivo en el que se produjo esta impresión (si procede).
`${CARRIER_ID}`	El entero Xandr que representa el identificador del operador de telefonía móvil. Para obtener una lista completa de los ID de los operadores de telefonía móvil, consulte el Servicio del operador.
`${SUPPLY_TYPE}`	Esta macro se rellenará con un valor numérico que denota el tipo de suministro de la impresión. Los valores permitidos incluyen: 0: web 1: Web móvil 2: aplicación móvil 4: barra de herramientas

Macros de función

Una macro de función, un tipo especial de macro que realiza una función en otra macro. Las macros de función se pueden usar en combinación con cualquier otra macro creativa, incluidas las macros personalizadas, aunque si no se reconocen en el momento del renderizado, no se traducirán y no se llamará a la función.

Xandr admite actualmente la macro de función, que se puede usar para una variedad de propósitos relacionados con la {$URL_ENC} codificación. Un caso de uso clave es cuando una URL debe pasarse de un servidor de anuncios a otro a través de una macro creativa y, debido a la presencia de caracteres no admitidos en el formato de URL estándar, debe codificarse en varios pasos del proceso.

La macro adopta la forma siguiente:

 ${URL_ENC(${MACRO_NAME},#)}

donde ${MACRO_NAME} es la macro que se va a codificar y # es el entero 1, 2o 3, que representa el número de veces que se codifica el contenido. Tenga en cuenta que no se admiten más de tres codificaciones.

Nota:

Cada codificación corresponde a un paso de la cadena de redireccionamiento, así como a cómo funciona un rastreador de clics de terceros determinado con la macro. Por lo general, se necesitará doble codificación para las URL de destino final cuando haya un segundo servidor de anuncios involucrado, y triple codificación para un tercer servidor de anuncios.

Para determinar si tendrá que usar la codificación simple, doble o triple, debe consultar con el rastreador de clics de terceros y, a continuación, probar la URL_ENC macro para asegurarse de que funciona. Si la macro no funciona, una consecuencia de esto puede ser la rotura del vínculo, lo que provocará que los usuarios no lleguen a la URL de destino prevista.

Ejemplos de codificación

Para codificar, haga clic en la URL una vez

${URL_ENC(${CLICK_URL},1)}

Si https://xandr.com se pasa como URL de clic, si se usa ${URL_ENC(${CLICK_URL},1)} para codificar una sola URL, se rellenará https%3A%2F%2Fxandr.com la creatividad.

Para codificar una vez la dirección URL de los medios:

 ${URL_ENC(${MEDIA_URL},1)}

Para codificar dos veces la dirección URL del medio:

 ${URL_ENC(${MEDIA_URL},2)}

Para codificar una macro personalizada denominada ADFORMAT una vez:

${URL_ENC(${ADFORMAT},1)}

Last updated on 2026-08-19