Merge pull request #24 from ins0/feature/qt-param

Feature/qt param

src/Racecore/GATracking/Tracking/AbstractTracking.php

@@ -128,6 +128,9 @@ abstract class AbstractTracking
 
     private $customPayload = array();
 
+    // event queue time difference
+    private $queueTime;
+
     /**
      * Add Custom Tracking Payload Data send to Google
      * @param $key
@@ -196,6 +199,9 @@ public function getPackage()
             // content experiments
             'xid' => $this->experimentID,
             'xvar' => $this->experimentVariant,
+
+            // optional
+            'qt' => $this->queueTime,
         ));
 
         $package = $this->addCustomParameters($package);
@@ -209,6 +215,19 @@ public function getPackage()
         return $package;
     }
 
+    /**
+     * Set the Tracking Processing Time to pass the qt param within this tracking request
+     * ATTENTION!: Values greater than four hours may lead to hits not being processed.
+     *
+     * https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters#qt
+     *
+     * @param $milliseconds
+     */
+    public function setQueueTime($milliseconds)
+    {
+        $this->queueTime = $milliseconds;
+    }
+
     /**
      * Mark the Hit as Non Interactive
      *

test/Racecore/GATracking/Tracking/TrackingTest.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace Racecore\GATracking\Tracking;
+
+use Racecore\GATracking\AbstractGATrackingTest;
+
+/**
+ * Class TrackingTest
+ *
+ * @package       Racecore\GATracking\Tracking
+ */
+class TrackingTest extends AbstractGATrackingTest
+{
+    public function testCanSetTrackingProcessingTime()
+    {
+        $queueTime = 12345678;
+
+        $event = new Event();
+        $event->setEventCategory('foo');
+        $event->setEventAction('bar');
+        $event->setQueueTime($queueTime);
+
+        $package = $event->getPackage();
+        $this->assertEquals($queueTime, $package['qt']);
+    }
+}