Intégration avec AppsFlyer

Glossaire

AppsFlyer

Plateforme d’attribution mobile et d’analyse marketing qui permet aux développeurs d’applications, aux marketeurs et aux marques de suivre et de mesurer l’efficacité de leurs campagnes marketing sur différents canaux et appareils.
Pour plus d’informations, consultez la documentation AppsFlyer.

ID d’application

ID de l’application mobile, unique pour chaque plateforme mobile (Android/iOS/etc.). Les valeurs de l’ID d’application spécifiées dans Xsolla doivent correspondre à celles indiquées dans la section Mes Apps dans AppsFlyer.
Pour plus d’informations, consultez la documentation Android ou Apple.

ID Appsflyer

ID utilisateur généré par AppsFlyer.

ID Web AppsFlyer

ID du site dans le compte AppsFlyer, utilisé lors de l’intégration du SDK Web avec AppsFlyer. Cet ID est transmis dans le champ webAppId dans les événements Web.

App Tracking Transparency (ATT)

Fonctionnalité de confidentialité introduite par Apple dans iOS 14.5 et versions ultérieures obligeant les applications à obtenir l’autorisation de l’utilisateur avant de suivre son activité.

ID utilisateur du client (CUID)

ID utilisateur généré et défini par le propriétaire de l’application lors de l’inscription. Le CUID doit être le même pour le Web Shop et pour AppsFlyer. Pour plus d’informations, consultez la documentation AppsFlyer.

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.

Identifiant publicitaire (IDFA)

ID attribué par Apple à l’appareil d’un utilisateur. Pour plus d’informations, consultez la documentation Apple.

Événement in-app

Action de l’utilisateur dans l’application. Pour plus d’informations, consultez la documentation AppsFlyer.

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 envoyées à AppsFlyer depuis le back-end de Xsolla.

Événement Web

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

Valeur à vie (LTV)

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

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.

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.

Postback

Processus de réception de données sur les événements in-app dans les réseaux publicitaires. Pour plus d’informations, consultez la documentation AppsFlyer.

Jeton serveur-serveur (S2S) ou clé S2S

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

Clé dev AppsFlyer

Clé utilisée lors de l’intégration du SDK Web AppsFlyer. Elle est propre à chaque application et permet d’autoriser cette dernière dans le système AppsFlyer. Elle est générée côté AppsFlyer.

Consultez la documentation AppsFlyer pour plus d’informations sur la clé dev.

Acquisition d’utilisateurs

Processus consistant à attirer de nouveaux utilisateurs sur un site, un service, une plateforme ou une application via une activité de marketing.

Scénarios d’intégration

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

Intégration S2S d’applications mobiles — permet de réaliser des mesures complètes de la LTV et du ROAS pour les achats effectués sur l’application et via le Web Shop.

Xsolla transmet à AppsFlyer les informations relatives aux achats effectués via le Web Shop sous forme d’événements in-app, que AppsFlyer attribue ensuite au nombre d’installations d’applications mobiles ainsi qu’aux campagnes d’acquisition d’utilisateurs et de réengagement.

Intégration du SDK Web — permet de mesurer et d’évaluer l’efficacité des campagnes d’acquisition d’utilisateurs et de reciblage pour attirer le trafic vers le Web Shop.

L’intégration du SDK Web permet d’évaluer combien d’utilisateurs sont arrivés sur le site via une campagne de reciblage, ainsi que la conversion des différents canaux menant au site. Xsolla envoie les informations concernant les achats effectués dans le Web Shop à AppsFlyer sous forme d’événements Web, que AppsFlyer attribue à la source média, à la campagne, à l’ensemble de publicités et à l’annonce ayant conduit l’utilisateur à l’achat.

Configurez l’intégration du SDK Web avec AppsFlyer pour obtenir des analyses d’événements avancées si vous :

utilisez la plateforme de solution de mesure AppsFlyer et avez activé l’attribution basée sur les personnes pour le compte ;
utilisez Xsolla Site Builder.

Configurez l’intégration du SDK Web avec AppsFlyer pour obtenir des analyses d’événements avancées si vous :

