Intégration avec Airbridge

Glossaire

Scénario d'intégration

Airbridge et Xsolla prennent en charge l’intégration S2S d’applications mobiles, permettant un suivi complet de la LTV et du ROAS pour les achats effectués sur l’application mobile et via le Web Shop. Xsolla envoie à Airbridge les informations relatives aux achats effectués via le Web Shop sous forme d’événements in-app, que Airbridge attribue ensuite au nombre d’installations de l’application, 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 Airbridge ;
• 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 Airbridge :

Comment ça marche

L’intégration comprend un flux de données bidirectionnel entre Xsolla et Airbridge. 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 Airbridge
    User->>Mobile App: 1. Logs in
    Mobile App->>Airbridge: 2. Sends CUID
    Airbridge-->>Xsolla Backend: 3. Sends postback
    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->>Airbridge: 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 à Airbridge, par exemple, login, signup ou tout autre événement incluant le CUID.
3. Airbridge envoie un postback à Xsolla incluant l’application store ID, le Airbridge 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 Airbridge.
7. Le serveur Xsolla envoie à Airbridge un événement in-app S2S incluant l’Airbridge ID, l’application store ID et d’autres paramètres reçu de Airbridge.

Airbridge attribue un nouvel événement, l’achat et le revenu généré à la source média 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 Airbridge.

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

4. Dans la fenêtre qui s’ouvre, cochez la case Enable this integration.
5. Entrez les données suivantes :
   • Jeton S2S Airbridge.
   • Application store ID pour les plateformes de publication (Android/iOS). Pour ajouter une plateforme, appuyez sur Add application ID.

1. Copiez les valeurs de ces paramètres dans votre compte Airbridge comme décrit ci-dessous.

6. Appuyez sur Save.
7. Activez l’intégration dans Airbridge.

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. Appuyez sur le volet Airbridge.
2. Dans la fenêtre qui s’ouvre, appliquez les modifications nécessaires.
3. Appuyez sur Save.

Comment configurer dans Airbridge

Dans Airbridge, vous devez :

1. Obtenir des identifiants.
2. Activer l’intégration avec Xsolla.

Obtention des identifiants

1. Connectez-vous à votre compte Airbridge.
2. Accédez à la section Integration > Third-party integration.
3. Appuyez sur le volet Xsolla.

4. Dans la section Set up Xsolla dashboard, copiez les valeurs pour Application store ID et Airbridge S2S token et collez-les dans le Compte éditeur.

Activez l'intégration avec Xsolla

Après avoir activé l’intégration dans le Compte éditeur :

1. Connectez-vous à votre compte Airbridge.
2. Accédez à la section Integration > Third-party integration.
3. Appuyez sur le volet Xsolla.
4. Activez la bascule Send events.

Note

Pour partager les données des utilisateurs iOS qui refusent la transparence du suivi par les apps, désactivez la bascule EPC (Extended Privacy Control). Si cette bascule est désactivée, rendez-vous dans la section Settings > App settings pour la mettre à jour.

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 à Airbridge. 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 postback :