[SDK-1001] Add consent debug settings support

CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## Changelog
 
+### v2.2.0 (TBD)
+
++ Added debug geography override support: `SetDebugSettings()` method, `ConsentDebugSettings` class and `ConsentDebugGeography` enum
++ Bumped `com.appodeal.mediation` dependency to v4.4.0
+
 ### v2.1.0 (June 23, 2026)
 
 + Added Privacy Options Form support: `ShowPrivacyOptionsForm()` method and `PrivacyOptionsStatus` property

Runtime/Api/ConsentDebugSettings.cs

@@ -0,0 +1,16 @@
+// ReSharper disable CheckNamespace
+
+using System;
+using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
+
+namespace AppodealStack.Cmp
+{
+    [Serializable]
+    [SuppressMessage("ReSharper", "NotAccessedField.Global")]
+    public sealed class ConsentDebugSettings
+    {
+        public ConsentDebugGeography Geography;
+        public List<string> TestDeviceIds;
+    }
+}

Runtime/Api/ConsentManager.cs

@@ -9,7 +9,7 @@ namespace AppodealStack.Cmp
     [SuppressMessage("ReSharper", "UnusedMember.Global")]
     public static class ConsentManager
     {
-        private const string Version = "2.1.0";
+        private const string Version = "2.2.0";
 
         private static readonly Lazy<IConsentManager> Lazy = new Lazy<IConsentManager>(() => new ConsentManagerClient());
         public static IConsentManager Instance { get => Lazy.Value; }

Runtime/Api/Enums/ConsentDebugGeography.cs

@@ -0,0 +1,14 @@
+// ReSharper disable CheckNamespace
+
+using System.Diagnostics.CodeAnalysis;
+
+namespace AppodealStack.Cmp
+{
+    [SuppressMessage("ReSharper", "UnusedMember.Global")]
+    public enum ConsentDebugGeography
+    {
+        Eea,
+        RegulatedUsState,
+        Other,
+    }
+}

Runtime/Api/Interfaces/IConsentManager.cs

@@ -19,6 +19,7 @@ public interface IConsentManager
 
         void Load();
         void LoadAndShowConsentFormIfRequired();
+        void SetDebugSettings(ConsentDebugSettings debugSettings);
         void RequestConsentInfoUpdate(ConsentInfoParameters consentInfoParameters);
         void ShowPrivacyOptionsForm();
         void Revoke();

Runtime/Api/Internal/ConsentManagerClient.cs

@@ -41,6 +41,8 @@ internal ConsentManagerClient()
 
         public void LoadAndShowConsentFormIfRequired() => _consentManagerImpl?.LoadAndShowConsentFormIfRequired();
 
+        public void SetDebugSettings(ConsentDebugSettings debugSettings) => _consentManagerImpl?.SetDebugSettings(debugSettings);
+
         public void RequestConsentInfoUpdate(ConsentInfoParameters consentInfoParameters) => _consentManagerImpl?.RequestConsentInfoUpdate(consentInfoParameters);
 
         public void ShowPrivacyOptionsForm() => _consentManagerImpl?.ShowPrivacyOptionsForm();

Runtime/Platforms/Android/AndroidCmpJavaHelper.cs

@@ -109,6 +109,31 @@ public static AndroidJavaObject GetConsentInfoParametersJavaObject(ConsentInfoPa
             );
         }
 
