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

Macros

Nuestra plataforma admite macros para enlaces de llamada a la acción (CTA), permitiéndote añadir valores dinámicos que se rellenan automáticamente para optimizar tu flujo de trabajo y ofrecer una experiencia más personalizada al usuario.

¿Qué es una macro?



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

Cómo utilizar macros en enlaces de CTA



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

Identificar la macro: Selecciona la macro apropiada de la lista proporcionada a continuación.

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

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

¿Dónde se pueden utilizar las macros?



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

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

Lista de macros disponibles



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

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

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

%APP_ID%: Inserta el ID actual del juego.

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

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

Ejemplos de macros en acción



Para ofrecerte una comprensión más clara, 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 de CTA.

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

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

Esto te permite atribuir de qué juego provienen los visitantes mediante el enlace de CTA.

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

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

Esto te permite obtener y mostrar dinámicamente datos detallados del usuario basados en los valores de las macros, facilitando una experiencia de usuario personalizada y eficiente.# Macros Disponibles

MacroFunción
%SESSION_UID%Devuelve el ID de sesión del usuario.
%APP_ID%Devuelve el APP ID del juego actual.
%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 el 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 con el premio.
%OPTIN_NEWSLETTER%Devuelve si el usuario se suscribió al boletín.
%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 que ha tardado el usuario en segundos.
%LOCALE%Devuelve la configuración regional del usuario.


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

Actualizado el: 22/02/2025

¿Este artículo te resultó útil?

Comparte tu opinión

Cancelar

¡Gracias!