feat: add first session delay feature

uerceg · uerceg · commit 8838e7b381c1 · 2025-04-17T14:30:08.000+02:00
diff --git a/Assets/Adjust/Native/iOS/AdjustUnity.mm b/Assets/Adjust/Native/iOS/AdjustUnity.mm
@@ -103,6 +103,7 @@ void _AdjustInitSdk(
         int isCostDataInAttributionEnabled,
         int isDeviceIdsReadingOnceEnabled,
         int isAppTrackingTransparencyUsageEnabled,
+        int isFirstSessionDelayEnabled,
         int isDeferredDeeplinkOpeningEnabled,
         AdjustDelegateAttributionCallback attributionCallback,
         AdjustDelegateEventSuccessCallback eventSuccessCallback,
@@ -209,6 +210,13 @@ void _AdjustInitSdk(
             }
         }
 
+        // first session delay
+        if (isFirstSessionDelayEnabled != -1) {
+            if ((BOOL)isFirstSessionDelayEnabled == YES) {
+                [adjustConfig enableFirstSessionDelay];
+            }
+        }
+
         // deduplication IDs max number
         if (eventDeduplicationIdsMaxSize != -1) {
             [adjustConfig setEventDeduplicationIdsMaxSize:eventDeduplicationIdsMaxSize];
@@ -827,6 +835,25 @@ void _AdjustVerifyAndTrackAppStorePurchase(
         }];
     }
 
+    void _AdjustEndFirstSessionDelay() {
+        [Adjust endFirstSessionDelay];
+    }
+
+    void _AdjustEnableCoppaComplianceInDelay() {
+        [Adjust enableCoppaComplianceInDelay];
+    }
+
+    void _AdjustDisableCoppaComplianceInDelay() {
+        [Adjust disableCoppaComplianceInDelay];
+    }
+
+    void _AdjustSetExternalDeviceIdInDelay(const char* externalDeviceId) {
+        if (externalDeviceId != NULL) {
+            NSString *strExternalDeviceId = [NSString stringWithUTF8String:externalDeviceId];
+            [Adjust setExternalDeviceIdInDelay:strExternalDeviceId];
+        }
+    }
+
     void _AdjustSetTestOptions(const char* overwriteUrl,
                                const char* extraPath,
                                long timerIntervalInMilliseconds,
diff --git a/Assets/Adjust/Scripts/Adjust.cs b/Assets/Adjust/Scripts/Adjust.cs
@@ -714,6 +714,102 @@ public static void VerifyAndTrackPlayStorePurchase(
 #endif
         }
 
+        public static void EndFirstSessionDelay()
+        {
+            if (IsEditor())
+            {
+                return;
+            }
+
+#if UNITY_IOS
+            AdjustiOS.EndFirstSessionDelay();
+#elif UNITY_ANDROID
+            AdjustAndroid.EndFirstSessionDelay();
+#else
+            Debug.Log(errorMsgPlatform);
+#endif
+        }
+
+        public static void EnableCoppaComplianceInDelay()
+        {
+            if (IsEditor())
+            {
+                return;
+            }
+
+#if UNITY_IOS
+            AdjustiOS.EnableCoppaComplianceInDelay();
+#elif UNITY_ANDROID
+            AdjustAndroid.EnableCoppaComplianceInDelay();
+#else
+            Debug.Log(errorMsgPlatform);
+#endif
+        }
+
+        public static void DisableCoppaComplianceInDelay()
+        {
+            if (IsEditor())
+            {
+                return;
+            }
+
+#if UNITY_IOS
+            AdjustiOS.DisableCoppaComplianceInDelay();
+#elif UNITY_ANDROID
+            AdjustAndroid.DisableCoppaComplianceInDelay();
+#else
+            Debug.Log(errorMsgPlatform);
+#endif
+        }
+
+        public static void EnablePlayStoreKidsComplianceInDelay()
+        {
+            if (IsEditor())
+            {
+                return;
+            }
+
+#if UNITY_IOS
+            Debug.Log("[Adjust]: Play Store kids feature is only supported for Android platform.");
+#elif UNITY_ANDROID
+            AdjustAndroid.EnablePlayStoreKidsComplianceInDelay();
+#else
+            Debug.Log(errorMsgPlatform);
+#endif
+        }
+
+        public static void DisablePlayStoreKidsComplianceInDelay()
+        {
+            if (IsEditor())
+            {
+                return;
+            }
+
+#if UNITY_IOS
+            Debug.Log("[Adjust]: Play Store kids feature is only supported for Android platform.");
+#elif UNITY_ANDROID
+            AdjustAndroid.DisablePlayStoreKidsComplianceInDelay();
+#else
+            Debug.Log(errorMsgPlatform);
+#endif
+        }
+
+        public static void SetExternalDeviceIdInDelay(string externalDeviceId)
+        {
+            if (IsEditor())
+            {
+                return;
+            }
+
+#if UNITY_IOS
+            AdjustiOS.SetExternalDeviceIdInDelay(externalDeviceId);
+#elif UNITY_ANDROID
+            AdjustAndroid.SetExternalDeviceIdInDelay(externalDeviceId);
+#else
+            Debug.Log(errorMsgPlatform);
+#endif
+        }
+
         private static bool IsEditor()
         {
 #if UNITY_EDITOR
diff --git a/Assets/Adjust/Scripts/AdjustAndroid.cs b/Assets/Adjust/Scripts/AdjustAndroid.cs
@@ -127,6 +127,15 @@ public static void InitSdk(AdjustConfig adjustConfig)
                 }
             }
 