utilisez la plateforme de solution de mesure AppsFlyer et avez activé l’attribution basée sur les personnes pour le compte ;
utilisez le constructeur de site Xsolla.

Les événements suivants sont disponibles via l’intégration S2S du SDK Web 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 ID Web AppsFlyer, stocké dans un cookie de première partie.
`identify`	Événement de connexion, y compris l’ID Web AppsFlyer et le CUID.
`event`	Événement d’achat d’un objet, y compris l’ID Web AppsFlyer et le CUID.

Comment ça marche

Ci-dessous un scénario d’interaction du système lors de l’implémentation d’une campagne d’acquisition d’utilisateurs et de reciblage. L’utilisateur clique sur une bannière publicitaire pour accéder au Web Shop et effectue un achat. L’ensemble des événements transmis à AppsFlyer au cours de ce processus permettent de déterminer :

quels utilisateurs ont cliqué, combien et à partir de quelle bannière ;
le montant de leurs paiements ;
l’efficacité de la campagne de reciblage.

Pour suivre les sources de trafic, nous recommandons de configurer les paramètres de suivi suivants :

Groupe de paramètres AppsFlyer tels que pid, c, af_c_id, af_adset, af_adset_id, af_ad, af_ad_id, pour obtenir des rapports au niveau des publicités (niveau créatif) dans AppsFlyer.
Configurez le paramètre pid en fonction de la façon dont vous souhaitez afficher chaque source média dans AppsFlyer. Par exemple, vous pouvez utiliser pid=google ou pid=googleadwords_int pour classer et suivre les différentes sources de trafic.
Pour suivre vos campagnes publicitaires pour le Web Shop, incluez un paramètre de nom de campagne dans vos URL d’attribution. La valeur de ce paramètre sera intégrée aux données d’attribution et reflétée dans les rapports via AppsFlyer.

Utilisez le paramètre c pour passer le nom de la campagne.

Exemple : c=summer_sale ou c={{campaign.name}}.

Suivez les meilleures pratiques en matière d'URL d'attribution sur le site web PBA par AppsFlyer.

  sequenceDiagram
    participant U as Utilisateur
    participant WSP as Campagne promotionnelle de Web Shop (bannière publicitaire)
    participant WS as Web Shop
    participant AF as AppsFlyer
    U->>WSP: Appuie sur la bannière
    WSP->>WS: Redirection avec des paramètres d’URL
    WS->>AF: Envoie un événement de chargement
    U->>WS: Se connecte avec son CUID
    WS->>AF: Envoie un événement d’identification
    U->>WS: Effectue un achat
    WS->>AF: Envoie un événement d’achat

L’utilisateur clique sur la bannière de la campagne publicitaire.
L’utilisateur est redirigé vers le Web Shop. L’URL de la transition inclut le groupe de paramètres AppsFlyer, précisant la bannière et le site Web ayant dirigé l’utilisateur.
Un événement de visite est transmis depuis le côté client du Web Shop à AppsFlyer.
L’utilisateur se connecte à Web Shop à l’aide de son CUID.
L’événement d’autorisation est transmis à AppsFlyer.
L’utilisateur effectue un achat dans le Web Shop.
L’événement d’achat est transmis à AppsFlyer.

Comment configurer dans AppsFlyer

Avant de commencer, configurez les paramètres suivants sur la plateforme AppsFlyer :

Ajoutez une application :
1. Cliquez sur Add app ;
2. Dans la liste, sélectionnez la plateforme Web (PBA) ;
3. Indiquez le domaine de votre Web Shop, par exemple, https://www.webshop.example.com/ comme URL ;
4. Spécifiez un nom d’application, par exemple,Xsolla ;
5. Cliquez sur Add my app.

Ajoutez un bundle :
1. Cliquez sur Add bundle ;
2. Spécifiez Xsolla-bundle comme nom ;
3. Dans la liste des applications Web, sélectionnez l'applicationXsolla que vous avez ajoutée précédemment ;
4. Cliquez sur Create bundle.

Comment configurer dans le Compte éditeur

Comment configurer dans votre compte

