Intégration avec Adjust

Glossaire

Adjust

Plateforme d’attribution mobile et d’analyse marketing, Adjust permet aux développeurs d’applications, aux marketeurs et aux marques de suivre, mesurer et optimiser l’efficacité de leurs campagnes marketing sur divers canaux et appareils.

Pour plus d’informations sur la plateforme, consultez la documentation Adjust.

Jeton d'application

Identifiant unique de l’application mobile pour chaque plateforme (Android, iOS, etc.), généré automatiquement lors de l’ajout d’une application à Adjust. Vous pouvez le retrouver dans Adjust, dans la section AppView > All apps, à côté du nom de l’application concernée.

ID Adjust

ID utilisateur généré par Adjust.

Valeur à vie (LTV)

Revenu moyen généré par un utilisateur durant l’utilisation de votre application. Pour plus d’informations, consultez la documentation Adjust.

Retour sur investissement publicitaire (ROAS)

Métrique évaluant l’efficacité d’une campagne publicitaire en calculant les revenus générés par unité dépensée en publicité. Pour plus d’informations sur le ROAS, consultez la documentation Adjust.

Événement in-app

Action réalisée par l’utilisateur au sein de l’application. Pour plus d’informations sur les événements in-app, consultez la documentation Adjust. Les actions des utilisateurs dans le Web Shop sont également considérées comme des événements in-app dans le cadre d’une intégration S2S et sont transmises à Adjust depuis le back-end Xsolla.

Acquisition d'utilisateurs

Processus consistant à attirer de nouveaux utilisateurs sur un site, un service, une plateforme ou une application via une activité de marketing.

ID utilisateur du client (CUID)

ID utilisateur créé et défini par le propriétaire de l’application lors de l’enregistrement utilisateur. Le CUID doit être identique pour le Web Shop et Adjust, et sert à l’appariement et à l’attribution des utilisateurs.

Passez le CUID comme paramètre partenaire xsolla_cuid en suivant les instructions.

Si les CUID du Web Shop et de votre application mobile ne correspondent pas, contactez votre responsable de la réussite client ou envoyez un e-mail à csm@xsolla.com pour implémenter le webhook Validation utilisateur dans Web Shop ou l’authentification via lien profond.

Callback

Processus de réception des données relatives aux événements in-app. Consultez la documentation Adjust pour plus d’informations.

Jeton de sécurité serveur-serveur (S2S)

Jeton utilisé pour autoriser les appels S2S et envoyer les données d’événements à Adjust. Il est généré côté Adjust. Pour plus de d’informations sur le jeton S2S, consultez la documentation Adjust.

Reciblage

Ciblage des utilisateurs actuels ou anciens à travers des campagnes publicitaires. Cette stratégie vise à réengager ceux qui ont déjà interagi avec votre application ou votre site. Pour plus d’informations, reportez-vous à la documentation Adjust .

Événement web

Actions de l’utilisateur dans le Web Shop transmises du côté client de celui-ci à Adjust, essentielles pour l’intégration Web SDK.

Scénarios d'intégration

Adjust et Xsolla prennent en charge les types d’intégrations suivants :

Intégration S2S pour applications mobiles, qui permet une mesure complète de la LTV et du ROAS pour les achats sur application et sur le Web Shop. Xsolla transmet à Adjust les informations relatives aux achats réalisés sur le Web Shop sous forme d’événements in-app mobiles. Adjust attribue ensuite ces événements au nombre d’installations de l’application mobile, ainsi qu’aux compagnes d’acquisition d’utilisateurs et de réengagement.
Intégration du SDK Web, qui permet de mesurer et d’évaluer l’efficacité des campagnes d’acquisition d’utilisateurs et de reciblage pour générer du trafic vers le Web Shop. Grâce à cette intégration, il est possible d’évaluer le nombre d’utilisateurs redirigés sur le site via une campagne de reciblage, ainsi que la conversion des canaux menant au site. Xsolla transmet à Adjust les données des achats effectués sur le Web Shop sous forme d’événements Web. Adjust attribue ensuite des événements à la source média, à la campagne, à l’ensemble de publicités et à l’annonce ayant incité l’utilisateur à acheter.

Vous pouvez configurer l’intégration du SDK Web avec Adjust pour obtenir des analyses d’événements avancées si vous :

utilisez Adjust ;
avez créé votre site à l’aide de Xsolla Site Builder.

Les événements suivants sont disponibles via l’intégration Web SDK :