+        public static AndroidJavaObject GetConsentDebugSettingsJavaObject(ConsentDebugSettings debugSettings)
+        {
+            if (debugSettings == null) return null;
+
+            var geography = new AndroidJavaClass("com.appodeal.consent.ConsentDebugGeography").GetStatic<AndroidJavaObject>(GetJavaGeographyName(debugSettings.Geography));
+            var testDeviceIds = new AndroidJavaObject("java.util.ArrayList");
+            foreach (string testDeviceId in (debugSettings.TestDeviceIds ?? Enumerable.Empty<string>()).Where(id => !String.IsNullOrEmpty(id)))
+            {
+                testDeviceIds.Call<bool>("add", testDeviceId);
+            }
+
+            return new AndroidJavaObject("com.appodeal.consent.ConsentDebugSettings", geography, testDeviceIds);
+        }
+
+        private static string GetJavaGeographyName(ConsentDebugGeography geography)
+        {
+            return geography switch
+            {
+                ConsentDebugGeography.Eea => "EEA",
+                ConsentDebugGeography.RegulatedUsState => "REGULATED_US_STATE",
+                ConsentDebugGeography.Other => "OTHER",
+                _ => throw new ArgumentOutOfRangeException(nameof(geography), geography, "value must be assignable to ConsentDebugGeography")
+            };
+        }
+
         private static object GetJavaObject(object value)
         {
             return value switch

Runtime/Platforms/Android/AndroidConsentManager.cs

@@ -86,6 +86,11 @@ public void LoadAndShowConsentFormIfRequired()
             );
         }
 
+        public void SetDebugSettings(ConsentDebugSettings debugSettings)
+        {
+            _consentManagerJavaClass?.CallStatic("setDebugSettings", AndroidCmpJavaHelper.GetConsentDebugSettingsJavaObject(debugSettings));
+        }
+
         public void RequestConsentInfoUpdate(ConsentInfoParameters consentInfoParameters)
         {
             var paramsJavaObject = AndroidCmpJavaHelper.GetConsentInfoParametersJavaObject(consentInfoParameters);

Runtime/Platforms/Dummy/DummyConsentManager.cs

@@ -25,6 +25,8 @@ public event EventHandler<ConsentFormDismissedEventArgs> OnConsentFormDismissed
 
         public void LoadAndShowConsentFormIfRequired() => DisplayUnsupportedPlatformWarning();
 
+        public void SetDebugSettings(ConsentDebugSettings debugSettings) => DisplayUnsupportedPlatformWarning();
+
         public void RequestConsentInfoUpdate(ConsentInfoParameters consentInfoParameters) => DisplayUnsupportedPlatformWarning();
 
         public void ShowPrivacyOptionsForm() => DisplayUnsupportedPlatformWarning();

Runtime/Platforms/Editor/EditorConsentManager.cs

@@ -80,6 +80,11 @@ public void LoadAndShowConsentFormIfRequired()
             editorConsentForm.Show();
         }
 
+        public void SetDebugSettings(ConsentDebugSettings debugSettings)
+        {
+            Debug.Log("[Appodeal CMP] Debug settings are applied on Android and iOS only, the Editor ignores them");
+        }
+
         public void RequestConsentInfoUpdate(ConsentInfoParameters consentInfoParameters)
         {
             _isConsentInfoRequested = true;

Runtime/Platforms/iOS/IosConsentManager.cs

@@ -3,6 +3,7 @@
 // ReSharper disable CheckNamespace
 
 using System;
+using System.Linq;
 using System.Runtime.InteropServices;
 using System.Diagnostics.CodeAnalysis;
 using AOT;
@@ -36,6 +37,23 @@ public void LoadAndShowConsentFormIfRequired()
             CmpConsentManagerLoadAndShowConsentFormIfRequired(ConsentFormDismissed);
         }
 