+            // check if first session delay has been enabled
+            if (adjustConfig.IsFirstSessionDelayEnabled != null)
+            {
+                if (adjustConfig.IsFirstSessionDelayEnabled == true)
+                {
+                    ajoAdjustConfig.Call("enableFirstSessionDelay");
+                }
+            }
+
             // check if user has set custom preinstall file path
             if (adjustConfig.PreinstallFilePath != null)
             {
@@ -396,10 +405,14 @@ public static void ProcessDeeplink(AdjustDeeplink deeplink)
             using (AndroidJavaObject ajoUri = ajcUri.CallStatic<AndroidJavaObject>("parse", deeplink.Deeplink))
             using (AndroidJavaObject ajoAdjustDeeplink = new AndroidJavaObject("com.adjust.sdk.AdjustDeeplink", ajoUri))
             {
-                using (AndroidJavaObject ajoReferrer = ajcUri.CallStatic<AndroidJavaObject>("parse", deeplink.Referrer))
+                if (deeplink.Referrer != null)
                 {
-                    ajoAdjustDeeplink.Call("setReferrer", ajoReferrer);
+                    using (AndroidJavaObject ajoReferrer = ajcUri.CallStatic<AndroidJavaObject>("parse", deeplink.Referrer))
+                    {
+                        ajoAdjustDeeplink.Call("setReferrer", ajoReferrer);
+                    }
                 }
+
                 ajcAdjust.CallStatic("processDeeplink", ajoAdjustDeeplink, ajoCurrentActivity);
             }
         }
@@ -580,6 +593,38 @@ public static void GetAttribution(Action<AdjustAttribution> onAttributionRead)
             ajcAdjust.CallStatic("getAttribution", onAttributionReadProxy);
         }
 
