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    

WordPress Plugin

The official Kissmetrics WordPress plugin is now available (download link). The source is also on Github.

When you use this plugin, you do not need to follow our usual instructions for installing the JavaScript snippet. The plugin takes care of that for you, and more.

Setup Instructions

  1. Download the plugin and extract the contents.
  2. Upload the entire kissmetrics folder to your /wp-content/plugins/ directory.
  3. In the WordPress admin dashboard, go to the Plugins menu and activate the plugin.
  4. Go to Settings menu, then to the Kissmetrics settings.
  5. Add your API key here and select which events you would like to have automatically tracked.

Integration Details

Registration

Event Name

Properties

Identity

Viewed Signup Page

JavaScript anonymous ID or WordPress login (user_login ?>)

Signed In

JavaScript anonymous ID or WordPress login (user_login ?>)

Created Account / Registered

JavaScript anonymous ID or WordPress login (user_login ?>)

Facebook Connect'd

JavaScript anonymous ID or WordPress login (user_login ?>)

Facebook Logout

JavaScript anonymous ID or WordPress login (user_login ?>)

Activity

Event Name

Properties

Identity

Viewed Blog Homepage

JavaScript anonymous ID or WordPress login (user_login ?>)

Viewed Post

ID: the post ID viewed

JavaScript anonymous ID or WordPress login (user_login ?>)

Title: the title of the post

Categories: an array of the post’s categories

Viewed Page

ID: the page ID viewed

JavaScript anonymous ID or WordPress login (user_login ?>)

Title: the title of the post

Article Link Clicked

Title: the title of the link clicked

JavaScript anonymous ID or WordPress login (user_login ?>)

Page: the title of the post or page containing the link

Comment Link Clicked

Title: the title of the comment clicked

JavaScript anonymous ID or WordPress login (user_login ?>)

Page: the title of the post or page containing the link

Tweet

Shared URL: URL being tweeted

JavaScript anonymous ID or WordPress login (user_login ?>)

Twitter Follow

Username: Username of the new Twitter follower

JavaScript anonymous ID or WordPress login (user_login ?>)

Like

Shared URL: URL of the article being Facebook Liked

JavaScript anonymous ID or WordPress login (user_login ?>)

Unlike

Shared URL: URL of the article being Facebook Unliked

JavaScript anonymous ID or WordPress login (user_login ?>)

Searched Site

WordPress Search Query: the search terms from your site’s vanilla WordPress search engine

JavaScript anonymous ID or WordPress login (user_login ?>)

Comments

These events apply to WordPress’ vanilla commenting system.

Event Name

Properties

Identity

Commented

Commenter name: the commenter’s name

The commenter’s email address

Commenter email: the commenter’s email

Comment: the text of the comment

Updated about a year ago

WordPress Plugin


Suggested Edits are limited on API Reference Pages

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