Entities and Attributes

The following entities and attributes are available for reporting.

sessions

A session is a visit from a user to your site or app. A session is recorded when a new user visits your app or site, or when 30 minutes elapses from the user's last interaction. Also, for web tracking, a session in recorded when the user re-enters the site from a different source (campaign, referrer, or search engine).

view attributes

Name Title Description Type
adGroupId Ad Group Id The numeric ad group id for the current session. string
adGroup Ad Group Name The ad group name. string
avgPageViews Average Page Views The average page views per session. numeric
avgPurchaseAmount Average Purchase Amount The average revenue per purchase (events with revenue). currency
avgSessionLength Average Session Length The average session length in seconds. numeric
bidKeywords Bid Keywords The bid keywords for the ad clicked on. string
blockListed Block Listed Whether this session is on the block list of bots, click farms, and other fraudulent activity. boolean
blockListings Block Listings The count of sessions on the block list of bots, click farms, and other fraudulent activity. integer
bounce Bounce Sessions where only one page was viewed before the user exited the site. boolean
bounceRate Bounce Rate The rate of sessions where only one page was viewed. percent
bounces Bounces Sessions where only one page was viewed. integer
browser Browser The browser used for the session. string
browserVersion Browser Version The browser and specific browser version (if applicable) for the user's session. For example, 'Internet Explorer 11' or 'Opera Mobile'. Note - If the session is from an app, this will not be set. string
currentCampaign Campaign The advertising campaign where the customer originated from for the current session. string
channel Channel A group of several traffic sources with the same medium. For example, 'Direct', 'Referral' or 'Organic Search. string
city City The city the user originated the session from. This is determined from the user's IP address. string
clicks Clicks The number of clicks from campaigns. integer
colo Colocation Session Whether the customer's IP address originated from a datacenter or other co-location facility. boolean
colos Colocations The count of sessions with IP addresses from within a datacenter or co-location facility. integer
connectionType Connection Type The user's connection type (Dialup, Cable/DSL, Cellular, Corporate). string
content Content Information about the campaign content used to identify traffic details within a campaign. This is tracked automatically if set in the 'utm_content' query string parameter on the URL. string
conversionRate Conversion Rate The rate of sessions to purchases (events with revenue). percent
cookieId Cookie Id Your unique id for a user, which is generally stored in a cookie. string
cookieSupport Cookie Support Whether the session supports cookies. This is only tracked for web sessions. boolean
cookiesSupported Cookies Supported Whether the session supports cookies. This is only tracked for web sessions. integer
country Country The city the user originated the session from. This is determined from the user's IP address. string
countryCode Country Code The 2-character country code the user originated the session from (for example, US for the United States). This is derived from the IP address. string
device Device The specific device used during the user's session. For example, 'Samsung Galaxy S8' or ' Apple iPhone'. string
deviceType Device Type The type of device used during the user's session. For example, 'Desktop/laptop' or 'Mobile'. string
deviceVendor Device Vendor The vendor or manufacturer of the device used during the session. For example, 'Apple' or 'Samsung'. string
dma DMA The Designated Market Area (DMA) the user orginated the session from. A DMA is a group of counties in the United States that are covered by a specific group of television stations. There are 210 DMAs in the United States. This is determined from the user's IP address. string
dmaCode DMA Code The numeric code for the Designated Market Area (DMA) the user orginated the session from. A DMA is a group of counties in the United States that are covered by a specific group of television stations. There are 210 DMAs in the United States. This is determined from the users's IP address. integer
entryPage Entry Page The name or title of the first page the user entered your site from. For example, 'Home page'. string
eventCount Event Count The number of events for the session or timeframe. integer
events Events The events that occurred during the session. array
eventsDetail Events Detail The events with all data that occurred during the session. array
exitPage Exit Page The name or title of the last page displayed for a session. string
firstCampaign First Campaign The first advertising campaign where the customer originated from. string
hiddenCount Hidden Count The count of sessions hidden to the user. Hidden sessions can occur due to pre-loading, bots, being offscreen and a variety of other reasons. integer
invalidCount Invalid Count The count of sessions that have been determined to be likely not human based. These sessions have a quality score less than 100. integer
ipAddress IP Address The IP Address detected for the user. string
itemPrice Item Price The price of an item in a transaction. integer
itemQuantity Item Quantity The number of items in transactions. integer
language Language The language of the user. This is determined from the settings on the device they are currently using. string
languageCode Language Code The standard language code of the user (like 'en-us' for United States English), This is determined from the settings on the device they are currently using. string
lastAccess Last Access The last time of any activity for this session. date
latestCampaign Latest Campaign The latest advertising campaign where the customer originated from. This could be from the current session or a prior session. string
latitude Latitude The latitude of the user's location for the session. This value can derived from the IP address or mobile device. numeric
longitude Longitude The longitude of the user's location for the session. This value can derived from the IP address or mobile device. numeric
medianHouseholdIncome Median Income The median household income of the postal code the session originated from. integer
medium Medium The marketing medium for the campaign. This is tracked automatically if set in the 'utm_medium' query string parameter on the URL. string
newUser New User Whether the user for this session is a new user. boolean
newUserRate New User Rate The rate of new user, which is the first session ever initiated for a user. percent
newUsers New Users The number of users that have never visited your site or app before. integer
offense Offense The most relevent quality score indicator detected. string
organization Organization The organization the user originated the session from. This value can be an ISP, corporation, university or any other organization that can be identified by the net block. This is determined from the users's IP address. string
organizationType Organization Type The organization type the user originated the session from. string
pageViews Page Views The number of pages viewed by the user during the session. integer
pages Pages An array of pages that were viewed during the session. array
person Person The data assigned to a person. object
personId Person Id The person/customer/user, usually an email address or customer id. This is set via the setPerson API call. string
platform Platform The operating system type the session originated from. For example, 'Windows' or 'iOS' string
platformVersion Platform Version The operating system type and version the session originated from. For example, 'Windows 10' or 'iOS 11.4' string
postalCode Postal Code The postal code the user originated the session from. This is derived from the session's IP address. string
probability0_14 Probability 0 to 14 The probability in percent of how likely the user for the session is between the ages of 0 and 14. This is derived from adjusted census data. percent
probability15_24 Probability 15 to 24 The probability in percent of how likely the user for the session is between the ages of 15 and 24. This is derived from adjusted census data. percent
probability25_34 Probability 25 to 34 The probability in percent of how likely the user for the session is between the ages of 25 and 34. This is derived from adjusted census data. percent
probability35_44 Probability 35 to 44 The probability in percent of how likely the user for the session is between the ages of 35 and 44. This is derived from adjusted census data. percent
probability45_54 Probability 45 to 54 The probability in percent of how likely the user for the session is between the ages of 45 and 54. This is derived from adjusted census data. percent
probability55_64 Probability 55 to 64 The probability in percent of how likely the user for the session is between the ages of 55 and 64. This is derived from adjusted census data. percent
probabilityAsian Probability Asian The probability in percent of how likely the user for the session is asian. This is derived from adjusted census data. percent
probabilityBlack Probability Black The probability in percent of how likely the user for the session is black. This is derived from adjusted census data. percent
probabilityHispanic Probability Hispanic The probability in percent of how likely the user for the session is hispanic. This is derived from adjusted census data. percent
probability65Over Probability Over 65 The probability in percent of how likely the user for the session is the age of 65 or over. This is derived from adjusted census data. percent
probabilityWhite Probability White The probability in percent of how likely the user for the session is white. This is derived from adjusted census data. percent
proxies Proxies The count of sessions routed through known proxy servers. integer
proxy Proxy Based Session Whether this session was routed through a known proxy server. boolean
publisherId Publisher Id The publisher id of the session. string
purchases Purchases The number of purchases made. Purchases are defined as events with a revenue property. integer
referrer Referrer The domain and path of the site that a user came from via a link. For example, 'search.yahoo.com/search' or 'Direct' string
region Region The region, state, or province the user originated the session from. This is derived from the user's IP address. string
repeatClick Repeat Click Whether the session was flagged as a repeat click offense. boolean
repeatClicks Repeat Clicks The count of sessions flagged as repeat clicks. integer
resolution Resolution The screen resolution of the device used for the session. string
returns Returns The number of returns made. Returns are defined as events with a revenue property with a negative value. integer
revenue Revenue The revenue corresponding with the user's order placing during this session. currency
score Score The quality score of the user (0 - 999). A low score indicates that the user may be a bot, or intentionally committing click fraud. integer
searchEngine Search Engine The search engine the session originated from. For example, 'Google' or 'Bing' string
searchEngineVersion Search Engine Version The name of the search engine that referred the session. For search engines that support it, this attribute displays the regional version, for example, 'Google France'. string
searchTerms Search Terms The search terms that were used to refer the user. string
secure Secure Whether the session is using a secure protocol (HTTPS). boolean
session Session Data The data assigned to this session. object
sessionDate Session Date The session's date (YYYY-MM-DD). date
sessionDateTime Session Date / Time The session's date (YYYY-MM-DD) and time (HH:MM). date
sessionHour Session Hour The session's date (YYYY-MM-DD) and hour (0-23 AM/PM). date
sessionHourOfDay Session Hour of Day The session's hour day (0 - 23) integer
sessionId Session Id The session's unique ID number. string
sessionLength Session Length The session length in seconds, counting up until the last user interaction. integer
sessionMinute Session Minute The session's date (YYYY-MM-DD) and time (HH:MM AM/PM). date
sessionMonth Session Month The sessions year and month (YYYY-MM). date
sessionMonthOfYear Session Month of Year The session's month in the year (1-12). integer
sessionNumber Session No. The number of sessions the user has initiated. integer
sessionWeek Session Week The session's week in the year (YYYY-MM-DD). date
sessionYear Session Year The session's year (YYYY). string
sessions Sessions The number of user sessions. Sessions are started in the following cases: 1) A new user visits your app or site. 2) 30 minutes elapses from the user's last interaction. 3) The user re-enters the site or app from a different source (campaign, referrer, or search engine) integer
share Share The share as a percentage. percent
shipping Shipping The shipping cost from events. currency
source Source The original source of customer before they came to the site. For example, 'email', 'google.com' 'm.facebook.com' or even 'Direct' (if they navigated to the site via typing the address in the URL). string
spoofedUserAgent Spoofed User Agent Whether this session claims to originate from a device or browser that the user is not actually on. boolean
spoofedUserAgents Spoofed User Agents The count of sessions that have user agents that do not match the systems they are on. integer
subPublisherId Sub Publisher Id The sub publisher id of the session. string
tax Tax The tax from events. currency
term Term The paid search term keywords that drove traffic to an ad. This is tracked automatically if set in the 'utm_term' query string parameter on the URL. string
TOR TOR User Whether the customer is using The Onion Router (TOR) network, an anonymous network that is largely used to mask a person's identity. boolean
TORs TORs The count of sessions using the TOR network. integer
universities Universities The count of sessions originated from a university or college. integer
university University Whether the session originated from a university, college or other academic institution. boolean
userAgent User Agent The user agent header for the user. string
userId User Id The user's unique ID number. integer
valid Valid Whether the session was valid, meaning having a quality score above 100. boolean
validCount Valid Count The count of valid items, meaning having a quality score above 100. integer
visible Visible Whether the session was visible to the user. Hidden sessions can occur due to pre-loading, bots, being offscreen and a variety of other reasons. boolean
visibleCount Visible Count The count of items visible to the user. Hidden sessions can occur due to pre-loading, bots, being offscreen and a variety of other reasons. integer