+        public void SetDebugSettings(ConsentDebugSettings debugSettings)
+        {
+            if (debugSettings == null)
+            {
+                CmpConsentManagerSetDebugSettings(-1, null);
+                return;
+            }
+
+            if (!Enum.IsDefined(typeof(ConsentDebugGeography), debugSettings.Geography))
+            {
+                throw new ArgumentOutOfRangeException(nameof(debugSettings.Geography), debugSettings.Geography, "value must be assignable to ConsentDebugGeography");
+            }
+
+            string testDeviceIds = debugSettings.TestDeviceIds == null ? "" : String.Join(",", debugSettings.TestDeviceIds.Where(id => !String.IsNullOrEmpty(id)));
+            CmpConsentManagerSetDebugSettings((int)debugSettings.Geography, testDeviceIds);
+        }
+
         public void RequestConsentInfoUpdate(ConsentInfoParameters consentInfoParameters)
         {
             var paramsStruct = IosConsentInfoParameters.FromDtoClass(consentInfoParameters);
@@ -79,6 +97,9 @@ ConsentFormLoadSucceededCallback onConsentFormLoadSucceeded
         [DllImport("__Internal", EntryPoint = "CMPUnityPluginConsentManagerShowPrivacyOptionsForm")]
         private static extern void CmpConsentManagerShowPrivacyOptionsForm(ConsentFormDismissedCallback onConsentFormDismissed);
 
+        [DllImport("__Internal", EntryPoint = "CMPUnityPluginConsentManagerSetDebugSettings")]
+        private static extern void CmpConsentManagerSetDebugSettings(int geography, string testDeviceIds);
+
         [DllImport("__Internal", EntryPoint = "CMPUnityPluginConsentManagerRequestConsentInfoUpdate")]
         private static extern void CmpConsentManagerRequestConsentInfoUpdate(
             IntPtr consentInfoParametersPtr,

Runtime/Plugins/iOS/CmpConsentManager.m

@@ -46,6 +46,20 @@ void CMPUnityPluginConsentManagerLoadAndShowConsentFormIfRequired(ConsentFormDis
     }];
 }
 
+void CMPUnityPluginConsentManagerSetDebugSettings(int geography, const char* testDeviceIds) {
+    APDConsentDebugGeography debugGeography;
+    switch (geography) {
+        case 0:  debugGeography = APDConsentDebugGeographyEEA; break;
+        case 1:  debugGeography = APDConsentDebugGeographyRegulatedUSState; break;
+        case 2:  debugGeography = APDConsentDebugGeographyOther; break;
+        default: APDConsentManager.shared.debugSettings = nil; return;
+    }
+
+    NSString* joinedTestDeviceIds = testDeviceIds ? [NSString stringWithUTF8String:testDeviceIds] : @"";
+    NSArray<NSString*>* ids = joinedTestDeviceIds.length > 0 ? [joinedTestDeviceIds componentsSeparatedByString:@","] : @[];
+    APDConsentManager.shared.debugSettings = [[APDConsentDebugSettings alloc] initWithGeography:debugGeography testDeviceIds:ids];
+}
+
 void CMPUnityPluginConsentManagerRequestConsentInfoUpdate(CMPUnityPluginConsentInfoParameters consentInfoParameters,
                                                           ConsentInfoUpdateFailedCallback updateFailedCallback,
                                                           ConsentInfoUpdateSucceededCallback updateSucceededCallback) {

Samples~/UsageSample/AppodealCmpDemo.cs

@@ -94,6 +94,10 @@ public void RequestConsentInfoUpdate()
 
             Debug.Log($"[Appodeal CMP] init params: {parameters.ToJsonString()}");
 
+            var debugSettings = new ConsentDebugSettings { Geography = ConsentDebugGeography.Eea };
+            Debug.Log($"[Appodeal CMP] SetDebugSettings() method called, geography: {debugSettings.Geography}");
+            ConsentManager.Instance.SetDebugSettings(debugSettings);
+
             ConsentManager.Instance.RequestConsentInfoUpdate(parameters);
         }
 

package.json

@@ -1,12 +1,12 @@
 {
   "name": "com.appodeal.cmp",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "displayName": "Appodeal CMP",
   "description": "A Consent Management Platform (CMP) is a software that develops notices to inform users and capture their preferences with respect to the processing of their personal data.",
   "unity": "2021.3",
   "documentationUrl": "https://docs.appodeal.com/unity/data-protection/gdpr-and-ccpa",
   "dependencies": {
-    "com.appodeal.mediation": "4.2.0"
+    "com.appodeal.mediation": "4.4.0"
   },
   "keywords": [
     "CMP",