Intelligems

Tag survey responses with the Intelligems experiment and test group each respondent saw

If you run A/B tests with Intelligems, you can record which test group each respondent was in alongside their survey response. That lets you compare how customers in each variant answered — for example, whether shoppers who saw a new product page layout report a different reason for buying than shoppers who saw the control.

The integration is a short snippet you add to your Shopify theme. Nothing needs to be turned on in Zigpoll or in Intelligems.

How it works

Intelligems puts a JavaScript object, window.igData, on every page it runs on. The snippet waits for Intelligems to load, reads the name of each experiment the visitor is in and the name of the test group they were assigned to, and hands them to Zigpoll in two ways:

• Storefront surveys — it adds them to window.Zigpoll.metadata, which Zigpoll saves with every answer.

• Checkout and thank-you page surveys — it saves them as hidden cart attributes starting with _zigpoll_. Zigpoll's checkout extension copies those attributes onto the response.

Intelligems only reports the experiments that run on the page the visitor is currently viewing. A test that runs on product pages is invisible on the homepage or the thank-you page, so the snippet remembers each assignment in the visitor's browser and keeps sending it on later pages.

Each experiment becomes one metadata field named intelligems_ followed by the experiment name, and the value is the test group name:

Intelligems experiment	Test group	Zigpoll metadata
PDP Hero Image	Lifestyle Photo	intelligems_pdp_hero_image: Lifestyle Photo
Free Shipping Threshold	Control Group	intelligems_free_shipping_threshold: Control Group

Setup

Step #1: Add the snippet to your theme

1. In Shopify, go to Online Store → Themes.

2. Next to your live theme, click ⋯ → Edit code.

3. Under Layout, open theme.liquid.

4. Paste the snippet below just above the closing </head> tag, then click Save.

<script>
/* Zigpoll + Intelligems: tag survey responses with the visitor's test groups */
(function () {
  var STORAGE_KEY = 'zigpoll_intelligems';
  var MAX_AGE = 30 * 24 * 60 * 60 * 1000; // forget experiments not seen for 30 days

  function toKey(name) {
    return 'intelligems_' + String(name).toLowerCase().replace(/[^a-z0-9]+/g, '_').replace(/^_+|_+$/g, '').slice(0, 60);
  }

  function sync() {
    var user = window.igData && window.igData.user;
    if (!user) { return; }

    var now = Date.now();
    var seen = {};
    try { seen = JSON.parse(localStorage.getItem(STORAGE_KEY)) || {}; } catch (e) {}

    /* Intelligems only lists the experiments that run on the current page,
       so remember the ones seen on earlier pages (e.g. a product page test). */
    (user.getExperiments() || []).forEach(function (experiment) {
      var group = user.getTestGroup(experiment.id);
      if (group) { seen[experiment.id] = { name: experiment.name, group: group.name, at: now }; }
    });

    var fields = {};
    Object.keys(seen).forEach(function (id) {
      if (now - seen[id].at > MAX_AGE) { delete seen[id]; return; }
      fields[toKey(seen[id].name)] = seen[id].group;
    });
    try { localStorage.setItem(STORAGE_KEY, JSON.stringify(seen)); } catch (e) {}
    if (!Object.keys(fields).length) { return; }

    /* 1. Surveys on your storefront */
    window.Zigpoll = window.Zigpoll || {};
    window.Zigpoll.metadata = window.Zigpoll.metadata || {};
    Object.keys(fields).forEach(function (key) { window.Zigpoll.metadata[key] = fields[key]; });

    /* 2. Checkout and thank-you page surveys, which read _zigpoll_ cart attributes */
    var root = (window.Shopify && window.Shopify.routes && window.Shopify.routes.root) || '/';
    fetch(root + 'cart.js', { credentials: 'same-origin' })
      .then(function (res) { return res.json(); })
      .then(function (cart) {
        var current = cart.attributes || {};
        var attributes = {};
        var changed = false;
        Object.keys(fields).forEach(function (key) {
          attributes['_zigpoll_' + key] = fields[key];
          if (current['_zigpoll_' + key] !== fields[key]) { changed = true; }
        });
        if (!changed) { return; }
        return fetch(root + 'cart/update.js', {
          method: 'POST',
          credentials: 'same-origin',
          headers: { 'Content-Type': 'application/json' },
          body: JSON.stringify({ attributes: attributes })
        });
      })
      .catch(function () {});
  }

  if (window.igData) { sync(); } else { window.addEventListener('ig:ready', sync); }
})();
</script>

The snippet waits for Intelligems to finish loading, so it works wherever you place it in the page — before or after the Intelligems and Zigpoll scripts. It only updates the cart when a test group has changed, not on every page view.

Step #2: Check that it's working

1. Open your store on a page where an Intelligems experiment is running. Intelligems preview links work too.

2. Open your browser's developer console and run window.Zigpoll.metadata. You should see an intelligems_… field for each experiment you're in.

3. Visit /cart.js on your store. Under attributes you should see the same fields, starting with _zigpoll_intelligems_.

4. Submit a test response and open it on the survey's Responses page. The intelligems_… fields appear in the response's metadata.

Using the data

Once responses carry test group metadata, you can compare variants anywhere Zigpoll lets you filter by metadata:

• Filter results by test group — on the Dashboard, Answers, or Charts page, click the filter icon, choose the intelligems_… field under Custom, and pick a test group. Every tally and chart recalculates for that group. See Filtering results by metadata.

• Export — the fields are included as columns in CSV exports and Google Sheets syncs, so you can pivot answers by test group in your own tools.

• Match to orders — post-purchase responses are already linked to their Shopify order, so you can line them up with Intelligems' own order export.

Which surveys are tagged

Survey	Tagged?
Surveys shown on your storefront	Yes
Checkout and thank-you page surveys	Yes, as long as the shopper visited a page with the snippet before checking out
Email, SMS, and survey link surveys	No — they are answered outside the shopper's browsing session
Surveys with Anonymous mode on	No — anonymous surveys don't store metadata

Good to know

• Renaming an experiment in Intelligems starts a new metadata field, since the field name comes from the experiment name. Responses collected before the rename keep the old field.

• Ended experiments stop being recorded 30 days after the visitor last saw them on a page where the experiment ran. To change that window, edit MAX_AGE in the snippet.

• Testing in preview mode tags your own browser with the previewed group. To clear it, run localStorage.removeItem('zigpoll_intelligems') in the console.

• Shoppers who skip your storefront, for example by following a direct checkout link, won't have a test group on their post-purchase response. Intelligems still adds its own igTestGroups attribute to the order, which holds the test group ID.