Piwik\Plugins\ExampleTracker\Columns\ExampleVisitDimension::onNewVisit PHP Method

onNewVisit() public method

The onNewVisit method is triggered when a new visitor is detected. This means here you can define an initial value for this user. By returning boolean false no value will be saved. Once the user makes another action the event "onExistingVisit" is executed. That means for each visitor this method is executed once. If you do not want to perform any action on a new visit you can just remove this method.
public onNewVisit ( Request $request, Piwik\Tracker\Visitor $visitor, Action | null $action ) : mixed | false
$request Piwik\Tracker\Request
$visitor Piwik\Tracker\Visitor
$action Piwik\Tracker\Action | null
return mixed | false
    public function onNewVisit(Request $request, Visitor $visitor, $action)
    {
        if (empty($action)) {
            return 0;
        }
        return 1;
        // you could also easily save any custom tracking url parameters
        // return Common::getRequestVar('myCustomTrackingParam', 'default', 'string', $request->getParams());
        // return Common::getRequestVar('linuxversion', false, 'string', $request->getParams());
    }