Cet article est aussi disponible en :

Macros

Notre plateforme prend en charge les macros dans les liens d’appel à l’action (CTA). Elles vous permettent d’insérer des valeurs dynamiques qui sont renseignées automatiquement pour simplifier votre travail et offrir une expérience utilisateur plus personnalisée.

Qu’est-ce qu’une macro ?

Une macro est une balise ou un code prédéfini qui est automatiquement remplacé par une valeur ou un ensemble de valeurs. Dans vos liens CTA, les macros insèrent des informations de manière dynamique pour rendre vos liens plus personnalisés et plus utiles, sans mise à jour manuelle.

Comment utiliser les macros dans les liens CTA

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

Choisissez la macro : sélectionnez la macro adaptée dans la liste ci-dessous.

Insérez la macro : ajoutez le code de la macro dans votre lien CTA, à l’endroit où vous souhaitez faire apparaître la valeur dynamique.

Enregistrez et prévisualisez : enregistrez vos modifications, puis prévisualisez le lien CTA pour vérifier que la macro est bien remplacée par la valeur attendue.

Où peut-on utiliser les macros ?

Les macros peuvent être utilisées comme paramètres de requête dans toutes les URL de vos liens CTA.

Elles vous permettent de créer des liens CTA plus utiles, qui se mettent automatiquement à jour avec les informations pertinentes.

Liste des macros disponibles

Voici quelques macros que vous pouvez utiliser et 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 intégrant ces macros, vous gardez vos liens CTA à jour tout en les personnalisant, ce qui favorise l’engagement des utilisateurs et améliore leur expérience globale.

Exemples d’utilisation des macros

Pour mieux comprendre leur fonctionnement, 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 à partir du lien CTA.

Avant : “https://example.com/newsletter”

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

Cela vous permet de savoir de quel jeu proviennent les visiteurs qui ont cliqué sur le lien CTA.

Ces exemples montrent comment les macros rendent vos CTA plus pertinents et vous permettent de récupérer des données de votre application depuis le lien de destination.

Les valeurs des macros, comme %SESSION_UID% et %APP_ID%, peuvent être récupérées depuis le lien de destination, puis utilisées pour interroger notre API afin de consulter les informations de l’utilisateur concerné.

Vous pouvez ainsi récupérer et afficher de manière dynamique des données utilisateur détaillées à partir des valeurs des macros, pour offrir une expérience utilisateur fluide et personnalisée.

Macros disponibles

Macro	Fonction
%SESSION_UID%	Renvoie l’identifiant de la session en cours de l’utilisateur.
%APP_ID%	Renvoie l’APP ID du jeu en cours.
%ID_UNIC%	Renvoie l’identifiant unique de l’utilisateur.
%GENDER%	Renvoie la civilité de l’utilisateur.
%USERNAME%	Renvoie le nom d’utilisateur.
%FIRSTNAME%	Renvoie le prénom de l’utilisateur.
%LASTNAME%	Renvoie le nom de l’utilisateur.
%EMAIL%	Renvoie l’adresse e-mail de l’utilisateur.
%PHONE_NUMBER%	Renvoie le numéro de téléphone de l’utilisateur.
%ADDRESS%	Renvoie l’adresse postale 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 société 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 gain.
%PRIZE_TITLE%	Renvoie le titre du gain.
%PRIZE_REF%	Renvoie la référence du gain.
%PRIZE_CODE%	Renvoie le code associé au gain.
%OPTIN_NEWSLETTER%	Indique si l’utilisateur a accepté de recevoir des newsletters.
%CUSTOM_TEXT%	Renvoie le contenu du champ de texte personnalisé associé à l’utilisateur.
%CUSTOM_FORMAT%	Renvoie le 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 passé par l’utilisateur, en secondes.
%LOCALE%	Renvoie la localisation de l’utilisateur.
%REF%	Renvoie la référence de la source de participation : le paramètre `ref` de l’URL du jeu s’il a été défini, sinon le domaine référent, ou `direct` si aucun des deux n’est disponible.

Remarque : toutes les données renvoyées par les macros sont encodées avec rawurlencode pour garantir leur compatibilité avec les URL. Les caractères spéciaux sont ainsi encodés pour être utilisés sans risque dans les liens, tout en préservant leur bon fonctionnement et en évitant les problèmes liés aux caractères réservés ou non autorisés. Par exemple, un espace sera remplacé par %20 et le caractère & sera encodé sous la forme %26.

Mis à jour le : 29/10/2026

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

Merci !