Clicks

Retrieve a Click

get

Retrieves the details of a click or a series of clicks associated with a consumer journey. A single ClickId can be associated with multiple click events.

Path parameters

AccountSIDstringRequired

The unique identifier for the account.

CampaignIdintegerRequired

The ID of the program (campaign) associated with the click.

ClickIdstringRequired

The generated ClickId (or irclickid) representing the consumer journey.

Responses

200

A click object.

application/json

IdstringOptional

Generated value representing the consumer journey (ClickId/irclickid).

Example: abcdefg1hijkl2mn3opq4rStUvwxyz5a6bcdef7

CampaignIdintegerOptional

Program (campaign) Id associated with the click.

Example: 1000

CampaignNamestringOptional

Program (campaign) name associated with the click.

Example: Acme Campaign

ProfileIdstringOptional

impact.com's unique identifier for a user on a specific device.

Example: ab12345c-6789-0123-4de5-678f90g123h4

IpAddressstringOptional

Hashed IP address that the click was sourced from.

Example: abcdefghijklmnopqrstuvwxyz1234567890

EventDatestring · date-timeOptional

Date and time this click happened.

Example: 2021-01-25T08:06:24-05:00

MediaIdintegerOptional

Partner Id that drove the click.

Example: 10000

MediaNamestringOptional

Partner name that drove the click.

Example: Partner Person

AdIdintegerOptional

Id of the ad that was clicked.

Example: 656565

AdNamestringOptional

Name of the ad that was clicked.

Example: Our Anvils Are Awesome

AdTypestring · enumOptional

Type of the ad that was clicked.

Example: BANNERPossible values:

ProductSkustringOptional

SKU of the item the ad is marketing.

Example: 12345

CustomerAreastringOptional

Generated from the IpAddress attribute, this is the geographical area from where the customer generated the click. If IpAddress was not tracked, n/a will appear.

Example: n/a

CustomerCitystringOptional

Generated from the IpAddress attribute, this is the city from where the customer generated the click. If IpAddress was not tracked, n/a will appear.

Example: n/a

CustomerRegionstringOptional

Generated from the IpAddress attribute, this is the geographical region from where the customer generated the click. If IpAddress was not tracked, n/a will appear.

Example: n/a

CustomerCountrystringOptional

Generated from the IpAddress attribute, this is the country from where the customer generated the click. If IpAddress was not tracked, n/a will appear. See ISO 3166-1 alpha-2 .

Example: US

DeviceTypestring · enumOptional

What device the customer clicked or tapped the ad on.

Example: UNKNOWNPossible values:

DeviceFamilystringOptional

General group of devices that the attribute DeviceType comes from. Only a sample of all enum values are presented below.

Example: null

BrowserstringOptional

Which web browser the customer used when they generated the click. Only a sample of all enum values are presented below.

Example: null

OsstringOptional

Which operating system the customer used when they generated the click. Only a sample of all enum values are presented below.

Example: null

ReferringUrlstring · uriOptional

The URL that the customer came from when they generated the click.

Example: https://www.google.com/

ReferringDomainstringOptional

The web domain that the customer came from when they generated the click.

Example: NA

LandingPageUrlstring · uriOptional

The URL the customer landed on when they generated the click.

Example: http://google.com?irgwc=1

SharedIdstringOptional

A SharedId that is passed on the tracking link the partner used.

UniqueClickbooleanOptional

If the click follows IAB standards for a "unique click."

Example: true

CpcBidstringOptional

How much the partner will be paid for driving the click.

Example: 0.0

DealNamestringOptional

Name of the associated deal.

DealTypestring · enumOptional

Type of the associated deal.

Possible values:

DealScopestring · enumOptional

To what extent the deal applies to the click.

Possible values:

Payoutnumber · decimalOptional

Partner's payout for driving the click.

Example: 5

TrafficCategorystringOptional

What kind of traffic is generating the click.

Example: AFFILIATE

TrafficSourcestringOptional

Referring site (aka Source ) of the traffic generating the click.

Example: CONTENT

BidKeywordstringOptional

If the click was generated from a Paid Search, then this will be the keyword used in that Paid search.