Ouvrez le projet dans le Compte éditeur.
Accédez à Site Builder de l'une des manières suivantes :
- Dans le menu latéral, appuyez sur Storefronts > Websites ;
- Dans le menu latéral, appuyez sur Integrations. Dans la section qui s'ouvre :
  1. Appuyez sur le volet AppsFlyer,
  2. Dans le volet Web SDK (Site Builder), appuyez sur Configure.

Sélectionnez votre site et cliquez sur Configure.
Dans l'onglet Site settings, accédez à la section Apps.
Dans le volet AppsFlyer, cliquez sur Connect.

Ouvrez le projet dans votre compte.
Accédez à Site Builder de l'une des manières suivantes :
- Dans le menu latéral, appuyez sur Storefronts > Websites ;
- Dans le menu latéral, appuyez sur Other tools > Integrations. Dans la section qui s'ouvre :
  1. Appuyez sur le volet AppsFlyer,
  2. Dans le volet Web SDK (Site Builder), appuyez sur Configure.

Sélectionnez votre site et cliquez sur Configure.
Dans l'onglet Site settings, accédez à la section Apps.
Dans le volet AppsFlyer, cliquez sur Connect.

Ouvrez le projet dans votre compte.
Accédez à Site Builder de l'une des manières suivantes :
- Dans le menu latéral, appuyez sur Storefronts > Websites ;
- Dans le menu latéral, appuyez sur Other tools > Integrations. Dans la section qui s'ouvre :
  1. Appuyez sur le volet AppsFlyer,
  2. Dans le volet Web SDK (Site Builder), appuyez sur Configure.

Sélectionnez votre site et cliquez sur Configure.
Dans l'onglet Site settings, accédez à la section Apps.
Dans le volet AppsFlyer, cliquez sur Connect.

Ouvrez le projet dans votre compte.
Accédez à Site Builder de l'une des manières suivantes :
- Dans le menu latéral, appuyez sur Storefronts > Websites ;
- Dans le menu latéral, appuyez sur Other tools > Integrations. Dans la section qui s'ouvre :
  1. Appuyez sur le volet AppsFlyer,
  2. Dans le volet Web SDK (Site Builder), appuyez sur Configure.

Sélectionnez votre site et cliquez sur Configure.
Dans l'onglet Site settings, accédez à la section Apps.
Dans le volet AppsFlyer, cliquez sur Connect.

Ouvrez votre projet dans le compte pour les jeux mobiles.
Accédez à Site Builder de l'une des manières suivantes :
- Dans le menu latéral, cliquez sur Web Shop.
- Dans le menu latéral, cliquez sur Operations > MMP. Dans la section qui s'ouvre :
  1. Cliquez sur le volet AppsFlyer.
  2. Dans le volet Web SDK (Site Builder), cliquez sur Configure.

Dans le volet de votre site, appuyez sur l'icône ⋮ et sélectionnez Configure.
Dans l'onglet Site settings, accédez à la section Apps.
Dans le volet AppsFlyer, cliquez sur Connect.

Dans le champ AppsFlyer Dev Key, saisissez la clé de développeur. Pour l'obtenir, accédez à votre compte AppsFlyer :
1. Accédez à la section My Apps.
2. Cliquez sur View brand bundles.
3. Dans la ligne du bundle de marque Xsolla-bundle, cliquez sur l'icône de copie dans la colonne Web dev key.
Cliquez sur Connect.

Pour accéder aux informations sur les événements, dans votre compte AppsFlyer :

Accédez à la section My Apps.
Dans la section Available Apps, sélectionnez l’application Xsolla et cliquez sur View in PBA.

Vous pouvez également consulter les événements d’analyse dans la section Dashboards > People-Based Attribution.

Configurez l’intégration mobile pour obtenir des analyses d’événements avancées si vous :

disposez d’une application mobile sur la plateforme Android/iOS ;
utilisez la plateforme de solution de mesure AppsFlyer ;
utilisez la solution Web Shop pour vendre des objets en-jeu.

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

Événement	Description
xsolla-billing-payment	Achat d’un objet. Les paramètres de l’événement contiennent les informations sur l’achat.
xsolla-billing-refund	Remboursement de paiement. Les paramètres de l’événement incluent des informations sur le montant à rembourser.
xsolla-billing-created	Création de facture. Les paramètres de l’événement incluent des informations sur la facture créée.
xsolla-billing-error	Erreur de paiement. Les paramètres de l’événement incluent des informations sur l’erreur survenue lors du traitement du paiement.

