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.

Avis

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.

Scénario d'intégration

Adjust et Xsolla prennent en charge l’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 aux paiements effectués dans l’application mobile, ainsi qu’aux compagnes d’acquisition d’utilisateurs et de réengagement.

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 :

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

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

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

3. Dans le volet Mobile app S2S integration, appuyez sur Configure.
4. Dans la fenêtre qui s’ouvre, vérifiez que la case Enable this integration est bien cochée.
5. 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.
6. Cliquez sur Save.
7. 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 :

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

Comment configurer dans Adjust

Dans Adjust :

1. Configurez le passage du CUID comme paramètre partenaire.
2. Récupérez un jeton de sécurité S2S.
3. 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 :

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

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

Obtenez un jeton de sécurité S2S

Pour obtenir un jeton de sécurité S2S  :

1. Connectez-vous à votre compte Adjust.
2. Ouvrez la section AppView > All apps et accédez à la page d’application.
3. Accédez à l’onglet Protection.
4. Dans le bloc S2S security, appuyez sur Open S2S security.
5. 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

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

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

6. Sélectionnez l’application pour laquelle vous configurez l’intégration.
7. Appuyez sur Next.
8. 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.

9. Configurez le mappage d’événements :

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

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

10. Appuyez sur Next.
11. 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 :

Données supplémentaires

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