From bf58a5e4d0809cd75d3e745b53c3df60261ba278 Mon Sep 17 00:00:00 2001
From: James Newman <james.newman@rokt.com>
Date: Thu, 3 Jul 2025 12:50:15 +1000
Subject: [PATCH 1/2] fix: Handle InstallReferrerClient crash

---
 .../src/main/java/com/mparticle/internal/MPUtility.java         | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/android-core/src/main/java/com/mparticle/internal/MPUtility.java b/android-core/src/main/java/com/mparticle/internal/MPUtility.java
index cb6f1ca5e..6e8efcc7f 100644
--- a/android-core/src/main/java/com/mparticle/internal/MPUtility.java
+++ b/android-core/src/main/java/com/mparticle/internal/MPUtility.java
@@ -593,7 +593,9 @@ public static Boolean isFirebaseAvailablePreV21() {
 
     public static boolean isInstallRefApiAvailable() {
         try {
+            Class.forName("com.android.installreferrer.api.InstallReferrerClient");
             Class.forName("com.android.installreferrer.api.InstallReferrerStateListener");
+            Class.forName("com.android.installreferrer.api.ReferrerDetails");
             return true;
         } catch (Exception ignored) {
         }

From 9f77df9d6d54e0de6c774983ff6fcaaba6b63097 Mon Sep 17 00:00:00 2001
From: James Newman <james.newman@rokt.com>
Date: Thu, 3 Jul 2025 12:56:49 +1000
Subject: [PATCH 2/2] Add testing documentation

---
 .../com/mparticle/InstallReferrerHelper.java  | 24 +++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/android-core/src/main/java/com/mparticle/InstallReferrerHelper.java b/android-core/src/main/java/com/mparticle/InstallReferrerHelper.java
index 46b01d90d..f36979c80 100644
--- a/android-core/src/main/java/com/mparticle/InstallReferrerHelper.java
+++ b/android-core/src/main/java/com/mparticle/InstallReferrerHelper.java
@@ -15,6 +15,30 @@
 import com.mparticle.internal.Logger;
 import com.mparticle.internal.MPUtility;
 
+/**
+ * Helper class to fetch install referrer via reflection.
+ * <p>
+ * To test the install referrer functionality:
+ * 1. Set test application `applicationId` to a real app's Play Store package name, e.g. "com.medium.reader".
+ * <p>
+ * 2. Ensure the app is fully uninstalled from the test device:
+ *    `adb uninstall com.medium.reader`
+ * <p>
+ * 3. Broadcast the test referrer to the Play Store. This will open the Play Store app:
+ *    `adb shell "am start -a android.intent.action.VIEW -d 'https://play.google.com/store/apps/details?id=com.medium.reader&referrer=utm_source%3Dgoogle%26utm_medium%3Dcpc%26utm_term%3Drunning%252Bshoes%26utm_content%3Dcontent%26utm_campaign%3Dpromo'"`
+ * <p>
+ * 4. Install the debug version of your test app.
+ * <p>
+ * 5. Launch the app and check the logs for the referrer:
+ *    `adb logcat -d | grep 'Install Referrer received'`
+ * <p>
+ * 6. Verify the referrer is logged in the test app's logs by checking for the utm_* parameters passed in during step 3.
+ *    e.g. `Install Referrer received: utm_source=google&utm_medium=cpc&utm_term=running%2Bshoes&utm_content=content&utm_campaign=promo`
+ *
+ * @see <a href="https://developer.android.com/reference/com/android/installreferrer/api/InstallReferrerClient">InstallReferrerClient</a>
+ * @see <a href="https://medium.com/@madicdjordje/how-to-test-the-play-store-install-referrer-api-78a63d59945b">How to Test the Play Store Install Referrer API</a>
+ * @noinspection JavadocLinkAsPlainText
+ */
 public class InstallReferrerHelper {
 
     @Nullable