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

Macros

Nuestra plataforma admite macros en los enlaces de llamada a la acción (CTA), lo que te permite añadir valores dinámicos que se rellenan automáticamente para agilizar tu trabajo y ofrecer una experiencia de usuario más personalizada.


¿Qué es una macro?


Una macro es un marcador de posición o un código predefinido que se sustituye automáticamente por un valor concreto o un conjunto de valores. En los enlaces CTA, las macros insertan información de forma dinámica para que tus enlaces sean más personalizados y funcionales, sin necesidad de actualizarlos manualmente.


Cómo usar macros en los enlaces CTA


Usar macros en tus enlaces CTA es muy sencillo. Solo tienes que seguir estos pasos:


  1. Elige la macro: Selecciona la macro adecuada de la lista que aparece más abajo.


  1. Inserta la macro: Añade el código de la macro en el punto del enlace CTA donde quieras que aparezca el valor dinámico.


  1. Guarda los cambios y comprueba la vista previa: Guarda los cambios y revisa la vista previa del enlace CTA para asegurarte de que la macro se sustituye correctamente por el valor previsto.


¿Dónde se pueden usar las macros?


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


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


Lista de macros disponibles


Estas son algunas de las macros que puedes usar y lo que hace cada una:


  1. %SESSION_UID%: Inserta el identificador único de la sesión del jugador.


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


  1. %APP_ID%: Inserta el ID del juego actual.


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


Al incluir estas macros, tus enlaces CTA estarán siempre actualizados y personalizados, lo que ayuda a fomentar la participación de los usuarios y a mejorar su experiencia.


Ejemplos de macros en acción


Para que veas mejor cómo funcionan, aquí tienes algunos ejemplos:




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




Esto te permite saber de qué juego proceden los visitantes que acceden al enlace CTA.


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


Los valores de las macros, como %SESSION_UID% y %APP_ID%, se pueden recuperar desde el enlace de destino y utilizar después para hacer una llamada a nuestra API y consultar la información del usuario.


Así, puedes obtener y mostrar de forma dinámica información detallada del usuario a partir de los valores de las macros, para ofrecerle una experiencia personalizada y fluida.


Macros disponibles


Macro

Función

%SESSION_UID%

Devuelve el ID de la sesión actual del usuario.

%APP_ID%

Devuelve el ID de la aplicación correspondiente al 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.

%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 ha dado su consentimiento para recibir boletines informativos.

%CUSTOM_TEXT%

Devuelve el valor de cualquier campo de 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 que ha tardado el usuario, en segundos.

%LOCALE%

Devuelve la configuración regional del usuario.

%REF%

Devuelve el origen de la participación: el parámetro ref de la URL del juego, si se ha definido; en caso contrario, el dominio de procedencia, o direct si no existe ninguno de los dos.


Nota: Todos los datos que devuelven las macros se procesan mediante rawurlencode para garantizar su compatibilidad con las URL. Esto significa que los caracteres especiales se codifican para que puedan utilizarse de forma segura en los enlaces, manteniendo su funcionamiento y evitando posibles problemas con caracteres reservados o no seguros. Por ejemplo, un espacio aparecerá como %20 y los caracteres especiales como & se codificarán como %26.

Actualizado el: 29/10/2026

¿Este artículo te resultó útil?

Comparte tu opinión

Cancelar

¡Gracias!