+        public static void GetSdkVersion(Action<string> onSdkVersionRead) 
+        {
+            SdkVersionReadListener onSdkVersionReadProxy = new SdkVersionReadListener(onSdkVersionRead, sdkPrefix);
+            ajcAdjust.CallStatic("getSdkVersion", onSdkVersionReadProxy);
+        }
+
+        public static void GetLastDeeplink(Action<string> onLastDeeplinkRead) 
+        {
+            LastDeeplinkListener onLastDeeplinkReadProxy = new LastDeeplinkListener(onLastDeeplinkRead);
+            ajcAdjust.CallStatic("getLastDeeplink", ajoCurrentActivity, onLastDeeplinkReadProxy);
+        }
+
+        public static void EndFirstSessionDelay()
+        {
+            ajcAdjust.CallStatic("endFirstSessionDelay");
+        }
+
+        public static void EnableCoppaComplianceInDelay()
+        {
+            ajcAdjust.CallStatic("enableCoppaComplianceInDelay");
+        }
+
+        public static void DisableCoppaComplianceInDelay()
+        {
+            ajcAdjust.CallStatic("disableCoppaComplianceInDelay");
+        }
+
+        public static void SetExternalDeviceIdInDelay(string externalDeviceId)
+        {
+            ajcAdjust.CallStatic("setExternalDeviceIdInDelay", externalDeviceId);
+        }
+
         // android specific methods
         public static void GetGoogleAdId(Action<string> onDeviceIdsRead) 
         {
@@ -593,18 +638,6 @@ public static void GetAmazonAdId(Action<string> onAmazonAdIdRead)
             ajcAdjust.CallStatic("getAmazonAdId", ajoCurrentActivity, onAmazonAdIdReadProxy);
         }
 
-        public static void GetSdkVersion(Action<string> onSdkVersionRead) 
-        {
-            SdkVersionReadListener onSdkVersionReadProxy = new SdkVersionReadListener(onSdkVersionRead, sdkPrefix);
-            ajcAdjust.CallStatic("getSdkVersion", onSdkVersionReadProxy);
-        }
-
-        public static void GetLastDeeplink(Action<string> onLastDeeplinkRead) 
-        {
-            LastDeeplinkListener onLastDeeplinkReadProxy = new LastDeeplinkListener(onLastDeeplinkRead);
-            ajcAdjust.CallStatic("getLastDeeplink", ajoCurrentActivity, onLastDeeplinkReadProxy);
-        }
-
         public static void VerifyPlayStorePurchase(
             AdjustPlayStorePurchase purchase,
             Action<AdjustPurchaseVerificationResult> verificationInfoCallback)
