Meta CAPI Setup Guide

1. Meta Pixel & Access Token Setup

To start sending events to the Meta Conversions API, you need your Pixel ID and a Graph API Access Token:

1. Step 1 Log in to your Meta Events Manager.
2. Step 2 Navigate to your active Data Source (Pixel) and copy the Pixel ID shown on the top left.
3. Step 3 Go to the Settings tab of the Data Source.
4. Step 4 Scroll down to the Conversions API section and click the Generate access token link under the "Set up manually" block.
5. Step 5 Copy this token, go to your WordPress admin dashboard > Settings > Meta CAPI Tracker, paste both credentials into the fields, and click Save Configuration.

2. Configuring Premium Integrations

The Pro version supports automatic integrations with your site's conversion forms and storefronts:

• WooCommerce E-commerce Events: Toggle this option ON to automatically track critical shopping funnel stages (ViewContent, AddToCart, InitiateCheckout, and Purchase). The plugin matches transaction totals, currencies, and products automatically.
• Form Submissions (Contact & Leads): Enable this option to capture form events from popular plugins (Contact Form 7, WPForms, and Elementor Forms). Submissions automatically map as a Meta Lead or Contact event.
• Hashing of PII Details: All customer data (Email, Phone, First Name, Last Name, City, Zip, State, and Country) is automatically formatted, normalized, and hashed securely on your server using SHA-256 before being transmitted to Meta to preserve user privacy and comply with Meta's security rules.

3. Advanced Features

Maximize your attribution accuracy with our advanced server-side optimization engines:

• Script Proxy Engine: Direct browser pixel scripts (like fbevents.js) are frequently blocked by popular browser extensions and adblockers. The Script Proxy Engine routes this script through your first-party domain, making the tracking request invisible to blockers and raising tracking volume by up to 25%.
• Cookie Keeper Module: Apple Safari's Intelligent Tracking Prevention (ITP) caps the lifetime of third-party cookie matches to 1 to 7 days. Enabling the Cookie Keeper module sets a first-party HTTP cookie directly from your server, extending match lifespans up to 2 years to track returning customers.

4. Testing & Verification

Ensure your setup is sending events correctly before putting the tracking live:

1. Go to your Meta Events Manager > Test Events tab.
2. Copy the Test Event Code (e.g. TEST12345).
3. Paste this code into the "Meta Test Code" field in the plugin's Configuration tab and save.
4. Go to the Test Event Center tab inside the plugin settings, select an event (like PageView), and click Trigger Server-Side Event.
5. Check the CAPI Logs tab in the plugin settings to confirm a 200 OK response code was returned, or inspect the live updates in your Meta Events Manager panel.