Add option for session_id and engagement_time_msec params in events

Author: aawnu

src/Facade/Type/DefaultEventParamsType.php

@@ -44,5 +44,25 @@ public function setPageTitle(string $title);
      */
     public function setScreenResolution(string $wxh);
 
+    /**
+     * In order for user activity to display in reports like Realtime, \
+     * "session_id" must be supplied as part of the params for an event. \
+     * The "session_id" is supplied from the reserved "session_start" event.
+     *
+     * @var session_id
+     * @param string $id eg. "123"
+     */
+    public function setSessionId(string $id);
+
+    /**
+     * In order for user activity to display in reports like Realtime, \
+     * "engagement_time_msec" must be supplied as part of the params for an event. \
+     * The "engagement_time_msec" parameter should reflect the event's engagement time in milliseconds.
+     *
+     * @var engagement_time_msec
+     * @param string $msec eg. '150' for 150 milliseconds
+     */
+    public function setEngagementTimeMSec(int $msec);
+
     public function toArray(): array;
 }

src/Helper/EventHelper.php

@@ -15,6 +15,9 @@ abstract class EventHelper extends IOHelper implements EventType
     protected null|string $page_title;
     protected null|string $screen_resolution;
 
+    protected null|string $session_id;
+    protected null|int $engagement_time_msec;
+
     protected array $campaign = [];
 
     public function setLanguage(string $lang)
@@ -60,6 +63,18 @@ public function setEventPage(DefaultEventParamsType $page)
         return $this;
     }
 
+    public function setSessionId(string $id)
+    {
+        $this->session_id = $id;
+        return $this;
+    }
+
+    public function setEngagementTimeMSec(int $msec)
+    {
+        $this->engagement_time_msec = $msec;
+        return $this;
+    }
+
     public function toArray(): array
     {
         $return = [];