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 im_ref. 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"
}