Comment ça marche

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

  sequenceDiagram
    participant User
    participant App as Application
    participant Shop as Web Shop
    participant Backend as Xsolla Backend
    participant AF as AppsFlyer
    User->>App: 1. Logs in
    App->>AF: 2. Sends CUID
    AF-->>Backend: 3. Sends postback (Application ID, AppsFlyer ID, CUID)
    User->>Shop: 4. Logs in with CUID
    User->>Shop: 5. Makes purchase
    Shop->>Backend: 6. Sends purchase event
    Backend->>AF: 7. Sends xsolla-billing-payment event

L’utilisateur (joueur) s’inscrit ou se connecte à l’application mobile Android/iOS.
Votre application envoie un événement in-app standard à AppsFlyer : af_login, af_signup ou tout événement contenant le CUID.
AppsFlyer envoie un postback à Xsolla, contenant les informations suivantes : ID d’application, ID AppsFlyer et CUID.
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 backend Xsolla, qui vérifie les informations avec celles fournies par AppsFlyer.
Le backend Xsolla envoie un événement S2S in-app à AppsFlyer contenant l’ID et le CUID AppsFlyer.

AppsFlyer attribue ce nouvel événement, cet 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 à Integrations.

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

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

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

Ouvrez le projet dans votre compte et accédez à Operations > MMP.

Cliquez sur le volet AppsFlyer.

Dans le volet Mobile app S2S integration, cliquez sur Configure.

Dans la fenêtre qui s'affiche, entrez les données suivantes :
1. Jeton S2S AppsFlyer.
2. ID d'application pour les plateformes de publication Android/iOS au format suivant :
  - iOS — idXXXXXXXXX ;
  - Android — com.example.yourapp.
  Pour ajouter une plateforme, cliquez sur Add application ID.
Cliquez sur Save.

Après l’enregistrement, la bascule dans le volet AppsFlyer sera activée.

Pour apporter des modifications à l’intégration connectée :

Cliquez sur le volet AppsFlyer.
Dans la fenêtre qui s’affiche, effectuez les modifications nécessaires.
Cliquez sur Save.

Comment configurer dans AppsFlyer

Dans AppsFlyer, vous devez :

Obtenir un jeton S2S.
Activer l’intégration avec Xsolla.

Obtention du jeton S2S

Vous devez posséder un rôle d’administrateur sur le compte AppsFlyer pour voir et gérer les jetons S2S.
Veillez à générer et à partager la clé S2S (jeton S2S) et non la clé (jeton) API V2, qui est destinée à d’autres API et ne concerne pas cette intégration.

Pour récupérer le jeton S2S :

Connectez-vous à votre compte AppsFlyer HQ.
Accédez à la section Account > Security Center > AppsFlyer API and S2S tokens.
Dans la ligne contenant le jeton S2S, cliquez sur l’icône de copie dans la colonne Token.

Si vous ne disposez pas encore de jeton S2S, créez-en un.

Activation de l’intégration avec Xsolla

Dans votre compte AppsFlyer HQ, sélectionnez l'application Android/iOS requise et accédez à la section Collaborate > Partner marketplace.

Recherchez Xsolla et sélectionnez-le.

Cliquez sur Set up integration.

Dans l'onglet d'intégration :
1. Cochez Activate Partner ;
2. Pour les applications iOS uniquement : réglez la bascule Advanced Privacy en fonction de votre politique de confidentialité :
  - Activée — tous les événements sont envoyés à Xsolla,
  - Désactivée — seuls les événements consentis par ATT sont envoyés à Xsolla ;

L'IDFA n'est pas envoyé à Xsolla dans les deux cas, seuls l'ID Appsflyer et le CUID sont partagés.

1. Laissez la valeur Default postbacks — off (par défaut) ;
2. Activez la bascule In-app event postbacks ;
3. Configurez au moins un événement in-app qui inclut des informations de connexion (CUID) ;
4. Entrez n'importe quelle valeur dans le champ mapped to partner event. Xsolla prend en charge n'importe quel nom d'événement ;
5. Enregistrez l'intégration.

