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.

Singular Device ID (SDID)

Identifiant unique généré automatiquement par Singular Web SDK, permettant d’identifier le navigateur de chaque visiteur.

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.

Valeur à vie (LTV)

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

Retour sur investissement publicitaire (ROAS)

Évaluation de l’efficacité d’une campagne publicitaire en mesurant le revenu généré par unité de dépense publicitaire.

Événement web

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

É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

Une stratégie visant à engager les utilisateurs ayant déjà interagi avec votre application ou votre site. Elle vise à relancer l’activité des utilisateurs actifs ou inactifs via des campagnes publicitaires. Pour plus d’informations, consultez 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.

Vous devez transmettre ce paramètre dans le postback.

Si l’authentification par identifiant utilisateur est configurée dans votre Web Shop, vérifiez que le CUID utilisé correspond à celui transmis à la plateforme de mesure mobile (MMP) par votre application mobile. Dans le cas contraire, contactez un responsable de la réussite client ou écrivez à [email protected] pour mettre en place le webhook de validation des utilisateurs dans le Web Shop ou l’authentification par lien profond.

Si vous avez configuré d’autres méthodes d’authentification, reportez-vous à la section Configuration de l’authentification pour l’intégration avec les MMP.

Pour configurer le CUID, consultez la documentation du SDK Singular.

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.

Clé secrète du SDK

Composant utilisé avec la clé Singular SDK pour initialiser et authentifier Singular SDK dans une application. Cette clé secrète, combinée à la clé SDK, permet au SDK de communiquer de manière sécurisée avec la plateforme Singular et d’attribuer correctement les installations d’applications, les événements et autres données pour l’analyse marketing.

Flux d’intégration

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

Intégration S2S pour applications mobiles — permet de mesurer de manière complète la LTVet le ROAS pour les achats réalisés dans l’application ainsi que sur le Web Shop. Xsolla passe les informations des achats effectués sur le Web Shop à Singular sous forme d’événements in-app, que Singular attribue ensuite aux installations de l’application mobile ainsi qu’aux campagnes d’acquisition et de réengagement.
Intégration Web SDK — permet de mesurer et d’évaluer l’efficacité des campagnes d’acquisition et de reciblage visant à générer du trafic vers le Web Shop.
Cette intégration indique combien d’utilisateurs sont arrivés sur le site via une campagne de reciblage et suit la conversion des canaux menant au site. Xsolla envoie les informations sur les achats effectués sur le Web Shop à Singular sous forme d’événements web, que Singular attribue à la source média, à la campagne, au groupe de publicité et à l’annonce ayant conduit l’utilisateur à l’achat.

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

Singular Mobile Measurement Platform ;
constructeur de site Xsolla.

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

Événement	Description
`load`	É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 Singular Device ID, stocké dans un cookie de première partie.
`identify`	Événement de connexion, y compris le Singular Device ID et le CUID.
`event`	Événement d’achat d’objet, incluant le Singular Device ID, le CUID et d’autres événements du constructeur de site.

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 à Singular 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 U as Utilisateur
    participant WSP as Campagne promotionnelle de Web Shop (bannière publicitaire)
    participant WS as Web Shop
    participant SG as Singular
    U->>WSP: Appuie sur la bannière
    WSP->>WS: Redirection avec des paramètres d’URL
    WS->>SG: Envoie un événement de chargement
    U->>WS: Se connecte avec son CUID
    WS->>SG: Envoie un événement d’identification
    U->>WS: Effectue un achat
    WS->>SG: Envoie un événement d’achat

Flux utilisateur :

L’utilisateur appuie sur la bannière de la campagne publicitaire.
L’utilisateur est redirigé vers le Web Shop, l’URL de cette transition incluant les paramètres et macros de Singular qui indiquent depuis quelle bannière et quel site il a été dirigé.
Un événement de visite est envoyé à Singular depuis le côté client du Web Shop.
L’utilisateur se connecte au Web Shop en utilisant le CUID.
L’événement d’autorisation est transmis à Singular.
L’utilisateur effectue un achat sur le Web Shop.
L’événement d’achat est envoyé à Singular.

