Introduction: What is a Conversion Point

Ongage conversion points are used to track post click conversions on a website for example, to where the recipients of your email message arrived to, after they clicked on a link in the email message you sent them:

When the thank-you page loads, the pixel fires, reporting back to the Ongage platform (via an HTTP call), about the conversion, for that specific contact.

Example of conversion points are:

Once implemented, you can then get email campaign stats that include conversion numbers, just like you have stats for opens and clicks, you can have stats of number of registrations for example. Similarly you'll be able to segment based on these behavioral conversions, just like one does with opens and clicks.

Conversion Points: Basic Technical Notes

  1. You can setup up to 5 conversion points per List.
  2. Ongage conversion pixels can be implemented either as client side or sever side – both are supported.
  3. It takes on average about 20 minutes for a conversion pixel to be processed from the time the Ongage platform receives it.

Conversion Point Pixel Overview

(info) Go to List → Conversion Points menu item in order to define and setup conversion point pixels

An Ongage conversion point pixel looks like this: 


The following parameters are passed back on the conversion pixel:

  1. Email {{email}}  --or-- Encoded Email {{ocx_email_hash}} in order to associate the conversion with that recipient email.
  2. CID (AKA Campaign ID) {{ocx_mailing_id}} in order for the conversion stat to get associated with that campaign.
  3. (Optional) value: send back a value associated with conversion. For example if the conversion is a purchase you can send back the value of the purchase.
    1. (warning) The value must be an integer. I.e., if the purchase value on your website was $24.99, then pass here in the conversion URL &xv=2499

Your conversion pixel needs to be implement on the post-conversion page of your website (e.g. the thank-you page of a registration or purchase). For more details see below.

How to Implement an Ongage Conversion Point Pixel

  1. Go to List → Conversion Points  and click on "New Conversion Point"

    And fill in the following:

    1. If you'd like to also pass back a value and get sum of that value in the aggregate report – check the "Save sum of value in stats" option. 
      This is particularly useful to get a sum total of all purchases for a given campaign, figure out earnings per thousand emails, etc. 
    2. In addition you can save the values to a list field by clicking the "Save value to member list field" option.
  2. Copy the conversion pixel URL, from your Ongage account
  3. Place the conversion pixel on the post conversion page of your website
    1. For example: Let's say the conversion is "Registration", on the thank-you page following the registration form, place the pixel URL you got from the above dashboard
    2. See below details for how to implement the pixel on the post-conversion page
  4. When setting up a email campaign, in the Email editor add the following dynamic fields to the relevant links in your email, that sends the recipients to the landing page where they'll be converting:

    1. Dynamic field: {{email}}

    2. System field: {{ocx_mailing_id}}

    3. So the link will look something like this: http://my-landing-page/?email={{email}}&cid={{ocx_mailing_id}}

How to implement the conversion pixel on the post conversion point page 

Your website programmer will be required to capture the values of the variables that arrived on the link to the landing page, and pass them back on the pixel that you'll fire on the post conversion page. For example:

// Capture the variables on the landing page
   $email = $_GET['email'];
   $cid  = $_GET['cid'];
// Pass on the values to the post conversion page and populate the pixel with the values, that the recipient arrived with
// This is an example of a client side pixel that you'd plant in the post-conversion page
// When this page loads, the following pixel will load and send back the conversion data back to Ongage
<img src="<?php echo $_GET['email']?>&xc=<?php echo $_GET['cid']?>" width="1" height="1" >

How to Implement Email Encryption  

Sending a encrypted email address in both the email message and then back on the conversion pixel

This does not require any programming! Simply do the following:

  1. On the link in the email message send {{ocx_email_hash}} instead of {{email}}
    e.g.,  http://my-landing-page/?email={{ocx_email_hash}}&cid={{ocx_mailing_id}}
  2. Capture the hashed email on your website, just like you would capture a regular email
    I.e., $enc_email = $_GET['email'];

  3. Send back the encoded email as is, on the pixel, just use &xih parameter instead of &xi


If you only need to send an encrypted email address back on the conversion pixel

The following is what your programmer will need to implement if you want the email addresses that are passed back on the conversion pixel to be encrypted.

The method

The Private/Public key encryption is a secure method to encrypt data that needs to be decrypted afterwards.
The way it works is that our system generates a key which you use to encrypt your data, in this case, the email address.
This key is the public key
Once the encrypted data arrives to our servers we decrypt it with our Private key which is known only to us.

How to use it:

In order to user the public key to encrypt your data you need to run a command with the public key that you copy form the UI as one of the parameters.
The results should be put in the email field of the parameter “xih” in the URL: &xih=encoded_email

Example of PHP code that does that:

// this is a sample of public key as taken from Ongage UI
$pub = '-----BEGIN PUBLIC KEY-----
-----END PUBLIC KEY-----';
// the data to be encoded
$data = '';
// call the encoding function. $enc is returned by reference
openssl_public_encrypt($data, $enc, $pub);
// make the encoded email usable by base64-encoding it
$encoded_email = base64_encode($enc);