API InCost pour les réseaux publicitaires

En bref : l’API InCost, partie intégrante de ROI360 AppsFlyer, permet aux réseaux publicitaires d'envoyer à AppsFlyer de manière programmée des données de coûts publicitaires. Cela permet aux annonceurs de connaître les données de coûts globales et de comprendre l'importance effective de votre réseau.

À propos de l’API InCost

L'API InCost est la meilleure solution pour permettre aux réseaux publicitaires d’envoyer des données de coûts à AppsFlyer. Les partenaires du réseau publicitaire envoient des données de coûts publicitaires détaillées à AppsFlyer via l'API. AppsFlyer ingère et traite les données et les met à la disposition des annonceurs et des partenaires dans des tableaux de bord et rapports.

Les points forts

  • Aidez vos clients à connaître l'impact effectif de votre réseau avec à de simples rapports de coûts. Sans les données de coûts, un élément crucial des mesures manque à vos clients, ils ne peuvent donc pas mesurer avec précision le ROAS. Ils risquent donc d'investir par erreur dans d'autres sources média, ce qui aura un effet négatif sur vos résultats.
  • Donnez des preuves de votre ROI avec une solution qui garantit une mesure des coûts précise, complète et en temps réel.
  • API inCost est rapide et simple à déployer, et ses résultats sont quasi immédiats. Vous disposez également d'un contrôle total sur comment et quand vous envoyez les données, avec la possibilité d'envoyer les données de coûts datant de 90 jours.
  • L'API InCost prend en charge tous les modèles de tarification des campagnes, et pas seulement le CPI (qui est le seul modèle disponible lors de l'envoi du coût par clic).
  • Démarquez-vous dans le marketplace des partenaires AppsFlyer avec un badge "Coût" qui indique que vous proposez cette fonctionnalité.

Mise en œuvre de l'API InCost

Conditions à remplir : pour que l'API InCost soit éligible, votre réseau publicitaire doit remplir ces conditions :

  • 90 % des campagnes contiennent l'ID de campagne dans l'attribution.
  • Possibilité d'envoyer des données au moins 6 fois par jour pour une meilleure actualisation des données. La fréquence est définie par le réseau publicitaire.
  • Si le réseau publicitaire met à jour les données rétroactivement : possibilité d'envoyer les données des 7 derniers jours à chaque fois, afin de permettre l’intégrité des données.

Mettre en œuvre l'API InCost et envoyer les données de coûts à AppsFlyer

  • Suivez les étapes indiquées dans le tableau.
Étape n° Action 
1

Postuler à InCost :

  1. Dans AppsFlyer, dans le menu du haut, sélectionnez Assistance > Contacter notre équipe.
    Le widget de l'assistant des partenaires s'ouvre.
  2. Sélectionnez Activer la mesure des coûts et soumettez vos informations.
    Une fois soumis, un ticket s'ouvre pour qu’un agent AppsFlyer dédié aux partenaires vous contacte.
