Artículos sobre: Desarrolladores y API
Este artículo también está disponible en:

Macros

Nuestra plataforma admite macros para enlaces de call-to-action (CTA), permitiéndote añadir valores dinámicos que se rellenen automáticamente para optimizar tu flujo de trabajo y crear una experiencia de usuario más personalizada.

¿Qué es una macro?



Una macro es un marcador o código predefinido que se expande automáticamente a un valor específico o conjunto de valores. En el contexto de tus enlaces CTA, una macro insertará información de manera dinámica, haciendo que tus enlaces sean más personalizados y funcionales sin necesidad de actualizaciones manuales.

Cómo usar macros en los enlaces CTA



Usar macros en tus enlaces CTA es sencillo. Aquí te explicamos cómo hacerlo:

Identificar la macro: Escoge la macro adecuada de la lista proporcionada a continuación.

Insertar la macro: Añade el código de la macro en tu enlace CTA donde deseas que aparezca el valor dinámico.

Guardar y previsualizar: Guarda tus cambios y previsualiza el enlace CTA para asegurarte de que la macro se ha reemplazado correctamente con el valor deseado.

¿Dónde se pueden usar las macros?



Las macros se pueden usar en cualquier URL dentro de tus enlaces CTA como parámetros de consulta.

Al utilizar macros, puedes crear enlaces CTA más útiles que se actualizan automáticamente con información relevante.

Lista de macros disponibles



Aquí tienes una lista de las macros que puedes usar, junto con sus descripciones:

%SESSION_UID%: Inserta el UID del jugador de la sesión.

Ejemplo: https://example.com/profile?session=%SESSION_UID%

%APP_ID%: Inserta la ID del juego actual.

Ejemplo: “https://example.com/events?game_id=%APP_ID%

Al incluir estas macros, aseguras que tus enlaces CTA estén siempre actualizados y personalizados, mejorando la participación del usuario y la experiencia general.

Ejemplos de Macros en Acción



Para darte una mejor comprensión, aquí tienes algunos ejemplos:

Antes: “https://example.com/profile”

Después: “https://example.com/profile?session=%SESSION_UID%”

Esto te permite identificar la sesión única de cada visitante a través del enlace CTA.

Antes: “https://example.com/newsletter”

Después: “https://example.com/newsletter?game_id=%APP_ID%”

Esto te permite atribuir qué visitantes llegaron al enlace CTA desde qué juego.

Estos ejemplos muestran cómo las macros pueden hacer que tus CTAs sean más relevantes y ayudarte a recuperar datos desde tu aplicación, desde el enlace en cuestión.

Los valores de las macros, como %SESSION_UID% y %APP_ID%, se pueden recuperar desde el enlace objetivo y luego usarse para llamar a nuestra API para verificar la información de ese usuario.

Esto te permite obtener y mostrar datos completos de usuario de manera dinámica basándote en los valores de las macros, habilitando una experiencia personalizada y eficiente para el usuario.# Macros Disponibles

MacroFunción
%SESSION_UID%Devuelve el ID de sesión actual del usuario.
%APP_ID%Devuelve el ID de la APP del juego que se está jugando.
%ID_UNIC%Devuelve el identificador único del usuario.
%GENDER%Devuelve el género del usuario.
%USERNAME%Devuelve el nombre de usuario del usuario.
%FIRSTNAME%Devuelve el nombre del usuario.
%LASTNAME%Devuelve el apellido del usuario.
%EMAIL%Devuelve la dirección de correo electrónico del usuario.
%PHONE_NUMBER%Devuelve el número de teléfono del usuario.
%ADDRESS%Devuelve la dirección del usuario.
%ZIP_CODE%Devuelve el código postal del usuario.
%TOWN%Devuelve la ciudad del usuario.
%COUNTRY%Devuelve el país del usuario.
%DOB%Devuelve la fecha de nacimiento del usuario en formato YYYY-MM-DD.
%COMPANY_NAME%Devuelve el nombre de la empresa del usuario.
%WEBSITE%Devuelve la página web del usuario.
%PROFIL_UID%Devuelve el identificador único del perfil del usuario.
%PROFIL_TITLE%Devuelve el título del perfil del usuario.
%PRIZE_UID%Devuelve el identificador único del premio.
%PRIZE_TITLE%Devuelve el título del premio.
%PRIZE_REF%Devuelve la referencia del premio.
%PRIZE_CODE%Devuelve el código asociado al premio.
%OPTIN_NEWSLETTER%Devuelve si el usuario optó por recibir boletines.
%CUSTOM_TEXT%Devuelve cualquier texto personalizado asociado al usuario.
%CUSTOM_FORMAT%Devuelve cualquier formato personalizado asociado al usuario.
%SCORE%Devuelve la puntuación del usuario.
%SELECT_VALUE%Devuelve el primer valor seleccionado.
%SELECT_VALUE2%Devuelve el segundo valor seleccionado.
%CUSTOM_CHECKBOX%Devuelve el valor de la casilla de verificación personalizada.
%TIME_TAKEN%Devuelve el tiempo en segundos que tardó el usuario.
%LOCALE%Devuelve la configuración regional del usuario.


Nota:
Todos los datos de macro devueltos se procesan utilizando rawurlencode para asegurar la compatibilidad en URLs. Esto significa que los caracteres especiales se codifican para su uso seguro en enlaces, preservando la funcionalidad mientras se evitan posibles problemas con caracteres reservados o no seguros. Por ejemplo, un espacio aparecerá como %20, y caracteres especiales como & se codifican como %26.

Actualizado el: 01/03/2025

¿Este artículo te resultó útil?

Comparte tu opinión

Cancelar

¡Gracias!