Can I include a campaign code or custom parameter in my Analytics reports?

Sometimes, one customer parameter just isn't enough. :)

With our custom parameter field, you can collect additional data about every open. You could use this field to include a campaign code, web analytics code, or another merge field from your messaging platform or email service provider (ESP).

Where does this data go?

When you've configured your tracking code to include an additional parameter and sent it out to your subscribers, the data will populate inside your individual-level report, in the "custom_type" field. (screenshots below.)

How can this parameter benefit me?

The quickest win is to use a single tracking code across all of your email sends, even if you have dozens or hundreds of campaigns running simultaneously. With the custom parameter, you can add a variable that will populate the custom_type field with a campaign-level unique identifier, and then automatically bring the data back to your organization via our FTP export.

With "global" analytics coverage across all of your sends, and the data automatically brought back to you, you can easily generate insightful client reports, track campaign effectiveness over time, and much more. (More resources at the bottom of this post.)

How do I set up my tracking code to supply this information?

When you create a new tracking code, start by choosing your ESP. This will add a default email merge tag as the unique user ID (UUID).  If you want to make sure you're not storing personally identifiable subscriber information, select "Other" as your ESP and enter an alternative merge tag as your UUID. 

In Step 2, you will be able to add as many custom parameters (i.e. merge tags like campaign ID, tags, etc.) as you would like. You will need to separate each custom data tag out with a plus sign (+) after each tag, for example: *|CAMPAIGN_UID|*+custom-data1+custom-data-2+custom-data-3

Here's an example of how your tracking code might look with custom parameters added:

In the expanded tracking code above, the individual-level email address merge tag appears in red. The green text is where your custom parameters will show up. 

Examples of custom parameters: 

  1. Static text (for example "JuneNews")
  2. Another merge tag that identifies the field from your ESP

You'll also want to be sure that you convert any spaces or special characters to their ASCII equivalents for proper URL encoding. For example, "&t=Café News" would become "&t=Caf%E9%20News". W3Schools also has a handy reference and tool you can use.

When you export your individual level tracking data, you'll see the additional custom parameters in the custom_type field in your CSV. (screenshot below)

Mailchimp Campaign UID example

Mailchimp provides a Campaign_UID that "Displays the unique ID from your campaign archive URL."

Here, we've inserted the listed merge tag, which is *|CAMPAIGN_UID|* into our tracking code:

Litmus tracking code (indented for clarity) configured to retrieve Mailchimp's campaign_uid.

On inserting this tracking code and sending out across several campaigns, here is what the individual-level report looks like:

Individual-level report with data in custom_type field.

These strings can be made meaningful by referring to Mailchimp's Campaign Archive page, to see which campaign has what UID.

Now, if you have an onboarding campaign, or want to track engagement and opens across many email campaigns, you can get all the data into a single tracking code, instead of creating new tracking codes for every campaign.

Once you're using a merge tag in this configuration, you can choose to receive our analytics data via FTP. Otherwise, you'll need to keep logging into your Litmus account, and re-exporting the file containing data in the Custom Campaign Type field.

To get FTP access, you'll need to be on an existing Pro plan or an Enterprise plan and then send us an email (hello@litmus.com) with server credentials, so we can send you that data. Complete this form to have someone get in touch about our Enterprise plans!

If you're using our Reseller API, you may export your raw data.

Additional resources:

Still need help? Contact Us Contact Us