2 Assurez-vous que les hiérarchies de campagne (ID de campagne et, éventuellement, l’ID d'adset et l’ID publicitaire) sont incluses dans vos liens d'attribution pour plus de 90 % de votre trafic.
3

Obtenez le jeton d’API AppsFlyer dans le tableau de bord AppsFlyer.

4

Transmettez le jeton d’API à votre développeur pour qu'il l'utilise dans l'en-tête d'autorisation API, et demandez-lui de suivre ses instructions pour mettre en œuvre les trois méthodes d’API :

  1. Obtenir la liste des apps.
  2. Importer InCost indiquez au développeur quels champs doivent être utilisés pour renseigner le JSON :
    • Les champs obligatoires doivent être remplis. En d'autres termes : n'envoyez pas de champs vides. 
    • La source média est limitée aux sources média associées à (enregistrées dans) votre compte de réseau publicitaire. La liste peut être obtenue auprès de votre responsable du développement des partenaires.
    • Tenez compte du fuseau horaire de l'app (tel qu'il est indiqué via l'API Get app permission list) pour que les dates des données de coûts s’alignent sur celles de l'application.
    • Si certains champs ne font pas partie de la hiérarchie du reporting des coûts de votre campagne, ne les ajoutez pas. Par exemple, l'ID d'adset, le nom d'actif, l'ID publicitaires, le nom de la publicité.
  3. Obtenir le statut de l'opération.
6

Dans le fil du ticket (cf l'étape 1), informez AppsFlyer que l'implémentation de l'API est terminée, puis attendez la confirmation que votre intégration est opérationnelle.

7

Vérifiez que vos annonceurs ont activé les données de coûts dans l'onglet coût de leur page partenaire intégrée à AppsFlyer. Ils commenceront alors à recevoir des données de coûts.

Champs pour InCost Upload JSON

Champ

Obligatoire

Remarques

date

Oui

  • Date de la dépense
  • Format : YYYY-MM-DD
  • Exemple : 2019-12-30
app_id

Oui

  • L'ID de l'application tel qu'il apparaît dans la plateforme AppsFlyer
  • Format : chaîne de 250 caractères maxi
  • Exemple : Android :com.app.nameiOS : id123456789

media_source

Oui

  • Nom du réseau (ID), affichant la publicité associée à votre compte de partenaire de réseau publicitaire dans AppsFlyer
  • Format : chaîne de 50 caractères
  • Exemple : network_int

af_prt

Non*

  • Obligatoire pour les données d'attribution et de coûts des agences.
  • Nom de l'agence tel qu'il apparaît dans le lien d'attribution, et tel qu’il est associé au compte de l'agence dans AppsFlyer.
  • Format : chaîne de 50 caractères
  • Exemple : agencya

campaign_id

Oui

  • Doit être identique au paramètre af_c_id envoyé dans le lien d'attribution.
  • Chaîne vide non autorisée
  • Format : chaîne de 24 caractères
  • Exemple : 123abc

campaign_name

Oui

  • Format : chaîne de 100 caractères
  • Exemple : my_campaign123

adset_id

Non*
  • Obligatoire si vous envoyez adset_name
  • Doit être identique au paramètre af_adset_id envoyé dans le lien d'attribution.
  • Si votre système de déclaration des coûts ne prend pas en charge adset_id, vous ne devez jamais l'envoyer.
  • Format : chaîne de 24 caractères
  • Exemple : 123A

adset_name

Non

  • Si vous envoyez ce champ, vous devez également envoyer adset_id
  • Format : chaîne de 100 caractères
  • Exemple : my_adset_name

ad_id

Non*

  • Obligatoire si vous envoyez ad_name.
  • Ce champ doit être identique au paramètre af_ad_id envoyé dans le lien d'attribution
  • Si votre système de déclaration des coûts ne prend pas en charge adset_id, vous ne devez jamais l'envoyer.
  • Format : chaîne de 24 caractères
  • Exemple : 123AB

site_id

Non

  • L'ID unique qui définit l'éditeur qui affiche la publicité.
  • Format : chaîne de 24 caractères.

ad_name

Non

  • Si vous envoyez ce champ, vous devez également envoyer ad_id
  • Format : chaîne de 100 caractères
  • Exemple : Ad-name

geo

Non

  • Le pays que vous avez enregistré comme étant associé au coût
  • Dans la mesure du possible, il s'agit du pays où la publicité a été diffusée.
  • Format : code pays à 2 caractères ISO 3166
  • Exemple : US, CN, ZA
currency

Oui

  • Type de devise dépensé
  • Format : Code devise à 3 caractères ISO 4217
  • Exemple : USD, EUR, ZAR
spend Oui
  • Montant des dépenses dans la devise indiquée 
  • Jusqu'à 5 chiffres après la virgule
  • La valeur 0 (zéro) est autorisée
  • Les valeurs négatives (-) ne sont PAS autorisées
  • N’envoyez pas les séparateurs (virgule)
  • N'envoyez pas les valeurs entre guillemets. 
  • Format : nombre décimal
  • Exemple de valeurs : 1 1.2 1234.20 
channel Non
  • Doit être identique au paramètre af_channel envoyé dans le lien d'attribution
  • Format : chaîne de 20 caractères
  • Exemple : my_channel
keywords Non
  • Format : chaîne de 100 caractères
  • Exemple : abc app

* Voir la colonne Remarques, car dans certains cas précis ce champ doit être envoyé.