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

Macros

Notre plateforme prend en charge les macros pour les liens call-to-action (CTA), vous permettant d'ajouter des valeurs dynamiques qui se remplissent automatiquement, simplifiant ainsi votre flux de travail et offrant une expérience utilisateur plus personnalisée.

Qu'est-ce qu'une macro ?



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

Comment utiliser les macros dans les liens CTA



Utiliser des macros dans vos liens CTA est simple. Voici comment procéder :

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

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

Enregistrez et prévisualisez : 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ù peut-on utiliser les macros ?



Les macros peuvent être utilisées dans n'importe quelle URL au sein 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 une liste des macros que vous pouvez utiliser, accompagnée de descriptions de leur fonction :

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

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

%APP_ID% : Insère l'identifiant du jeu en cours.

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, améliorant 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 d'attribuer quels visiteurs du lien CTA proviennent de quel jeu.

Ces exemples illustrent comment les macros peuvent rendre vos CTAs plus pertinents et vous aider à récupérer des données de votre application, à partir du lien ciblé.

Les valeurs des macros, telles que %SESSION_UID% et %APP_ID%, peuvent être récupérées à partir du lien ciblé et ensuite 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 utilisateur complètes basées sur les valeurs des macros, offrant ainsi une expérience utilisateur personnalisée et efficace.# Macros Disponibles

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


Remarque :
Toute donnée renvoyée par les macros est traitée avec rawurlencode pour garantir la compatibilité dans les URL. 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 éventuels problèmes liés aux caractères réservés ou non sécurisés. Par exemple, un espace apparaîtra comme %20 et des caractères spéciaux comme le & seront encodés en %26.

Mis à jour le : 01/03/2025

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

Partagez vos commentaires

Annuler

Merci !