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), lo que te permite añadir valores dinámicos que se integran automáticamente para agilizar tu flujo de trabajo y ofrecer una experiencia más personalizada al usuario.

¿Qué es una macro?



Una macro es un marcador de posición 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á de manera dinámica información, haciendo tus enlaces más personalizados y funcionales sin necesidad de actualizaciones manuales.

Cómo utilizar macros en enlaces CTA



Usar macros en tus enlaces CTA es sencillo. Así es como puedes hacerlo:

Identifica la macro: Elige la macro adecuada desde la lista que se proporciona a continuación.

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

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

¿Dónde se pueden usar las macros?



Las macros se pueden utilizar 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 actualizan 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 llegaron al enlace CTA desde qué juego.

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

Los valores de las macros, como %SESSION_UID% y %APP_ID%, se pueden recuperar desde el enlace objetivo 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

MacroFunción
%SESSION_UID%Devuelve el ID de la sesión actual del usuario.
%APP_ID%Devuelve el APP ID del juego actual 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 AAAA-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 se suscribió a los 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 que tardó el usuario en segundos.
%LOCALE%Devuelve el idioma y región del usuario.


Nota:
Todos los datos de los macros devueltos son procesados usando rawurlencode para asegurar la compatibilidad en URLs. Esto significa que los caracteres especiales son codificados para uso seguro en enlaces, preservando la funcionalidad y evitando problemas potenciales con caracteres reservados o no seguros. Por ejemplo, un espacio aparecerá como %20, y caracteres especiales como & se codificarán como %26.

Actualizado el: 16/11/2024

¿Este artículo te resultó útil?

Comparte tu opinión

Cancelar

¡Gracias!