pages

For website tracking only, distinct pages on a website.

view attributes

Name Title Description Type
adGroupId Ad Group Id The numeric ad group id for the current session. string
adGroup Ad Group Name The ad group name. string
blockListed Block Listed Whether this session is on the block list of bots, click farms, and other fraudulent activity. boolean
blockListings Block Listings The count of sessions on the block list of bots, click farms, and other fraudulent activity. integer
browser Browser The browser used for the session. string
browserVersion Browser Version The browser and specific browser version (if applicable) for the user's session. For example, 'Internet Explorer 11' or 'Opera Mobile'. Note - If the session is from an app, this will not be set. string
currentCampaign Campaign The advertising campaign where the customer originated from for the current session. string
channel Channel A group of several traffic sources with the same medium. For example, 'Direct', 'Referral' or 'Organic Search. string
city City The city the user originated the session from. This is determined from the user's IP address. string
colo Colocation Session Whether the customer's IP address originated from a datacenter or other co-location facility. boolean
colos Colocations The count of sessions with IP addresses from within a datacenter or co-location facility. integer
connectionType Connection Type The user's connection type (Dialup, Cable/DSL, Cellular, Corporate). string
content Content Information about the campaign content used to identify traffic details within a campaign. This is tracked automatically if set in the 'utm_content' query string parameter on the URL. string
cookieId Cookie Id Your unique id for a user, which is generally stored in a cookie. string
cookieSupport Cookie Support Whether the session supports cookies. This is only tracked for web sessions. boolean
cookiesSupported Cookies Supported Whether the session supports cookies. This is only tracked for web sessions. integer
country Country The city the user originated the session from. This is determined from the user's IP address. string
countryCode Country Code The 2-character country code the user originated the session from (for example, US for the United States). This is derived from the IP address. string
device Device The specific device used during the user's session. For example, 'Samsung Galaxy S8' or ' Apple iPhone'. string
deviceType Device Type The type of device used during the user's session. For example, 'Desktop/laptop' or 'Mobile'. string
deviceVendor Device Vendor The vendor or manufacturer of the device used during the session. For example, 'Apple' or 'Samsung'. string
dma DMA The Designated Market Area (DMA) the user orginated the session from. A DMA is a group of counties in the United States that are covered by a specific group of television stations. There are 210 DMAs in the United States. This is determined from the user's IP address. string
dmaCode DMA Code The numeric code for the Designated Market Area (DMA) the user orginated the session from. A DMA is a group of counties in the United States that are covered by a specific group of television stations. There are 210 DMAs in the United States. This is determined from the users's IP address. integer
firstCampaign First Campaign The first advertising campaign where the customer originated from. string
hiddenCount Hidden Count The count of sessions hidden to the user. Hidden sessions can occur due to pre-loading, bots, being offscreen and a variety of other reasons. integer
invalidCount Invalid Count The count of sessions that have been determined to be likely not human based. These sessions have a quality score less than 100. integer
ipAddress IP Address The IP Address detected for the user. string
language Language The language of the user. This is determined from the settings on the device they are currently using. string
languageCode Language Code The standard language code of the user (like 'en-us' for United States English), This is determined from the settings on the device they are currently using. string
lastAccess Last Access The last time of any activity for this session. date
latestCampaign Latest Campaign The latest advertising campaign where the customer originated from. This could be from the current session or a prior session. string
latitude Latitude The latitude of the user's location for the session. This value can derived from the IP address or mobile device. numeric
longitude Longitude The longitude of the user's location for the session. This value can derived from the IP address or mobile device. numeric
medianHouseholdIncome Median Income The median household income of the postal code the session originated from. integer
medium Medium The marketing medium for the campaign. This is tracked automatically if set in the 'utm_medium' query string parameter on the URL. string
offense Offense The most relevent quality score indicator detected. string
organization Organization The organization the user originated the session from. This value can be an ISP, corporation, university or any other organization that can be identified by the net block. This is determined from the users's IP address. string
organizationType Organization Type The organization type the user originated the session from. string
page Page The name or title of the page. string
pageDateTime Page Date / Time The date and time of when the page was viewed in ISO-8601 format. date
pageViews Page Views The number of pages viewed by the user during the session. integer
person Person The data assigned to a person. object
personId Person Id The person/customer/user, usually an email address or customer id. This is set via the setPerson API call. string
platform Platform The operating system type the session originated from. For example, 'Windows' or 'iOS' string
platformVersion Platform Version The operating system type and version the session originated from. For example, 'Windows 10' or 'iOS 11.4' string
postalCode Postal Code The postal code the user originated the session from. This is derived from the session's IP address. string
probability0_14 Probability 0 to 14 The probability in percent of how likely the user for the session is between the ages of 0 and 14. This is derived from adjusted census data. percent
probability15_24 Probability 15 to 24 The probability in percent of how likely the user for the session is between the ages of 15 and 24. This is derived from adjusted census data. percent
probability25_34 Probability 25 to 34 The probability in percent of how likely the user for the session is between the ages of 25 and 34. This is derived from adjusted census data. percent
probability35_44 Probability 35 to 44 The probability in percent of how likely the user for the session is between the ages of 35 and 44. This is derived from adjusted census data. percent
probability45_54 Probability 45 to 54 The probability in percent of how likely the user for the session is between the ages of 45 and 54. This is derived from adjusted census data. percent
probability55_64 Probability 55 to 64 The probability in percent of how likely the user for the session is between the ages of 55 and 64. This is derived from adjusted census data. percent
probabilityAsian Probability Asian The probability in percent of how likely the user for the session is asian. This is derived from adjusted census data. percent
probabilityBlack Probability Black The probability in percent of how likely the user for the session is black. This is derived from adjusted census data. percent
probabilityHispanic Probability Hispanic The probability in percent of how likely the user for the session is hispanic. This is derived from adjusted census data. percent
probability65Over Probability Over 65 The probability in percent of how likely the user for the session is the age of 65 or over. This is derived from adjusted census data. percent
probabilityWhite Probability White The probability in percent of how likely the user for the session is white. This is derived from adjusted census data. percent
proxies Proxies The count of sessions routed through known proxy servers. integer
proxy Proxy Based Session Whether this session was routed through a known proxy server. boolean
publisherId Publisher Id The publisher id of the session. string
referrer Referrer The domain and path of the site that a user came from via a link. For example, 'search.yahoo.com/search' or 'Direct' string
region Region The region, state, or province the user originated the session from. This is derived from the user's IP address. string
repeatClick Repeat Click Whether the session was flagged as a repeat click offense. boolean
repeatClicks Repeat Clicks The count of sessions flagged as repeat clicks. integer
resolution Resolution The screen resolution of the device used for the session. string
score Score The quality score of the user (0 - 999). A low score indicates that the user may be a bot, or intentionally committing click fraud. integer
searchEngine Search Engine The search engine the session originated from. For example, 'Google' or 'Bing' string
searchEngineVersion Search Engine Version The name of the search engine that referred the session. For search engines that support it, this attribute displays the regional version, for example, 'Google France'. string
searchTerms Search Terms The search terms that were used to refer the user. string
secure Secure Whether the session is using a secure protocol (HTTPS). boolean
session Session Data The data assigned to this session. object
sessionDate Session Date The session's date (YYYY-MM-DD). date
sessionDateTime Session Date / Time The session's date (YYYY-MM-DD) and time (HH:MM). date
sessionHour Session Hour The session's date (YYYY-MM-DD) and hour (0-23 AM/PM). date
sessionHourOfDay Session Hour of Day The session's hour day (0 - 23) integer
sessionId Session Id The session's unique ID number. string
sessionMinute Session Minute The session's date (YYYY-MM-DD) and time (HH:MM AM/PM). date
sessionMonth Session Month The sessions year and month (YYYY-MM). date
sessionMonthOfYear Session Month of Year The session's month in the year (1-12). integer
sessionNumber Session No. The number of sessions the user has initiated. integer
sessionWeek Session Week The session's week in the year (YYYY-MM-DD). date
sessionYear Session Year The session's year (YYYY). string
share Share The share as a percentage. percent
source Source The original source of customer before they came to the site. For example, 'email', 'google.com' 'm.facebook.com' or even 'Direct' (if they navigated to the site via typing the address in the URL). string
spoofedUserAgent Spoofed User Agent Whether this session claims to originate from a device or browser that the user is not actually on. boolean
spoofedUserAgents Spoofed User Agents The count of sessions that have user agents that do not match the systems they are on. integer
subPublisherId Sub Publisher Id The sub publisher id of the session. string
term Term The paid search term keywords that drove traffic to an ad. This is tracked automatically if set in the 'utm_term' query string parameter on the URL. string
TOR TOR User Whether the customer is using The Onion Router (TOR) network, an anonymous network that is largely used to mask a person's identity. boolean
TORs TORs The count of sessions using the TOR network. integer
universities Universities The count of sessions originated from a university or college. integer
university University Whether the session originated from a university, college or other academic institution. boolean
userAgent User Agent The user agent header for the user. string
userId User Id The user's unique ID number. integer
valid Valid Whether the session was valid, meaning having a quality score above 100. boolean
validCount Valid Count The count of valid items, meaning having a quality score above 100. integer
visible Visible Whether the session was visible to the user. Hidden sessions can occur due to pre-loading, bots, being offscreen and a variety of other reasons. boolean
visibleCount Visible Count The count of items visible to the user. Hidden sessions can occur due to pre-loading, bots, being offscreen and a variety of other reasons. integer

