Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

New Tracking API feature: &new_visit=1 lets you create new visits on demand #3951

Closed
mattab opened this issue May 23, 2013 · 9 comments
Closed

New Tracking API feature: &new_visit=1 lets you create new visits on demand #3951

mattab opened this issue May 23, 2013 · 9 comments
Assignees
@mattab
Labels
Enhancement For new feature suggestions that enhance Matomo's capabilities or add a new report, new API etc. Major Indicates the severity or impact or benefit of an issue is much higher than normal but not critical.
Milestone
1.12

Comments

@mattab
Copy link
Member

mattab commented May 23, 2013

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:

  • Intranet sites, where you know exactly who is using the computer, so you can trigger a new visit on each new login
  • Any system with a login system where you want to trigger new visit/user interactions within Piwik

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.
You can use the feature in Javascript such as:

_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
@mattab
Copy link
Member Author

mattab commented May 23, 2013

In 80721ac: Fixes #3951

@mattab
Copy link
Member Author

mattab commented May 23, 2013

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

@mattab
Copy link
Member Author

mattab commented May 23, 2013

Added a new FAQ: Piwik trigger new visits

@peterbo
Copy link
Contributor

peterbo commented May 23, 2013

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.

@mattab
Copy link
Member Author

mattab commented May 24, 2013

In 2bd91ec: 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:

_paq.push(["deleteCookies"]);
_paq.push("new_visit=1");

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

@mattab
Copy link
Member Author

mattab commented May 30, 2013

In 8e10521: Thanks Julien for the report! refs #3951
we shouldnt disable cookies when deleting cookies, these are two different things.

@mattab
Copy link
Member Author

mattab commented May 30, 2013

In 41a8af7: and the minified refs #3951
(note to self: we should have a unit test checking the minified version is matching original piwik.js)

@anonymous-matomo-user
Copy link

Is this the right technique to track as a new visit? When I'm setting

_paq.push(["appendToTrackingUrl", "new_visit=1"]);

Piwik tracks a new visitor, even it is a returning visitor. Seems to be a bug, right?

@mattab
Copy link
Member Author

mattab commented May 9, 2014

see also #5123 Tracker: new method setForceNewVisit() to force creation of a new visit

@mattab mattab added this to the 1.12 - The Great 1.x Backlog milestone Jul 8, 2014
@mattab mattab self-assigned this Jul 8, 2014
@mattab mattab mentioned this issue May 9, 2014
Closed
@mattab mattab mentioned this issue Sep 9, 2014
Closed
This was referenced Apr 23, 2022
Open
Open
This issue was closed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees

@mattab mattab

Labels
Enhancement For new feature suggestions that enhance Matomo's capabilities or add a new report, new API etc. Major Indicates the severity or impact or benefit of an issue is much higher than normal but not critical.
Projects
None yet
Milestone
1.12
Development

No branches or pull requests
3 participants
@mattab @peterbo @anonymous-matomo-user