Pour une intégration réussie, envoyez au moins l’un des événements suivants : af_login, af_signup ou tout autre événement in-app contenant un CUID.
Le CUID dans AppsFlyer doit correspondre exactement au CUID utilisé dans le Web Shop. AppsFlyer et Xsolla utilisent le CUID pour synchroniser les données. Si les CUID ne correspondent pas, l’intégration échouera.
Exemple d’incompatibilité de valeur : Le CUID dans AppsFlyer est l’adresse e-mail hachée de l’utilisateur et dans Xsolla son adresse e-mail au format texte.
La configuration d’autres onglets n’est pas nécessaire : Attribution Link, Cost, Ad revenue ou Permissions.

Pour en savoir plus sur les paramètres d’intégration côté AppsFlyer, consultez la documentation.

Structure des valeurs d’événement

Pour organiser un événement spécifique ou demander des capacités d’intégration spéciales, contactez votre responsable de la réussite client ou envoyez un e-mail à [email protected].

Achat de bien

Lorsqu’un utilisateur effectue un achat dans le Web Shop, Xsolla envoie l’événement xsolla-billing-payment à AppsFlyer.

Paramètres principaux

Paramètre	Description
af_content_id	UGS unique ou tableau d’UGS dans l’achat.
af_quantity	Quantité de l’article avec l’UGS correspondante (un ou tout un tableau).
af_revenue	Montant de l’achat incluant les réductions, avant déduction des commissions et des taxes.
af_currency	Devise dans laquelle le prix de l’objet est affiché dans le Web Shop (devise d’achat).
af_net_revenue	Montant de l’achat reçu par le commerçant (jeu) après déduction des commissions et des taxes. Exprimé dans la devise de l’achat (`af_currency`).
af_receipt_id	Dix premiers chiffres de l’ID de la facture.

Paramètres supplémentaires

Ces paramètres n’apparaissent ni dans les rapports agrégés ni dans les tableaux de bord. Ils sont disponibles uniquement lors de l’exportation des données brutes :

Paramètre	Description
af_purchase_currency	Devise dans laquelle l’utilisateur a effectivement payé son achat, après conversion ou sélection d’un mode de paiement (devise de paiement).
af_payment_amount	Montant réellement payé par l’utilisateur dans la devise de paiement.
payout_amount	Montant de l’achat reçu par le commerçant (jeu) après déduction des commissions et des taxes. Exprimé dans la devise du paiement (`payout_currency`). Correspond à `af_net_revenue`, mais sans conversion en `af_currency`.
payout_currency	Devise du paiement. Correspond à `af_purchase_currency`.
af_store	Source des données. Ayant toujours pour valeur `xsolla`, elle sert à l’identification interne des événements dans AppsFlyer.
af_dry_run	Indicateur de paiement de test. Valeurs possibles : `1` — paiements effectués en mode bac à sable. `0` — paiements réels.
date_payment	Date du paiement au format ISO 8601.

Exemple d’événement avec une seule UGS :

Copy

Full screen

Small screen

 1{
 2    "af_content_id" : "test-coin",
 3    "af_quantity" : "2",
 4    "af_revenue" : "40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "af_net_revenue" : "32.27",
 9    "payout_amount" : "404577.4",
10    "payout_currency" : "UZS",
11    "af_receipt_id" : "5555555550",
12    "af_store" : "xsolla",
13    "af_dry_run" : "0",
14    "date_payment" : "2026-08-27T01:50:58Z"
15}

Exemple d’événement avec plusieurs UGS :

Copy

Full screen

Small screen

 1{
 2    "af_content_id" : [ "test-coin", "test-coin3" ],
 3    "af_quantity" : [ "2", "3" ],
 4    "af_revenue" : "40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "af_net_revenue" : "32.27",
 9    "payout_amount" : "404577.4",
10    "payout_currency" : "UZS",
11    "af_receipt_id" : "5555555550",
12    "af_store" : "xsolla",
13    "af_dry_run" : "0",
14    "date_payment" : "2026-08-27T01:50:58Z"
15}

Remboursement

