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 pour simplifier 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 un code prédéfini qui s'étend automatiquement à une valeur ou un ensemble de valeurs spécifique. Dans le contexte de vos liens CTA, une macro insérera automatiquement 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



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.

Sauvegardez 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ù les macros peuvent-elles être utilisées ?



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 automatiquement à jour avec des informations pertinentes.

Liste des macros disponibles



Voici une liste des macros que vous pouvez utiliser, ainsi que leurs descriptions :

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

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

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

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

En incluant ces macros, vous pouvez vous assurer que vos liens CTA sont toujours à jour et personnalisés, renforçant l'engagement utilisateur 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 quel visiteur du lien CTA provient de 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, du lien ciblé.

Les valeurs des macros, telles que %SESSION_UID% et %APP_ID%, peuvent être récupérées à partir 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 sur l'utilisateur en fonction des valeurs des macros, offrant ainsi une expérience utilisateur personnalisée et efficace.# Macros disponibles

MacroFonction
%SESSION_UID%Retourne l'identifiant actuel de la session de l'utilisateur.
%APP_ID%Retourne l'identifiant 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 email 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 à 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 en secondes pris par l'utilisateur.
%LOCALE%Retourne la langue de l'utilisateur.


Remarque :
Toutes les données des macros renvoyées sont traitées avec rawurlencode pour garantir leur compatibilité dans les URLs. Cela signifie que les caractères spéciaux sont encodés pour être utilisés en toute sécurité dans les liens, préservant ainsi la fonctionnalité tout en évitant les problèmes potentiels avec des caractères réservés ou non sécurisés. Par exemple, un espace apparaîtra comme %20, et les caractères spéciaux comme & seront encodés en %26.

Mis à jour le : 16/11/2024

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

Partagez vos commentaires

Annuler

Merci !