Merge pull request #70 from Parsely/issue/33_69_extradata_in_engageme…

…nt_session
Parsely · Sep 15, 2023 · 7dab75f · 7dab75f
2 parents 91c7922 + 231f043
commit 7dab75f
Show file tree

Hide file tree

Showing 2 changed files with 21 additions and 2 deletions.
diff --git a/example/src/main/java/com/example/MainActivity.java b/example/src/main/java/com/example/MainActivity.java
@@ -2,6 +2,8 @@
 
 import java.util.ArrayList;
 import java.util.Calendar;
+import java.util.HashMap;
+import java.util.Map;
 import java.util.Timer;
 import java.util.TimerTask;
 
@@ -116,7 +118,9 @@ public void trackPageview(View view) {
     }
 
     public void startEngagement(View view) {
-        ParselyTracker.sharedInstance().startEngagement("http://example.com/article1.html", "http://example.com/");
+        final Map<String, Object> extraData = new HashMap<>();
+        extraData.put("product-id", "12345");
+        ParselyTracker.sharedInstance().startEngagement("http://example.com/article1.html", "http://example.com/", extraData);
         updateEngagementStrings();
     }
 

diff --git a/parsely/src/main/java/com/parsely/parselyandroid/ParselyTracker.java b/parsely/src/main/java/com/parsely/parselyandroid/ParselyTracker.java
@@ -243,6 +243,21 @@ public void trackPageview(
      * @param urlRef Referrer URL associated with this video view.
      */
     public void startEngagement(@NonNull String url, @Nullable String urlRef) {
+        startEngagement(url, urlRef, null);
+    }
+
+    /**
+     * Same as {@link #startEngagement(String, String)} but with extra data.
+     *
+     * @param url       The URL to track engaged time for.
+     * @param urlRef    Referrer URL associated with this video view.
+     * @param extraData A Map of additional information to send with the event.
+     */
+    public void startEngagement(
+            final @NonNull String url,
+            @Nullable String urlRef,
+            final @Nullable Map<String, Object> extraData
+    ) {
         if (url.equals("")) {
             throw new IllegalArgumentException("url cannot be null or empty.");
         }
@@ -255,7 +270,7 @@ public void startEngagement(@NonNull String url, @Nullable String urlRef) {
         stopEngagement();
 
         // Start a new EngagementTask
-        Map<String, Object> event = buildEvent(url, urlRef, "heartbeat", null, null);
+        Map<String, Object> event = buildEvent(url, urlRef, "heartbeat", null, extraData);
         engagementManager = new EngagementManager(timer, DEFAULT_ENGAGEMENT_INTERVAL_MILLIS, event);
         engagementManager.start();
     }