User Guide
WordPress Plugin

WordPress Plugin

Convultra offers an official WordPress plugin that handles tracking installation, WooCommerce purchase tracking, and Enhanced Conversions — all without writing code.

Download and install

Download the plugin

Go to Settings → API Keys & Installation in your Convultra dashboard and select the WordPress tab. Click Download plugin to get convultra-wordpress.zip.

Install in WordPress

In your WordPress admin panel:

  1. Go to Plugins → Add New → Upload Plugin
  2. Choose the convultra-wordpress.zip file you downloaded
  3. Click Install Now, then Activate

Configure and enable tracking

After activation, the plugin starts with tracking disabled — no data is sent until you complete setup. A setup notice will appear in your WordPress admin until configuration is complete.

  1. Go to Settings → Convultra in your WordPress admin
  2. Paste your project API key (found in your Convultra dashboard under Settings → API Keys & Installation)
  3. Toggle Enable tracking to on
  4. If you use WooCommerce, enable the Server-side WooCommerce tracking toggle
  5. Click Save

The plugin does not send any data until you enter your API key and enable tracking. This gives you time to configure everything before going live.


WooCommerce purchase tracking

When WooCommerce tracking is enabled, the plugin sends purchase events directly from your server — not just from the thank-you page. This means conversions are captured even if a customer closes their browser before the confirmation page loads, or if JavaScript is blocked.

When purchases are tracked

  • When payment is confirmed (e.g., credit card charge succeeds)
  • When order status is set to Completed (e.g., for manual or offline orders)

The plugin automatically prevents duplicate sends — if a purchase is already tracked on payment confirmation, it will not be sent again when the order status changes.

Data sent with each purchase

DataDetails
Purchase valueOrder total and currency
Order IDUsed for deduplication and reporting
Line itemsProduct name, product ID, quantity, and price for each item
EmailHashed (SHA-256) before sending
PhoneHashed (SHA-256) before sending
First nameHashed (SHA-256) before sending
Last nameHashed (SHA-256) before sending
IP addressVisitor IP for attribution
User agentBrowser and device context
💡

Privacy first: All personal data (email, phone, first name, last name) is hashed in the plugin before it leaves your server. Convultra never receives plaintext customer information from the plugin.

Optional WooCommerce funnel events

Beyond purchases, the plugin can track mid-funnel events that help you understand your checkout flow. In Settings → Convultra → WooCommerce, you can toggle each event on or off:

EventDefaultWhat it tracks
View CartOnCustomer views their cart page
Add Payment InfoOnCustomer enters payment details at checkout
Add Shipping InfoOffCustomer enters shipping details at checkout
Remove From CartOffCustomer removes an item from their cart

These events appear in the All Events tab on the Conversions page (not in conversion totals). They are useful for spotting where customers drop off before purchasing.

💡

Funnel events are sent server-side when server-side WooCommerce tracking is enabled, ensuring they are captured reliably even if JavaScript is blocked.


Enhanced Conversions — automatic

Because the plugin sends hashed customer data (email, phone, name) with every WooCommerce purchase, Enhanced Conversions work automatically. There is no extra setup needed.

This means:

  • Google Ads and Meta receive hashed identifiers for better conversion matching
  • Match rates improve by up to 30% compared to click-ID-only tracking
  • Conversions are matched even when click IDs have expired (iOS, long sales cycles, cross-device)

If you are already running Google Ads Smart Bidding, enabling the WordPress plugin with WooCommerce tracking is one of the fastest ways to improve your bidding performance.


Using with audiences and rules

The data sent by the plugin supports additional Convultra features:

  • Rules — Build rules based on order value, currency, order ID, or line items to control how conversions are forwarded
  • Audiences — Hashed identifiers support audience building and lookalike segments on your ad platforms. Order value and product data enable value-based segmentation.

Updating the plugin

When a new version of the plugin is released, download the latest .zip from Settings → API Keys & Installation → WordPress and install it over the existing version in WordPress. Your settings (API key, WooCommerce toggle) are preserved during updates.

⚠️

Always download the plugin from your Convultra dashboard to ensure you have the latest version.