Track customers directly in PHP using Woopra's PHP SDK
The purpose of this SDK is to allow our customers who have servers running PHP to track their users by writing only PHP code. Tracking directly in PHP will allow you to decide whether you want to track your users:
- through the back-end: after configuring the tracker & identifying the user, add the optional parameter TRUE to the methods
push, and the PHP tracker will handle sending the data to Woopra by making HTTP Requests. By doing that, the client is never involved in the tracking process.
The best way to install Woopra/Woopra-php-sdk is using Composer
$ composer require woopra/woopra:dev-master
The first step is to setup the tracker SDK. To do so, import the woopra_tracker.php file then configure the tracker instance as follows (replace mybusiness.com with your website as registered on Woopra):
require_once('woopra_tracker.php'); // require_once('vendor/autoload.php'); // for composer installation $woopra = new WoopraTracker(array("domain" => "mybusiness.com"));
You can update your idle timeout (default: 30 seconds) by updating the timeout property in your WoopraTracker instance (NB: this could also have been done in the step above, by adding all the properties you wish to configure to the array):
$woopra->config(array("idle_timeout" => 15000)); // in milliseconds
If you don't want to keep the user online on Woopra when they don't commit any event between the last event and the idle_timeout, you can disable auto pings (auto ping only matters for front-end tracking).
$woopra->config(array("ping" => false)); // default is true
To add custom visitor properties, you should use the identify($user) function:
$woopra->identify(array( "name" => "User Name", "email" => "email@example.com", "company" => "User Business" ));
<head> ... <?php $woopra->track()->js_code(); ?> </head>
You can always track events through front-end later in the page. With all the previous steps done at once, it should look like:
<html> <head> ... <?php $woopra = new WoopraTracker($config); $woopra->identify($user)->track()->js_code(); ?> </head> <body> ... <?php $woopra->track("play", array( "artist" => "Dave Brubeck", "song" => "Take Five", "genre" => "Jazz" )); ?> ... </body> </html>
To track a custom event through back-end, just specify the additional parameter TRUE in the track() functions.
$woopra->track($event_name, $event_properties, TRUE);
If you identify the user after the last tracking event, don't forget to push() the update to Woopra:
$woopra->identify($user)->push(); //or, to push through back-end: $woopra->identify($user)->push(TRUE);
If you're only going to be tracking through the back-end, set the cookie (before the headers are sent):