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.
1067

Integration Details

Registration

Event NamePropertiesIdentity
Viewed Signup PageJavaScript anonymous ID or WordPress login (<?php echo $current_user->user_login ?>)
Signed InJavaScript anonymous ID or WordPress login (<?php echo $current_user->user_login ?>)
Created Account / RegisteredJavaScript anonymous ID or WordPress login (<?php echo $current_user->user_login ?>)
Facebook Connect'dJavaScript anonymous ID or WordPress login (<?php echo $current_user->user_login ?>)
Facebook LogoutJavaScript anonymous ID or WordPress login (<?php echo $current_user->user_login ?>)

Activity

Event NamePropertiesIdentity
Viewed Blog HomepageJavaScript anonymous ID or WordPress login (<?php echo $current_user->user_login ?>)
Viewed PostID: the post ID viewedJavaScript anonymous ID or WordPress login (<?php echo $current_user->user_login ?>)
Title: the title of the post
Categories: an array of the post’s categories
Viewed PageID: the page ID viewedJavaScript anonymous ID or WordPress login (<?php echo $current_user->user_login ?>)
Title: the title of the post
Article Link ClickedTitle: the title of the link clickedJavaScript anonymous ID or WordPress login (<?php echo $current_user->user_login ?>)
Page: the title of the post or page containing the link
Comment Link ClickedTitle: the title of the comment clickedJavaScript anonymous ID or WordPress login (<?php echo $current_user->user_login ?>)
Page: the title of the post or page containing the link
TweetShared URL: URL being tweetedJavaScript anonymous ID or WordPress login (<?php echo $current_user->user_login ?>)
Twitter FollowUsername: Username of the new Twitter followerJavaScript anonymous ID or WordPress login (<?php echo $current_user->user_login ?>)
LikeShared URL: URL of the article being Facebook LikedJavaScript anonymous ID or WordPress login (<?php echo $current_user->user_login ?>)
UnlikeShared URL: URL of the article being Facebook UnlikedJavaScript anonymous ID or WordPress login (<?php echo $current_user->user_login ?>)
Searched SiteWordPress Search Query: the search terms from your site’s vanilla WordPress search engineJavaScript anonymous ID or WordPress login (<?php echo $current_user->user_login ?>)

Comments

These events apply to WordPress’ vanilla commenting system.

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