Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP


New documentation: how to use the campaign feature to track newsletters #604

mattab opened this Issue · 7 comments

3 participants

Matthieu Aubry Anonymous Piwik user Anthon Pang
Matthieu Aubry
  • See new [Tracking Campaigns](
  • [URL Builder tool](
  • Official piwik campaign parameters names are now: pk_campaign and pk_kwd (consistent with cookie prefix, better than piwik_ prefix)
  • New FAQ: [“Does Piwik support Google Analytics campaign parameters (utm_campaign, utm_medium, utm_source, utm_term)?”](
  • New FAQ: [“How do I customize the Piwik Campaign parameters pk_campaign and pk_kwd?” ](
Matthieu Aubry

Very useful to track different visits from various medium, sources. For example on the page [great barrier reef]( a piwik user uses it to track twitter VS facebook VS standard search engine results VS adwords!

Anonymous Piwik user

hi, i searched for a way to track links from a newsletter this way an it does it fine for me!
but for a better presentation in actions/sites i use 'setCustomUrl' and then the paramter
?piwik_campaign won't work anymore. got any idea for a solution ?


Anthon Pang

heinetz: please don't use Trac for technical support questons. I believe I've answered your question in the forum already.

Matthieu Aubry

heinetz, see #1198

Matthieu Aubry

Documentation written by idw in #1164 (should be updated when all tickets from #1042 are done)


You can use campaigns to monitor how effective links you send out through things like your email list or twitter. Campaigns allow you to add an extra bit of information to any link you make to your site that will let Piwik recognize visitors who have followed that link.

For example, you launch a big marketing campaign for summer. Instead of sending out links you would send out a link to

Note: If the address you want to link to already includes a ? you should replace the ? before piwik_campaign with an &. For example: becomes becomes

You do not need to configure campaigns names in advance. Just use them in a link and visitors following those links will be tracked as campaign referrers and you will be able to monitor them in the Campaigns screen under the Referrers section of Piwik:


To add a little more precision to the tracking you can specify different channels for your campaign by adding a second parameter so your link might read

If you use keywords, you will be able to click on the name of the campaign to see the campaign referrers broken down by keyword. In this example, the summer campaign has had two visitors, one via the newsletter keyword and one with no keyword:


You will probably want to know more about your campaign visitors than just how many there were. The More metrics button, second from the left under the table and highlighted in red below, will help you understand what those visitors did on your site:


= Advanced Configuration =
If you would prefer not to have piwik_campaign and piwik_kwd in your links you can change the names of these parameters in Piwiks configuration file. Your Piwik installation will have a subdirectory called config and in that subdirectory is a file called config.ini.php. If you add the following lines to the bottom of that file then you will be able to use x and y in place of piwik_campaign and piwik_kwd:

campaign_var_name = x
campaign_keyword_var_name = y

You do not have to use x and y. You can use whatever is convenient for you.

Matthieu Aubry

(In [4571]) Fixes #604, #1042

Matthieu Aubry
Matthieu Aubry mattab added this to the 1.x - Piwik 1.x milestone
This issue was closed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Something went wrong with that request. Please try again.