Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Loading…

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

Closed
mattab opened this Issue · 7 comments

3 participants

@mattab
Owner
  • See new [Tracking Campaigns](http://piwik.org/docs/tracking-campaigns/)
  • [URL Builder tool](http://piwik.org/docs/tracking-campaigns/url-builder/)
  • 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)?”](http://piwik.org/faq/general/#faq_119)
  • New FAQ: [“How do I customize the Piwik Campaign parameters pk_campaign and pk_kwd?” ](http://piwik.org/faq/how-to/#faq_120)
@mattab
Owner

Very useful to track different visits from various medium, sources. For example on the page [great barrier reef](http://divezone.net/great-barrier-reef.htm) 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 ?

thanks,
best,
heinetz

@robocoder
Collaborator

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

@mattab
Owner

heinetz, see #1198

@mattab
Owner

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

Campaigns

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 http://example.org/ you would send out a link to http://example.org?piwik_campaign=summer.

Note: If the address you want to link to already includes a ? you should replace the ? before piwik_campaign with an &. For example:
http://example.org becomes http://example.org?piwik_campaign=summer
http://example.org?q=1 becomes http://example.org?q=1&piwik_campaign=summer

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:

SCREENSHOT SHOWING CAMPAIGN TABLE

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 http://example.org?piwik_campaign=summer&piwik_kwd=newsletter.

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:

SCREENSHOT SHOWING CAMPAIGN SUB TABLE

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:

SCREENSHOT SHOWING ADVANCED STATS SECOND ICON

= 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:

[Tracker]
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.

@mattab
Owner

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

@mattab
Owner
@mattab 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.