Événement	Description
`xsolla-web-event`	Événement de visite du site. Y compris les paramètres de l’URL contenant des informations sur la source de provenance de l’utilisateur, ainsi qu’un ID d’appareil, stocké dans un cookie de première partie.
`xsolla-web-identify`	Événement de connexion, y compris l’ID d’appareil et le CUID.
`xsolla-web-purchase`	Événement d’achat d’objet, y compris les événements du constructeur de site. Il peut également inclure les informations de la transaction.

Comment ça marche

Voici un scénario d’interaction du système lors de l’implémentation de campagnes d’acquisition et de reciblage. L’utilisateur appuie sur une bannière publicitaire pour accéder au Web Shop et y effectue un achat. Les événements passés à Adjust tout au long de ce processus permettent de suivre :

le nombre d’utilisateurs ayant appuyé sur chaque bannière et leur provenance ;
le montant dépensé par les utilisateurs ;
l’efficacité de la campagne de reciblage.

  sequenceDiagram
    participant User
    participant Promo as Web Shop<br>promotional campaign<br>(ad banner)
    participant Shop as Web Shop
    participant Adjust as Adjust
    User->>Promo: 1. Clicks banner
    Promo->>Shop: 2. Redirect with URL parameters
    Shop->>Adjust: 3. xsolla-web-event event
    User->>Shop: 4. Logs in with CUID
    Shop->>Adjust: 5. xsolla-web-identify event
    User->>Shop: 6. Makes purchase
    Shop->>Adjust: 7. xsolla-web-purchase event

Flux utilisateur :

L’utilisateur appuie sur la bannière de la campagne publicitaire.
L’utilisateur est redirigé vers le Web Shop. L’URL de la transition inclut les paramètres précisant la bannière et le site Web ayant dirigé l’utilisateur.
Un événement de visite est transmis depuis le côté client du Web Shop à Adjust.
L’utilisateur se connecte au Web Shop à l’aide du CUID.
L’événement d’autorisation est transmis à Adjust.
L’utilisateur effectue un achat dans le Web Shop.
L’événement d’achat est transmis à Adjust.

Comment configurer dans Adjust

Dans Adjust, vous devez :

Créer les événements que vous souhaitez inclure dans le rapport d’analyse Adjust ;
Activer l’intégration avec Xsolla.

Créez des événements

Vous devez disposer de l’un des rôles suivants dans le compte Adjust pour afficher et gérer les événements :

admin ;
editor ;
custom editor.

Connectez-vous à votre compte Adjust.
Accédez à la section AppView > All apps.
Appuyez sur le nom de l’application souhaitée.

Dans l’onglet Events, appuyez sur Add event.

Ajoutez les événements suivants un par un :
- Événement permettant d’obtenir des informations générales sur la visite du site, par exemple xsolla-web-event.
- Événement permettant de recevoir des informations sur l’authentification de l’utilisateur, par exemple xsolla-web-identify.
- Événement permettant de recevoir des informations sur l’achat, par exemple xsolla-web-purchase.

Vous pouvez nommer les événements et définir leurs règles selon vos besoins. Une fois ajoutés, les événements s’affichent dans la liste de l’onglet Events.

Activez l'intégration avec Xsolla

Connectez-vous à votre compte Adjust.
Accédez à la section Campaign Lab > Partners.
Appuyez sur New partner.

Dans la barre de rechercher, entrez et sélectionnez Xsolla.
Appuyez sur Next.

Sélectionnez l’application pour laquelle vous configurez l’intégration.
Appuyez sur Next.
Activez le partage des données. Pour ce faire, dans le bloc Enable data sharing, appuyez sur Edit, activez la bascule, puis appuyez sur Enable.

Configurez le mappage d’événements :

1. Dans le bloc Map your events, appuyez sur Map event.
2. Cartographiez l’événement selon le tableau :

Adjust event	Partner event
Événement que vous avez créé pour recevoir des informations générales sur la visite du site.	Xsolla Web Events
Événement que vous avez créé pour recevoir des informations sur l’authentification des utilisateurs.	Xsolla Web Identify
Événement que vous avez créé pour recevoir des informations sur l’achat.	Xsolla Web Purchase

1. Appuyez sur Apply.

Appuyez sur Next.
Vérifiez les paramètres et appuyez sur Enable partner. Si nécessaire, revenez aux étapes précédentes et mettez à jour les paramètres.

Comment configurer dans le Compte éditeur

Ouvrez le projet dans le Compte éditeur et accédez à la section Integrations.
Appuyez sur le volet Adjust.

Dans le volet Web SDK (Site Builder), appuyez sur Configure. Vous serez redirigé vers la liste de vos sites web.

