WordPress Setup (Using Plugin)

This article guides you through the process of how to set up the Facebook Conversions API on WordPress.

Overview

This guide will walk you through installing the PixelFlow WordPress plugin and setting up Meta Pixel tracking via the PixelFlow dashboard. After completing these steps, you'll be tracking Page View events on your website and ready to configure advanced tracking.

Prerequisites

• WordPress admin access with permission to install plugins

• A Meta Business Manager account with access to your Meta Pixel credentials

• Remove any existing Facebook Pixel scripts to avoid duplicate tracking

1. Login or Register to PixelFlow Dashboard

Before starting the setup process, you'll need a PixelFlow account.

• If you're a new user, you'll create your account during the plugin authentication step (Step 4 below)

• If you're an existing user, you'll log in during the authentication step

• A free 7-day trial starts automatically with no credit card required

2. Install the PixelFlow WordPress Plugin

1. Download the PixelFlow plugin from here

2. After installation completes, click Activate

3. Open PixelFlow Plugin Settings

1. Navigate to Settings → PixelFlow Settings in your WordPress admin menu

2. Or click the Settings link directly under the plugin name in your Plugins list

4. Login to the Plugin

When you first open PixelFlow Settings, you'll see a Welcome screen with authentication options.

For existing PixelFlow users:

1. Click Login

2. A popup window will open directing you to the PixelFlow login page

3. Enter your email and password, OR use Sign in with Google

4. After successful authentication, the popup will automatically close

5. Return to your WordPress admin panel—the plugin will now show as authenticated

For new users:

1. Click Start Free Trial

2. A popup window will open directing you to the PixelFlow registration page

3. Create your account with email and password, OR use Sign in with Google

4. Complete registration

5. The popup will automatically close after authentication

6. Return to your WordPress admin panel—the plugin will now show as authenticated

5. Wizard Auto-Opens: Autosync or Manual Site Sync

After authentication, you'll be directed to the PixelFlow dashboard where the setup wizard will automatically open and guide you through the remaining steps.

Automatic Sync (recommended):

• PixelFlow will attempt to automatically detect your WordPress site domain

• If successful, your domain and currency will be pre-filled

• The WordPress plugin will sync automatically with the dashboard

Manual Sync (if autosync fails):

• If automatic detection doesn't work, you'll see a warning message

• In your WordPress plugin settings, find the Site ID field

• Click "Click here to copy your site ID" to copy it to your clipboard

• Return to the PixelFlow dashboard wizard and paste the Site ID in the provided field

• This will manually sync your WordPress site with the dashboard

6. Add Site Domain and Currency

In the first step of the wizard, configure your site details:

1. Your WordPress domain will be automatically detected and displayed

2. Select your currency from the dropdown (optional, used for eCommerce tracking)

3. Click Continue to proceed to the next step

7. Add Your Meta Pixel

In the second wizard step, you'll add your Meta Pixel credentials:

1. Enter a Pixel Name (can be any name for your reference, e.g., "Main Website Pixel")

2. Add your Meta Pixel ID (also called Dataset ID; find this in Facebook Events Manager)

3. Add your Meta Pixel Access Token (generate this in Facebook Events Manager under Settings)

4. Check the box to confirm you've removed any existing native Meta Pixel

5. Click Add Pixel to save

8. Activate PixelFlow in WordPress Plugin

Now that your pixel is configured in the dashboard, return to your WordPress admin panel to activate tracking. You'll see that the information between your dashboard and the plugin is synchronized.

1. Go back to Settings → PixelFlow Settings in WordPress

2. Toggle ON the Activate PixelFlow switcher

1. Click the Save Changes & Insert Script button

9. Interact with Your Site and See Confetti

The final wizard step helps you verify your setup is working correctly.

1. Visit your live website in a new browser window or incognito/private mode

2. Navigate to a few pages on your site (e.g., homepage, then click some links)

3. Return to the PixelFlow wizard—it will automatically poll for events every 10 seconds

