Heatmap <> Pack Digital Integration Guide

If you're A/B testing through Pack Digital, we can set up a partial-integration for you to be able to review your test data in Heatmap.

Requirements

Heatmap scripts must be installed and running on your site.
The snippet should run after a variant has been selected.
This integration provides partial compatibility - we're currently working on an official integration with Pack Digital.

Note: Native variant previews in Heatmap Interactive Mode are not currently supported. A previous-version bypass may still work for previews.

Required Parameters

The following fields are required:

partner
experiment_id
experiment_name
variant_id

variant_preview_url is experimental and optional.

variants is optional but recommended.

Do I need to add any code?

Yes, you'll need to add this implementation snippet JavaScript to your experiment code:

if (typeof window.heatmap_set_event_tag === 'function') {
  window.heatmap_set_event_tag({
    partner: partnerName,
    experiment_id: experimentId,
    experiment_name: experimentName,
    variant_id: activeVariantId,
    variations: variationsArray,
    // Optional / Experimental
    variant_preview_url: variantPreviewUrl,
  });
}

Example implementation code:

if (typeof window.heatmap_set_event_tag === 'function') {
  window.heatmap_set_event_tag({
    partner: "packdigital",
    experiment_id: "pd-exp-1024",
    experiment_name: "Homepage Hero CTA Test",
    variant_id: "variant-b",
    variations: [
      { id: "variant-a", name: "Control" },
      { id: "variant-b", name: "New CTA Copy" }
    ],
    variant_preview_url: "https://www.example.com/?preview_variant=variant-b"
  });
}

Viewing A/B Test Variants

Currently, Pack Digital is not a fully integrated provider with Heatmap, so viewing variant data in Heatmap requires manual interaction. The page preview does not automatically switch to the active variant unless an experimental preview URL is configured.

Step-by-Step Guide

Set up A/B Testing Filter

Log in to your Heatmap account
Open Heatmap View:
1. Select Heatmap from the left sidebar
2. Choose a page from the Heatmaps list
Click Filters, then select A/B Tests
Choose your A/B testing platform from the dropdown
Select the experiment or specific variant you want to analyze.
Click Apply.

Manual Steps to View the Variant

The heatmap page view will not automatically change to the selected variant.
The view may update automatically only if the experimental variant_preview_url is configured in the integration.
If the preview URL is not set, continue with the manual steps below.
1. Open the Date Filter and select a date range where the chosen variant has collected data.
2. Click View Previous Versions.
3. Select the page preview that most closely matches the variant you want to review.

What You Will See

After completing the manual steps, the Heatmap will display:

A screenshot of the selected variant view for the chosen date range
Click heatmaps from visitors who saw that variant
Scroll and movement data specific to that variant
The variant name as configured in the integration
Total visit counts for the variant, broken down by device type

Troubleshooting Common Issues

What does this integration do?

The Pack Digital A/B Testing integration allows experiment and variant data to be sent to Heatmap so sessions, clicks, and behavior can be analyzed by experiment variant.

Is Pack Digital fully compatible with Heatmap?

Pack Digital is partially compatible with Heatmap at this time. Core experiment and variant tracking is supported, but some advanced features have limitations.

Do I need to install anything?

Yes. Heatmap scripts must already be installed and running on your site before the Pack Digital integration code is added.

What data is required for the integration to work?

The following fields are required:

Partner name
Experiment ID
Experiment name
Variant ID

If any of these are missing, Heatmap may not correctly associate sessions with your experiment.

Can I preview variants in Heatmap?

Native variant previews in Heatmap Interactive Mode are not currently supported with this integration.

A preview URL can be passed, but it is experimental and may not always work as expected. Some customers may continue using a previous-version bypass for preview workflows.

Why is my experiment not showing up in Heatmap?

Common reasons include:

Heatmap scripts are not loading correctly
The integration code runs before a variant is selected
Required parameters (such as variant_id) are missing or undefined

Does this affect site performance?

No. The integration sends lightweight metadata to Heatmap and does not block page rendering when implemented correctly.

Can I use this with multiple experiments at once?

Yes, as long as each experiment sends a unique experiment ID and variant ID.

Is the integration stable?

Yes for core tracking. However, some fields (such as preview URLs) are experimental and may change as the integration evolves.

Who should I contact if something doesn’t work?

If issues persist after verifying setup, contact Heatmap support and include:

Experiment ID
Variant ID
Page URL where the issue occurs
Any relevant console errors

Reach out to support@heatmap.com - we're here to help you succeed.

A/B Test Filters: Pack Digital Integration