Comment configurer dans Singular

Connectez-vous à votre compte Singular.
Accédez à la section Settings > Apps.

Appuyez sur Add new app.

Indiquez le nom de votre application web.

Sélectionnez Web comme système d’exploitation.
Dans le champ URL, indiquez le domaine du Web Shop, par exemple : yourapp.yourcompany.com.
Dans le champ Bundle ID, indiquez votre Bundle ID au format DNS inversé, par exemple : com.yourcompany.
Appuyez sur Save.

Comment configurer dans le Compte éditeur

Comment configurer dans votre compte

Ouvrez votre projet dans le Compte éditeur.
Accédez au constructeur de site en utilisant l'une de ces méthodes :
- Dans le menu latéral, appuyez sur Storefronts > Websites, sélectionnez votre site puis appuyez sur Configure.
- Dans le menu latéral, appuyez sur Integrations. Dans la section qui s'ouvre :
  1. Appuyez sur le volet Singular.

Ouvrez votre projet dans votre compte.
Accédez au constructeur de site en utilisant l'une de ces méthodes :
- Dans le menu latéral, appuyez sur Storefronts > Websites. Dans le volet du site, appuyez sur l'icône ⋮ et sélectionnez Configure.
- Dans le menu latéral, appuyez sur Other tools > Integrations. Dans la section qui s'ouvre :
  1. Appuyez sur le volet Singular.

Ouvrez votre projet dans votre compte.
Accédez au constructeur de site en utilisant l'une de ces méthodes :
- Dans le menu latéral, appuyez sur Storefronts > Websites. Dans le volet du site, appuyez sur l'icône ⋮ et sélectionnez Configure.
- Dans le menu latéral, appuyez sur Other tools > Integrations. Dans la section qui s'ouvre :
  1. Appuyez sur le volet Singular.

Ouvrez votre projet dans votre compte.
Accédez au constructeur de site en utilisant l'une de ces méthodes :
- Dans le menu latéral, appuyez sur Storefronts > Websites. Dans le volet du site, appuyez sur l'icône ⋮ et sélectionnez Configure.
- Dans le menu latéral, appuyez sur Other tools > Integrations. Dans la section qui s'ouvre :
  1. Appuyez sur le volet Singular.

Ouvrez votre projet dans le compte pour les jeux mobiles.
Accédez au constructeur de site en utilisant l'une de ces méthodes :
- Dans le menu latéral, cliquez sur Web Shop. Dans le volet de votre site, cliquez sur l'icône ⋮ et sélectionnez Configure.
- Dans le menu latéral, cliquez sur Operations > MMP. Dans la section qui s'ouvre :
  1. Cliquez sur le volet Singular.

- 1. Dans le volet Web SDK (Site Builder), appuyez sur Configure.

- 1. Sélectionnez votre site et appuyez sur Configure.
  2. Dans l'onglet Site settings, accédez à la section Apps.
  3. Dans le volet Singular, appuyez sur Connect.

Dans le formulaire Singular connection, remplissez les champs SDK key, Secret SDK et Bundle ID :

Pour trouver ces informations dans le compte Singular :
1. Connectez-vous au compte Singular ;
2. Accédez à la section Developer Tools > SDK Integration ;
3. Accédez à l'onglet SDK Keys ;
4. Appuyez sur Show Keys ;
5. Copiez la valeur du champ SDK Keys.
6. Copiez la valeur du champ SDK Secret.

1. Pour trouver le Bundle ID, rendez-vous dans Settings > Apps > Web Application et copiez le Bundle ID.

Appuyez sur Connect.

Comment mener des campagnes publicitaires sur le web et in-app

Vous pouvez lancer et suivre les campagnes publicitaires suivantes pour l’acquisition d’utilisateurs et le reciblage pour votre Web Shop :

