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 NamePropertiesIdentity
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 NamePropertiesIdentity
Viewed Blog Homepage JavaScript anonymous ID or WordPress login (user_login ?>)
Viewed Post ID: the post ID viewedJavaScript 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 viewedJavaScript anonymous ID or WordPress login (user_login ?>)
Title: the title of the post
Article Link Clicked Title: the title of the link clickedJavaScript 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 clickedJavaScript anonymous ID or WordPress login (user_login ?>)
Page: the title of the post or page containing the link
Tweet Shared URL: URL being tweetedJavaScript anonymous ID or WordPress login (user_login ?>)
Twitter Follow Username: Username of the new Twitter followerJavaScript anonymous ID or WordPress login (user_login ?>)
Like Shared URL: URL of the article being Facebook LikedJavaScript anonymous ID or WordPress login (user_login ?>)
Unlike Shared URL: URL of the article being Facebook UnlikedJavaScript anonymous ID or WordPress login (user_login ?>)
Searched Site WordPress Search Query: the search terms from your site’s vanilla WordPress search engineJavaScript anonymous ID or WordPress login (user_login ?>)

Comments

These events apply to WordPress’ vanilla commenting system.

Event NamePropertiesIdentity
Commented Commenter name: the commenter’s nameThe commenter’s email address
Commenter email: the commenter’s email
Comment: the text of the comment