events

An event is an activity performed by a user, like 'App Launch', or 'Signup'. Events are tracked via JavaScript or API calls. Events can track any extra data. For example, a signup event can also pass in the user's name and other info.

view attributes

Name Title Description Type
adGroupId Ad Group Id The numeric ad group id for the current session. string
adGroup Ad Group Name The ad group name. string
avgItemQuantity Average Item Quantity The average quantity of items on transactions. numeric
avgPrice Average Price The average price of an item. currency
avgPurchaseAmount Average Purchase Amount The average revenue per purchase (events with revenue). currency
blockListed Block Listed Whether this session is on the block list of bots, click farms, and other fraudulent activity. boolean
blockListings Block Listings The count of sessions on the block list of bots, click farms, and other fraudulent activity. integer
browser Browser The browser used for the session. string
browserVersion Browser Version The browser and specific browser version (if applicable) for the user's session. For example, 'Internet Explorer 11' or 'Opera Mobile'. Note - If the session is from an app, this will not be set. string
currentCampaign Campaign The advertising campaign where the customer originated from for the current session. string
channel Channel A group of several traffic sources with the same medium. For example, 'Direct', 'Referral' or 'Organic Search. string
city City The city the user originated the session from. This is determined from the user's IP address. string
colo Colocation Session Whether the customer's IP address originated from a datacenter or other co-location facility. boolean
colos Colocations The count of sessions with IP addresses from within a datacenter or co-location facility. integer
connectionType Connection Type The user's connection type (Dialup, Cable/DSL, Cellular, Corporate). string
content Content Information about the campaign content used to identify traffic details within a campaign. This is tracked automatically if set in the 'utm_content' query string parameter on the URL. string
conversionRate Conversion Rate The rate of sessions to purchases (events with revenue). percent
cookieId Cookie Id Your unique id for a user, which is generally stored in a cookie. string
cookieSupport Cookie Support Whether the session supports cookies. This is only tracked for web sessions. boolean
cookiesSupported Cookies Supported Whether the session supports cookies. This is only tracked for web sessions. integer
country Country The city the user originated the session from. This is determined from the user's IP address. string
countryCode Country Code The 2-character country code the user originated the session from (for example, US for the United States). This is derived from the IP address. string
eventDateTime Date / Time The date and time of the event in ISO-8601 format. date
device Device The specific device used during the user's session. For example, 'Samsung Galaxy S8' or ' Apple iPhone'. string
deviceType Device Type The type of device used during the user's session. For example, 'Desktop/laptop' or 'Mobile'. string
deviceVendor Device Vendor The vendor or manufacturer of the device used during the session. For example, 'Apple' or 'Samsung'. string
dma DMA The Designated Market Area (DMA) the user orginated the session from. A DMA is a group of counties in the United States that are covered by a specific group of television stations. There are 210 DMAs in the United States. This is determined from the user's IP address. string
dmaCode DMA Code The numeric code for the Designated Market Area (DMA) the user orginated the session from. A DMA is a group of counties in the United States that are covered by a specific group of television stations. There are 210 DMAs in the United States. This is determined from the users's IP address. integer
entryPage Entry Page The name or title of the first page the user entered your site from. For example, 'Home page'. string
event Event The event object. object
eventCount Event Count The number of events for the session or timeframe. integer
eventName Event Name The event name. string
exitPage Exit Page The name or title of the last page displayed for a session. string
firstCampaign First Campaign The first advertising campaign where the customer originated from. string
hiddenCount Hidden Count The count of sessions hidden to the user. Hidden sessions can occur due to pre-loading, bots, being offscreen and a variety of other reasons. integer
invalidCount Invalid Count The count of sessions that have been determined to be likely not human based. These sessions have a quality score less than 100. integer
ipAddress IP Address The IP Address detected for the user. string
itemCategory Item Category The category of the item in the transaction detail. string
itemName Item Name The name of the item, which could be a product, service, donation, etc. in the transaction detail. string
itemPrice Item Price The price of an item in a transaction. integer
itemQuantity Item Quantity The number of items in transactions. integer
itemRevenue Item Revenue The item quantity multiplied by the item price in transactions. currency
language Language The language of the user. This is determined from the settings on the device they are currently using. string
languageCode Language Code The standard language code of the user (like 'en-us' for United States English), This is determined from the settings on the device they are currently using. string
lastAccess Last Access The last time of any activity for this session. date
latestCampaign Latest Campaign The latest advertising campaign where the customer originated from. This could be from the current session or a prior session. string
latitude Latitude The latitude of the user's location for the session. This value can derived from the IP address or mobile device. numeric
longitude Longitude The longitude of the user's location for the session. This value can derived from the IP address or mobile device. numeric
medianHouseholdIncome Median Income The median household income of the postal code the session originated from. integer
medium Medium The marketing medium for the campaign. This is tracked automatically if set in the 'utm_medium' query string parameter on the URL. string
newUser New User Whether the user for this session is a new user. boolean
offense Offense The most relevent quality score indicator detected. string
organization Organization The organization the user originated the session from. This value can be an ISP, corporation, university or any other organization that can be identified by the net block. This is determined from the users's IP address. string
organizationType Organization Type The organization type the user originated the session from. string
page Page The name or title of the page. string
pages Pages An array of pages that were viewed during the session. array
person Person The data assigned to a person. object
personId Person Id The person/customer/user, usually an email address or customer id. This is set via the setPerson API call. string
platform Platform The operating system type the session originated from. For example, 'Windows' or 'iOS' string
platformVersion Platform Version The operating system type and version the session originated from. For example, 'Windows 10' or 'iOS 11.4' string
postalCode Postal Code The postal code the user originated the session from. This is derived from the session's IP address. string
probability0_14 Probability 0 to 14 The probability in percent of how likely the user for the session is between the ages of 0 and 14. This is derived from adjusted census data. percent
probability15_24 Probability 15 to 24 The probability in percent of how likely the user for the session is between the ages of 15 and 24. This is derived from adjusted census data. percent
probability25_34 Probability 25 to 34 The probability in percent of how likely the user for the session is between the ages of 25 and 34. This is derived from adjusted census data. percent
probability35_44 Probability 35 to 44 The probability in percent of how likely the user for the session is between the ages of 35 and 44. This is derived from adjusted census data. percent
probability45_54 Probability 45 to 54 The probability in percent of how likely the user for the session is between the ages of 45 and 54. This is derived from adjusted census data. percent
probability55_64 Probability 55 to 64 The probability in percent of how likely the user for the session is between the ages of 55 and 64. This is derived from adjusted census data. percent
probabilityAsian Probability Asian The probability in percent of how likely the user for the session is asian. This is derived from adjusted census data. percent
probabilityBlack Probability Black The probability in percent of how likely the user for the session is black. This is derived from adjusted census data. percent
probabilityHispanic Probability Hispanic The probability in percent of how likely the user for the session is hispanic. This is derived from adjusted census data. percent
probability65Over Probability Over 65 The probability in percent of how likely the user for the session is the age of 65 or over. This is derived from adjusted census data. percent
probabilityWhite Probability White The probability in percent of how likely the user for the session is white. This is derived from adjusted census data. percent
proxies Proxies The count of sessions routed through known proxy servers. integer
proxy Proxy Based Session Whether this session was routed through a known proxy server. boolean
publisherId Publisher Id The publisher id of the session. string
purchases Purchases The number of purchases made. Purchases are defined as events with a revenue property. integer
referrer Referrer The domain and path of the site that a user came from via a link. For example, 'search.yahoo.com/search' or 'Direct' string
region Region The region, state, or province the user originated the session from. This is derived from the user's IP address. string
repeatClick Repeat Click Whether the session was flagged as a repeat click offense. boolean
repeatClicks Repeat Clicks The count of sessions flagged as repeat clicks. integer
resolution Resolution The screen resolution of the device used for the session. string
returns Returns The number of returns made. Returns are defined as events with a revenue property with a negative value. integer
revenue Revenue The revenue corresponding with the user's order placing during this session. currency
score Score The quality score of the user (0 - 999). A low score indicates that the user may be a bot, or intentionally committing click fraud. integer
searchEngine Search Engine The search engine the session originated from. For example, 'Google' or 'Bing' string
searchEngineVersion Search Engine Version The name of the search engine that referred the session. For search engines that support it, this attribute displays the regional version, for example, 'Google France'. string
searchTerms Search Terms The search terms that were used to refer the user. string
secure Secure Whether the session is using a secure protocol (HTTPS). boolean
session Session Data The data assigned to this session. object
sessionDate Session Date The session's date (YYYY-MM-DD). date
sessionDateTime Session Date / Time The session's date (YYYY-MM-DD) and time (HH:MM). date
sessionHour Session Hour The session's date (YYYY-MM-DD) and hour (0-23 AM/PM). date
sessionHourOfDay Session Hour of Day The session's hour day (0 - 23) integer
sessionId Session Id The session's unique ID number. string
sessionLength Session Length The session length in seconds, counting up until the last user interaction. integer
sessionMinute Session Minute The session's date (YYYY-MM-DD) and time (HH:MM AM/PM). date
sessionMonth Session Month The sessions year and month (YYYY-MM). date
sessionMonthOfYear Session Month of Year The session's month in the year (1-12). integer
sessionNumber Session No. The number of sessions the user has initiated. integer
sessionWeek Session Week The session's week in the year (YYYY-MM-DD). date
sessionYear Session Year The session's year (YYYY). string
share Share The share as a percentage. percent
shipping Shipping The shipping cost from events. currency
sku SKU The SKU of the item in the transaction detail. string
source Source The original source of customer before they came to the site. For example, 'email', 'google.com' 'm.facebook.com' or even 'Direct' (if they navigated to the site via typing the address in the URL). string
spoofedUserAgent Spoofed User Agent Whether this session claims to originate from a device or browser that the user is not actually on. boolean
spoofedUserAgents Spoofed User Agents The count of sessions that have user agents that do not match the systems they are on. integer
subPublisherId Sub Publisher Id The sub publisher id of the session. string
tax Tax The tax from events. currency
term Term The paid search term keywords that drove traffic to an ad. This is tracked automatically if set in the 'utm_term' query string parameter on the URL. string
TOR TOR User Whether the customer is using The Onion Router (TOR) network, an anonymous network that is largely used to mask a person's identity. boolean
TORs TORs The count of sessions using the TOR network. integer
uniqueId Unique Id The unique id for the event. string
universities Universities The count of sessions originated from a university or college. integer
university University Whether the session originated from a university, college or other academic institution. boolean
userAgent User Agent The user agent header for the user. string
userId User Id The user's unique ID number. integer
valid Valid Whether the session was valid, meaning having a quality score above 100. boolean
validCount Valid Count The count of valid items, meaning having a quality score above 100. integer
visible Visible Whether the session was visible to the user. Hidden sessions can occur due to pre-loading, bots, being offscreen and a variety of other reasons. boolean
visibleCount Visible Count The count of items visible to the user. Hidden sessions can occur due to pre-loading, bots, being offscreen and a variety of other reasons. integer