Campagnes web qui dirigent les utilisateurs depuis des sources en ligne vers votre Web Shop. Dans ce cas, le suivi et l’attribution sont assurés par Singular.
Campagnes intégrées à l’application qui redirigent les utilisateurs depuis d’autres applications vers votre Web Shop. Dans ce cas, vous devez utiliser DSP, le suivi et l’attribution étant assurés par Singular.

Pour créer un lien de site Singular :

Connectez-vous au compte Singular.
Accédez à la section Attribution Setup et sélectionnez Create Web Link.
Dans le champ Target (App), choisissez l’application web liée à Xsolla Web Shop.
Dans le champ Partner, sélectionnez le partenaire réseau publicitaire.

Entrez un chemin de page de destination si nécessaire (facultatif).
Actualisez les champs UTM pour suivre les informations de la campagne (facultatif).
Appuyez sur Generate Link.

Une URL finale pour votre campagne web sera générée en fonction de vos choix. Utilisez ce lien pour diriger le trafic de votre campagne web.

Pour un suivi plus détaillé de la campagne (granularité), ajoutez des macros à l’URL générée. Utilisez le guide d’ajout de macros pour insérer des paramètres macro pour Singular Web SDK, ce qui permet de capturer des données au niveau de la campagne. Veillez à ne pas écraser les paramètres existants du lien.

Les instructions peuvent varier selon le réseau publicitaire choisi. Suivez toujours les indications spécifiques au réseau affichées dans le générateur d’URL web.

Pour plus d’informations, consultez le guide Singular Website Links.

Comment ajouter des événements web/Web Shop dans Singular

Connectez-vous au compte Singular.
Accédez à la section Settings > Events.
Ajoutez les événements capturés par votre Web SDK :
1. Sélectionnez App specific Events ;
2. Sélectionnez l'application ;
3. Dans la section Cohort Events, ajoutez le nom de l'événement qui apparaîtra dans vos rapports ;
4. Dans le champ Event maps to the following, sélectionnez l'événement SDK ;
5. Appuyez sur Save.

Pour plus d’informations, consultez les instructions Comment suivre des événements in-app.

Les événements de revenu sont automatiquement inclus dans la mesure Revenue des rapports Singular. Vous n’avez pas besoin d’ajouter un événement personnalisé, sauf si vous souhaitez suivre séparément le nombre d’événements de revenu.

Comment obtenir le rapport de performance des campagnes publicitaires du Web Shop dans Singular

Pour générer un rapport pour les campagnes publicitaires web-to-web et in-app-to-web :

Connectez-vous au compte Singular.
Accédez à la section Reports > Insights.
Configurez vos filtres :
- Définissez la période souhaitée.
- Sélectionnez l’application que vous souhaitez analyser.

Ajoutez des dimensions pour segmenter vos données :
- Source ;
- Campaign Name ;
- dimensions supplémentaires si nécessaire.

Choisissez vos mesures web :
- Web New Visitors ;
- Web Re-Engaged Visitors.

Incluez les données de cohorte :
- Revenue ;
- ROI ;
- tout événement de cohorte personnalisé précédemment configuré sur la page Settings > Events.

Appuyez sur Run report dans le coin supérieur droit.

Établissez une convention de nommage claire pour vos campagnes afin de distinguer les campagnes web-to-web des campagnes in-app-to-web. Cette classification facilite l’analyse des rapports et permet à votre équipe d’identifier rapidement le type de chaque campagne.

Reportez-vous à Reports FAQ pour en savoir plus.

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 :

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

L’utilisateur (joueur) s’inscrit ou se connecte à l’application mobile.
L’application envoie un événement in-app à Singular, par exemple, login ou tout autre événement incluant le CUID.

Pour configurer le CUID, consultez la documentation du SDK Singular.

Singular envoie un postback à Xsolla, qui inclut le CUID ainsi que d’autres informations sur l’appareil de l’utilisateur.
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 de Singular.
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

Comment configurer dans votre compte

