Macros Xandr

Las macros se usan para rellenar direcciones URL (como las que se encuentran en las creatividades) con información útil. Básicamente son variables expandidas por nuestro servidor de anuncios con cualquier 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, enumeramos la información por la que se reemplaza esa macro durante la llamada al anuncio.

Sugerencia

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

Para obtener ejemplos adicionales sobre cómo se > pueden usar las macros al cargar creatividades, consulte la página de Creative Service .

Macros creativas

Advertencia

Las macros de OpenRTB (como ${AUCTION_PRICE}) no se admiten al agregar creatividades mediante Creative Service. Solo se admiten en la respuesta de la oferta.

Xandr admite las siguientes macros creativas al agregar creatividades mediante Creative Service.

Macro	Description
${CLICK_URL}	Dirección URL de seguimiento de clics.
${CLICK_URL_ENC}	Dirección URL de seguimiento de clic codificada (solo es necesaria para algunos servidores de anuncios de terceros)
${AUCTION_ID}	Cadena de caracteres de 64 bits que representa la subasta individual que condujo a la impresión.
${TAG_ID}	Identificador de Xandr TinyTag que originó la solicitud de puja
${EXT_APP_ID}	Identificador externo de la aplicación que solicita la impresión. Esto es más útil para las impresiones de aplicaciones móviles.
${CREATIVE_ID}	Identificador creativo que ganó la impresión.
${DEAL_ID}	El identificador de la oferta Xandr asociada a la puja ganadora, si procede. Si no hay ningún trato, esto devolverá 0.
${ECP}	Precio claro estimado del lado del editor para la subasta.
${RESERVE_PRICE}	Precio de reserva establecido por el publicador.
${SESSION_FREQ}	Frecuencia de sesión del usuario.
${AGE}	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}	Cadena de número aleatorio que se usa para limitar el almacenamiento en caché de la dirección URL
${PRICE_PAID}	El precio pagado por esta impresión. (En contraposición a la oferta de precio, antes de la reducción del precio).
${SECOND_PRICE}	Precio que representa la segunda puja más alta en la 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 de este inventario. Nota: Este campo está en desuso (a partir de mayo de 2016). En su lugar, use ${REFERER_URL_ENC}.
${REFERER_URL_ENC}	Dirección URL de referencia codificada.
${BID_PRICE}	Precio pujado por esta impresión en lugar del precio pagado después de la reducción del precio.
${TAG_CODE1}	Código de integración establecido en la ubicación.
${TAG_CODE2}	Código de integración adicional establecido en la ubicación.
${INV_SOURCE_ID}	En desuso.
${USER_ID}	Cadena de caracteres Xandr de 64 bits que representa al usuario para la impresión.
${USER_IP}	Dirección IP del usuario.
${IS_PREVIEW}	Si vamos a "obtener una vista previa" de la creatividad, podemos pasar una marca al servidor de terceros para que no la cuenten como una impresión de producción. Si es true, pasamos un "1"; si es false, pasamos un "0".
${SELLER_MEMBER_ID}	El miembro propietario del publicador donde se origina la impresión.
${SEG_IDS}	Identificadores de los segmentos que pertenecen al comprador ganador en la cookie de este usuario (en orden de hora vista por última vez). Tenga en cuenta que esta macro no funciona para segmentos compartidos (como los que pertenecen a un proveedor de datos de terceros).
${SEG_CODES}	Códigos para los segmentos que pertenecen al comprador ganador en la cookie de este usuario (en orden de hora vista por última vez). Tenga en cuenta que esta macro no funciona para segmentos compartidos (como los que pertenecen a 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}	Identificador del publicador que vende la impresión
${PUBLISHER_CODE}	Código del publicador que vende la impresión (si está disponible)
${CREATIVE_CODE}	Código de la creatividad servida (si está disponible)
${CREATIVE_SIZE}	Ancho x Alto de la creatividad servida (por ejemplo, "300x250")
${WIDTH}	Ancho de la creatividad servida
${HEIGHT}	Altura 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}	Marca de tiempo de UNIX para la subasta.
${USER_AGENT}	Cadena del agente de usuario del encabezado HTTP de la solicitud. El agente de usuario suele identificar 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}	Cadena del agente de usuario codificada del encabezado HTTP de la solicitud.
${EXTENDED_IDS}	Los identificadores (identificadores del sector y identificadores proporcionados por el publicador) representan al usuario de la impresión. Estos se pasarían como recibidos en la solicitud, con varios 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 canalización entre diferentes tipos de identificador y pares de valores.

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

Advertencia

Con el fin de que nuestros clientes cumplan con sus requisitos de transparencia, notificación y elección/consentimiento en virtud de la ley de privacidad del estado de EE. UU., el RGPD y la directiva ePrivacy existente, Xandr apoya el Marco de transparencia & consentimiento de IAB Europe (el "Marco").

