How can I customize Piwik PRO campaign parameters?

Piwik PRO recognizes its own pk_* parameters and Google utm_* parameters.

There are six Piwik PRO’s parameters you can add to your URLs:

  • pk_campaign: the name for a campaign. For example, Winter_Promo. 
  • pk_source: helps you identify the advertiser, website, publication, and more. For example, Newsletter, Facebook, Google.
  • pk_medium: describes the medium used for advertising. For example, CPC, banner, sponsored_post.
  • pk_keyword: helps you identify paid search keywords. For example, free_bank_account.
  • pk_content: used to separate similar content within the same ad. For example, if you have a newsletter with two call-to-action buttons, you can tag each link for each button with a different pk_content parameter, and see which version is working better.
  • pk_cid: helps you differentiate campaigns using an ID number. For example, if you are using two similar creatives for Facebook, and want to see which one performs better, you can tag them with a different pk_cid parameter.

You can customize parameter names. For example, if you want to use a different campaign name than pk_campaign or a different keyword name than pk_keyword, you can do it with a simple method.

To change the name of a parameter, do the following step:

  1. In your tracking code, above the trackPageView() call, add the following code:
_paq.push(['setCampaignNameKey', 'new name']);
_paq.push(['setCampaignKeywordKey', 'new name']);
Was this article helpful?

Be the first to rate this article.

Technical Support

If you have any questions, drop us a line at

We’re happy to help!