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

[matt]

• 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?"

[heinetz]

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

[vipsoft]

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

[matt]

heinetz, see #1198

[matt]

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 Piwik’s 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.

[matt]

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

• See new Tracking Campaigns doc at: http://piwik.org/docs/tracking-campaigns/
• URL Builder tool: http://piwik.org/docs/tracking-campaigns/url-builder/
• Adds links to the tracking campaigns & URL builder directly on the Campaigns report in Piwik.
• 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

[matt]

• 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?"