Integrate ABlyftIntegrations

etracker

Send the experiments and variations a visitor saw to etracker as a user-defined event and compare them with segments.

With a custom integration, ABlyft sends a user-defined event to etracker whenever a visitor sees an experiment. In etracker you compare the variations with one segment per variation.

What you need

  • The etracker tracking code is installed on your pages.
  • Events are counted towards your etracker hit quota. Check your contract if you expect a lot of traffic.

Create the integration in ABlyft

  1. Open Project → Integrations → Custom Integrations and create a new integration, for example etracker.
  2. Choose the trigger Experiment viewed (default) or User bucketed.
  3. Paste the code below and save. The snippet is republished automatically.

Details about triggers, timing and available data: Custom Integrations.

Integration code

var _etrackerOnReady = typeof _etrackerOnReady === 'undefined' ? [] : _etrackerOnReady;
_etrackerOnReady.push(function () {
  _etracker.sendEvent(new et_UserDefinedEvent(
    experimentName,
    'ABlyft',
    experimentId + ':' + variationId,
    variationName
  ));
});

The four parameters of et_UserDefinedEvent are object, category, action and type. Here the object is the experiment name, the category is ABlyft, the action is <experimentId>:<variationId> and the type is the variation name.

The constants experimentId, experimentName, variationId and variationName are provided by ABlyft. They are also available as experiment.data.id, experiment.data.name, variation.data.id and variation.data.name.

Check before use

etracker expects values to be URL-encoded. If your experiment or variation names contain special characters, wrap them in encodeURIComponent(). Whether this is needed for your account, and how the encoded names are shown in reports, is not covered by the documentation. Test it first.

Where you see the data in etracker

The four values become the dimensions Object, Category, Action and Type of the event. Use them as follows:

  1. In etracker, open Web Analytics → Custom Reports and create a report for the events.
  2. Create one segment per variation, for example with the condition that the action equals or contains <experimentId>:<variationId>.
  3. Add metrics such as visitors and conversion rate and apply the segments side by side.

etracker does not calculate the statistical significance of the experiment for you. Use ABlyft Results for that.

Check the setup

  1. Open the experiment with Run in preview mode and enable Run in preview mode in the integration.
  2. In the browser developer tools, look at the network requests to etracker for the event.
  3. Check in etracker that the event arrives with the category ABlyft.

Notes

Custom integrations do not run when a visitor opted out or sends Do Not Track. etracker may need its own consent setting. Which user-defined events must be set up in etracker before they are reported depends on your account, so set up the tracking in etracker first. The exact menu names and report paths can differ between etracker versions.

etracker documentation

On this page