Lorsqu’un utilisateur demande le remboursement d’un paiement, Xsolla envoie l’événement xsolla-billing-refund à AppsFlyer.

Paramètres principaux

Paramètre	Description
af_content_id	UGS unique ou tableau d’UGS dans l’achat remboursé.
af_quantity	Quantité de l’article avec l’UGS correspondante (un ou tout un tableau).
af_revenue	Montant de l’achat remboursé. Un montant négatif est passé.
af_currency	Devise dans laquelle le prix de l’objet est affiché dans le Web Shop (devise d’achat).
af_net_revenue	Montant de l’achat reçu par le commerçant (jeu) après déduction des commissions et des taxes. Exprimé dans la devise de l’achat (`af_currency`).
af_receipt_id	Dix premiers chiffres de l’ID de la facture.

Paramètres supplémentaires

Ces paramètres n’apparaissent ni dans les rapports agrégés ni dans les tableaux de bord. Ils sont disponibles uniquement lors de l’exportation des données brutes :

Paramètre	Description
af_purchase_currency	Devise dans laquelle l’utilisateur a effectivement payé son achat, après conversion ou sélection d’un mode de paiement (devise de paiement).
af_payment_amount	Montant réellement payé par l’utilisateur dans la devise de paiement.
payout_amount	Montant de l’achat reçu par le commerçant (jeu) après déduction des commissions et des taxes. Exprimé dans la devise du paiement (`payout_currency`). Correspond à `af_net_revenue`, mais sans conversion en `af_currency`.
payout_currency	Devise du paiement. Correspond à `af_purchase_currency`.
af_store	Source des données. Ayant toujours pour valeur `xsolla`, elle sert à l’identification interne des événements dans AppsFlyer.
af_dry_run	Indicateur de paiement de test. Toujours défini sur `0`. Pour éviter que les données relatives aux paiements effectués en mode bac à sable n’apparaissent dans les rapports, utilisez un bundle distinct dans AppsFlyer pour les tests.
date_payment	Date du paiement au format ISO 8601.

Exemple d’événement avec plusieurs UGS :

Copy

Full screen

Small screen

 1{
 2    "af_content_id" : [ "test-coin", "test-coin3" ],
 3    "af_quantity" : [ "2", "3" ],
 4    "af_revenue" : "-40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "af_net_revenue" : "-32.27",
 9    "payout_amount" : "404577.4",
10    "payout_currency" : "UZS",
11    "af_receipt_id" : "5555555550",
12    "af_store" : "xsolla",
13    "af_dry_run" : "0",
14    "date_payment" : "2026-08-27T01:50:58Z"
15}

Création de factures

Lorsqu’une facture pour l’achat d’un objet est créée dans le système Xsolla pour le Web Shop, Xsolla envoie l’événement xsolla-billing-created à AppsFlyer.

Paramètres principaux

Paramètre	Description
af_content_id	UGS unique ou tableau d’UGS dans l’achat.
af_quantity	Quantité de l’article avec l’UGS correspondante (un ou tout un tableau).
af_currency	Devise dans laquelle le prix de l’objet est affiché dans le Web Shop (devise d’achat).
af_receipt_id	Dix premiers chiffres de l’ID de la facture.

Paramètres supplémentaires

Ces paramètres n’apparaissent ni dans les rapports agrégés ni dans les tableaux de bord. Ils sont disponibles uniquement lors de l’exportation des données brutes :

Paramètre	Description
af_item_value	Coût de l’objet acheté, remises incluses. Utilisé pour l’analyse au niveau de l’objet, il n’est pas pris en compte dans le calcul des revenus, contrairement à `af_revenue` utilisé pour les événements achat et remboursement.
af_purchase_currency	Devise dans laquelle l’utilisateur a effectivement payé son achat, après conversion ou sélection d’un mode de paiement (devise de paiement).
af_payment_amount	Montant réellement payé par l’utilisateur dans la devise de paiement.
payout_amount	Montant de l’achat reçu par le commerçant (jeu) après déduction des commissions et des taxes. Exprimé dans la devise du paiement (`payout_currency`).
payout_currency	Devise du paiement. Correspond à `af_purchase_currency`.
af_store	Source des données. Ayant toujours pour valeur `xsolla`, elle sert à l’identification interne des événements dans AppsFlyer.
af_dry_run	Indicateur de paiement de test. Toujours défini sur `0`. Pour éviter que les données relatives aux paiements effectués en mode bac à sable n’apparaissent dans les rapports, utilisez un bundle distinct dans AppsFlyer pour les tests.
date_payment	Date du paiement au format ISO 8601.

