Installing Usermaven on WordPress

This guide walks you through installing the Usermaven tracking pixel on your WordPress website using two methods:

1. The official Usermaven WordPress plugin (recommended)

2. A third-party WordPress plugin for tracking snippets

Method 1: Official Usermaven WordPress plugin (recommended)

Step 1: Install the plugin

1. Log into your WordPress admin dashboard

2. Go to Plugins > Add New

3. Search for "Usermaven"

4. Click "Install Now" then "Activate"

Step 2: Configure Usermaven

After activation, you'll need to set up the plugin:

Authentication

1. Locate your API key:

• Log into your Usermaven account

• Navigate to Workspace Settings > Setup

• Copy the API key from the tracking script

2. In WordPress, go to the Usermaven plugin settings

3. Paste your API key in the "API Key" field

Bypass adblockers with pixel white-labeling

If you've set up pixel white-labeling, enter your custom domain in the "Custom Domain" field. This helps bypass ad blockers by using your domain instead of Usermaven's.

Tracking options

Choose your preferred tracking methods:

1. Enable "Cookie-less tracking" for privacy-focused tracking

2. Check "Automatically capture frontend events" to track clicks, form submissions, etc.

Tracking identified users

Enable "Identify logged-in users in Usermaven" to track registered user behavior

Exclude visits from tracking

You can choose to exclude visits from certain user roles. Check the boxes next to the roles you want to exclude (e.g., Administrator, Author, Contributor, etc.)

WordPress dashboard integration

To view your Usermaven Web Analytics dashboard stats in your WordPress dashboard:

1. Enable "Enable your stats in your WordPress dashboard"

2. Create a shared link in your Usermaven workspace

3. Paste this link in the "Shared Link" field

Step 3: Save changes

Once you’re done configuring your settings, click "Save Changes" at the bottom of the settings page.

Your WordPress site is now configured to send data to Usermaven. You can view your stats by clicking "View Statistics" in your WordPress dashboard.

Method 2: Using a third-party WordPress plugin

If you prefer not to use the official Usermaven plugin, you can use a third-party plugin to add the Usermaven tracking code to your WordPress site. This method is useful if you're already using a code snippet plugin for other purposes.

Step 1: Install a code snippet plugin

1. Log in to your WordPress admin dashboard.

2. Go to Plugins > Add New.

3. Search for a code snippet plugin. We recommend "Code Snippets" or "Header and Footer Scripts".

4. Click "Install Now" and then "Activate" on your chosen plugin.

Step 2: Access the code snippet area

For this example, we'll use the "Code Snippets" plugin:

1. In the WordPress sidebar, locate "Code Snippets".

2. Hover over it and click on "Add New".

3. Alternatively, some plugins may have a "Header & Footer" option - use this if available.

Step 3: Add Usermaven tracking pixel

1. Log in to your Usermaven account.

2. Navigate to Workspace Settings > Setup.

3. Locate and copy the Usermaven JavaScript tracking pixel code.

4. Return to your WordPress dashboard and the code snippet area.

5. Paste the Usermaven code into the header section of your site.

• Ensure you're adding it to the header section, not the body.

• If using the "Header & Footer" option, paste it into the "Header" field.

Step 4: Save and verify

1. Click "Save Changes" or "Activate" (depending on your plugin).

2. Visit your website's frontend and use your browser's developer tools (usually F12 key) to verify the code is in the header section.