WordPress Plugin

The official Kissmetrics WordPress plugin is now available.

👍
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

Download the plugin and extract the contents:
- Newer PHP versions (8, or 8+): download link.
- Older PHP versions: download link.
Upload the entire kissmetrics folder to your /wp-content/plugins/ directory.
In the WordPress admin dashboard, go to the Plugins menu and activate the plugin.
Go to Settings menu, then to the Kissmetrics Product settings to grab the Tracking API Key.
Add your Tracking 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 (`<?php echo $current_user->user_login ?>`)
Signed In		JavaScript anonymous ID or WordPress login (`<?php echo $current_user->user_login ?>`)
Created Account / Registered		JavaScript anonymous ID or WordPress login (`<?php echo $current_user->user_login ?>`)

Activity

Event Name	Properties	Identity
Viewed Blog Homepage		JavaScript anonymous ID or WordPress login (`<?php echo $current_user->user_login ?>`)
Viewed Post	ID: the post ID viewed	JavaScript 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 Page	ID: the page ID viewed	JavaScript anonymous ID or WordPress login (`<?php echo $current_user->user_login ?>`)
	Title: the title of the post
Article Link Clicked	Title: the title of the link clicked	JavaScript anonymous ID or WordPress login (`<?php echo $current_user->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 (`<?php echo $current_user->user_login ?>`)
	Page: the title of the post or page containing the link
Searched Site	WordPress Search Query: the search terms from your site’s vanilla WordPress search engine	JavaScript anonymous ID or WordPress login (`<?php echo $current_user->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