The click object holds information about a click action. You can retrieve a click, as well as list all clicks.
Attributes
Id
string
Id
stringA generated value that represents the consumer journey — also known as ClickId
(or irclickid
). This value can be associated with multiple click objects.
CampaignId
integer
CampaignId
integerProgram (formerly known as campaign) Id associated with the click.
CampaignName
string
CampaignName
stringProgram (formerly known as campaign) name associated with the click.
ProfileId
string
ProfileId
stringimpact.com's unique identifier for a user on a specific device.
IpAddress
string
IpAddress
stringHashed IP address that the click was sourced from. This attribute is used to determine Customer
attributes (e.g., CustomerCity
).
EventDate
string
EventDate
stringDate and time this click happened. See ISO 8601.
MediaId
integer
MediaId
integerPartner Id that drove the click.
MediaName
string
MediaName
stringPartner name that drove the click.
AdId
integer
AdId
integerId of the ad that was clicked.
AdName
string
AdName
stringName of the ad that was clicked.
AdType
enum
AdType
enumType of the ad that was clicked.
View possible enum values | |
---|---|
BANNER | Click was generated on a banner ad. |
EMAIL | Click was generated on an email ad. |
FLASH | Click was generated on a flash player ad. |
TEXT | Click was generated on a sponsored text ad. |
TEXT_LINK | Click was generated on a text hyperlink ad. |
LONG_SPONSORED_TEXT | Click was generated on a long sponsored text ad. |
XML_SYNDICATION | Click was generated on an XML syndication. |
COUPON | Click was generated on a coupon ad. |
CONTENT | Partner requested an additional content ad tracking value. |
VIDEO | Click was generated on a video ad. |
ONLINE_TRACKING_LINK | Click was generated on an online tracking link ad. |
MEDIA_SOURCE_TRACKING | Click was generated on a media source (e.g., an SEO source). |
ProductSku
string
ProductSku
stringUnique stock-keeping unit (SKU) Id that represents the item that the ad is marketing. This Id will coincide with the item's SKU Id as it is listed in the product catalog.
BrandRelated
array
BrandRelated
arrayYour brand's information that is related to the click event.
View child attributes
AdCampaign
string
AdCampaign
stringName of the third-party ad grouping that the ad is grouped with.
AdGroup
string
AdGroup
stringWhich third-party ad group the ad is contained in (e.g., Paid Search).
Keyword
string
Keyword
stringInternal keyword associated with the ad.
MatchType
string
MatchType
stringHow the click is matched to the consumer who generated it.
Channel
string
Channel
stringWhich channel generated the click.
CustomerArea
string
CustomerArea
stringGenerated 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.
CustomerCity
string
CustomerCity
stringGenerated from the IpAddress
attribute, this is the city from where the customer generated the click. If IpAddress
was not tracked, n/a
will appear.
CustomerRegion
string
CustomerRegion
stringGenerated 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.
CustomerCountry
string
CustomerCountry
stringGenerated 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.
DeviceType
enum
DeviceType
enumWhat device the customer clicked or tapped the ad on.
View possible enum values | |
---|---|
DESKTOP | Consumer generated the click from a personal computer. |
PHONE | Consumer generated the click using a mobile phone. |
TABLET | Consumer generated the click using a tablet computer. |
GAME | Consumer generated the click from a mobile game. |
WATCH | Consumer generated the click from a smart watch. |
TV | Consumer generated the click from a TV ad. |
ROBOT | A robot generated the click. |
CAR | Consumer generated the click from a their car. |
UNKNOWN | The DeviceType could not be tracked. |
DeviceFamily
enum
DeviceFamily
enumGeneral group of devices that the attribute DeviceType
comes from. Only a sample of all enum values are presented below.
View possible enum values | |
---|---|
WINDOWS_MACHINE | Consumer generated the click using a Windows machine. |
LINUX_MACHINE | Consumer generated the click using a Linux machine. |
APPLE_MAC | Consumer generated the click using an Apple machine. |
IPHONE | Consumer generated the click using an iPhone. |
IPAD | Consumer generated the click using an iPad. |
ONE | Consumer generated the click using a OnePlus One mobile device. |
CHROMEBOOK | Consumer generated the click using a Google Chromebook. |
UNKNOWN | The DeviceFamily could not be tracked. |
Browser
enum
Browser
enumWhich web browser the customer used when they generated the click. Only a sample of all enum values are presented below.
View possible enum values | |
---|---|
CHROME | Consumer generated the click using Google Chrome. |
CHROME_MOBILE | Consumer generated the click using Google Chrome on a mobile device. |
UC_BROWSER | Consumer generated the click using UC Browser. |
OPERA | Consumer generated the click using Opera. |
OPERA_MOBILE | Consumer generated the click using Opera on a mobile device. |
EDGE | Consumer generated the click using Microsoft Edge. |
FIREFOX | Consumer generated the click using Mozilla Firefox. |
SAFARI | Consumer generated the click using Apple's Safari browser. |
CAKE | Consumer generated the click using the mobile browser Cake. |
AMAZON_SILK | Consumer generated the click using Amazon's web browser, Silk. |
UNKNOWN | The Browser could not be tracked. |
Os
enum
Os
enumWhich operating system the customer used when they generated the click. Only a sample of all enum values are presented below.
View possible enum values | |
---|---|
ANDROID | Consumer generated the click using the Android operating system. |
LINUX | Consumer generated the click using the Linux operating system. |
IOS | Consumer generated the click using the iOS operating system. |
WINDOWS_10 | Consumer generated the click using the Windows 10 operating system. |
WINDOWS_7 | Consumer generated the click using the Windows 7 operating system. |
UNKNOWN | The Os could not be tracked. |
ReferringUrl
string
ReferringUrl
stringThe URL that the customer came from when they generated the click.
ReferringDomain
string
ReferringDomain
stringThe web domain that the customer came from when they generated the click.
LandingPageUrl
string
LandingPageUrl
stringThe URL the customer landed on when they generated the click.
SharedId
string
SharedId
stringA SharedId that is passed on the tracking link the partner used.
UniqueClick
boolean
UniqueClick
booleanIf the click follows IAB standards for a "unique click."
More attributes
View more attributes
CpcBid
string
CpcBid
stringHow much the partner will be paid for driving the click.
DealName
string
DealName
stringName of the associated deal.
DealType
enum
DealType
enumType of the associated deal.
View possible enum values | |
---|---|
BOGO | Deal will apply a buy-one-get-one deal to the order. |
FREE_SHIPPING | Deal applies free shipping to the order. |
GENERAL_SALE | Deal applies a general discount to the products identified in `DealScope`. |
GIFT_WITH_PURCHASE | A gift will come with the order. |
REBATE | A rebate will be available to the customer upon purchase. |
DealScope
enum
DealScope
enumTo what extent the deal applies to the click.
View possible enum values | |
---|---|
CATEGORY | Deal applies to a category of products. |
ENTIRE_STORE | Deal applies to the entire store. |
PRODUCT | Deal only applies to a specific product or a specific group of products. |
PartnerRelated
array
PartnerRelated
arrayA partner's information that is related to the click event.
View child attributes
SubId1
string
SubId1
stringA SubId that is passed on the tracking link the partner used.
SubId2
string
SubId2
stringA SubId that is passed on the tracking link the partner used.
SubId3
string
SubId3
stringA SubId that is passed on the tracking link the partner used.
Payout
decimal
Payout
decimalPartner's payout for driving the click.
TrafficCategory
string
TrafficCategory
stringWhat kind of traffic is generating the click.
TrafficSource
string
TrafficSource
stringReferring site (aka Source
) of the traffic generating the click.
BidKeyword
string
BidKeyword
stringIf the click was generated from a Paid Search, then this will be the keyword used in that Paid search.
SearchText
string
SearchText
stringIf the click was generated from a Paid Search, then this will be the search query the customer put into a search engine.
{
"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",
"BrandRelated": {
"AdCampaign": " ",
"AdGroup": " ",
"Channel": "Affiliate/CPA Network",
},
"CustomerArea": "n/a",
"CustomerCity": "n/a",
"CustomerRegion": "n/a",
"CustomerCountry": "US",
"DeviceType": "UNKNOWN",
"DeviceFamily": "null",
"Browser": "null",
"Os": "null",
"ReferringDomain": "NA",
"LandingPageUrl": "http://google.com?irgwc=1",
"CpcBid": "0.0",
"UniqueClick": "true"
}