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

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.

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.

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 :

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 User
    participant Promo as Web Shop<br>promotional campaign<br>(ad banner)
    participant Shop as Web Shop
    participant SG as Singular
    User->>Promo: 1. Clicks banner
    Promo->>Shop: 2. Redirect with URL parameters
    Shop->>SG: 3. load event
    User->>Shop: 4. Logs in with CUID
    Shop->>SG: 5. identify event
    User->>Shop: 6. Makes purchase
    Shop->>SG: 7. event

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

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.

- 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

Utilisez ces instructions pour lancer et suivre vos campagnes publicitaires d’acquisition et de reciblage pour Xsolla Web Shop. Cela s’applique à la fois aux :

campagnes web-to-web shop (publicités dirigeant les utilisateurs depuis des sources web vers votre magasin en ligne) ;
campagnes de reciblage in-app-to-web shop (publicités ciblant les utilisateurs depuis l’application vers le Web Shop).

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

Ouvrez le projet dans le Compte éditeur et accédez à la section Integrations.
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.

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 :

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: 30 Décembre 2025

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 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 Singular
Obtenez une clé SDK
Activez l'intégration avec Xsolla
Structure des valeurs d'événement
Achat d'objet
Données supplémentaires

Your browser is not supported. Please try a different browser

Intégration avec Singular

Glossaire

Singular

Singular Device ID (SDID)

ID d'application

Valeur à vie (LTV)

Retour sur investissement publicitaire (ROAS)

Événement web

Événement in-app

Acquisition d'utilisateurs

Reciblage

ID utilisateur du client (CUID)

Postback

Clé SDK

Clé secrète du SDK

Flux d'intégration

Comment ça marche

Comment configurer dans Singular

Comment configurer dans le Compte éditeur

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 Singular

Obtenez une clé SDK

Activez l'intégration avec Xsolla

Structure des valeurs d'événement

Achat d'objet

Données supplémentaires