Passer au contenu principal
Outils API
Daria Mamchenkova avatar
Écrit par Daria Mamchenkova
Mis à jour il y a plus d’une semaine

Les outils API vous permettent d'obtenir des données brutes dans vos systèmes d'analyse, ce qui vous aide à mieux analyser les utilisateurs et à améliorer leur parcours client (CJM). Cette option permet de tester de nouvelles fonctionnalités, d'analyser les performances des produits et de faire des prévisions sur la situation financière de l'application.

Clés API

Pour trouver la liste des clés API, allez dans Attribution > Outils API. Sur cette page, vous pouvez voir ce qui suit :

  • La liste des clés API, que vous pouvez ajouter, supprimer et régénérer :
    ​

🔎 Vous pouvez ajouter jusqu'à 3 clés API.

Vous pouvez utiliser n'importe laquelle de ces clés API pour obtenir des données sur les installations, les événements et les conversions. Chacune de ces demandes a ses propres conditions.

Obtenir des installations

URL : https://restapi.affattr.com/v1/report/raw/installs

En-têtes : API-KEY

Params:

  • pagination.limit (uint) - limite.

  • pagination.offset (uint) - offset.

  • time_window.from_rfc3339 (string) - exemple:2022-01-01T12:00:27.87+00:20.

  • time_window.from.seconds (uint) - horodatage - priorité plus élevée que from_rfc3339.

  • time_window.from_not_include bool - si coché "time > from" sinon "time >= from".

  • time_window.to_rfc3339 (string) - exemple:2022-01-01T12:00:27.87+00:20.

  • time_window.to.seconds (uint) - horodatage - priorité plus élevée que to_rfc3339.

  • non_organic_only (booléen).

