Méthode : GET /advertiser/listStats
Description : Vous pouvez récupérer les statistiques des campagnes publicitaires créées dans votre compte HilltopAds.
Remarque : les statistiques peuvent ne pas être disponibles via l’API immédiatement après leur génération. Les données nécessitent un certain temps de préparation avant d’être accessibles via l’API et devraient normalement être disponibles dans un délai d’une heure. Si /advertiser/listStats renvoie un résultat vide pour des statistiques récentes, veuillez patienter et réessayer ultérieurement.
Paramètres :
nom | description | exemple | commentaire |
key | Une clé API unique que vous pouvez générer dans la section API de votre compte HilltopAds. | nXzgO3Bc | Il s'agit d'un paramètre obligatoire dans la demande. |
Date | Le jour pour lequel vous devez récupérer les données statistiques. | 2023-01-01 | Par défaut, la réponse fournira des statistiques pour la journée d'hier. |
Date2 | Spécifiez ce paramètre si vous avez besoin de statistiques pour une période spécifique. | 2023-01-31 | Cette date sera considérée comme le dernier jour de la période et le paramètre date sera le premier jour. |
GEO | Spécifiez ce paramètre si vous avez besoin de statistiques pour des pays spécifiques.
| ROYAUME-UNI | Pour obtenir des données pour plusieurs pays, il suffit de les énumérer en les séparant par des virgules.
|
OS | Spécifiez ce paramètre si vous avez besoin de statistiques pour des systèmes d’exploitation spécifiques. Valeurs disponibles : android, ios, windows, macos, linux | ios | Pour récupérer des données pour plusieurs systèmes d’exploitation, listez-les séparés par des virgules. |
zoneID | Spécifiez ce paramètre si vous avez besoin de statistiques pour des zones spécifiques. | 4OACSGAI8 | Pour récupérer les données de plusieurs zones, il suffit de les énumérer en les séparant par des virgules. |
sourceID | Spécifiez ce paramètre si vous avez besoin de statistiques pour des sources spécifiques. | 4OACSGAI8-SDE34 | Pour récupérer des données pour plusieurs sources, listez-les séparées par des virgules. |
campaignID | Spécifiez ce paramètre si vous avez besoin de statistiques pour des campagnes spécifiques. | 123456 | Pour récupérer les données de plusieurs campagnes, énumérez-les en les séparant par des virgules. |
adID | Spécifiez ce paramètre si vous avez besoin de statistiques pour des annonces spécifiques. | 123456 | Pour récupérer les données de plusieurs annonces, il suffit de les énumérer en les séparant par des virgules. |
group | Ce paramètre permet de regrouper les données. | date | Vous pouvez grouper par : date, hour, geo, zoneID, campaignID, adID. |
Exemple de demande :
Pour récupérer les statistiques de la campagne 123456 pour la période du 1er février au 31 mars 2023, regroupées par date, vous devez écrire la requête suivante :
https://api.hilltopads.com/advertiser/listStats?key=nXzgO3Bc&date=2023-02-01&date2=2023-03-31&campaignId=123456&group=date
Débloquez tout le potentiel de l'API du réseau publicitaire HilltopAds !