Exemple d’événement avec plusieurs UGS :

Copy

Full screen

Small screen

 1{
 2    "af_content_id" : [ "test-coin", "test-coin3" ],
 3    "af_quantity" : [ "2", "3" ],
 4    "af_item_value" : "40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "payout_amount" : "404577.4",
 9    "payout_currency" : "UZS",
10    "af_receipt_id" : "5555555550",
11    "af_store" : "xsolla",
12    "af_dry_run" : "0",
13    "date_payment" : "2026-08-27T01:50:58Z"
14}

Erreur de paiement

En cas d’erreur de paiement lors d’un achat dans le Web Shop, Xsolla envoie l’événement xsolla-billing-error à AppsFlyer. Les paramètres de l’événement incluent les informations suivantes :

Paramètres principaux

Paramètre	Description
af_content_id	UGS unique ou tableau d’UGS dans l’achat.
af_quantity	Quantité de l’article avec l’UGS correspondante (un ou tout un tableau).
af_currency	Devise dans laquelle le prix de l’objet est affiché dans le Web Shop (devise d’achat).
af_receipt_id	Dix premiers chiffres de l’ID de la facture.

Paramètres supplémentaires

Ces paramètres n’apparaissent ni dans les rapports agrégés ni dans les tableaux de bord. Ils sont disponibles uniquement lors de l’exportation des données brutes :

Paramètre	Description
af_item_value	Coût de l’objet acheté, remises incluses. Utilisé pour l’analyse au niveau de l’objet, il n’est pas pris en compte dans le calcul des revenus, contrairement à `af_revenue` utilisé pour les événements achat et remboursement.
af_purchase_currency	Devise dans laquelle l’utilisateur a effectivement payé son achat, après conversion ou sélection d’un mode de paiement (devise de paiement).
af_payment_amount	Montant réellement payé par l’utilisateur dans la devise de paiement.
payout_amount	Montant de l’achat reçu par le commerçant (jeu) après déduction des commissions et des taxes. Exprimé dans la devise du paiement (`payout_currency`).
payout_currency	Devise du paiement. Correspond à `af_purchase_currency`.
af_store	Source des données. Ayant toujours pour valeur `xsolla`, elle sert à l’identification interne des événements dans AppsFlyer.
af_dry_run	Indicateur de paiement de test. Toujours défini sur `0`. Pour éviter que les données relatives aux paiements effectués en mode bac à sable n’apparaissent dans les rapports, utilisez un bundle distinct dans AppsFlyer pour les tests.
date_payment	Date du paiement au format ISO 8601.

Exemple d’événement avec plusieurs UGS :

Copy

Full screen

Small screen

 1{
 2    "af_content_id" : [ "test-coin", "test-coin3" ],
 3    "af_quantity" : [ "2", "3" ],
 4    "af_item_value" : "40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "payout_amount" : "404577.4",
 9    "payout_currency" : "UZS",
10    "af_receipt_id" : "5555555550",
11    "af_store" : "xsolla",
12    "af_dry_run" : "0",
13    "date_payment" : "2026-08-27T01:50:58Z"
14}

Merci pour votre commentaire !

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

Dernière mise à jour: 2 Octobre 2026

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

Contenu

Glossaire
Scénarios d’intégration
Comment ça marche
Comment configurer dans AppsFlyer
Comment configurer dans le Compte éditeur
Comment configurer dans votre compte
Comment configurer dans votre compte
Comment ça marche
Comment configurer dans le Compte éditeur
Comment configurer dans votre compte
Comment configurer dans votre compte
Comment configurer dans AppsFlyer
Obtention du jeton S2S
Activation de l’intégration avec Xsolla
Structure des valeurs d’événement
Achat de bien
Remboursement
Création de factures
Erreur de paiement