Método: GET /advertiser/listStats
Descrição: Pode obter estatísticas para campanhas publicitárias criadas na sua conta de publicidade HilltopAds.
Parâmetros:
nome | descrição | exemplo | comentário |
key | Uma chave de API exclusiva que pode ser gerada na secção API da sua conta HilltopAds | nXzgO3Bc | Este é um parâmetro obrigatório no pedido. |
Date | O dia para o qual é necessário recuperar dados estatísticos. | 2023-01-01 | Por defeito, a resposta fornecerá estatísticas para o dia de ontem. |
Date2 | Especifique este parâmetro se necessitar de estatísticas para um período específico. | 2023-01-31 | Esta data será considerada o último dia do período, e o parâmetro date será o primeiro dia. |
GEO | Especifique este parâmetro se necessitar de estatísticas para países específicos.
| REINO UNIDO | Para obter dados de vários países, liste-os separados por vírgulas.
|
zoneID | Especifique este parâmetro se necessitar de estatísticas para zonas específicas. | 4OACSGAI8 | Para obter dados de várias zonas, liste-as separadas por vírgulas. |
campaignID | Especifique este parâmetro se necessitar de estatísticas para campanhas específicas. | 123456 | Para recuperar dados de várias campanhas, liste-as separadas por vírgulas. |
adID | Especifique este parâmetro se necessitar de estatísticas para anúncios específicos. | 123456 | Para obter dados de vários anúncios, liste-os separados por vírgulas. |
group | Especifique este parâmetro para agrupar os dados. | data | Pode agrupar por: data, horas, GEO, zoneID, campaignID, adID. |
Exemplo de pedido:
Para recuperar as estatísticas da campanha 123456 para o período de 1 de fevereiro a 31 de março de 2023, agrupadas por data, deve escrever o seguinte pedido:
https://hilltopads.com/api/advertiser/listStats?key=nXzgO3Bc&date=2023-02-01&date2=2023-03-31&campaignId=123456&group=date