SEE FAQ for How to instructions! http://piwik.org/faq/how-to/#faq_187
This is a very powerful feature for many of you :)
This feature lets Piwik users manually tell Piwik to create new visits when it suits, using the &new_visit=1 Tracking API parameter.
Use cases for this small but great new feature:
The unique visitor stats will be more accurate, if you are able to use this feature when users of your website/system logout and login.
This feature is of course protected, by default it requires admin token_auth.
_paq.push(["deleteCookies"]); _paq.push(['appendToTrackingUrl', 'new_visit=1']);
To enable this feature, you must configure your config.ini.php:
[Tracker] new_visit_api_requires_admin = 0
Also, you may use the "Custom Visitor ID" feature via '&cid=' and pass it 16 hexa character ID. To enable &cid= you must set [Tracker]tracking_requests_require_authentication=0 in the config file.
Then you can create visits on demand, and set custom visitor ID to each.
As part of: #3490 we will make this even better
Hi Matt! There is a small Bug left:
Flow: A Visitor visits a Site (Visitor A) -> The new visitor mechanism is triggered with new_visit=1 (Visitor B) -> The next Pageview (without new_visit=1) should be attributed to Visitor B but is attributed to Visitor A.
In 2bd91ecbb4b0084192390d94a19b241449c3cc3a: Fixes #3951
cheers Peter for finding this bad bug!
The new deleteCookies function can be used, whenever new_visit=1 is used, to ensure the cookies are re-created for the new visitor.
For example use as:
put both at the same time. Make sure you remove the "deleteCookies" otherwise. This should fix it! I have updated the faq at http://piwik.org/faq/how-to/#faq_187
In 8e105211af8359dbf5f22e0dfa5ed89d3da52c96: Thanks Julien for the report! refs #3951
we shouldnt disable cookies when deleting cookies, these are two different things.
In 41a8af7ddaa118208a3625b0ccfa7bf97012eca9: and the minified refs #3951
(note to self: we should have a unit test checking the minified version is matching original piwik.js)
Is this the right technique to track as a new visit? When I'm setting
Piwik tracks a new visitor, even it is a returning visitor. Seems to be a bug, right?
see also #5123 Tracker: new method setForceNewVisit() to force creation of a new visit