Intégration avec Singular

Glossaire

Singular

Plateforme d’attribution mobile et d’analyse marketing, Singular 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 Singular.

ID d'application

ID de l’application mobile unique pour chaque plateforme (Android, iOS). Il correspond à la valeur Bundle ID que vous trouverez dans Singular dans la section Settings > Apps, dans le panneau de l’application concernée.

É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 Singular. 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 à Singular 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.

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

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 Singular, et sert à l’appariement et à l’attribution des utilisateurs.

Avis

Vous devez passer ce paramètre dans le postback. 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.

Postback

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

Clé SDK

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

Flux d'intégration

Singular et Xsolla prennent en charge l’intégration S2S pour applications mobiles, qui vous permet de mesurer et d’évaluer l’efficacité des campagnes d’acquisition d’utilisateur et de reciblage visant à générer du trafic vers le Web Shop. Xsolla transmet les informations sur les achats effectués dans le Web Shop à Singular sous forme d’événements in-app mobiles, que Singular attribue ensuite à la source correspondante.

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 pour Android ou iOS ;
• utilisez Singular ;
• 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 Singular :

Comment ça marche

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

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent', 'noteTextColor': '#495C6B' }}}%%
sequenceDiagram
    participant User
    participant Mobile App
    participant Web Shop
    participant Xsolla Backend
    participant Singular
    User->>Mobile App: 1. Logs in
    Mobile App->>Singular: 2. Sends CUID
    Singular->>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->>Singular: 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 à Singular, par exemple, login ou tout autre événement incluant le CUID.
3. Singular envoie un postback à Xsolla, qui inclut le CUID ainsi que d’autres informations sur l’appareil de l’utilisateur.
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 Singular.
7. Le serveur Xsolla envoie un événement in-app à Singular, contenant les paramètres nécessaires pour le mappage.

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

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. Fournissez les données suivantes :
   1. clé SDK Singular ;
   2. ID d’application, unique pour chaque plateforme (Android/iOS). Pour ajouter une plateforme, appuyez sur Add application ID.
6. Cliquez sur Save.
7. Activez l’intégration dans Singular.

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

Comment configurer dans Singular

Dans Singular, vous devez :

1. Obtenir une clé S2S.
2. Activer l’intégration avec Xsolla.

Obtenez une clé SDK

1. Connectez-vous à votre compte Singular.
2. Ouvrez la section Developer Tools > SDK Integration.
3. Accédez à l’onglet SDK Keys.
4. Appuyez sur Show Keys.
5. Copiez la valeur dans le champ SDK Key.

Activez l'intégration avec Xsolla

1. Connectez-vous à votre compte Singular.
2. Accédez à la section Attribution Setup > Partner Configuration.
3. Appuyez sur Add Partner.
4. Dans la barre de rechercher, entrez et sélectionnez Xsolla.

5. Dans la fenêtre qui s’ouvre, sélectionnez l’application pour laquelle vous configurez l’intégration.
6. Appuyez sur Next.
7. Vérifiez que dans le bloc Events Postbacks, l’événement Login est sélectionné.
8. Cliquez 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 à Singular. Les informations d’achat suivantes sont passées dans les paramètres de l’événement :

Données supplémentaires

En plus des paramètres passés dans l’événement xsolla-billing-payment, Xsolla envoie les données suivantes :