Metodo: GET /advertiser/listStats
Descrizione: È possibile recuperare le statistiche delle campagne pubblicitarie create nel proprio account pubblicitario HilltopAds.
Parametri:
nome | descrizione | esempio | commento |
key | Una chiave API unica che potete generare nella sezione API del vostro account HilltopAds. | nXzgO3Bc | È un parametro obbligatorio della richiesta. |
Date | Il giorno per il quale è necessario recuperare i dati statistici. | 2023-01-01 | Per impostazione predefinita, la risposta fornirà le statistiche relative alla giornata di ieri. |
Date2 | Specificare questo parametro se si desiderano le statistiche per un periodo specifico. | 2023-01-31 | Questa data sarà considerata l'ultimo giorno del periodo e il parametro data sarà il primo giorno. |
GEO | Specificare questo parametro se si desiderano statistiche per paesi specifici.
| REGNO UNITO | Per recuperare i dati di più Paesi, elencarli separati da virgole.
|
zonaID | Specificare questo parametro se si desiderano statistiche per zone specifiche. | 4OACSGAI8 | Per recuperare i dati di più zone, elencarle separate da virgole. |
campagnaID | Specificare questo parametro se si desiderano statistiche per campagne specifiche. | 123456 | Per recuperare i dati di più campagne, elencarle separate da virgole. |
adID | Specificare questo parametro se si desiderano statistiche per annunci specifici. | 123456 | Per recuperare i dati di più annunci, elencarli separati da virgole. |
group | Specificare questo parametro per raggruppare i dati. | data | È possibile raggruppare per: data, ora, GEO, zoneID, campaignID, adID. |
Esempio di richiesta:
Per recuperare le statistiche della campagna 123456 per il periodo dal 1 febbraio al 31 marzo 2023, raggruppate per data, si deve scrivere la seguente richiesta:
https://hilltopads.com/api/advertiser/listStats?key=nXzgO3Bc&date=2023-02-01&date2=2023-03-31&campaignId=123456&group=date