Articles sur : Développeurs et API
Cet article est aussi disponible en :

Macros

Notre plateforme prend en charge les macros pour les liens d'appel à l'action (CTA), vous permettant d'ajouter des valeurs dynamiques qui se remplissent automatiquement pour optimiser votre flux de travail et offrir une expérience utilisateur plus personnalisée.

Qu'est-ce qu'une macro ?



Une macro est un espace réservé ou code prédéfini qui s'étend automatiquement à une valeur spécifique ou à un ensemble de valeurs. Dans le contexte de vos liens CTA, une macro insérera dynamiquement des informations, rendant vos liens plus personnalisés et fonctionnels sans nécessiter de mises à jour manuelles.

Comment utiliser les macros dans les liens CTA



L'utilisation des macros dans vos liens CTA est simple. Voici comment procéder :

Identifier la macro : Choisissez la macro appropriée dans la liste fournie ci-dessous.

Insérer la macro : Ajoutez le code de la macro dans votre lien CTA à l'endroit où vous souhaitez que la valeur dynamique apparaisse.

Sauvegarder et prévisualiser : Enregistrez vos modifications et prévisualisez le lien CTA pour vous assurer que la macro est correctement remplacée par la valeur souhaitée.

Où peuvent être utilisées les macros ?



Les macros peuvent être utilisées dans n'importe quelle URL de vos liens CTA en tant que paramètres de requête.

En utilisant des macros, vous pouvez créer des liens CTA plus utiles qui se mettent à jour automatiquement avec des informations pertinentes.

Liste des macros disponibles



Voici la liste des macros que vous pouvez utiliser, avec des descriptions de ce qu'elles font :

%SESSION_UID% : Insère l'ID de session du joueur.

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

%APP_ID% : Insère l'ID du jeu actuel.

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

En incluant ces macros, vous vous assurez que vos liens CTA sont toujours à jour et personnalisés, renforçant l'engagement des utilisateurs et l'expérience globale.

Exemples de macros en action



Pour vous donner une meilleure compréhension, voici quelques exemples :

Avant : https://example.com/profile

Après : https://example.com/profile?session=%SESSION_UID%

Cela vous permet d'identifier la session unique de chaque visiteur via le lien CTA.

Avant : https://example.com/newsletter

Après : https://example.com/newsletter?game_id=%APP_ID%

Cela vous permet de savoir quels visiteurs sont arrivés sur le lien CTA depuis quel jeu.

Ces exemples montrent comment les macros peuvent rendre vos CTA plus pertinents et vous aider à récupérer des données de votre application via le lien ciblé.

Les valeurs des macros, telles que %SESSION_UID% et %APP_ID%, peuvent être extraites du lien ciblé puis utilisées pour appeler notre API afin de vérifier les informations de cet utilisateur.

Cela vous permet de récupérer et d'afficher dynamiquement des données complètes de l'utilisateur en fonction des valeurs des macros, offrant ainsi une expérience utilisateur personnalisée et efficace.# Macros Disponibles

MacroFonction
%SESSION_UID%Renvoie l'ID de la session actuelle de l'utilisateur.
%APP_ID%Renvoie l'ID de l'application du jeu actuel en cours.
%ID_UNIC%Renvoie l'identifiant unique de l'utilisateur.
%GENDER%Renvoie la civilité de l'utilisateur.
%USERNAME%Renvoie le nom d'utilisateur de l'utilisateur.
%FIRSTNAME%Renvoie le prénom de l'utilisateur.
%LASTNAME%Renvoie le nom de famille de l'utilisateur.
%EMAIL%Renvoie l'adresse email de l'utilisateur.
%PHONE_NUMBER%Renvoie le numéro de téléphone de l'utilisateur.
%ADDRESS%Renvoie l'adresse de l'utilisateur.
%ZIP_CODE%Renvoie le code postal de l'utilisateur.
%TOWN%Renvoie la ville de l'utilisateur.
%COUNTRY%Renvoie le pays de l'utilisateur.
%DOB%Renvoie la date de naissance de l'utilisateur au format YYYY-MM-DD.
%COMPANY_NAME%Renvoie le nom de l'entreprise de l'utilisateur.
%WEBSITE%Renvoie l'adresse du site internet de l'utilisateur.
%PROFIL_UID%Renvoie l'identifiant unique du profil de l'utilisateur.
%PROFIL_TITLE%Renvoie le titre du profil de l'utilisateur.
%PRIZE_UID%Renvoie l'identifiant unique du prix.
%PRIZE_TITLE%Renvoie le titre du prix.
%PRIZE_REF%Renvoie la référence du prix.
%PRIZE_CODE%Renvoie le code associé au prix.
%OPTIN_NEWSLETTER%Indique si l'utilisateur a accepté de recevoir des newsletters.
%CUSTOM_TEXT%Renvoie tout texte personnalisé associé à l'utilisateur.
%CUSTOM_FORMAT%Renvoie tout format personnalisé associé à l'utilisateur.
%SCORE%Renvoie le score de l'utilisateur.
%SELECT_VALUE%Renvoie la première valeur sélectionnée.
%SELECT_VALUE2%Renvoie la deuxième valeur sélectionnée.
%CUSTOM_CHECKBOX%Renvoie la valeur de la case à cocher personnalisée.
%TIME_TAKEN%Renvoie le temps pris par l'utilisateur en secondes.
%LOCALE%Renvoie la langue et le pays de l'utilisateur.


Remarque :
Toute donnée de macro renvoyée est traitée à l'aide de rawurlencode pour assurer la compatibilité dans les URLs. Cela signifie que les caractères spéciaux sont encodés pour une utilisation sécurisée dans les liens, préservant la fonctionnalité tout en évitant les problèmes potentiels avec les caractères réservés ou peu sûrs. Par exemple, un espace apparaîtra sous la forme %20, et les caractères spéciaux comme & seront encodés en %26.

Mis à jour le : 22/02/2025

Cet article a-t-il répondu à vos questions ?

Partagez vos commentaires

Annuler

Merci !