Export clicks

The ClickExport endpoint schedules a job to asynchronously export clicks. It returns a URI to poll for job status updates and a URI where the exported clicks can be downloaded once the job has completed.

🚧

Note

If you are migrating from the Clicks endpoint to the ClicksExport endpoint, please ensure that you incorporate the field name changes found in the result object.

The return object will return the fields ProgramId and ProgramName, which were previously known as CampaignId and CampaignName.

Parameters


AdId (optional)

Id of the ad that was clicked. This parameter can be repeated for multiple ads.


Date (optional)

A click’s date. If left empty, the call will use today's date. Format should match 'yyyy-MM-dd'.


MediaId (optional)

The unique identifier (sometimes referred to as Partner Id) of the partner that drove the click. This parameter can be repeated for multiple partners.


UniqueClick (optional)

If the click follows IAB standards for a unique click. These standards can be found starting on page 9 of the IAB’s Click Measurement Guidelines.


ResultFormat (optional)

Pass in the query’s desired return format, either CSV, XML, or JSON. Returns CSV by default.

Example request


curl 'https://api.impact.com/Advertisers/<AccountSID>/Programs/<ProgramId>/ClickExport' \
  -X GET \
  -u '<AccountSID>:<AuthToken>' \
  -H 'Accept: application/json' \
  -d 'MediaId=1207480' \
  -d 'MediaId=1207477' \
  -d 'Date=2022-07-25' \
  -d 'ResultFormat=JSON'

Example response


{
  "Status": "QUEUED",
  "QueuedUri": "/Advertisers/<AccountSID>/Jobs/d8807a9f-a5ee-4e3f-ad2b-3dfd19d1915f",
  "ResultUri": "/Advertisers/<AccountSID>/Jobs/d8807a9f-a5ee-4e3f-ad2b-3dfd19d1915f/Download"
}