Vous pouvez également accéder à cette liste en vous rendant dans la section Storefronts > Websites.

Dans le volet du site souhaité, appuyez sur Configure.

Dans l’onglet Site settings, accédez à la section Apps.
Dans le volet Adjust Web SDK, appuyez sur Connect.

Dans la fenêtre modale qui s’ouvre, entrez le jeton d’application.
Appuyez sur Connect.

Pour trouver des informations sur les événements dans le compte Adjust, rendez-vous dans la section Datascape > Reports > All reports. Pour plus d’informations sur l’utilisation des rapports, reportez-vous à la documentation Adjust.

Vous pouvez configurer l’intégration d’une application mobile pour bénéficier d’analyses avancées des événements si vous :

disposez d’une application mobile sur les plateformes Android ou iOS ;
utilisez Adjust ;
utilisez la solution Web Shop pour vendre des objets en jeu.

L’événement suivant est disponible via l’intégration S2S de Xsolla avec Adjust :

Événement	Description
xsolla-billing-payment	Achat d’un objet. Les paramètres de l’événement contiennent les informations sur l’achat.

Comment ça marche

L’intégration comprend un flux de données bidirectionnel entre Xsolla et Adjust. Voici comment le système interagit lorsqu’un utilisateur effectue un achat.

  sequenceDiagram
    participant User
    participant Mobile App
    participant Web Shop
    participant Xsolla Backend
    participant Adjust
    User->>Mobile App: 1. Logs in
    Mobile App->>Adjust: 2. Sends CUID
    Adjust-->>Xsolla Backend: 3. Sends callback
    User->>Web Shop: 4. Logs in using CUID
    User->>Web Shop: 5. Makes a purchase
    Web Shop->>Xsolla Backend: 6. Sends purchase event
    Xsolla Backend->>Adjust: 7. Sends xsolla-billing-payment event

L’utilisateur (joueur) s’inscrit ou se connecte à l’application mobile.
L’application envoie un événement in-app à Adjust, par exemple, login, signup ou tout autre événement incluant le CUID.
Adjust envoie un callback à Xsolla incluant le jeton d’application, l’ID Adjust, le CUID et d’autres paramètres de données.
L’utilisateur se connecte à Web Shop à l’aide de son CUID.
L’utilisateur effectue un achat dans le Web Shop.
L’événement d’achat est transmis au serveur Xsolla, qui vérifie les données avec celles reçues d’Adjust.
Le serveur Xsolla envoie à Adjust un événement in-app S2S incluant l’ID Adjust, le jeton d’application et d’autres paramètres transmis par Adjust.

Adjust attribue un nouvel événement, l’achat et le revenu généré à la source médiatique qui a permis d’acquérir ou de réengager l’utilisateur.

Comment configurer dans le Compte éditeur

Ouvrez le projet dans le Compte éditeur et accédez à la section Integrations.
Appuyez sur le volet Adjust.

Dans le volet Mobile app S2S integration, appuyez sur Configure.

Dans la fenêtre qui s’ouvre, vérifiez que la case Enable this integration est bien cochée.
Entrez les données suivante :
- Adjust S2S security token ;
- App token pour les plateformes de publication (Android/iOS). Pour ajouter une plateforme, appuyez sur Add app token.
Cliquez sur Save.
Activez l’intégration dans Adjust.

Une fois les paramètres enregistrés, un indicateur vert apparaît dans le volet d’intégration S2S.

Pour modifier l’intégration connectée :

Cliquez sur le volet Adjust.
Dans la fenêtre qui s’ouvre, appliquez les modifications nécessaires.
Cliquez sur Save.

Comment configurer dans Adjust

Dans Adjust :

Configurez le passage du CUID comme paramètre partenaire.
Récupérez un jeton de sécurité S2S.
Activez l’intégration avec Xsolla.

Passez le CUID comme paramètre partenaire

Configurez manuellement le passage du CUID en suivant les instructions. Pour ce faire, appelez la méthode addGlobalPartnerParameter et passez les données suivantes :

ID utilisateur de votre côté ;
forKey: “xsolla_cuid”.

Exemple :

Copy

Full screen

Small screen

swift

1Adjust.addGlobalPartnerParameter("abcd123", forKey: "xsolla_cuid")

1[Adjust addGlobalPartnerParameter:@"abcd123" forKey:@"xsolla_cuid"];

Obtenez un jeton de sécurité S2S

Vous devez posséder l’un des rôles suivants dans votre compte Adjust pour consulter et gérer les jetons de sécurité S2S :