Esta es una referencia para los editores que usan 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 señalar a proveedores aprobados, y cuando sea necesario, pasar el consentimiento o no compartir o vender señales a Xandr y a los orígenes 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 colección, uso y almacenamiento de datos personales son diferentes, también debe buscar asesoramiento legal independiente en relación con las obligaciones establecidas en la legislación estatal estadounidense, las regulaciones europeas, incluido el RGPD y la Directiva ePrivacy existente. Solo un abogado puede proporcionarle asesoramiento legal específicamente adaptado a su situación. Nada en esta guía está pensado para proporcionarle, o debe usarse como sustituto de, asesoramiento legal adaptado a su negocio.

Tenga en cuenta que nuestra parte de las directivas de servicio (para comprar, vender y proveedores de datos) incluye obligaciones específicas de privacidad de las que debe tener en cuenta. Estas directivas de servicio se han actualizado a partir del 1 de enero de 2023.

Macro	Description
${GDPR_APPLIES}	Designa si se aplican las regulaciones del RGPD. En concreto, indica si el usuario se encuentra en un país afectado por el RGPD, o si tenemos una señal requerida por RGPD pasada con la solicitud. 1 si es así, 0 si no.
${GDPR}	Ofrece lo mismo funcionalmente que ${GDPR_APPLIES}.
${GDPR_CONSENT_STRING}	Esta es la cadena de consentimiento del RGPD de IAB. Si se aplica el RGPD, tendrá una lista de proveedores aprobados por el usuario según el marco de transparencia y consentimiento del RGPD de IAB.
${GDPR_CONSENT}	Esta es la cadena de consentimiento del RGPD de IAB según la especificación oficial de 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 ellos se resuelven en la misma cadena de consentimiento del RGPD que se explicó anteriormente en '${GDPR_CONSENT_STRING}'.
${GPP_SID}	Designa si se debe aplicar una sección (es decir, marco normativo) de la Plataforma global de privacidad . En concreto, indica si el usuario se encuentra en un país afectado por la legislación cubierta por el GPP.
${GPP_STRING_XXXXX*}	Esta es la cadena de la Plataforma de privacidad global (GPP) de 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 identificador numérico

La tabla siguiente contiene nombres de macro reservados que los clientes del Licitador no pueden usar. Provocarán conflictos con otras tecnologías Xandr y no se usarán 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	Description
${GEO_LAT}	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 south se representa como negativo. Puede haber un máximo de 5 posiciones decimales de precisión.
${GEO_LON}	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 west se representa como negativo. Puede haber un máximo de 5 posiciones decimales de precisión.
${EXT_APP_ID}	Identificador externo de la aplicación que solicita la impresión. Esto solo es útil para las impresiones de aplicaciones móviles.
${DEVICE_MD5}	Identificador único cifrado md5 que representa el dispositivo móvil.
${DEVICE_SHA1}	Identificador único cifrado SHA1 que representa el dispositivo móvil.
${DEVICE_OPENUDID}	Identificador único cifrado de OPENUDID que representa el dispositivo móvil.
${DEVICE_ODIN}	Identificador único cifrado por ODIN que representa el dispositivo móvil.
${DEVICE_AAID}	Identificador de publicidad de Android, cuando la impresión es de un dispositivo Android.
${DEVICE_APPLE_IDA}	El identificador de publicidad de Apple, cuando la impresión es de un dispositivo Apple.
${DEVICE_MAKE_ID}	Entero Xandr que representa el identificador de la make del dispositivo móvil (por ejemplo, 26). Para obtener una lista completa de identificadores de creación de dispositivos móviles, consulte Device Make Service.
${DEVICE_MODEL_ID}	Entero Xandr que representa el identificador del modelo de dispositivo móvil (por ejemplo, 301). Para obtener una lista completa de los identificadores de modelo de dispositivo móvil, consulte Device Model Service.
${DEVICE_WIN_ID}	Identificador de Windows Ad para el dispositivo en el que se produjo esta impresión (si procede).
${CARRIER_ID}	Entero Xandr que representa el identificador del operador de telefonía móvil. Para obtener una lista completa de los identificadores de operador de telefonía móvil, consulte el Servicio de 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 funciones

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

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

La macro tiene el siguiente formato:

 ${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 va a codificar 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 seguimiento de clics de terceros determinado con la macro. La codificación doble normalmente será necesaria para las direcciones URL de destino final cuando haya un segundo servidor de anuncios implicado y una codificación triple para un tercer servidor de anuncios.

Para determinar si tendrá que usar una codificación única, doble o triple, debe comprobar 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 interrupción de vínculos, lo que hará que los usuarios no lleguen a la dirección URL de destino prevista.

Ejemplos de codificación

Para codificar, haga clic en URL una vez.

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

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

Para codificar la dirección URL del medio una vez:

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

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

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

Para codificar una macro personalizada denominada ADFORMAT una vez:

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