timings

A timing is a measure of how long a page took to load. This is broken down in connection time, DNS resolution time, how long the page took to become interactive, and total time.

view attributes

Name Title Description Type
adGroupId Ad Group Id The numeric ad group id for the current session. string
adGroup Ad Group Name The ad group name. string
avgTimingConnect Avg. Connect Time The average connection time in milliseconds. numeric
avgTimingDNS Avg. DNS Time The average DNS resolution time in milliseconds. numeric
avgTimingInteractive Avg. Page Interactive Time The average amount of time in milliseconds before the page becomes interactive. numeric
avgTimingTotal Avg. Page Load Time The average elapsed time of the page load timing in milliseconds. numeric
avgTimingResponse Avg. Response Time The average eamount of time in milliseconds it takes for the response to occur. numeric
bounce Bounce Sessions where only one page was viewed before the user exited the site. boolean
bounceRate Bounce Rate The rate of sessions where only one page was viewed. percent
bounces Bounces Sessions where only one page was viewed. integer
browser Browser The browser used for the session. string
browserVersion Browser Version The browser and specific browser version (if applicable) for the user's session. For example, 'Internet Explorer 11' or 'Opera Mobile'. Note - If the session is from an app, this will not be set. string
channel Channel A group of several traffic sources with the same medium. For example, 'Direct', 'Referral' or 'Organic Search. string
city City The city the user originated the session from. This is determined from the user's IP address. string
timingConnect Connect Time The connection time in milliseconds. integer
country Country The city the user originated the session from. This is determined from the user's IP address. string
countryCode Country Code The 2-character country code the user originated the session from (for example, US for the United States). This is derived from the IP address. string
device Device The specific device used during the user's session. For example, 'Samsung Galaxy S8' or ' Apple iPhone'. string
deviceType Device Type The type of device used during the user's session. For example, 'Desktop/laptop' or 'Mobile'. string
deviceVendor Device Vendor The vendor or manufacturer of the device used during the session. For example, 'Apple' or 'Samsung'. string
dma DMA The Designated Market Area (DMA) the user orginated the session from. A DMA is a group of counties in the United States that are covered by a specific group of television stations. There are 210 DMAs in the United States. This is determined from the user's IP address. string
dmaCode DMA Code The numeric code for the Designated Market Area (DMA) the user orginated the session from. A DMA is a group of counties in the United States that are covered by a specific group of television stations. There are 210 DMAs in the United States. This is determined from the users's IP address. integer
timingDNS DNS Time The DNS resolution time in milliseconds. integer
entryPage Entry Page The name or title of the first page the user entered your site from. For example, 'Home page'. string
timingInteractive Interactive Time The amount of time in milliseconds before the page becomes interactive. integer
language Language The language of the user. This is determined from the settings on the device they are currently using. string
languageCode Language Code The standard language code of the user (like 'en-us' for United States English), This is determined from the settings on the device they are currently using. string
lastAccess Last Access The last time of any activity for this session. date
latitude Latitude The latitude of the user's location for the session. This value can derived from the IP address or mobile device. numeric
longitude Longitude The longitude of the user's location for the session. This value can derived from the IP address or mobile device. numeric
medianHouseholdIncome Median Income The median household income of the postal code the session originated from. integer
organization Organization The organization the user originated the session from. This value can be an ISP, corporation, university or any other organization that can be identified by the net block. This is determined from the users's IP address. string
organizationType Organization Type The organization type the user originated the session from. string
platform Platform The operating system type the session originated from. For example, 'Windows' or 'iOS' string
platformVersion Platform Version The operating system type and version the session originated from. For example, 'Windows 10' or 'iOS 11.4' string
postalCode Postal Code The postal code the user originated the session from. This is derived from the session's IP address. string
region Region The region, state, or province the user originated the session from. This is derived from the user's IP address. string
timingResponse Response Time The amount of time in milliseconds it takes for the response to occur. integer
secure Secure Whether the session is using a secure protocol (HTTPS). boolean
sessionDate Session Date The session's date (YYYY-MM-DD). date
sessionDateTime Session Date / Time The session's date (YYYY-MM-DD) and time (HH:MM). date
sessionHour Session Hour The session's date (YYYY-MM-DD) and hour (0-23 AM/PM). date
sessionHourOfDay Session Hour of Day The session's hour day (0 - 23) integer
sessionMinute Session Minute The session's date (YYYY-MM-DD) and time (HH:MM AM/PM). date
share Share The share as a percentage. percent
timingCategory Timing Category The category of the timing, like 'Page Load'. string
timingCount Timing Count The number of timings performed. integer
timingTotal Total Time The total elapsed time of the timing in milliseconds. numeric
universities Universities The count of sessions originated from a university or college. integer
university University Whether the session originated from a university, college or other academic institution. boolean
userAgent User Agent The user agent header for the user. string
userId User Id The user's unique ID number. integer

