Impression And Click Device report

Note: Before accessing the Api, Please understand the API signature rules first (refer to the Authentication), which is the source of some http request headers in the Api request sample. Here are authentication demos for different development languages:  Authentication Demo

Note:

• Data generation is supported starting from the time TopOn allows the operation permissions (for example, if the permissions are opened on the 1st, the earliest data can be pulled on the 2nd. For specific times, please refer to the update time of the data in each time zone for the advance tasks below), and only the data for the most recent 30 days is retained. The returned content is provided in the form of a file. If the data is not obtained at that time, please try again the next day. Tips: TopOn will execute the task of generating data for each time zone twice a day, once as an advance task and once as a backup task. The revenue data of the advance task may not be complete (the determining factor is that different advertising platforms have different report data release times, and some advertising platforms may not have released report data at the time of the advance task). Developers can pull the data after the backup task again as needed.
• the data update time of each time zone for the first task:

1. UTC + 8: delayed 1 day, update at 11:30 pm (UTC + 8)
2. UTC + 0: delayed by 1 day, updated at 5:30 pm (UTC + 8)
3. UTC - 8: delayed by 2 days, updated at 1:30 am (UTC + 8)

• the data update time of each time zone for the second task:

1. UTC + 8: delayed 2 days, update at 4 am (UTC + 8)
2. UTC + 0: delayed by 2 days, updated at 12 am (UTC + 8)
3. UTC - 8: delayed by 3 days, updated at 4 am (UTC + 8)

1 Request URL

https://api.toponad.net/v3/devicereport

2 Request method

GET

3 Request param

request sample：

curl --location --request GET 'https://api.toponad.net/v3/devicereport?app_id=a606c22b789bc3&day=20210823&timezone=8' \
--header 'X-Up-Key: fadcf18aa7805522b1cbbf847f20a9fd871aa902' \
--header 'X-Up-Signature: E3BDAB211713C0CFEDDB249121524123' \
--header 'X-Up-Timestamp: 1623744546000'

4 Response data

API will return the download url, you can get data from the url.
https://topon-openapi.s3.amazonaws.com/topon_report_device/dt%3D2019-07-10/publisher_id%3D22/app_id%3Da5d147334b3685/000000_0?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIA35FGARBHLHHS7TWB%2F20190828%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20190828T095315Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&X-Amz-Signature=6aaf947f9b2cf02f3acb49d64a3daf719cb0b57a3d5221b0121a006e58b04b10

The data file is CSV, split by ',' ,Fields detail: