kissmetrics

The Kissmetrics Developer Hub

Welcome to the kissmetrics developer hub. You'll find comprehensive guides and documentation to help you start working with kissmetrics as quickly as possible, as well as support if you get stuck. Let's jump right in!

Knowledge Base    

Channel Definitions

Channels are your sources of traffic. The Channels property in Kissmetrics automatically reads incoming traffic data and organizes it into three different Kissmetrics Channel properties so you can analyze your acquisition data without any extra work. The three Channel properties are:

  • Channel — the traffic source (e.g., Direct, Organic, Referral, Email, Paid, Social)
  • Channel: Origin — the traffic source + original referring URL/domain or Campaign Name
  • Origin — the referring URL/domain or Campaign Name

Channel definitions

  • Direct — Visits from direct referrers, typing your site into the browser, or bookmarks
  • Organic — Visits from search engines
  • Referral — Visits from 3rd party
  • Email — Visits from emails
  • Paid — Visits from Paid sources such as cpc, cpm, display, ppc, and more (details below)
  • Social — Visits from social networks/sites

How we calculate Channel

Google Campaign Medium UTMs

Before categorizing on any other criteria, the first thing Kissmetrics looks for is a Google Campaign Medium UTM variable on the referral URL (utm_medium). Here’s how we group different values into channels:

  • Paid = utm_medium of “cpc”, “cpm”, “display”, “cpv”, “cpa”, “cpp”, “ppc”, or "paid"
  • Email = utm_medium of “email” or “e-mail”
  • Organic = utm_medium of “organic” or “search”
  • Social = utm_medium of “social”, “social-network”, “social-media”, “sm”, “social network”, or “social media”

Any other values will be under their own channel.

When you drill down into Channel:Origin for these visitors, people will be also categorized under the Campaign Name UTM (i.e., utm_campaign) that was also defined at the same time. For example, a utm_medium of “email” with utm_campaign of “spring_promo” would read as a “Channel:Origin” property of “Email: Spring Promo”.

If the Campaign Name UTM is missing (it usually shouldn’t be as it’s required along with Campaign Source and Campaign Medium), it will be labeled be as “Campaign Name Unknown”.

AdWords gclid parameter

If a campaign medium UTM parameter isn’t detected, the next thing Kissmetrics looks for is a Google Adwords gclid parameter on the referral URL.

Traffic with a gclid parameter is placed in the Paid channel and under AdWords in the Origin drilldown.

Google AdWords uses a gclid parameter when you set up auto-tagging in your Google AdWords account. The auto-tagging feature of Google AdWords is for the Google Analytics integration, but Kissmetrics and other analytics providers cannot read that parameter. Google restricts access to read the gclid parameter. We won’t know which AdWords campaign/keyword was used but we do know that the traffic is from Google AdWords at least. Basically, any traffic with a gclid parameter will be added to an AdWords Origin within the Paid channel.

By putting AdWords after Campaign Medium UTM, the UTM acts as an override. Since we can’t get AdWords campaign values because Google blocks access to information like Campaign Name, Campaign Source, etc, we recommend that you add UTM variables to AdWords links even if you have Google AdWords auto-tagging/gclid enabled. So if you’ve added UTM parameters, we’ll use that data. If not, we’ll group them under the Paid channel as a generic AdWords Origin.

Organic

If the visit came from a search engine, people will be placed in the “Organic” channel. When you drill down into the Origin of the channel, you will see the search engine that drove the visit.

Social

We have a list of 276 social domains and subdomains including major social networks such as Facebook, Twitter, LinkedIn, Pinterest, Reddit, Quora, Tumblr, and more.

If the top-level domain of the referring URL matches one of these, people will be grouped into the Social channel. When you drill-down in the Social channel, you should be able to see the actual social network that drove the visit.

If you see a referring domain that should be grouped into the Social channel, please email [email protected], and we’ll add it to our list of domains to be considered for the Social channel.

Referral

This group will contain the top-level domains of any traffic that doesn’t fit into any other category. When you drill-down into this channel Origin, you get a list of the referring domains.

Direct

Any people that have a site visit with a direct referrer. This will not have an Origin.

Unknown

If a visit doesn’t fall into any of the categories above, we’ll place them into the Unknown channel. If you see traffic categorized as Unknown, it may be from data that you imported from a database or CSV upload. This data usually doesn’t contain acquisition/visit data unless you include it in the upload.

Updated 8 months ago

Channel Definitions


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.