Macros
Nuestra plataforma soporta macros para enlaces de llamada a la acción (CTA), permitiéndote añadir valores dinámicos que se rellenan automáticamente para agilizar tu flujo de trabajo y ofrecer una experiencia más personalizada al usuario.
Una macro es un marcador de posición o código predefinido que se expande automáticamente a un valor o conjunto de valores específicos. 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.
Usar macros en tus enlaces CTA es sencillo. Aquí te explicamos cómo hacerlo:
Identificar la macro: Elige la macro adecuada desde 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 vista previa: Guarda tus cambios y haz una vista previa del enlace CTA para asegurar que la macro se reemplaza correctamente con el valor deseado.
Las macros se pueden usar en cualquier URL dentro de tus enlaces CTA como parámetros de consulta.
Al usar macros, puedes crear enlaces CTA más útiles que se actualicen automáticamente con información relevante.
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 del juego actual.
Ejemplo: https://example.com/events?game_id=%APP_ID%
Al incluir estas macros, puedes asegurarte de que tus enlaces CTA están siempre actualizados y personalizados, mejorando la participación del usuario y la experiencia general.
Para darte una mejor comprensión, aquí hay 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 al enlace CTA provienen de qué juego.
Estos ejemplos muestran cómo las macros pueden hacer tus CTAs más relevantes y ayudarte a recuperar datos desde 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 usar para llamar a nuestra API para verificar la información de ese usuario.
Esto te permite obtener y mostrar dinámicamente datos completos del usuario basados en los valores de las macros, permitiendo una experiencia de usuario personalizada y eficiente.# Macros Disponibles
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 no seguros. Por ejemplo, un espacio aparecerá como %20, y caracteres especiales como & serán codificados como %26.
¿Qué es una macro?
Una macro es un marcador de posición o código predefinido que se expande automáticamente a un valor o conjunto de valores específicos. 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 enlaces CTA
Usar macros en tus enlaces CTA es sencillo. Aquí te explicamos cómo hacerlo:
Identificar la macro: Elige la macro adecuada desde 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 vista previa: Guarda tus cambios y haz una vista previa del enlace CTA para asegurar que la macro se reemplaza 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 usar macros, puedes crear enlaces 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 del juego actual.
Ejemplo: https://example.com/events?game_id=%APP_ID%
Al incluir estas macros, puedes asegurarte de 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í hay 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 al enlace CTA provienen de qué juego.
Estos ejemplos muestran cómo las macros pueden hacer tus CTAs más relevantes y ayudarte a recuperar datos desde 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 usar para llamar a nuestra API para verificar la información de ese usuario.
Esto te permite obtener y mostrar dinámicamente datos completos del usuario basados en los valores de las macros, permitiendo una experiencia de usuario personalizada y eficiente.# Macros Disponibles
Macro | Función |
---|---|
%SESSION_UID% | Devuelve la ID de sesión actual del usuario. |
%APP_ID% | Devuelve la ID de la APP del juego actual que se está jugando. |
%ID_UNIC% | Devuelve el identificador único para el 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 newsletters. |
%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 tomado por el usuario en segundos. |
%LOCALE% | Devuelve la localización 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 no seguros. Por ejemplo, un espacio aparecerá como %20, y caracteres especiales como & serán codificados como %26.
Actualizado el: 23/02/2025
¡Gracias!