4. When the first Page View event is detected, you'll see:

   • A confetti animation (purple, pink, and blue particles from center screen)

   • A green congratulations modal: "Congratulations! Your WordPress site is now connected to PixelFlow"

   • The wizard will close automatically

5. Your site status will change to "Connected" in the Pixels table on your Overview page

Additional verification:

• Check the PixelFlow Events page in your dashboard

• Check Facebook Events Manager to confirm events are arriving (look for both "Browser" and "Server" sources)

For detailed verification steps, see How to Test and Verify Your PixelFlow CAPI Setup.

10. Set Other Tracking

After the wizard closes, you can configure additional event tracking beyond Page Views.

Available tracking options:

• Event Classes: Track form submissions, button clicks, and custom interactions using CSS classes—see Event Classes on WordPress

• Tracking URLs: Track specific page visits, button clicks, or link interactions—see How to Track Events

• Form Submissions: Capture lead data from contact forms—see How to Track Events for Form Submissions

• Calendly Integration: Automatically track Lead or Schedule events when users book calls—see How to Track Calendars & Call Bookings

• WooCommerce Auto-Tracking: Automatically track product views, add to cart, checkout, and purchases (see Advanced Configuration below)

All tracking is unlimited on every plan, with no limits on events or pixels.

Advanced Configuration

Exclude Script for User Roles

You may not want to track events for yourself, editors, or other WordPress user roles. By default, all site visitor actions are tracked.

To exclude specific user roles from tracking:

1. In Settings → PixelFlow Settings, scroll to the Advanced section

2. Select the user roles you want to exclude (Administrator, Editor, Shop Manager, etc.)

3. Click Save Settings

WooCommerce Integration

If you have WooCommerce installed and active on your website, PixelFlow can automatically add all required tracking classes to your product pages, cart, and checkout.

1. In Settings → PixelFlow Settings, find the Enable WooCommerce Integration section

2. Toggle ON Enable WooCommerce Integration

3. Click Save Settings

After enabling WooCommerce integration, you'll see additional configuration options:

WooCommerce Integration Debug

You can enable visual debugging to verify which elements are being tracked.

1. In the WooCommerce integration settings, toggle ON Debug WooCommerce Integration

2. This adds visual styles (borders or backgrounds) to tracked elements for easy identification

3. Visit your product pages, cart, and checkout to see highlighted elements

4. Disable debugging mode when you've finished verification

WooCommerce Purchase Tracking

The Purchase event is automatically triggered on the Order Received page when Track WooCommerce Purchase is enabled.

How it works:

• The event is sent only once when a customer lands on the Order Received page after completing checkout

• Events from excluded user roles (admin, shop manager) will not be tracked

• When Debug WooCommerce Integration is enabled, you'll see the event confirmation each time you visit the Order Received page for testing purposes

Troubleshooting

Limitations

• Popup requirement: Authentication requires a popup window. If your browser blocks popups, you must allow them to complete login.

• Session timeout: Authentication sessions expire after 5 minutes. If you don't complete login within this window, you'll need to restart the process.

• Manual return to WordPress: After authentication in the popup window, you must manually return to your WordPress admin panel—there is no automatic redirect.

• Wizard polling window: The verification step polls for events for up to 1 hour. After that, check the Events page manually.

• WooCommerce theme compatibility: Some themes use custom WooCommerce templates. If automatic class assignment doesn't work correctly, you may need to manually add classes to your theme files.

• Cache must be cleared: Changes won't appear on your live site until you clear your caching plugin.

Getting Help

If you're experiencing issues with your WordPress setup:

• Check that you've completed all 10 setup steps and cleared your cache

• Verify your Meta Pixel ID and Access Token are correct in the PixelFlow dashboard

• Use browser developer tools (F12) to check for JavaScript errors on your site

• Visit the PixelFlow Events page to confirm events are being received

• Contact PixelFlow support at [email protected] or book a free setup call

When contacting support, please provide:

• Your WordPress site URL

• Screenshots of any error messages

• Whether you're seeing events in your PixelFlow dashboard

• Whether you're seeing events in Facebook Events Manager

• Your WooCommerce version (if using WooCommerce integration)