Example: tennis balls

SearchTextstringOptional

If the click was generated from a Paid Search, then this will be the search query the customer put into a search engine.

Example: best tennis balls

get/Advertisers/{AccountSID}/Campaigns/{CampaignId}/Clicks/{ClickId}

HTTPcURLJavaScriptPython

GET /Advertisers/{AccountSID}/Campaigns/{CampaignId}/Clicks/{ClickId} HTTP/1.1
Host: api.impact.com
Accept: */*

200

A click object.

{
  "Id": "abcdefg1hijkl2mn3opq4rStUvwxyz5a6bcdef7",
  "CampaignId": "1000",
  "CampaignName": "Acme Campaign",
  "ProfileId": "ab12345c-6789-0123-4de5-678f90g123h4",
  "IpAddress": "abcdefghijklmnopqrstuvwxyz1234567890",
  "EventDate": "2021-01-25T08:06:24-05:00",
  "MediaId": "10000",
  "MediaName": "Partner Person",
  "AdId": "656565",
  "AdName": "Our Anvils Are Awesome",
  "AdType": "BANNER",
  "ProductSku": "12345",
  "BrandRelated": {
    "AdCampaign": "Summer Sale",
    "AdGroup": "Tennis Equipment",
    "Keyword": "tennis balls",
    "MatchType": "BROAD",
    "Channel": "GOOGLE_SHOPPING"
  },
  "CustomerArea": "n/a",
  "CustomerCity": "n/a",
  "CustomerRegion": "n/a",
  "CustomerCountry": "US",
  "DeviceType": "UNKNOWN",
  "DeviceFamily": "null",
  "Browser": "null",
  "Os": "null",
  "ReferringUrl": "https://www.google.com/",
  "ReferringDomain": "NA",
  "LandingPageUrl": "http://google.com?irgwc=1",
  "SharedId": "text",
  "UniqueClick": "true",
  "CpcBid": "0.0",
  "DealName": "text",
  "DealType": "BOGO",
  "DealScope": "CATEGORY",
  "PartnerRelated": {
    "SubId1": "subid1value",
    "SubId2": "subid2value",
    "SubId3": "subid3value"
  },
  "Payout": 5,
  "TrafficCategory": "AFFILIATE",
  "TrafficSource": "CONTENT",
  "BidKeyword": "tennis balls",
  "SearchText": "best tennis balls"
}

Export Clicks

get

Schedules a job to asynchronously export clicks for a given program and date. Returns job status and download URIs.

Path parameters

AccountSIDstringRequired

The unique identifier for the account.

ProgramIdintegerRequired

The ID of the program (campaign) to export clicks from.

Query parameters

AdIdinteger[]Optional

Filter clicks by the ID of the ad that was clicked. Can be repeated.

Datestring · dateOptional

The date for which to export clicks (yyyy-MM-dd). Defaults to today.

MediaIdinteger[]Optional

Filter clicks by the Partner ID. Can be repeated.

UniqueClickbooleanOptional

Filter for clicks that follow IAB standards for a "unique click".

ResultFormatstring · enumOptional

The desired format for the exported file.

Default: CSVPossible values:

Responses

200

The job has been successfully queued.

application/json

StatusstringOptionalExample: QUEUED

QueuedUristring · uri-referenceOptionalExample: /Advertisers/<AccountSID>/Jobs/d8807a9f-a5ee-4e3f-ad2b-3dfd19d1915f

ResultUristring · uri-referenceOptionalExample: /Advertisers/<AccountSID>/Jobs/d8807a9f-a5ee-4e3f-ad2b-3dfd19d1915f/Download

ReplayUristring · uri-referenceOptionalExample: /Advertisers/<AccountSID>/Jobs/d8807a9f-a5ee-4e3f-ad2b-3dfd19d1915f/Replay

get/Advertisers/{AccountSID}/Programs/{ProgramId}/ClickExport

HTTPcURLJavaScriptPython

GET /Advertisers/{AccountSID}/Programs/{ProgramId}/ClickExport HTTP/1.1
Host: api.impact.com
Accept: */*

200

The job has been successfully queued.

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