Passer au contenu principal
API pour les statistiques (administrateurs)
Natalya Yefimenko avatar
Écrit par Natalya Yefimenko
Mis à jour il y a plus de 8 mois

Avant de commencer

API pour les statistiques

L'API Affise vous fournit plusieurs méthodes pour obtenir des données statistiques par différents types ou tranches. Il s'agit absolument des mêmes données que celles que vous voyez dans votre panneau d'administration.

⚠️ Vous ne pouvez utiliser certaines méthodes qu'avec la clé API de l'utilisateur ayant le type de directeur général. Certaines méthodes ne sont disponibles qu'avec la clé API de l'affilié.

Liste des clics

Utilisez cette méthode pour obtenir la liste des offres en fonction de leurs propriétés, que vous pouvez indiquer dans votre demande API.

⚠️ Vous ne pouvez obtenir des données que pour les sept derniers jours.

La méthode: GET /3.0/stats/clics

La requête pour obtenir les clics pour une certaine offre :

https://api-rocketcompany.affise.com/3.0/stats/clicks?api-key=4sdf87fsdfd8723lkjhrn324&date_from=2022-12-01&date_to=2022-12-05&offer[]=1441584

Conversions

Sur Affise, vous pouvez gérer vos conversions via l'API exactement comme sur votre panneau d'administration. Consultez les statistiques, modifiez les conversions ou importez-les.

Liste des conversions

Utilisez cette méthode pour obtenir la liste des conversions pour une certaine période et avec certaines propriétés, comme un statut, un objectif, un pays, un revenu, etc.

La méthode: GET /3.0/stats/conversions

La requête pour obtenir les conversions pour le mois de novembre 2022, avec le statut Approved, et la valeur d'objectif "1" :

https://api-rocketcompany.affise.com/3.0/stats/conversions?api-key=4sdf87fsdfd8723lkjhrn324&date_from=2022-11-01&date_to=2022-11-30&status[]=1&goal[]=1

Modifier une conversion

Utilisez cette méthode pour modifier la conversion : son statut, sa devise, son paiement ou son revenu. Vous pouvez mettre à jour plus d'une conversion dans une requête.

⚠️ L'ID de conversion utilisé dans la demande est l'ID de conversion interne. Vous pouvez le trouver en cliquant sur une certaine conversion dans les statistiques, ou en faisant une demande pour la liste des conversions.

La méthode: POST /3.0/admin/conversion/edit.

La requête cURL pour changer le statut des conversions de Declined à Approved, et la devise de USD à EUR.

curl --request POST \N- --url https://api-rocketcompany.affise.com/3.0/admin/conversion/edit \N- --header 'api-key : 4sdf87fsdfd8723lkjhrn324' \N- --header 'content-type : application/x-www-form-urlencoded' \N- --cookie PHPSESSID=7u7eu0hds2parivvhl6nbicgj9 \N- --data 'ids[0]=634eb220f09cdc2d1b5cf49d' \N- --data 'ids[1]=634eb21af09cdc2d1b5cf49a' \N- --data 'ids[2]=634eb215f09cdc2d1b5cf497' \N- --data status=confirmed \N- --data currency=eur

Importer plusieurs conversions

Utilisez cette méthode pour importer plusieurs conversions dans votre panneau d'administration. Vous pouvez importer des conversions aussi bien pour des clics existants que pour des clics non existants.

La méthode: POST /3.0/admin/conversions/import.

La requête cURL pour importer deux conversions pour des clics inexistants, des offres différentes :

curl --request POST \ --url https://api-rocketcompany.affise.com/3.0/admin/conversions/import \N- --header 'api-key : 4sdf87fsdfd8723lkjhrn324' \N- --header 'content-type : application/x-www-form-urlencoded' \N- --cookie PHPSESSID=7u7eu0hds2parivvhl6nbicgj9 \N- --data 'list[0][offer]=1441586' \N- --data 'list[0][pid]=2' \N- --data 'list[0][action_id]=6666666' \N- --data 'list[0][goal]=install' \N- --data 'list[0][status]=confirmed' \N- --data 'list[1][offer]=7777777' \N- --data 'list[1][pid]=2' \N- --data 'list[1][action_id]=87654321' \N- --data 'list[1][goal]=install' \N- --data 'list[1][status]=confirmed' \N- --data 'list[1][status]=confirmed' \N- --data 'list[1][action_id]=

La requête cURL pour importer deux conversions pour deux clics existants, mêmes offres :

curl --request POST \N- --url https://api-rocketcompany.affise.com/3.0/admin/conversions/import \N- --header 'api-key : 4sdf87fsdfd8723lkjhrn324' \N- --header 'content-type : application/x-www-form-urlencoded' \N- --cookie PHPSESSID=7u7eu0hds2parivvhl6nbicgj9 \N- --data 'list[0][offer]=1441586' \N- --data 'list[0][pid]=2' \N- -data 'list[0][offer]=1441586' \N- --data 'list[0][pid]=2' \N- --data 'list[0][action_id]=11111' \N- --data 'list[0][click_id]=6388a7c9fe1fe60001a98910' \N- --data 'list[0][goal]=install' \N- --data 'list[0][status]=confirmed' \N- --data 'list[1][offer]=22222' \N- --data 'list[1][pid]=2' \N- --data 'list[1][action_id]=87654321' \N- -data 'list[1][action_id]=87654321' \N- -data 'list[0][goal]=install' \N- -data 'list[1][click_id]=6388bfb5b10ff500010c749b' \N- --data 'list[1][goal]=install' \N- --data 'list[1][status]=confirmed' \N- --data 'list[1][status]=confirmed' \N- --data 'list[1][goal]=install' \N-

Statistiques personnalisées

Utilisez cette méthode pour exploiter différents types de données dans une seule demande d'API, comme dans la tranche personnalisée des statistiques de votre panneau d'administration.

Si vous souhaitez classer les données en fonction d'un certain type, vous devez ajouter une tranche appropriée/ Par exemple : classer par affiliés, tranche par affiliés.

La méthode: GET /3.0/stats/custom

La requête permet d'obtenir des données sur le trafic des offres et des affiliés pendant dix jours. Les données sont classées par offre et par affilié.

https://api-rocketcompany.affise.com/3.0/stats/custom?api-key=4sdf87fsdfd8723lkjhrn324&filter[date_from]=2022-11-25&filter[date_to]=2022-12-04&slice[]=day&slice[]=offer&slice[]=affiliate&order[]=offer&order[]=affiliate

Veuillez contacter l'équipe d'assistance à la clientèle d'Affise pour toutes les questions soulevées par l'intermédiaire de l'e-mail : [email protected].

Avez-vous trouvé la réponse à votre question ?