Tous les champs sont facultatifs. Ordre par created_at asc toujours. Les nouveaux événements dont la date de création est inférieure ne peuvent pas être ajoutés.
​
Exemple de réponse API :
​

 { "info" : [ { "device" : { "affise_device_id" : "310d8335-80b1-4849-8925-ef54126004af", "random_user_id" : "b2080f39-f9e1-4f7e-bc42-8863dfe028d5", "first_open_time" : { "seconds" : 1696156153 }, "app_id" : 1, "affise_pkg_app_name" : "com.itbxp.surf", "partner_id" : 10, "device_parameters" : { "platform" : "android", "device_name" : "5058", "device_type" : "smartphone", "os_name" : "Nougat", "os_version" : "7.0", "android_id" : "421a9e99321086d6", "gaid_adid" : "d8313cad-070f-4c0e-824f-bb58d7be5acf", "referrer" : "referrer=4107abce-890d-4098-b83b-01d9bdc195d4&clickid=651949b9660c680001ef66c8&pid=10" }, "click_affise" : { "click_id" : "4317abce-990d-4098-b83b-01d9bdc195d4", "created_at" : { "seconds" : 1696156090 }, "subs" : {}, "geo" : { "country" : "ID", "region" : "Jawa Timur", "city" : "Tamansari", "isp" : " ?"                   }, "ip" : "2001:448a:5139:1985:5d62:4fe6:118d:9c12", "user_agent" : "Mozilla/5.0 (Linux ; Android 7.0 ; 5058 Build/NRD90M ; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/117.0.0.0 Mobile Safari/537.36 agentweb/4.0.2 UCBrowser/11.6.4.950", "pub_click_id" : "652949b9660c680001ef66c8" }           }, "uuid" : "924ee319-6e6d-44f3-9449-08d4b4dd1300", "timestamp" : { "seconds" : 1696156248 }, "geo" : { "country" : "ID", "region" : "ID", "isp" : "IND TELKOMSEL"           }, "ip" : "2001:448a:2130:1985:5d62:4fe6:118d:9c12", "created_at" : { "seconds" : 1696156279 }       }

Obtenir des événements

URL : https://restapi.affattr.com/v1/report/raw/events

En-têtes : API-KEY

Params:

  • pagination.limit (uint) - limite.

  • pagination.offset (uint) - offset.

  • time_window.from_rfc3339 (string) - exemple:2022-01-01T12:00:27.87+00:20.

  • time_window.from.seconds (uint) - horodatage - priorité plus élevée que from_rfc3339.

  • time_window.from_not_include bool - si coché "time > from" sinon "time >= from".

  • time_window.to_rfc3339 (string) - exemple:2022-01-01T12:00:27.87+00:20.

  • time_window.to.seconds (uint) - horodatage - priorité plus élevée que to_rfc3339.

  • non_organic_only (booléen).

Tous les champs sont facultatifs. Ordre par created_at asc toujours. Les nouveaux événements dont la date de création est inférieure ne peuvent pas être ajoutés.
​
Exemple de réponse API :
​
​

{ "events" : [ { "info" : { "device" : { "affise_device_id" : "8f29848f-ecfa-49f2-93a7-d2d484a13515", "random_user_id" : "071dcb20-1826-47ff-a310-e84ab4a673a1", "first_open_time" : { "seconds" : 1696122018 }, "app_id" : 1, "affise_pkg_app_name" : "com.itbxp.surf", "is_organic" : true, "device_parameters" : { "platform" : "android", "device_name" : "i55C", "device_type" : "smartphone", "os_name" : "Nougat", "os_version" : "7.0", "android_id" : "e627c254f84cd9a9", "gaid_adid" : "0ed20689-2435-4816-ab58-e2bc03639ecb", "referrer" : "referrer=8ba10af2-4cc9-4cda-806f-47181d47fcef&clickid=65176bfb55c3260001bad183&pid=10" }.               }, "uuid" : "0f8e8e41-3b1e-4981-b36d-f919dc15f7ca", "timestamp" : { "seconds" : 1696122034 }, "geo" : { "country" : "ID", "region" : "ID", "isp" : "Indosat Ooredoo" }, "ip" : "2001:448a:3041:2d33:b900:e218:be45:ae55", "created_at" : { "seconds" : 1696122079 }           }, "created_at" : { "seconds" : 1696122079 }, "id" : "afbcac17-4a0a-4df8-9acd-d0b7706185b9", "name" : "ContentItemsView", "category" : "native", "timestamp" : { "seconds" : 1696122019 }, "user_data" : "raccourcis", "data" : "{\"affise_event_content_items_view" :[{\"title":\N "News",\N "url":\N "https://track.g2afse.com/click ?pid=127\&offer_id=32107\"},{\"title\":\"Kids\",\"url\":\"https://track.g2afse.com/click?pid=127\&offer_id=32102\"},{\"title\":\"Goods\",\"url\":\"https://track.g2afse.com/click?pid=127\&offer_id=32100\"},{\"title\":\"Utilities\",\"url\":\"https://track.g2afse.com/click?pid=127\&offer_id=32110\"},{\"title\":\"Fun\",\"url\":\"https://appspress.g2afse.com/click?pid=127\&offer_id=32098\"},{\"title\":\"Food\",\"url\":\"https://appspress.g2afse.com/click?pid=127\&offer_id=32097\"}]}"       }

Obtenir des conversions


​URL : https://restapi.affattr.com/v1/report/raw/conversions

En-têtes : API-KEY

Params:

  • pagination.limit (uint) - limite.

  • pagination.offset (uint) - offset.

  • time_window.from_rfc3339 (string) - exemple:2022-01-01T12:00:27.87+00:20.

  • time_window.from.seconds (uint) - horodatage - priorité plus élevée que from_rfc3339.

  • time_window.from_not_include bool - si coché "time > from" sinon "time >= from".

  • time_window.to_rfc3339 (string) - exemple:2022-01-01T12:00:27.87+00:20.

  • time_window.to.seconds (uint) - horodatage - priorité plus élevée que to_rfc3339.

  • non_organic_only (booléen).

Tous les champs sont facultatifs. Ordre par created_at asc toujours. Les nouveaux événements dont la date de création est inférieure ne peuvent pas être ajoutés.

⚠️ L'exemple inclut des valeurs supplémentaires que vous pouvez obtenir si vous les transmettez via le référent.

{ "conversions" : [ { "event" : { "info" : { "device" : { "affise_device_id" : "6f9491d3-000a-1000-0f45-58674f4c7485", "random_user_id" : "6f9000ee-018a-1000-8c19-58a34e8a8d72", "first_open_time" : { "seconds" : 1694089122, "nanos" : 256000000 }, "app_id" : 129, "affise_pkg_app_name" : "com.affise.app", "device_parameters" : { "platform" : "android", "device_name" : "sdk_gphone_x86_64", "device_type" : "smartphone", "os_name" : "Android11", "os_version" : "11", "android_id" : "b6ea55ccaee29142", "referrer" : "referrer=4c5a6cff-4a76-4518-b2b7-a9d21abbd8ca&clickid=640f91362bc1a20001646bd7&pid=85" }, "click_affise" : { "click_id" : "4c9a6cff-4a76-4518-b2b7-a9d90abbd0ca", "created_at" : { "seconds" : 1694089122 }, "subs" : { "sub1" : "s1", "sub2" : "s2", "sub3" : "s3", "sub4" : "s4", "sub5" : "s5" }, "geo" : { "country" : "UK" }, "ip" : "127.0.0.1", "user_agent" : "Mozilla/5.0 (Macintosh ; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/99.0.4844.51 Safari/537.36", "campaign_id" : "123", "campaign_name" : "cname", "network_id" : "123", "network_name" : "nname", "tracker_id" : "123", "tracker_name" : "tname", "creative_id" : "123", "pub_click_id" : "640f91362bc1a20001646bd7", "partner_name" : "pname" }         }, "uuid" : "f5a01792-018a-1000-bd27-633c0f2d5839", "timestamp" : { "seconds" : 1696338024 }, "geo" : { "country" : "US", "region" : "US" }, "ip" : "188.17.96.239", "user_agent" : "Dalvik/2.1.0 (Linux ; U ; Android 11 ; sdk_gphone_x86_64 Build/RSR1.201211.001)", "created_at" : { "seconds" : 1696338042, "nanos" : 67913469 }       }     }, "created_at" : { "seconds" : 1696338026 }, "id" : "58791a4-3a4f-41aa-9319-225a30f847e5", "conversion_type" : "install", "currency" : "USD"   } ]}{

Essayer une clé API

Pour essayer une clé API, procédez comme suit :

  1. Sélectionnez Try installs, Try events ou Try conversions.

  2. Dans la liste déroulante API-KEY, sélectionnez une certaine clé API.

  3. Dans le filtre Période, indiquez la période.

  4. Si vous souhaitez obtenir uniquement les événements non organiques, cochez la case Non organique uniquement.

  5. Cliquez sur Request.

Il se peut que vous obteniez la réponse suivante :

Erreurs de postbacks

Dans l'onglet Erreurs de postbacks, vous pouvez vérifier les logs des postbacks envoyés par votre annonceur.

Veuillez contacter l'équipe du support client Affise pour toutes les questions soulevées via l'e-mail : [email protected].
​

Articles connexes
Paramètres d'attribution probabiliste et macros
Macros de liens de cross-postback
API pour les offres (admins)
Avez-vous trouvé la réponse à votre question ?