users

Users are anonymous visitors to your website or app.

view attributes

Name Title Description Type
adGroupId Ad Group Id The numeric ad group id for the current session. string
adGroup Ad Group Name The ad group name. string
browser Browser The browser used for the session. string
browserVersion Browser Version The browser and specific browser version (if applicable) for the user's session. For example, 'Internet Explorer 11' or 'Opera Mobile'. Note - If the session is from an app, this will not be set. string
channel Channel A group of several traffic sources with the same medium. For example, 'Direct', 'Referral' or 'Organic Search. string
city City The city the user originated the session from. This is determined from the user's IP address. string
completionTime Completion Time The average amount of time in seconds to complete this step of the conversion funnel. numeric
content Content Information about the campaign content used to identify traffic details within a campaign. This is tracked automatically if set in the 'utm_content' query string parameter on the URL. string
country Country The city the user originated the session from. This is determined from the user's IP address. string
countryCode Country Code The 2-character country code the user originated the session from (for example, US for the United States). This is derived from the IP address. string
device Device The specific device used during the user's session. For example, 'Samsung Galaxy S8' or ' Apple iPhone'. string
deviceType Device Type The type of device used during the user's session. For example, 'Desktop/laptop' or 'Mobile'. string
deviceVendor Device Vendor The vendor or manufacturer of the device used during the session. For example, 'Apple' or 'Samsung'. string
dma DMA The Designated Market Area (DMA) the user orginated the session from. A DMA is a group of counties in the United States that are covered by a specific group of television stations. There are 210 DMAs in the United States. This is determined from the user's IP address. string
dmaCode DMA Code The numeric code for the Designated Market Area (DMA) the user orginated the session from. A DMA is a group of counties in the United States that are covered by a specific group of television stations. There are 210 DMAs in the United States. This is determined from the users's IP address. integer
firstCampaign First Campaign The first advertising campaign where the customer originated from. string
language Language The language of the user. This is determined from the settings on the device they are currently using. string
languageCode Language Code The standard language code of the user (like 'en-us' for United States English), This is determined from the settings on the device they are currently using. string
latestCampaign Latest Campaign The latest advertising campaign where the customer originated from. This could be from the current session or a prior session. string
latitude Latitude The latitude of the user's location for the session. This value can derived from the IP address or mobile device. numeric
longitude Longitude The longitude of the user's location for the session. This value can derived from the IP address or mobile device. numeric
medianHouseholdIncome Median Income The median household income of the postal code the session originated from. integer
medium Medium The marketing medium for the campaign. This is tracked automatically if set in the 'utm_medium' query string parameter on the URL. string
organization Organization The organization the user originated the session from. This value can be an ISP, corporation, university or any other organization that can be identified by the net block. This is determined from the users's IP address. string
organizationType Organization Type The organization type the user originated the session from. string
platform Platform The operating system type the session originated from. For example, 'Windows' or 'iOS' string
platformVersion Platform Version The operating system type and version the session originated from. For example, 'Windows 10' or 'iOS 11.4' string
postalCode Postal Code The postal code the user originated the session from. This is derived from the session's IP address. string
probability0_14 Probability 0 to 14 The probability in percent of how likely the user for the session is between the ages of 0 and 14. This is derived from adjusted census data. percent
probability15_24 Probability 15 to 24 The probability in percent of how likely the user for the session is between the ages of 15 and 24. This is derived from adjusted census data. percent
probability25_34 Probability 25 to 34 The probability in percent of how likely the user for the session is between the ages of 25 and 34. This is derived from adjusted census data. percent
probability35_44 Probability 35 to 44 The probability in percent of how likely the user for the session is between the ages of 35 and 44. This is derived from adjusted census data. percent
probability45_54 Probability 45 to 54 The probability in percent of how likely the user for the session is between the ages of 45 and 54. This is derived from adjusted census data. percent
probability55_64 Probability 55 to 64 The probability in percent of how likely the user for the session is between the ages of 55 and 64. This is derived from adjusted census data. percent
probabilityAsian Probability Asian The probability in percent of how likely the user for the session is asian. This is derived from adjusted census data. percent
probabilityBlack Probability Black The probability in percent of how likely the user for the session is black. This is derived from adjusted census data. percent
probabilityHispanic Probability Hispanic The probability in percent of how likely the user for the session is hispanic. This is derived from adjusted census data. percent
probability65Over Probability Over 65 The probability in percent of how likely the user for the session is the age of 65 or over. This is derived from adjusted census data. percent
probabilityWhite Probability White The probability in percent of how likely the user for the session is white. This is derived from adjusted census data. percent
referrer Referrer The domain and path of the site that a user came from via a link. For example, 'search.yahoo.com/search' or 'Direct' string
region Region The region, state, or province the user originated the session from. This is derived from the user's IP address. string
resolution Resolution The screen resolution of the device used for the session. string
score Score The quality score of the user (0 - 999). A low score indicates that the user may be a bot, or intentionally committing click fraud. integer
searchEngine Search Engine The search engine the session originated from. For example, 'Google' or 'Bing' string
searchEngineVersion Search Engine Version The name of the search engine that referred the session. For search engines that support it, this attribute displays the regional version, for example, 'Google France'. string
searchTerms Search Terms The search terms that were used to refer the user. string
secure Secure Whether the session is using a secure protocol (HTTPS). boolean
share Share The share as a percentage. percent
source Source The original source of customer before they came to the site. For example, 'email', 'google.com' 'm.facebook.com' or even 'Direct' (if they navigated to the site via typing the address in the URL). string
term Term The paid search term keywords that drove traffic to an ad. This is tracked automatically if set in the 'utm_term' query string parameter on the URL. string
userAgent User Agent The user agent header for the user. string
userId User Id The user's unique ID number. integer
users Users The number of unique users. integer

