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 on a 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

Provide the Client with Tracking Pixels

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. 
  • 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 a project which has public API key "f6515c49-5695-4b18-b0ed-6796643af237" we 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, we can set up custom reporting for you on the conversions, as well as help you create segments based on these events. 

Did this answer your question?