IMPORTANT: Third-party tracking must be enabled on your project to track conversions. Please reach out to the
support@permutive.com in order to enable this.

Permutive can collect data on users who have visited your partner's site and converted for this campaign. This data can be incredibly useful for:

  • Reporting back on the performance of a campaign after it has run
  • Optimising during the campaign to make sure you reach conversion KPIs
  • Removing users from targeting segments if they have already converted
  • Offering premium targeting for users who have visited the partner site but not yet converted

There are two methods to collect conversion data, deploy the Permutive script or use tracking pixels.

Deploy the Permutive Script on the Client's Site

Permutive will automatically ingest pageviews, form submissions and link clicks, enabling you to build detailed segments with no additional coding (e.g. add to baskets, basket size, conversions). The rich data collected allows you to optimise campaigns based upon a partner's users' on-site behaviour.

Provide the Client with Tracking Pixels

This will enable you to collect similar data to deploying the Permutive script, and optimise in the same manner too.

To use this method,

  • The partner will need to test and deploy a pixel on the conversion page of their site
  • Third-party tracking must be enabled on your project. Please reach out to the support@permutive.com in order to enable this. This only needs to be enabled once.
  • You will need the Public API key for your project (which is available under 'Settings' in the Permutive dashboard).
  • We recommend you email support@permutive.com for help setting this up and to confirm the pixel is deployed correctly

First, you need to prepare the pixel. We recommend you fire in this data using the pixel structure below. There are 2 examples below for tracking a 'PartnerConversion' event.

<script>
var publicKey = PUBLIC_KEY;
var eventName = EVENT_NAME;
var eventProperties = {
    /* Fill out the event properties as JSON here */
};

var protocol = 'https:' == document.location.protocol ? 'https:' : 'http:';
(new Image()).src = protocol + "//ib.adnxs.com/getuid?" + encodeURI(protocol + "//api.permutive.com/v1.1/px/track?k=" + publicKey + "&i=$UID&e=" + eventName + "&p=" + encodeURIComponent(JSON.stringify(eventProperties)) + "&it=appnexus&rand=" + Math.round(Math.random() * 1000000));
</script>

Track a Basic Conversion Event

This will track an event in Permutive whenever a user converts. It doesn't contain any additional information about the conversion event. This method is very easy to set up, and can be used for multiple partners.

For example, for my project which has public API key "f6515c49-5695-4b18-b0ed-6796643af237" I will track a basic 'PartnerConversion' event using the pixel below.

<script>
var publicKey = YOUR_PROJECT_PUBLIC_KEY;
var eventName = "PartnerConversion";
var eventProperties = {
    url: (window.location.href ? window.location.href : '')
};

var protocol = 'https:' == document.location.protocol ? 'https:' : 'http:';
(new Image()).src = protocol + "//ib.adnxs.com/getuid?" + encodeURI(protocol + "//api.permutive.com/v1.1/px/track?k=" + publicKey + "&i=$UID&e=" + eventName + "&p=" + encodeURIComponent(JSON.stringify(eventProperties)) + "&it=appnexus&rand=" + Math.round(Math.random() * 1000000));
</script>

Note: If using for multiple partners you can use exactly the same pixel - as the partner can be inferred from the url.

Track a Detailed Conversion Event

This will track an event in Permutive whenever a user converts. It contains additional, custom information about the conversion event. This method is set up using basic JSON, and is customised for each conversion  and each partner.

For example, I want to track the partner name, conversion url and the value of the conversion. I will track a detailed 'Partner Conversion' event using these event properties:

{ 
partner: "Site A",
value: 50.0,  
url: "http://example.com/checkout"
}

So the final pixel is:

<script>
var publicKey = "f6515c49-5695-4b18-b0ed-6796643af237";
var eventName = "PartnerConversion";
var eventProperties = {
    partner: "Site A",
    value: 50.0,
    url: "http://example.com/checkout"
};

var protocol = 'https:' == document.location.protocol ? 'https:' : 'http:';
(new Image()).src = protocol + "//ib.adnxs.com/getuid?" + encodeURI(protocol + "//api.permutive.com/v1.1/px/track?k=" + publicKey + "&i=$UID&e=" + eventName + "&p=" + encodeURIComponent(JSON.stringify(eventProperties)) + "&it=appnexus&rand=" + Math.round(Math.random() * 1000000));
</script>


Second, the partner site needs to deploy the pixel on the conversion page of their site.

Note: We recommend that a developer tests this script before deploying.

Using This Data

Once you have collected this data in Permutive, let us know and we can set up custom reporting for you on the conversions and help you create segments of users who have/ haven't converted.

Did this answer your question?