people

A person is a known user, which means you have identified the user via the API. Generally, a person is known to you when they log in or identify themselves in some other way. People can be tracked across devices.

view attributes

Name Title Description Type
adGroupId Ad Group Id The numeric ad group id for the current session. string
adGroup Ad Group Name The ad group name. string
browser Browser The browser used for the session. string
browserVersion Browser Version The browser and specific browser version (if applicable) for the user's session. For example, 'Internet Explorer 11' or 'Opera Mobile'. Note - If the session is from an app, this will not be set. string
city City The city the user originated the session from. This is determined from the user's IP address. string
country Country The city the user originated the session from. This is determined from the user's IP address. string
countryCode Country Code The 2-character country code the user originated the session from (for example, US for the United States). This is derived from the IP address. string
device Device The specific device used during the user's session. For example, 'Samsung Galaxy S8' or ' Apple iPhone'. string
deviceType Device Type The type of device used during the user's session. For example, 'Desktop/laptop' or 'Mobile'. string
deviceVendor Device Vendor The vendor or manufacturer of the device used during the session. For example, 'Apple' or 'Samsung'. string
dma DMA The Designated Market Area (DMA) the user orginated the session from. A DMA is a group of counties in the United States that are covered by a specific group of television stations. There are 210 DMAs in the United States. This is determined from the user's IP address. string
dmaCode DMA Code The numeric code for the Designated Market Area (DMA) the user orginated the session from. A DMA is a group of counties in the United States that are covered by a specific group of television stations. There are 210 DMAs in the United States. This is determined from the users's IP address. integer
language Language The language of the user. This is determined from the settings on the device they are currently using. string
languageCode Language Code The standard language code of the user (like 'en-us' for United States English), This is determined from the settings on the device they are currently using. string
latitude Latitude The latitude of the user's location for the session. This value can derived from the IP address or mobile device. numeric
longitude Longitude The longitude of the user's location for the session. This value can derived from the IP address or mobile device. numeric
medianHouseholdIncome Median Income The median household income of the postal code the session originated from. integer
newUser New User Whether the user for this session is a new user. boolean
organization Organization The organization the user originated the session from. This value can be an ISP, corporation, university or any other organization that can be identified by the net block. This is determined from the users's IP address. string
organizationType Organization Type The organization type the user originated the session from. string
platform Platform The operating system type the session originated from. For example, 'Windows' or 'iOS' string
platformVersion Platform Version The operating system type and version the session originated from. For example, 'Windows 10' or 'iOS 11.4' string
postalCode Postal Code The postal code the user originated the session from. This is derived from the session's IP address. string
region Region The region, state, or province the user originated the session from. This is derived from the user's IP address. string
share Share The share as a percentage. percent
userAgent User Agent The user agent header for the user. string
userId User Id The user's unique ID number. integer