WordPress Plugin

​

What the Plugin Does

​

Installation

​

Step 1: Download

1. In WisePilot, go to Integrations -> WordPress
2. Click Download Plugin
3. This generates a ZIP file with your site’s configuration

​

Step 2: Install

1. In WordPress admin, go to Plugins -> Add New -> Upload Plugin
2. Choose the downloaded ZIP file
3. Click Install Now, then Activate

​

Step 3: Connect

• Website ID
• Events URL
• Tracking token

​

Step 4: Verify

1. Visit any page on your site
2. View page source — search for crConfig. You should see:
   var crConfig = {"websiteId":"your-uuid","eventsUrl":"https://...","trackingToken":"crtkn_..."};
   
3. Check Network tab — scroll to a CTA and verify a POST to /api/integrations/cr/events fires
4. Console check — run window.getAttributionId() to verify the attribution cookie exists

​

CTA Requirements

<div data-cta-id="your-cta-uuid"
     data-cta-position="abtf"
     data-asset-content-id="CNT-123">
  <a href="https://your-booking-page.com">Book a Call</a>
</div>

​

Event Batching

• CTA views are batched with a 1-second debounce (up to 50 per batch)
• CTA clicks flush immediately (before navigation)
• Events are flushed on page unload (visibilitychange / pagehide)
• Delivery uses navigator.sendBeacon() with fetch() fallback

​

View Deduplication

​

CTA ID Formats

• UUID — The internal WisePilot CTA ID (used when CTAs are published from WisePilot)
• ACF CTA ID — WordPress ACF field IDs like cta_footer_1558 (used when CTAs are managed via ACF)

​

GA4 Integration

• cta_view with parameters: cta_id, cta_position, page_path, attribution_id
• cta_click with same parameters

1. Go to GA4 -> Admin -> Custom Definitions
2. Add cta_id as an Event parameter
3. Add cta_position as an Event parameter

​

Manual Configuration (Advanced)

​

Option A: wp-config.php

define('CR_WEBSITE_ID', 'your-website-uuid');
define('CR_EVENTS_URL', 'https://app.contentregistry.com');
define('CR_TRACKING_TOKEN', 'crtkn_your_token');

​

Option B: WP-CLI

wp option update cr_website_id "your-website-uuid"
wp option update cr_events_url "https://app.contentregistry.com"
wp option update cr_tracking_token "crtkn_your_token"

​

Plugin REST Endpoints

​

Troubleshooting

​

crConfig is empty

• Plugin is activated but not yet connected. Go to Integrations -> WordPress in WisePilot and connect your site.
• Or set values manually (see Manual Configuration above).

​

Events not arriving

• Check browser Network tab for POST requests to the events URL
• Verify the tracking token is valid (matches wordpress_config.tracking_token in WisePilot)
• Check for CORS errors — the origin must match your wordpress_config.site_url

​

Events arrive but CTA data shows zero

• If using ACF-managed CTAs, ensure your CTAs have been synced to WisePilot so the ACF CTA ID (e.g. cta_footer_1558) can be resolved to the internal UUID. Unmatched ACF IDs are stored with cta_id: null.

​

Upgrading from v2.x

1. Deactivate and delete the old plugin
2. Download and install v3.0 from WisePilot
3. Connect your site to auto-configure
4. Remove any GTM CTA tracking tags (no longer needed)
5. Existing tracking data is preserved — new events use cr_plugin source