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 СUID doit être le même pour le Web Shop et pour AppsFlyer. Pour plus d’informations, consultez la documentation AppsFlyer.

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

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.

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égration suivants :

Intégration S2S pour applications mobiles : permet une mesure complète de la LTV et du ROAS pour les achats sur application et sur Web Shop.
Xsolla transmet à AppsFlyer les informations relatives aux achats réalisés sur Web Shop sous forme d’événements in-app mobiles. AppsFlyer attribue ensuite ces événements aux paiements effectués dans l’application mobile, ainsi qu’aux compagnes 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 générer du trafic vers le Web Shop.
Grâce à cette intégration, il est possible d'évaluer le nombre d'utilisateurs redirigés sur le site via une campagne de reciblage, ainsi que la conversion des canaux menant au site. Xsolla transmet à AppsFlyer les données des achats effectués sur le Web Shop sous forme d'événements Web. AppsFlyer attribue ensuite des événements à la source média, à la campagne, à l'ensemble de publicités et à l'annonce ayant incité l'utilisateur à acheter.

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.

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 définir 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 publicitaire (niveau de création) dans AppsFlyer ;
Configurez le paramètre pid en fonction de la manière dont vous souhaitez afficher chaque source de média dans AppsFlyer. Par exemple, vous pouvez utiliser pid=google ou pid=googleadwords_int, selon vos préférences pour la classification et le suivi des sources de trafic.

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 plateformeWeb (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

Ouvrez votre projet dans le Compte éditeur.
Accédez à Site Builder de l'une des manières suivantes :
- Dans le menu latéral, cliquez sur Site Builder ;
- Dans le menu latéral, cliquez sur Integrations. Dans la section qui s'ouvre :
  1. Cliquez sur le volet AppsFlyer,
  2. Dans le volet Web SDK (Site Builder), cliquez 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.

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 solutionWeb 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	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 AppsFlyer. Voici comment le système interagit lorsqu’un utilisateur effectue un achat.

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

Ouvrez votre projet dans le Compte éditeur.
Dans le menu latéral, cliquez sur Integrations.
Cliquez sur le volet AppsFlyer.

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

Dans la fenêtre qui s'affiche, entrez les données suivantes :
1. Jeton S2S AppsFlyer ;
2. ID d'application sur les plateformes de publication (Android/iOS). 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 Compte > Centre de sécurité > Jetons S2S et jetons d’API AppsFlyer.
Dans la ligne contenant le jeton S2S, cliquez sur l’icône de copie dans la colonne Jeton.

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 Collaboration > Marketplace partenaire.

Recherchez Xsolla et sélectionnez-le.

Cliquez sur Configurer l'intégration.

Dans l'onglet d'intégration :
1. Cochez Activer le partenaire ;
2. Pour les applications iOS uniquement : réglez la bascule Confidentialité avancée 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 Postbacks par défaut — off (par défaut) ;
2. Activez la bascule Postbacks d'événements in-app ;
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 mappé à l'événement du partenaire. 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 : Lien d’attribution,Coût,Revenus publicitaires ou Autorisations.

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 à csm@xsolla.com.

Achat de bien

Lorsqu’un utilisateur effectue un achat dans le Web Shop, Xsolla envoie l’événement xsolla-billing-payment à AppsFlyer. Les informations d’achat suivantes sont passées dans les paramètres de l’événement :

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. Les remises sont incluses. Les commissions et les taxes ne sont pas incluses.
af_currency	Devise d’achat.

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

Copy

Full screen

Small screen

{
    "af_content_id": "test-coin",
    "af_quantity": "11",
    "af_revenue": "99.99",
    "af_currency": "USD",
    "af_purchase_currency": "USD",
    "af_receipt_id": "1234567890"
}

Exemple d’événement avec plusieurs UGS :

Copy

Full screen

Small screen

{
    "af_content_id": ["test-coin-1", "test-coin-2"],
    "af_quantity": ["5", "60"],
    "af_revenue": "99.99",
    "af_currency": "USD",
    "af_purchase_currency": "USD",
    "af_receipt_id": "1234567890"
}

Remboursement

Lorsqu’un utilisateur initie un remboursement, Xsolla envoie l’événement xsolla-billing-refund à AppsFlyer. Les informations de remboursement suivantes sont passées dans les paramètres de l’événement :

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 de l’achat remboursé.

Exemple d’événement avec plusieurs UGS :

Copy

Full screen

Small screen

{
    "af_content_id": ["test-coin-1", "test-coin-2"],
    "af_quantity": ["5", "60"],
    "af_revenue": "-99.99",
    "af_currency": "USD",
    "af_purchase_currency": "USD",
    "af_receipt_id": "1234567890"
}

Merci pour votre commentaire !

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

Dernière mise à jour: 2 Octobre 2024

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

Your browser is not supported. Please try a different browser

Articles populaires

Ou choisissez les questions les plus fréquemment posées:

Réponse basée sur les sources suivantes:

Laissez-nous un commentaire (facultatif)

Laissez-nous un commentaire (facultatif)

Web Shop

Intégration avec AppsFlyer

Glossaire

AppsFlyer

ID d'application

ID Appsflyer

ID Web AppsFlyer

App Tracking Transparency (ATT)

ID utilisateur du client (CUID)

Identifiant publicitaire (IDFA)

Événement in-app

Événement Web

Valeur à vie (LTV)

Reciblage

Retour sur investissement publicitaire (ROAS)

Postback

Jeton serveur-serveur (S2S) ou clé S2S

Clé dev AppsFlyer

Acquisition d'utilisateurs

Scénarios d'intégration

Comment ça marche

Comment configurer dans AppsFlyer

Comment configurer dans le Compte éditeur

Comment ça marche

Comment configurer dans le Compte éditeur

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