Ouvrez le projet dans le Compte éditeur et accédez à la section Integrations.

Ouvrez le projet dans votre compte et accédez à la section Other tools > Integrations.

Ouvrez le projet dans votre compte et accédez à la section Other tools > Integrations.

Ouvrez le projet dans votre compte et accédez à la section Other tools > Integrations.

Ouvrez votre projet dans le compte pour les jeux mobiles et accédez à la section Operations > MMP.

Appuyez sur le volet Singular.

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.
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.
Cliquez sur Save.
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 :

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

Comment configurer dans Singular

Dans Singular, vous devez :

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

Obtenez une clé SDK

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

Activez l’intégration avec Xsolla

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

Dans la fenêtre qui s’ouvre, sélectionnez l’application pour laquelle vous configurez l’intégration.
Appuyez sur Next.
Vérifiez que dans le bloc Events Postbacks, l’événement Login est sélectionné.
Cliquez sur Save.

Assurez-vous d’avoir configuré le CUID :

La méthode SetCustomerId et votre événement d’authentification sont implémentés via le SDK Singular.
Dans le Compte éditeur Xsolla, l’intégration avec Singular est configurée.
Dans le compte Singular, l’intégration avec Xsolla est activée.

Si l’option Reject IAP without receipt est activée pour votre application dans Singular, contactez un responsable client Singular pour activer ou désactiver les événements de revenus Xsolla.

Assurez-vous d’avoir configuré le CUID :

La méthode SetCustomerId et votre événement d’authentification sont implémentés via le SDK Singular.
Dans votre compte Xsolla, l’intégration avec Singular est configurée.
Dans le compte Singular, l’intégration avec Xsolla est activée.

Assurez-vous d’avoir configuré le CUID :

La méthode SetCustomerId et votre événement d’authentification sont implémentés via le SDK Singular.
Dans votre compte pour les jeux mobiles, l’intégration avec Singular est configurée.
Dans votre compte Singular, l’intégration avec Xsolla est activée.

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 à [email protected] .

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 :

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 plus des paramètres passés dans l’événement xsolla-billing-payment, Xsolla envoie les données suivantes :

Paramètre	Description
a	Clé SDK Singular.
p	Plateforme d’application. Exemple : iOS.
ip	Adresse IP publique de l’appareil de l’utilisateur.
ve	Version du système d’exploitation de l’appareil de l’utilisateur.
ma	Marque de l’appareil de l’utilisateur. Exemple : Apple.
mo	Modèle de l’appareil de l’utilisateur. Exemple : iPhone 4S.
lc	Langue de l’appareil de l’utilisateur au format `^[a-z]{2}-[A-Z]{2}$`. Exemple : `en_US`.
i	ID de l’application côté Singular.
att_authorization_status	Code de statut App Tracking Transparency (ATT)
n	Nom de l’événement. La longueur maximale est de 32 caractères.
is_revenue_event	Si l’événement est lié aux revenus.
amt	Montant de la devise.
cur	Devise. Code de devise à trois lettres selon la norme ISO 4217.
custom_user_id	CUID.
partner	Partenaire — `xsolla`.
e	Autres paramètres personnalisés (facultatifs).

Merci pour votre commentaire !

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

Dernière mise à jour: 20 Octobre 2026

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

Contenu

Glossaire
Flux d’intégration
Comment ça marche
Comment configurer dans Singular
Comment configurer dans le Compte éditeur
Comment configurer dans votre compte
Comment configurer dans votre compte
Comment mener des campagnes publicitaires sur le web et in-app
Comment ajouter des événements web/Web Shop dans Singular
Comment obtenir le rapport de performance des campagnes publicitaires du Web Shop dans Singular
Comment ça marche
Comment configurer dans le Compte éditeur
Comment configurer dans votre compte
Comment configurer dans votre compte
Comment configurer dans Singular
Obtenez une clé SDK
Activez l’intégration avec Xsolla
Structure des valeurs d’événement
Achat d’objet
Données supplémentaires