administrateur
éditeur
éditeur personnalisé

Pour obtenir un jeton de sécurité S2S :

Connectez-vous à votre compte Adjust.
Ouvrez la section AppView > All apps et accédez à la page d’application.
Accédez à l’onglet Protection.
Dans le bloc S2S security, appuyez sur Open S2S security.
Dans la ligne contenant le jeton S2S nécessaire, appuyez sur l’icône de copie.

Si vous n’avez pas encore de jeton S2S, créez-en un en suivant ces instructions.

Activez l'intégration avec Xsolla

Connectez-vous à votre compte Adjust.
Accédez à la section Campaign Lab > Partners.
Appuyez sur New partner.

Dans la barre de rechercher, entrez et sélectionnez Xsolla.
Appuyez sur Next.

Sélectionnez l’application pour laquelle vous configurez l’intégration.
Appuyez sur Next.
Activez le partage des données. Pour ce faire, dans le bloc Enable data sharing, appuyez sur Edit, activez la bascule, puis appuyez sur Enable.

Configurez le mappage d’événements :

1. Dans le bloc Map your events, appuyez sur Map event.

1. Dans la section Adjust event, sélectionnez xsolla-billing-payment.
2. Dans la section Partner event, sélectionnez Xsolla billing payment.
3. Appuyez sur Apply.

Pour associer un autre événement Adjust à Xsolla billing payment, créez d’abord l’événement en suivant les instructions.

Appuyez sur Next.
Vérifiez les paramètres et appuyez sur Enable partner. Si nécessaire, revenez aux étapes précédentes et mettez à jour les paramètres.

Structure des valeurs d'événement

Pour organiser un événement spécifique ou demander des options d’intégration spéciales, contactez votre responsable de la réussite client ou envoyez un e-mail à csm@xsolla.com.

Achat d'objet

Lorsqu’un utilisateur effectue un achat dans le Web Shop, Xsolla envoie l’événement xsolla-billing-payment à Adjust. Les informations d’achat suivantes sont passées dans les paramètres de l’événement :

Paramètre	Description
content_id	UGS unique ou tableau d’UGS dans l’achat.
quantity	Quantité de l’article avec l’UGS correspondante (un ou tout un tableau).
revenue	Montant de l’achat. Les remises sont incluses. Les commissions et les taxes ne sont pas incluses.
currency	Devise d’achat.

Données supplémentaires

En outre, vous pouvez passer les paramètres suivants dans le callback :

Paramètre	Description
os_name	Systèmes d’exploitation de l’appareil
adid	ID d’appareil côté Adjust (toutes les plateformes).
idfa	Identifiant d’annonce dans l’App Store.
idfv	Identifiant de fournisseur du côté Apple.
gps_adid	Identifiant publicitaire dans Google Play.
app_token	Jeton d’application côté Adjust.
{partner_parameters}	Autres paramètres personnalisés pour lesquels vous souhaitez obtenir des informations.

Merci pour votre commentaire !

Nous examinerons votre message et l'utiliserons pour améliorer votre expérience.

Dernière mise à jour: 28 Janvier 2026

Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entrée.

Contenu

Glossaire
Scénarios d'intégration
Comment ça marche
Comment configurer dans Adjust
Créez des événements
Activez l'intégration avec Xsolla
Comment configurer dans le Compte éditeur
Comment ça marche
Comment configurer dans le Compte éditeur
Comment configurer dans Adjust
Passez le CUID comme paramètre partenaire
Obtenez un jeton de sécurité S2S
Activez l'intégration avec Xsolla
Structure des valeurs d'événement
Achat d'objet
Données supplémentaires

Your browser is not supported. Please try a different browser

Intégration avec Adjust

Glossaire

Adjust

Jeton d'application

ID Adjust

Valeur à vie (LTV)

Retour sur investissement publicitaire (ROAS)

Événement in-app

Acquisition d'utilisateurs

ID utilisateur du client (CUID)

Callback

Jeton de sécurité serveur-serveur (S2S)

Reciblage

Événement web

Scénarios d'intégration

Comment ça marche

Comment configurer dans Adjust

Créez des événements

Activez l'intégration avec Xsolla

Comment configurer dans le Compte éditeur

Comment ça marche

Comment configurer dans le Compte éditeur

Comment configurer dans Adjust

Passez le CUID comme paramètre partenaire

Obtenez un jeton de sécurité S2S

Activez l'intégration avec Xsolla

Structure des valeurs d'événement

Achat d'objet

Données supplémentaires