Opened 5 years ago

Closed 3 years ago

Last modified 3 years ago

#604 closed New feature (fixed)

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

Reported by: matt Owned by:
Priority: major Milestone: 1.x - Piwik 1.x
Component: Documentation Keywords:
Cc: Sensitive: no

Description (last modified by matt)

Change History (13)

comment:1 Changed 5 years ago by matt (mattab)

  • Description modified (diff)

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!

comment:2 Changed 5 years ago by matt (mattab)

  • Component changed from Core to Documentation

comment:3 Changed 5 years ago by skeeper

comment:4 Changed 5 years ago by albass

comment:5 Changed 5 years ago by domtop

comment:6 Changed 4 years ago by 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

comment:7 Changed 4 years ago by vipsoft (robocoder)

  • Sensitive unset

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

comment:8 Changed 4 years ago by matt (mattab)

heinetz, see #1198

comment:9 Changed 4 years ago by matt (mattab)

  • Milestone changed from 3 - Piwik 0.9 - Surviving The Wild to 4 - Piwik 1.0 - Stable release
  • Type changed from Bug to New feature

comment:10 Changed 3 years ago by matt (mattab)

  • Milestone changed from 1.1 - Piwik 1.1 to Piwik 1.x

comment:11 Changed 3 years ago by matt (mattab)

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:

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.

comment:12 Changed 3 years ago by matt (mattab)

  • Resolution set to fixed
  • Status changed from new to closed

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

comment:13 Changed 3 years ago by matt (mattab)

  • Description modified (diff)
Note: See TracTickets for help on using tickets.