@@ -625,6 +658,14 @@ public static void ProcessAndResolveDeeplink(AdjustDeeplink deeplink, Action<str
             using (AndroidJavaObject ajoUri = ajcUri.CallStatic<AndroidJavaObject>("parse", deeplink.Deeplink))
             using (AndroidJavaObject ajoAdjustDeeplink = new AndroidJavaObject("com.adjust.sdk.AdjustDeeplink", ajoUri))
             {
+                if (deeplink.Referrer != null)
+                {
+                    using (AndroidJavaObject ajoReferrer = ajcUri.CallStatic<AndroidJavaObject>("parse", deeplink.Referrer))
+                    {
+                        ajoAdjustDeeplink.Call("setReferrer", ajoReferrer);
+                    }
+                }
+
                 ajcAdjust.CallStatic(
                     "processAndResolveDeeplink",
                     ajoAdjustDeeplink,
@@ -697,6 +738,16 @@ public static void VerifyAndTrackPlayStorePurchase(
             }
         }
 
+        public static void EnablePlayStoreKidsComplianceInDelay()
+        {
+            ajcAdjust.CallStatic("enablePlayStoreKidsComplianceInDelay");
+        }
+
+        public static void DisablePlayStoreKidsComplianceInDelay()
+        {
+            ajcAdjust.CallStatic("disablePlayStoreKidsComplianceInDelay");
+        }
+
         // used for testing only
         public static void SetTestOptions(Dictionary<string, string> testOptions)
         {
diff --git a/Assets/Adjust/Scripts/AdjustConfig.cs b/Assets/Adjust/Scripts/AdjustConfig.cs
@@ -14,6 +14,7 @@ public class AdjustConfig
         public bool? IsDeviceIdsReadingOnceEnabled { get; set; }
         public bool? IsDeferredDeeplinkOpeningEnabled { get; set; }
         public bool? IsAppTrackingTransparencyUsageEnabled { get; set; }
+        public bool? IsFirstSessionDelayEnabled { get; set; }
         public bool? AllowSuppressLogLevel { get; private set; }
         public bool? IsDataResidency { get; private set; }
         public bool? ShouldUseSubdomains { get; private set; }
diff --git a/Assets/Adjust/Scripts/AdjustiOS.cs b/Assets/Adjust/Scripts/AdjustiOS.cs
@@ -64,6 +64,7 @@ private static extern void _AdjustInitSdk(
             int isCostDataInAttributionEnabled,
             int isDeviceIdsReadingOnceEnabled,
             int isAppTrackingTransparencyUsageEnabled,
+            int isFirstSessionDelayEnabled,
             int isDeferredDeeplinkOpeningEnabled,
             AdjustDelegateAttributionCallback attributionCallback,
             AdjustDelegateEventSuccessCallback eventSuccessCallback,
@@ -246,6 +247,18 @@ private static extern void _AdjustVerifyAndTrackAppStorePurchase(
             string jsonPartnerParameters,
             AdjustDelegatePurchaseVerificationCallback callback);
 
+        [DllImport("__Internal")]
+        private static extern void _AdjustEndFirstSessionDelay();
+
+        [DllImport("__Internal")]
+        private static extern void _AdjustEnableCoppaComplianceInDelay();
+
+        [DllImport("__Internal")]
+        private static extern void _AdjustDisableCoppaComplianceInDelay();
+
+        [DllImport("__Internal")]
+        private static extern void _AdjustSetExternalDeviceIdInDelay(string externalDeviceId);
+
         // public API
         public AdjustiOS() {}
 
@@ -271,6 +284,7 @@ public static void InitSdk(AdjustConfig adjustConfig)
             int isCostDataInAttributionEnabled = AdjustUtils.ConvertBool(adjustConfig.IsCostDataInAttributionEnabled);
             int isDeviceIdsReadingOnceEnabled = AdjustUtils.ConvertBool(adjustConfig.IsDeviceIdsReadingOnceEnabled);
             int isAppTrackingTransparencyUsageEnabled = AdjustUtils.ConvertBool(adjustConfig.IsAppTrackingTransparencyUsageEnabled);
+            int isFirstSessionDelayEnabled = AdjustUtils.ConvertBool(adjustConfig.IsFirstSessionDelayEnabled);
             int shouldUseSubdomains = AdjustUtils.ConvertBool(adjustConfig.ShouldUseSubdomains);
             int isDataResidency = AdjustUtils.ConvertBool(adjustConfig.IsDataResidency);
             appAttributionCallback = adjustConfig.AttributionChangedDelegate;
@@ -303,6 +317,7 @@ public static void InitSdk(AdjustConfig adjustConfig)
                 isCostDataInAttributionEnabled,
                 isDeviceIdsReadingOnceEnabled,
                 isAppTrackingTransparencyUsageEnabled,
+                isFirstSessionDelayEnabled,
                 isDeferredDeeplinkOpeningEnabled,
                 AttributionCallbackMonoPInvoke,
                 EventSuccessCallbackMonoPInvoke,
@@ -611,6 +626,26 @@ public static void VerifyAndTrackAppStorePurchase(
                 VerifyAndTrackCallbackMonoPInvoke);
         }
 
+        public static void EndFirstSessionDelay()
+        {
+            _AdjustEndFirstSessionDelay();
+        }
+
+        public static void EnableCoppaComplianceInDelay()
+        {
+            _AdjustEnableCoppaComplianceInDelay();
+        }
+
+        public static void DisableCoppaComplianceInDelay()
+        {
+            _AdjustDisableCoppaComplianceInDelay();
+        }
+
+        public static void SetExternalDeviceIdInDelay(string externalDeviceId)
+        {
+            _AdjustSetExternalDeviceIdInDelay(externalDeviceId);
+        }
+
         // used for testing only (don't use this in your app)
         public static void SetTestOptions(Dictionary<string, string> testOptions)
         {
diff --git a/Assets/Test/Scripts/CommandExecutor.cs b/Assets/Test/Scripts/CommandExecutor.cs
