Intégration avec Tenjin

Glossaire

Tenjin

Une plateforme dédiée à l’attribution mobile et à l’analyse marketing. Elle permet aux développeurs d’applications et aux spécialistes du marketing de suivre, mesurer et optimiser leurs campagnes sur différents canaux et appareils.

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

ID d'application

Identifiant de l’application mobile généré automatiquement lors de l’ajout d’une application à Tenjin. Il correspond au Bundle ID. Pour trouver sa valeur :

1. Dans votre compte Tenjin, accédez à la section Configure > All apps.
2. Ouvrez la page de l’application nécessaire.
3. Dans la section Add details, copiez le Bundle ID.

Clé SDK

Identifiant de l’application mobile généré automatiquement lors de l’ajout d’une application à Tenjin. Il correspond au Bundle ID. Pour trouver sa valeur :

1. Dans votre compte Tenjin, accédez à la section Configure > All apps.
2. Ouvrez la page de l’application nécessaire.
3. Dans la section Add details, copiez le Bundle ID.

Note

Si votre application est publiée à la fois sur iOS et Android, vous devez obtenir une clé au niveau du compte. Pour ce faire, contactez votre responsable Tenjin.

Clé au niveau du compte

Jeton utilisé pour autoriser les appels serveur à serveur (S2S) lorsque votre application est publiée à la fois sur iOS et Android. Il est généré manuellement par Tenjin. Pour l’obtenir, contactez un responsable Tenjin.

Gardez à l’esprit que les Bundle ID sont uniques pour chaque plateforme.

Tenjin ID

Identifiant utilisateur généré par Tenjin (analytics_installation_id).

Valeur à vie (LTV)

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

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 Tenjin.

Retour sur investissement (ROI)

Métrique mesurant le retour sur investissement en calculant le pourcentage de bénéfices par rapport au coût total. Pour en savoir plus sur le retour sur investissement, consultez la documentation Tenjin.

Événement in-app

Actions effectuées par l’utilisateur dans l’application. Les actions de l’utilisateur dans le Web Shop sont également considérées comme des événements in-app dans le cadre de l’intégration S2S et sont transmises à Tenjin depuis le back-end de 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 Tenjin, et sert à l’appariement ainsi qu’à l’attribution des utilisateurs.

Avis

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 Tenjin pour plus d’informations.

Scénario d'intégration

Tenjin et Xsolla prennent en charge l’intégration S2S pour applications mobiles, qui permet une mesure complète de la LTV, du ROAS et du ROI pour les achats sur application et sur le Web Shop. Xsolla transmet à Tenjin les informations relatives aux achats réalisés sur le Web Shop sous forme d’événements in-app mobiles. Tenjin attribue ensuite ces événements au nombre d’installations de l’application mobile, ainsi qu’aux campagnes d’acquisition d’utilisateurs.

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 Tenjin ;
• 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 Tenjin :

Comment ça marche

L’intégration comprend un flux de données bidirectionnel entre Xsolla et Tenjin. 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 Tenjin
    User->>Mobile App: 1. Logs in
    Mobile App->>Tenjin: 2. Sends CUID
    Tenjin-->>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->>Tenjin: 7. Sends xsolla-billing-payment event

1. L’utilisateur s’inscrit ou se connecte à l’application mobile.
2. Votre application envoie un événement iin-app qui inclut le CUID à Tenjin.
3. Tenjin envoie un callback à Xsolla incluant l’ID d’application, le Tenjin ID, 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 de Tenjin.
7. Le serveur Xsolla envoie à Tenjin un événement in-app S2S incluant le Tenjin ID, l’ID application et d’autres paramètres reçu de Tenjin.

Tenjin attribue un nouvel événement, un nouvel achat et un nouveau revenu à la source média.

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 Tenjin.

3. Dans le volet Mobile app S2S integration, appuyez sur Configure.
4. Cochez la case Enable this integration.
5. Entrez les données suivantes :
   • Clé SDK générée par Tenjin pour chaque plateforme. Si votre application est publiée à la fois sur iOS et Android, vous devez utiliser une clé de niveau compte fournie par Tenjin.
   • ID d’application.
6. Appuyez sur Save.
7. Activez l’intégration dans Tenjin.

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

Pour modifier l’intégration activée :

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

Comment configurer dans Tenjin

Dans Tenjin, vous devez :

1. Configurer le transfert du CUID vers Tenjin.
2. Ajouter Xsolla comme canal publicitaire.
3. Configurer un rappel.

Transmission du CUID

Configurez le transfert du CUID depuis votre application mobile vers Tenjin en appelant la méthode setCustomerUserId :

1TenjinSDK instance = TenjinSDK.getInstance(this, "<TENJIN_SDK_KEY>");
2instance.setCustomerUserId(cuid);   // CUID generated by your backend
3instance.connect();

1TenjinSDK.initialize("<TENJIN_SDK_KEY>")
2TenjinSDK.setCustomerUserId(userId: cuid);  // CUID used for Web Shop
3TenjinSDK.connect();

1BaseTenjin instance = Tenjin.getInstance("<TENJIN_SDK_KEY>");
2instance.SetCustomerUserId(cuid);   // CUID used for Web Shop
3instance.Connect();

Ajoutez Xsolla comme canal supplémentaire

1. Connectez-vous à votre compte Tenjin.
2. Accédez à la section Configure > Channels.
3. Appuyez sur Add a channel.

4. Dans la barre de recherche, entrez et sélectionnez Xsolla.
5. Appuyez sur le volet Xsolla.

6. Appuyez sur Add ad account.

Configuration du callback

1. Connectez-vous à votre compte Tenjin.
2. Accédez à la section Configure > Channels.
3. Accédez à la page de l’application nécessaire.
4. Accédez à l’onglet Callbacks.
5. Dans la liste déroulante des canaux publicitaires, sélectionnez Xsolla.

6. Dans la section Channel callbacks, appuyez sur Add events et sélectionnez Xsolla login.

7. Dans la fenêtre modale, sélectionnez l’événement qui contient le CUID et appuyez sur Save.

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 à Tenjin. 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 :