WordPress

ProductLense needs no WordPress plugin of its own. Paste the script into a site-wide header box from a code-snippet plugin, or print it from a child theme's functions.php. Either way it lands in the head of every page.

Add the script#

Replace SITE_ID with the id from Settings → Sites in the ProductLense dashboard.

<script>window.productlense=window.productlense||function(){(window.productlense.q=window.productlense.q||[]).push(arguments)}</script>
<script defer data-site="SITE_ID" src="https://api.productlense.app/a.js"></script>

<?php
add_action('wp_head', function () {
    echo '<script>window.productlense=window.productlense||function(){(window.productlense.q=window.productlense.q||[]).push(arguments)}</script>' . "\n";
    echo '<script defer data-site="SITE_ID" src="https://api.productlense.app/a.js"></script>' . "\n";
});

Use a child theme so a theme update does not remove the snippet.

Identify users#

For sites with logins (memberships, WooCommerce accounts, LMS plugins), identify the signed-in user in the footer:

<?php
add_action('wp_footer', function () {
    if (!is_user_logged_in()) return;
    $user = wp_get_current_user();
    printf(
        '<script>window.productlense("identify",%s);</script>',
        wp_json_encode((string) $user->ID)
    );
});

The id is passed as a string, as identify requires. Use the same id you store on the customer in your billing provider; see how payments are attributed.

Custom events#

<script>
  document.addEventListener('submit', (e) => {
    if (e.target.matches('.newsletter-form')) window.productlense('event', 'Newsletter signup');
  }, true);
</script>

See custom events for naming rules.

Verify your installation#

1. Clear any page cache, then open your site in a normal browser window, logged out.
2. Open the Live page in the ProductLense dashboard. Your visit appears within a few seconds.
3. In the browser's developer tools, the Network tab shows a POST to https://api.productlense.app/api/e with status 204.

A local WordPress on localhost sends nothing unless the tag has data-dev="true". Ad blockers in your own browser may block the request. If the visit does not appear, follow Verify your installation.