En bref : AppsFlyer décode et transforme la valeur de conversion que vous avez définie en événements. Les événements sont utilisés pour remplir le tableau de bord SKAN, les données brutes et les postbacks pour les partenaires.
Décoder la valeur de conversion SKAN
Les annonceurs utilisent le décodage de la valeur de conversion comme alternative aux options disponibles dans Conversion Studio. Si vous utilisez Decode, cela signifie que vous êtes responsable de la définition de updatePostbackConversionValue en fonction de la logique de votre app.
Outre la définition de la valeur de conversion (VC) dans l'app, le reste du flux, les fonctionnalités et les options de rapport sont les mêmes que ceux décrits dans le guide de solution SKAN. Cela signifie qu'à l'expiration de la fenêtre d'activité (contrôlée par vous), iOS envoie le postback au réseau publicitaire, qui le transmet à AppsFlyer. AppsFlyer décode la VC en fonction de votre mappage dans des événements traités comme les VC décodées définies par le SDK.
Valeur de conversion personnalisée — Décoder
La mise en œuvre du décodage de VC personnalisé nécessite le téléchargement d'un fichier CSV contenant votre mappage de VC sur la plateforme AppsFlyer.
Principes de cartographie du décodage
- Fournit un mappage de décodage pour les valeurs de conversion précises (1 à 63) et les valeurs de conversion grossières (faible, moyenne et élevée) pour les fenêtres 1 à 3. Il n’est pas obligatoire de mapper toute la plage de valeurs. Par exemple, vous pouvez mapper les valeurs 1, 2, 10 et 43.
- La VC 0 est toujours mappée sur l'installation. Vous ne pouvez pas la régler.
- La table de mappage est téléchargée sur AppsFlyer dans un fichier CSV. Vous pouvez télécharger une table de mappage mise à jour selon vos besoins.
- Lors de la réception d'un postback d'iOS, la VC est décodée en événements, tel qu’illustré dans les exemples.
- L'heure d'installation est dérivée à l'aide de l'heure d'arrivée du postback.
- Les événements ont la même durée que le temps d'installation.
- Pour mieux comprendre comment préparer le schéma, examinez les scénarios de mappage qui suivent.
-
Les noms d'événements personnalisés dans l'app sont autorisés.
- Cela signifie que vous envoyez de nouveaux noms d'événements, même s'ils n'ont jamais été envoyés par le SDK.
- Vous pouvez mapper les événements in-app aux événements intégrés au réseau publicitaire.
- Ceci est également vrai pour l'intégration des annonces Meta, sous réserve des règles spécifiques à Meta détaillées dans la section suivante.
Décoder les règles du scénario de cartographie
N'oubliez pas :
- Plage de valeurs de conversion précise : 1-63
- Plage de valeurs de conversion grossière : Faible, moyen et élevé
- Une valeur de conversion donnée correspond à un ou plusieurs événements in-app que vous avez spécifiés. Les événements in-app ont des paramètres facultatifs.
- Pour les exemples : Supposons que la date d'installation soit le 1er février à 08h00.
- Le tableau suivant est un exemple de table de mappage de décodage. Sa structure est similaire à celle du fichier CSV requis. Le tableau suivant présente les événements générés à la suite du processus de décodage.
- Un événement d'installation est toujours généré, quel que soit votre mappage.
- Mesure des revenus :
- Les revenus sont en USD.
- Une valeur de conversion donnée a une plage de revenus délimitée par min_revenue et max_revenue.
- Dans les rapports et tableaux de bord agrégés, les revenus sont calculés comme la moyenne de la plage. Exemple : min_revenue=4 et max_revenue=10. Le revenu calculé est de 7.
- Les rapports de données brutes incluent les revenus calculés (skad_revenue), min_revenue et max_revenue.
Règles méta-spécifiques
Si vous intégrez des annonces Meta, respectez les règles suivantes :
- Les valeurs de revenus minimales et maximales pour une valeur de conversion donnée doivent être différentes. Signifie pas égal.
- Les valeurs ne doivent pas se chevaucher et doivent être dans un ordre consécutif comme illustré pour conversion_value 1-2 et 62 dans le tableau suivant.
- event_counter : Les méta-annonces ne prennent pas en compte cette valeur. [Bonne pratique] Renseignez-la avec une valeur de 1.
Ex. : Cartographie de décodage
| conversion_ valeur |
event_ name |
event_ valeur |
min_revenue (non inclusif) |
max_revenue (inclusif) | event_ compteur |
hours_from_ install |
|---|---|---|---|---|---|---|
| 1 | af_purchase | {abc} | 0 | 3 | 1 | 24 |
| 2 | af_purchase | {def} | 3 | 10 | 3 | 36 |
| 21 | event_a | 1 | 24 | |||
| 21 | event_b | 3 | 24 | |||
| 21 | event_c | {xyz} | 2 | 24 | ||
| 21 | event_d | 1 | 24 | |||
| 21 | event_e | 1 | 24 | |||
| 21 | event_f | 1 | 24 | |||
| 21 | event_g | 1 | 24 | |||
| 62 | af_purchase | {fgh) | 10 | 17 | 2 | 72 |
| 62 | event_a | {klm} | 3 | 72 |
Exemple A : Valeur de conversion précise 1
| event_name | skad_revenue |
min_revenue |
max_revenue |
event_value |
|---|---|---|---|---|
| install | ||||
| af_purchase | 1,5 | 0 | 3 | {abc} |
Exemple B : Valeur de conversion précise 2
| event_name | skad_revenue | min_revenue | max_revenue | event_value |
|---|---|---|---|---|
| install | ||||
| af_purchase | 6,5 | 3 | 10 | {def} |
| af_purchase | 6,5 | 3 | 10 | {def} |
| af_purchase | 6,5 | 3 | 10 | {def} |
Exemple C : Valeur de conversion précise 21
| event_name | skad_revenue | min_revenue | max_revenue | event_value |
|---|---|---|---|---|
| install | ||||
| event_a | ||||
| event_b | ||||
| event_b | ||||
| event_b | ||||
| event_c | {xyz} | |||
| event_c | {xyz} | |||
| event_d | ||||
| event_e | ||||
| event_f | ||||
| event_g |
Exemple D : Valeur de conversion précise 62
| event_name | skad_revenue | min_revenue | max_revenue | event_value |
|---|---|---|---|---|
| install | ||||
| af_purchase | 13.5 | 10 | 17 | {fgh} |
| af_purchase | 13.5 | 10 | 17 | {fgh} |
| event_a | {klm} | |||
| event_a | {klm} | |||
| event_a | {klm} |
Décoder les spécifications du fichier csv
Les valeurs de conversion sont mappées à un ou plusieurs événements in-app.
Règles de fichier
- Format : Fichier CSV
- Nombre maximal de lignes : 640 + ligne d'en-tête ; total 641.
- La ligne d'en-tête doit inclure tous les noms de colonnes exactement tels qu'ils s'affichent ici. Recommandation : utilisez le fichier d’exemple ci-joint comme modèle. Voir des exemples de fichiers CSV décodés pour SKAN 3 et SKAN 4.
- N'utilisez pas les caractères suivants comme premier caractère d'une colonne :
=,+,-, et@(édité).
Décoder les spécifications du fichier csv
| Colonne | Valeur obligatoire | Contenu | Détails |
|---|---|---|---|
| conversion_value |
Oui, pour :
|
Valeur entière 1–63 |
La même valeur de conversion précise peut être répertoriée plusieurs fois. Voir les exemples pour plus d'explications. |
| coarse_conversion_value |
Uniquement valable pour SKAN 4 |
Chaîne :
|
La même valeur de conversion grossière peut être répertoriée plusieurs fois. |
| event_name | Oui | Chaîne |
Évènement in-app. Il n’est pas nécessaire que l’événement existe déjà dans AppsFlyer. Attention ! Les noms des événements in-app sont sensibles à la casse. [Recommandation] : Nom de l'événement pour les revenus af_skad_revenue. |
| event_value | Non | Chaîne | Chaîne définie par le développeur contenant les données à décoder par l'annonceur dans ses systèmes. Il s'agit généralement d'un format JSON. |
| min_revenue |
Non
|
Entier ou flottant |
Utilisez min_revenue et max_revenue pour définir une plage de revenus en USD.
Attention ! Si vous générez le fichier à l'aide d'Excel, avant de l'enregistrer, modifiez le format de colonne en virgule et non en devise pour éviter qu'Excel n'intègre un symbole $ dans le fichier CSV. |
| max_revenue | Non |
Si vous renseignez min_revenue : max_revenue doit avoir une valeur supérieure à 0. Voir min_revenue pour l'explication. |
|
| Non |
Obsolète depuis le 7 juillet 2021. Utilisez min_revenue et max_revenue
|
||
| event_counter | Oui |
Integer
|
Ex. : si l'utilisateur a effectué un événement donné 5 fois, alors 5 événements sont générés. Attention : Si vous envoyez des revenus, le montant total en USD indiqué est multiplié par la valeur dans event_counter. Cela signifie que si min_revenue = 0, max_revenue = 3 et event_counter = 4, le revenu total déclaré est de 1,5 X 4 = 6. Voir les exemples. |
| hours_from_install | Oui | Integer |
AppsFlyer l'utilise pour dériver et définir la date d'installation comme suit :
|
| postback_sequence_index |
Oui, mais uniquement pertinent pour SKAN 4 |
Integer :
|
Pour une valeur précise, seule la valeur 0 peut être reçue. |
Télécharger le fichier de schéma de valeur de conversion
Avant de commencer :
- Préparez le fichier CSV du schéma de valeur de conversion.
- Si vous intégrez des annonces Meta et mesurez les revenus, vérifiez que votre schéma est conforme aux règles relatives à Meta. Si vous ne le faites pas, les annonces Meta ne peuvent pas interpréter le schéma.
Pour activer la mesure SKAN à l’aide de la mesure de décodage :
- Dans AppsFlyer, rendez-vous dans Paramètres > Studio de Conversion SKAN.
- Cliquez sur Options (⋮), sélectionnez Télécharger le fichier de mappage de décodage.
- Si vous n'avez pas encore effectué la mise à niveau vers SKAN 4, choisissez de télécharger un fichier pour SKAN 4 ou pré-SKAN 4. Une fois que vous avez effectué la mise à niveau vers SKAN 4, le choix d'autres versions n'est plus disponible.
- Effectuez l'une des opérations suivantes :
- Cliquez pour glisser-déposer le fichier.
- Téléchargez le fichier de mappage mis à jour.
- Suivez les instructions de l'interface utilisateur pour télécharger le fichier.
- Activer la mesure SKAN.
- Cliquez sur Enregistrer les modifications.
Remarque : Pour les 48 à 72 prochaines heures, les données du tableau de bord sont ambiguës. En raison de problèmes de minuterie iOS, nous ne pouvons pas être sûrs que le mappage de décodage correspond au mappage d'encodage que vous utilisez. - Assurez-vous d'avoir mappé vos événements intégrés à ceux utilisés par les partenaires afin qu'ils puissent consommer correctement les postbacks.
Dépannage du fichier d'erreurs de téléchargement CSV
Télécharger les messages d'erreur
Une ou plusieurs valeurs dans le fichier ne correspondent pas au format requis : Le format du fichier a été modifié à compter du 7 juin 2021. Vérifiez que le format de votre fichier correspond à l’exemple de cet article.
Utilisation d'Excel pour formater la colonne event_revenue_usd
Lorsque vous utilisez des feuilles Excel/Google pour créer un fichier CSV, la colonne event_revenue_usd doit être formatée correctement avant d'enregistrer le fichier en tant que fichier CSV.
Après avoir enregistré le fichier CSV, vérifiez que le contenu est correctement formaté. Remarque : N'utilisez pas Excel pour effectuer la vérification ; utilisez plutôt un éditeur.
Formatage des cellules event_revenue_usd dans Excel
Excel formate généralement les cellules de valeur avec une virgule pour séparer les milliers, comme indiqué dans la figure. Ce format ne convient pas au téléchargement de fichiers CSV. Vous devez également supprimer le symbole $.
Vous pouvez corriger cela en formatant les cellules dans Excel.
Pour formater les montants dépensés sans virgule 1000 ni symbole $ :
- Sélectionnez les cellules à formater.
- Faites un clic droit, sélectionnez Formater les cellules.
La fenêtre de formatage des cellules s'ouvre. - Sélectionnez Number.
- DésélectionnezUse 1000 separator (,).
- (Facultatif) Définissez le nombre de décimales. La valeur par défaut est 2. Le maximum autorisé est 5.
- Cliquez surOK.
Les cellules sont correctement formatées.
Inspection visuelle du fichier CSV sans Excel
Pour examiner le contenu du fichier CSV, utilisez un éditeur.
- Windows : Bloc-notes, Notepad++
- MacOS : TextEdit
Ce qui suit contient une capture d’écran de l’exemple de fichier CSV affiché dans un éditeur.
Vue de l'éditeur
Examinez le fichier CSV dans un éditeur. Portez une attention particulière aux points suivants :
- Espaces vides : Assurez-vous qu'il n'y a pas d'espaces vides au début ou à la fin, avant ou après les virgules qui séparent les champs. Dans Excel, utilisez la commande @trim pour supprimer les espaces vides.
-
event_revenue_usd : Assurez-vous qu'il n'y a ni virgule ni symbole $ dans la colonne event_revenue_usd.
Les fichiers CSV générés par Excel n'ont pas de virgules comme délimiteurs
Si Excel crée un fichier CSV avec un point-virgule « ; » ou d'autres caractères comme délimiteur mais pas de virgule :
- Cela se produit lorsque les paramètres régionaux de votre ordinateur sont définis sur une langue/région autre que l'anglais.
- Ce problème est particulièrement répandu lorsque l’allemand est sélectionné dans les paramètres régionaux.
- La solution diffère selon le système d'exploitation de votre ordinateur (macOS ou Windows).
- Pour résoudre ce problème, recherchez les derniers conseils de Microsoft ou d’autres forums. Utilisez les termes de recherche suivants : Système d'exploitation (macOS ou Windows) Excel modifie le délimiteur pour les fichiers CSV.