Microsoft Monetize: macros creativas admitidas

Tenemos macros creativas que se pueden usar para todas las impresiones de vídeo, móviles y móviles. También se admiten macros de privacidad y función.

Nota:

Las macros creativas distinguen mayúsculas de minúsculas y no están disponibles para los píxeles de conversión de perrito.

Macros creativas para todas las impresiones

Las macros siguientes se pueden usar para todas las impresiones:

Macro	Description
${CLICK_URL}	Dirección URL de seguimiento de clics. Por ejemplo: https://xandr.com
${CLICK_URL_ENC}	Dirección URL de seguimiento de clic codificada (solo es necesaria para algunos servidores de anuncios de terceros). Por ejemplo: https%3A%2F%2Fxandr.com

Las macros siguientes se pueden usar en etiquetas creativas de terceros y direcciones URL de página de aterrizaje:

Macro	Description
${ADV_CODE}	El código del anunciante al que pertenece la creatividad.
${ADV_FREQ}	El número total de impresiones que ha visto un usuario en todas las campañas de anunciantes.
${ADV_ID}	Id. del anunciante al que pertenece la creatividad.
${AGE}	La edad del usuario si está disponible. Los valores admitidos son un entero o 0.
${APPNEXUS_AUCTION_ID}	Esta macro es un alias para ${AUCTION_ID}y se comporta de la misma manera.
${AUCTION_ID}	Cadena de caracteres de 64 bits que representa la subasta individual que condujo a la impresión.
${BID_PRICE}	La primera oferta de precio para esta impresión, en lugar del precio pagado después de la reducción del precio.
${BIDPRICE}	Esta macro es un alias para ${BID_PRICE}y se comporta de la misma manera.
${CACHEBUSTER}	Cadena de número aleatorio que se usa para limitar el almacenamiento en caché de la dirección URL. Nota: Esta macro garantiza que se realiza una nueva llamada al servidor de anuncios cada vez que se llama a la etiqueta para contar con precisión todas las impresiones. Si no agrega esta macro a la etiqueta, es posible que vea totales de impresiones inexactos.
${CP_CODE}	El código de campaña de la impresión servida.
${CP_ID}	La campaña o el identificador dividido de la impresión servida.
${CPG_CODE}	El código de elemento de línea de la impresión servida.
${CPG_ID}	Identificador de elemento de línea de la impresión que se ha servido.
${CREATIVE_CODE}	El código de la creatividad que se sirve si está disponible.
${CREATIVE_HEIGHT}	La altura de la creatividad servida.
${HEIGHT}	Se trata de un alias para ${CREATIVE_HEIGHT}y se comporta de la misma manera.
${CREATIVE_ID}	Identificador creativo que ganó la impresión.
${CREATIVE_SIZE}	Ancho y alto de la creatividad servida. Por ejemplo: 300x250.
${CREATIVE_WIDTH}	Ancho de la creatividad servida.
${WIDTH}	Esta macro es un alias para ${CREATIVE_WIDTH}y se comporta de la misma manera.
${CUSTOM_MODEL_ID}	del id modelo personalizado usado en la subasta. Cuando no se usa ningún modelo personalizado, esta macro devolverá 0. Nota: Esta macro personalizada solo funcionará para los clientes de prueba alfa de APB.
${CUSTOM_MODEL_LAST_MODIFIED}	Fecha y hora (en la época unix) desde que se modificó por última vez el modelo personalizado que se usó en la subasta. Si no se usó ningún modelo, esta macro devolverá 0. Nota: Esta macro personalizada solo funcionará para los clientes de prueba alfa de APB.
${CUSTOM_MODEL_LEAF_NAME}	Especificado leaf_name en la hoja que determinó la puja ganadora. Si no se especifica ningún nombre o si no se usó un modelo, esta macro devolverá ---. Esto se alinea con el leaf_name campo de la fuente estándar en datos de nivel de registro. Para obtener más información, vea Fuente estándar. Nota: Esta macro personalizada solo funcionará para los clientes de prueba alfa de APB.
${DATACENTER}	El identificador del centro de datos (1 = NYM, 2 = LAX, 3 = AMS, 4 = FRA, 5 = SIN).
${DEAL_ID}	El identificador de la oferta de Microsoft Advertising asociada a la puja ganadora, si procede. Si no hay ninguna oferta, esta macro devolverá 0.
${ECP}	Precio claro estimado por el editor (ECP) para la subasta.
${EXTENDED_IDS}	Los valores de identificador universal pasados por el vendedor, que el comprador tiene permiso para ver.
${GENDER}	El sexo del usuario si está disponible. Los valores posibles son: - f (hembra) - m (varón) - u (desconocido)
${INV_SOURCE_ID}	En desuso
${IO_CODE}	El código de orden de inserción de la impresión servida.
${IO_ID}	Identificador del orden de inserción de la impresión servida.
${OZONE_ID}	En desuso
${PMT_RULE_ID}	Identificador de la regla de pago utilizada para fijar el precio de la impresión.
${POSTAL_CODE}	Código postal del usuario.
${PRICE_PAID}	El precio pagado por esta impresión después de la reducción del precio. Este es el segundo precio.
${SECOND_PRICE}	Precio que representa la segunda puja más alta en la subasta.
${PT1}, ${PT2}, ${PT3}, ${PT4}, ${PT5}, ${PT6}, ${PT7}, ${PT8}, ${PT9}	Estas macros se pueden rellenar con datos personalizados arbitrarios que se envían al usar los siguientes parámetros de cadena de consulta de etiqueta de selección de ubicación: - pt1 - pt2 - pt3 - pt4 - pt5 - pt6 - pt7 - pt8 - pt9 Para obtener más información, vea Create una macro de etiqueta de selección de ubicación.
${PUBLISHER_CODE}	Código del publicador que vende la impresión. Nota: Este identificador solo está disponible si el publicador usa un código y lo ha expuesto para la generación de informes.
${PUBLISHER_ID}	Identificador del publicador que vende la impresión. Nota: Este identificador solo está disponible si el publicador está expuesto para la generación de informes.
${REFERER_URL}	En desuso Nota: Use ${REFERER_URL_ENC} en su lugar.
${REFERER_URL_ENC}	Dirección URL de referencia codificada si está disponible. En el caso de las impresiones de aplicaciones móviles, esta macro devuelve la dirección URL de la tienda de aplicaciones si está disponible.
${REM_USER}	Valor booleano que indica si el usuario está siendo objeto de un remarketed.
${RESERVE_PRICE}	Precio de reserva establecido por el publicador. Cuando no hay un precio de reserva, esta macro devolverá 0.
${SCHEME}	Rellena el protocolo de aplicación adecuado (HTTP o HTTPS) en función del tipo de inventario.
${SEG_CODES}	Códigos para los segmentos a los que el comprador ganador posee o tiene acceso dentro de la cookie de este usuario (en orden de la hora de la última vez que se ha visto). Si el usuario está en más de 15 de los segmentos accesibles, esta macro solo devolverá los 15 primeros (ordenados por el segmento visto más recientemente al segmento más antiguo).
${SEG_IDS}	Los identificadores de los segmentos a los que posee o tiene acceso el comprador ganador dentro de la cookie de este usuario (en orden de la hora que se ha visto por última vez). Si el usuario está en más de 15 de los segmentos accesibles, esta macro solo devolverá los 15 primeros (ordenados por el segmento visto más recientemente al segmento más antiguo).
${SELLER_MEMBER_ID}	Identificador de miembro del miembro que vende la impresión.
${SITE_ID}	El identificador del sitio en el que se está sirviendo la impresión.
${SSP_DATA}	Necesario para los píxeles de conversión del lado servidor. Para obtener más información, vea Píxeles de conversión del lado servidor.
${TAG_CODE1}	El código de integración establecido en la ubicación.
${TAG_CODE2}	Código de integración adicional establecido en la ubicación.
${TAG_ID}	El identificador de ubicación de Microsoft Advertising que inició la solicitud de puja.
${TIMESTAMP}	Marca de tiempo de UNIX para la subasta.
${USE_COOKIES}	Esto se usa para los creativos de terceros para indicar si se deben establecer cookies para que el usuario vea la impresión. Los valores permitidos incluyen: - 0 para no - 1 para sí Para obtener más información sobre la configuración relacionada con las cookies, consulte Configuración de privacidad de cookies y el Servicio de publicador.
${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.
${USER_CITY}	Cadena de caracteres de la ciudad del usuario.
${USER_COUNTRY}	Cadena de caracteres del país del usuario.
${USER_ID}	Cadena de caracteres de 64 bits de Microsoft Advertising que representa al usuario para la impresión.
${USER_IP}	Dirección IP del usuario, que se trunca.
${USER_LOCALE}	Idioma y dialecto (aa-DD) notificados por el dispositivo del usuario. Por ejemplo, en-ZA representa el inglés (es) usado en Sudáfrica (ZA).
${USER_STATE}	Cadena de caracteres del estado o región del usuario. - En EE. UU.: abreviatura de 2 letras - Fuera de EE. UU.: una dirección URL codificada con el país del usuario seguida del identificador de región del usuario (FIPS 10-4 o generado por Microsoft Advertising). Por ejemplo, la región que rodea a Riva, Letonia es LV%3A25 (codificación para LV:A25).

Macros creativas para impresiones de vídeo

Las macros siguientes se pueden usar específicamente para las impresiones de vídeo:

Macro	Description
${VIDEO_CONTEXT}	Contexto del anuncio de vídeo. Los valores permitidos incluyen: - 0: desconocido en secuencia - 1: pre-roll en streaming - 2: in-stream mid-roll - 3: post-roll en streaming - 4: salida de flujo
${VIDEO_PLAYBACK_METHOD}	Especifica cómo se ha reproducido el vídeo. Los valores permitidos incluyen: - 0:Desconocido - 1: reproducción automática, sonido activado - 2: reproducción automática, apagado del sonido - 3: hacer clic y reproducir - 4: pasar el mouse sobre - 5: reproducción automática, sonido desconocido
${VIDEO_PLAYER_HEIGHT}	Alto del reproductor de vídeo, expresado en píxeles.
${VIDEO_PLAYER_WIDTH}	Ancho del reproductor de vídeo, expresado en píxeles.

Macros creativas para impresiones móviles

Las macros siguientes se pueden usar específicamente para impresiones móviles:

Macro	Description
${CARRIER_ID}	Entero de Microsoft Advertising que representa el identificador del operador de telefonía móvil. Para obtener una lista completa de los identificadores de operador, consulte el Servicio de operador.
${DEVICE_AAID}	Identificador de publicidad de Android cuando la impresión se entrega desde un dispositivo Android.
${DEVICE_APPLE_IDA}	Identificador de publicidad de Apple cuando la impresión se entrega desde un dispositivo Apple.
${DEVICE_IFA_TYPE}	Tipo de identificador representado por .${DEVICE_IFA} Los valores posibles son: - AAID (Id. de publicidad de Android/Google) - IDFA (identificador de publicidad/Apple) - AFAI (Amazon Fire ID) - RIDA (id. de Roku) - OPENUDID - TIFA (Tizen Identifier for Advertising (Samsung Ad ID)) - VIDA (Vizio Advertising ID) - LGUDID (ID de dispositivo único de LG) ${DEVICE_IFA_TYPE} debe usarse junto con ${DEVICE_IFA}, y esta configuración se recomienda en macros de dispositivo individuales específicas de cada tipo IFA. Estas macros son aplicables a los tipos de dispositivos móviles y CTV.
${DEVICE_IFA}	Identificador único que representa el dispositivo.
${DEVICE_MAKE_ID}	Entero de Microsoft Advertising que representa el identificador de la make del dispositivo móvil, como 26. Para obtener una lista completa de identificadores de creación de dispositivos móviles, consulte Device Make Service.
${DEVICE_MD5}	Identificador único cifrado md5 que representa el dispositivo móvil.
${DEVICE_MODEL_ID}	Entero de Microsoft Advertising que representa el identificador del modelo de dispositivo móvil, como 301. Para obtener una lista completa de los identificadores de modelo de dispositivo móvil, consulte Device Model Service.
${DEVICE_ODIN}	Identificador único cifrado por ODIN que representa el dispositivo móvil. Para obtener más información, vea ODIN.
${DEVICE_OPENUDID}	Identificador único cifrado de OPENUDID que representa el dispositivo móvil.
${DEVICE_SHA1}	Identificador único cifrado SHA1 que representa el dispositivo móvil.
${DEVICE_WIN_ID}	Identificador de Windows Ad para el dispositivo en el que se produjo esta impresión, si procede.
${EXT_APP_ID}	Identificador externo de la aplicación que solicita la impresión. Esta macro solo es útil para las impresiones de aplicaciones móviles.
${GEO_LAT}	Latitud de la ubicación del usuario cuando los datos GPS están disponibles desde un dispositivo móvil, expresados con el snn.ddd,snn.ddd formato como +12.345 o -45.123. El sur se representa como negativo en este ejemplo. Para cumplir con los estándares de privacidad, el máximo es de cinco 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 con el formato snn.ddd,snn.ddd. Por ejemplo, +12.345 o -45.123. Oeste se representa como negativo en este ejemplo. Para cumplir con los estándares de privacidad, el máximo es de cinco posiciones decimales de precisión.
${IS_PREVIEW}	Se puede pasar una marca al servidor de terceros para que las impresiones de producción no se cuenten en el número total de impresiones al obtener una vista previa de las creatividades. Los valores posibles son: - 0 para no - 1 para sí
${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

Macros de privacidad

Con el fin de que nuestros clientes cumplan 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, Microsoft Advertising apoya la Plataforma de privacidad global y el Marco de transparencia & consentimiento de IAB Europa (el "Marco"). Para obtener más información, consulte IAB Europe Transparency & Consent Framework. Los publicadores deben hacer referencia a parte de las regulaciones de privacidad al usar macros, como las que se indican en la tabla siguiente, para mostrar avisos, transparencia y elegir a los usuarios finales ubicados en el EEE, señalar a los proveedores aprobados y pasar el consentimiento a Microsoft Advertising y a los orígenes de demanda, así como a sus proveedores a través de la Plataforma de Microsoft Advertising. Para obtener más información, consulte Parte de las directivas de servicio.

Macro	Description
${GDPR_APPLIES}	Designa si se aplican las regulaciones del RGPD. Indica específicamente 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. Los valores posibles son: - 0 para no - 1 para sí Nota: 0 puede recibirse de un país del EEE. Es la elección del editor indicar de esta manera.
${GDPR}	Se trata de un alias para ${GDPR_APPLIES}y se comporta de la misma manera.
${GDPR_CONSENT_STRING}	Esta macro especifica la cadena de consentimiento del RGPD de IAB. Si se aplica el RGPD, contendrá una lista de proveedores aprobados por el usuario basada en el marco de transparencia y consentimiento del RGPD de IAB. Para obtener más información, vea Marco de transparencia y consentimiento del RGPD de IAB.
${GDPR_CONSENT}	Esta macro es un alias para ${GDPR_CONSENT_STRING}y se comporta de la misma manera.
${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}'.
${XANDR_DOMAIN}	Recupera dinámicamente el dominio de Microsoft Advertising adecuado en función de la configuración de consentimiento de cookies incluida en la cadena TCF. Si el usuario tiene las cookies habilitadas desde la configuración del explorador, pero tiene: - no dar su consentimiento para que sus cookies se incluyan en la cadena TCF, el adnxs-simple.com dominio se usará para impedir que el navegador adjunte cookies a las llamadas de anuncios posteriores. - dado el consentimiento para que sus cookies se incluyan en la cadena TCF, el adnxs.com dominio se usará para pasar cookies en el encabezado de cada llamada de anuncio. Nota: Esta macro solo debe usarse si tiene previsto servir impresiones en países que requieren consentimiento para las cookies.
${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.

Macros de funciones

Una macro de función 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. Si no se reconocen en tiempo de representación, no se traducirán y no se llamará a la función.

Microsoft Advertising admite actualmente la {$URL_ENC} macro de funciones, que se puede usar para diversos fines relacionados con la codificación. Un caso de uso clave es cuando es necesario pasar una dirección URL del servidor de anuncios al servidor de anuncios mediante una macro creativa. Debido a la presencia de caracteres no admitidos en el formato de dirección URL estándar, la {$URL_ENC} macro de función debe codificarse en varias fases del proceso.

Esta macro de función tiene el siguiente formato:

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

${MACRO_NAME} es la macro que se va a codificar y # es el entero que representa el número de veces que se va a codificar el contenido. Los valores posibles son:

• 1
• 2
• 3

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.

Ejemplo de codificación	Formato
Codificación de las direcciones URL de clic una vez	Use el formato siguiente: ${URL_ENC(${CLICK_URL},1)} Nota: Si https://xandr.com se pasa como la dirección URL de clic, si se usa ${URL_ENC(${CLICK_URL},1)} para codificar una sola dirección URL, se rellenaría https%3A%2F%2Fxandr.com la creatividad.
Codificación de la dirección URL del medio una vez	Use el formato siguiente: ${URL_ENC(${MEDIA_URL},1)}
Codificación de la dirección URL del medio dos veces	Use el formato siguiente: ${URL_ENC(${MEDIA_URL},2)}
Codificación de una macro personalizada denominada ADFORMAT una vez	Use el formato siguiente: ${URL_ENC(#{ADFORMAT},1)}

Macros de Digital Services Act (DSA)

Según el artículo 26 de la DSA, las plataformas en línea, incluidos los clientes editores de Microsoft Advertising, deben proporcionar información clara, concisa e inequívoca sobre los anuncios antes del 17 de febrero de 2024. Entre estos requisitos se incluyen:

1. Identificar claramente que la información es un anuncio.
2. Revelar la identidad de una persona física o jurídica en cuyo nombre se presenta el anuncio.
3. Indica la identidad de una persona física o jurídica que realizó el pago del anuncio, si es diferente del anunciante.
4. Proporcionar información sobre los parámetros principales que se usan para determinar el destinatario del anuncio y, si procede, instrucciones sobre cómo modificar esos parámetros.

Macro	Description
${DSA_REQUIRED}	Indica si la información de DSA debe estar disponible. Los valores posibles son: - 0: no es necesario. - 1:Obligatorio. Se aceptarán las respuestas de puja con o sin objeto DSA. - 2:Obligatorio. No se aceptarán respuestas de puja sin objeto DSA. - 3:Obligatorio. No se aceptarán respuestas de puja sin objeto DSA. Aquí, el publicador es una plataforma en línea.
${DSA_BEHALF}	Cadena de texto UNICODE libre con un nombre en cuyo nombre se muestra el anuncio. Esta macro se rellena a partir de la respuesta de puja de DSA. Por ejemplo, Advertiser.
${DSA_PAID}	Cadena de texto UNICODE gratuita de quién pagó por el anuncio. Esta macro se rellena a partir de la respuesta de puja de DSA. Por ejemplo, Advertiser.
${DSA_PARAMS}	Combinación de valores enteros que representan parámetros de usuario, separados por un carácter de subrayado "_". Por ejemplo, 1_2_3. Los valores posibles son: - 1: información sobre su actividad en línea que indica su similitud con los grupos dirigidos por el anunciante. Por ejemplo, el grupo de edad, el género, el nivel educativo o los intereses. - 2: información sobre la configuración en la que se ve un anuncio específico. Por ejemplo, el contenido del sitio web, el tipo de dispositivo, la dirección IP, la ubicación (país o ciudad). - 3: información sobre su ubicación geográfica precisa, con una precisión de aproximadamente 500 metros.

Tema relacionado

Macros creativas