Merge pull request #103 from appodeal/release/3.5.2

DmitriiFeshchenko · web-flow · commit f7b50bb16232 · 2025-04-15T13:26:48.000+02:00
[APDM-1127] Release Appodeal Unity Plugin v3.5.2
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -4,6 +4,12 @@
 
 *The full changelog can always be obtained at [Appodeal website](https://docs.appodeal.com/unity/changelog).*
 
+### 3.5.2 (April 15, 2025)
+
++ Updated Appodeal Android SDK to v3.5.2
++ Updated Appodeal iOS SDK to v3.5.2
++ Implemented selective dispatch for `LogEvent` public API method
+
 ### 3.5.1 (April 01, 2025)
 
 + Updated Appodeal Android SDK to v3.5.1
diff --git a/Editor/DependencyManager/DefaultDependencies/AppodealDependencies.txt b/Editor/DependencyManager/DefaultDependencies/AppodealDependencies.txt
diff --git a/Runtime/Api/Appodeal.cs b/Runtime/Api/Appodeal.cs
@@ -722,18 +722,23 @@ public static double GetPredictedEcpmForPlacement(int adType, string placement)
         }
 
         /// <summary>
-        /// <para>Sends event data to all connected analytic services such as Firebase, Adjust, AppsFlyer and Facebook.</para>
+        /// Sends event data to selected analytic services such as Adjust, AppsFlyer, Facebook, or Firebase.<br/>
         /// See <see href="https://docs.appodeal.com/unity/advanced/event-tracking?distribution=upm#step-1-how-to-track-in-app-events"/> for more details.
         /// </summary>
+        /// <param name="eventName">the name of the event.</param>
+        /// <param name="eventParams">optional parameters associated with the event.</param>
+        /// <param name="services">target services to send the event to. Defaults to all connected services.</param>
         /// <remarks>
-        /// <para>Event parameter values must be one of the following types:  <see langword="string"/>, <see langword="double"/>, or <see langword="int"/></para>
-        /// If event has no params, call the shorten version of this method by passing only name of the event.
+        /// For the <c>eventParams</c> argument, every dictionary value should be either a <c>string</c>, <c>double</c>, or <c>int</c>.<br/>
+        /// Use the named argument <c>services:</c> if you want to specify target services while omitting the second optional argument.
         /// </remarks>
-        /// <param name="eventName">name of the event.</param>
-        /// <param name="eventParams">parameters of the event if any.</param>
-        public static void LogEvent(string eventName, Dictionary<string, object> eventParams = null)
+        /// <example>Send event to all connected services w/o params:<code>Appodeal.LogEvent("eventName");</code></example>
+        /// <example>Send event to all connected services w/ params:<code>Appodeal.LogEvent("eventName", eventParams);</code></example>
+        /// <example>Send event to a group of services w/o params:<code>Appodeal.LogEvent("eventName", services:AppodealService.AppsFlyer | AppodealService.Facebook);</code></example>
+        /// <example>Send event to a specific service w/ params:<code>Appodeal.LogEvent("eventName", eventParams, AppodealService.Adjust);</code></example>
+        public static void LogEvent(string eventName, Dictionary<string, object> eventParams = null, AppodealService services = AppodealService.All)
         {
-            GetInstance().LogEvent(eventName, eventParams);
+            GetInstance().LogEvent(eventName, eventParams, services);
         }
 
         /// <summary>
diff --git a/Runtime/Common/AppodealEnums.cs b/Runtime/Common/AppodealEnums.cs
@@ -1,5 +1,6 @@
 // ReSharper Disable CheckNamespace
 
+using System;
 using System.Diagnostics.CodeAnalysis;
 
 namespace AppodealStack.Monetization.Common
@@ -71,4 +72,14 @@ public enum MediationDebuggerProvider
     {
         AppLovinSdk,
     }
+
+    [Flags]
+    public enum AppodealService
+    {
+        Adjust = 1 << 0,
+        AppsFlyer = 1 << 1,
+        Facebook = 1 << 2,
+        Firebase = 1 << 3,
+        All = Adjust | AppsFlyer | Facebook | Firebase
+    }
 }
diff --git a/Runtime/Common/AppodealVersions.cs b/Runtime/Common/AppodealVersions.cs
@@ -12,7 +12,7 @@ namespace AppodealStack.Monetization.Common
     [SuppressMessage("ReSharper", "UnusedMember.Global")]
     public static class AppodealVersions
     {
-        private const string AppodealPluginVersion = "3.5.1";
+        private const string AppodealPluginVersion = "3.5.2";
 
         /// <summary>
         /// Gets the current version of the Appodeal Unity Plugin.
diff --git a/Runtime/Common/Interfaces/IAppodealAdsClient.cs b/Runtime/Common/Interfaces/IAppodealAdsClient.cs
@@ -68,7 +68,7 @@ public interface IAppodealAdsClient
         void ResetExtraData(string key);
         double GetPredictedEcpm(int adType);
         double GetPredictedEcpmForPlacement(int adType, string placement);
-        void LogEvent(string eventName, Dictionary<string, object> eventParams);
+        void LogEvent(string eventName, Dictionary<string, object> eventParams, AppodealService services);
         void ValidatePlayStoreInAppPurchase(IPlayStoreInAppPurchase purchase, IInAppPurchaseValidationListener listener);
         void ValidateAppStoreInAppPurchase(IAppStoreInAppPurchase purchase, IInAppPurchaseValidationListener listener);
         void SetBidonEndpoint(string baseUrl);
diff --git a/Runtime/Platforms/Android/AndroidAppodealClient.cs b/Runtime/Platforms/Android/AndroidAppodealClient.cs
@@ -430,11 +430,11 @@ public bool IsAutoCacheEnabled(int adType)
             return AppodealJavaClass?.CallStatic<bool>(AndroidConstants.JavaMethodName.Appodeal.IsAutoCacheEnabled, AndroidAppodealHelper.GetJavaAdTypes(adType)) ?? false;
         }
 
-        public void LogEvent(string eventName, Dictionary<string, object> eventParams)
+        public void LogEvent(string eventName, Dictionary<string, object> eventParams, AppodealService services)
         {
             if (eventParams == null)
             {
-                AppodealJavaClass?.CallStatic(AndroidConstants.JavaMethodName.Appodeal.LogEvent, eventName, null);
+                AppodealJavaClass?.CallStatic(AndroidConstants.JavaMethodName.Appodeal.LogEvent, eventName, null, (int)services);
                 return;
             }
 
@@ -451,7 +451,7 @@ public void LogEvent(string eventName, Dictionary<string, object> eventParams)
                     map.Call<AndroidJavaObject>("put", entry.Key, AndroidAppodealHelper.GetJavaObject(entry.Value));
                 }
 
-                AppodealJavaClass?.CallStatic(AndroidConstants.JavaMethodName.Appodeal.LogEvent, eventName, map);
+                AppodealJavaClass?.CallStatic(AndroidConstants.JavaMethodName.Appodeal.LogEvent, eventName, map, (int)services);
             }
             catch (Exception e)
             {
diff --git a/Runtime/Platforms/Dummy/DummyAppodealClient.cs b/Runtime/Platforms/Dummy/DummyAppodealClient.cs
@@ -824,7 +824,7 @@ public string GetUserId()
             return String.Empty;
         }
 
-        public void LogEvent(string eventName, Dictionary<string, object> eventParams)
+        public void LogEvent(string eventName, Dictionary<string, object> eventParams, AppodealService services)
         {
             if (CheckIfLoggingEnabled()) Debug.Log("Calling Appodeal.LogEvent method on an unsupported platform. Run your application on either Android or iOS device to test this method.");
         }
diff --git a/Runtime/Platforms/iOS/Bridge/AppodealObjCBridge.cs b/Runtime/Platforms/iOS/Bridge/AppodealObjCBridge.cs
@@ -183,7 +183,7 @@ internal static class AppodealObjCBridge
         internal static extern bool AppodealIsAutoCacheEnabled(int adType);
 
         [DllImport("__Internal")]
-        internal static extern void AppodealLogEvent(string eventName, string eventParams);
+        internal static extern void AppodealLogEvent(string eventName, string eventParams, int services);
 
         [DllImport("__Internal")]
         internal static extern void AppodealValidateInAppPurchase(
diff --git a/Runtime/Platforms/iOS/IosAppodealClient.cs b/Runtime/Platforms/iOS/IosAppodealClient.cs
@@ -745,14 +745,14 @@ public void TrackInAppPurchase(double amount, string currency)
             AppodealObjCBridge.AppodealTrackInAppPurchase(amount, currency);
         }
 
-        public void LogEvent(string eventName, Dictionary<string, object> eventParams)
+        public void LogEvent(string eventName, Dictionary<string, object> eventParams, AppodealService services)
         {
             var paramsFiltered = new Dictionary<string, object>();
 
             eventParams?.Keys.Where(key => eventParams[key] is int || eventParams[key] is double || eventParams[key] is string)
                 .ToList().ForEach(key => paramsFiltered.Add(key, eventParams[key]));
 
-            AppodealObjCBridge.AppodealLogEvent(eventName, DictionaryToString(paramsFiltered));
+            AppodealObjCBridge.AppodealLogEvent(eventName, DictionaryToString(paramsFiltered), (int)services);
         }
 
         public void ValidateAppStoreInAppPurchase(IAppStoreInAppPurchase purchase, IInAppPurchaseValidationListener listener)
diff --git a/Runtime/Plugins/iOS/AppodealObjCBridge.m b/Runtime/Plugins/iOS/AppodealObjCBridge.m
@@ -312,8 +312,8 @@ void AppodealSetUserId(const char *userid) {
     return strncpy(cStringCopy, cString, [[Appodeal userId] length]);
 }
 
-void AppodealLogEvent(const char *eventName, const char *eventParams) {
-    [Appodeal trackEvent:NSStringFromUTF8String(eventName) customParameters:NSDictionaryFromUTF8String(eventParams)];
+void AppodealLogEvent(const char *eventName, const char *eventParams, int services) {
+    [Appodeal trackEvent:NSStringFromUTF8String(eventName) customParameters:NSDictionaryFromUTF8String(eventParams) analytics:services];
 }
 
 void AppodealValidateInAppPurchase(const char *productIdentifier,
diff --git a/Samples~/UsageSample/AppodealDemo.cs b/Samples~/UsageSample/AppodealDemo.cs
@@ -44,6 +44,11 @@ public class AppodealDemo : MonoBehaviour
         [SerializeField] private Text               pluginVersionText;
         [SerializeField] private Text               interstitialButtonText;
         [SerializeField] private Text               rewardedVideoButtonText;
+        [SerializeField] private Toggle             allServicesToggle;
+        [SerializeField] private Toggle             adjustServiceToggle;
+        [SerializeField] private Toggle             appsFlyerServiceToggle;
+        [SerializeField] private Toggle             facebookServiceToggle;
+        [SerializeField] private Toggle             firebaseServiceToggle;
 
         #endregion
 
@@ -65,6 +70,8 @@ public class AppodealDemo : MonoBehaviour
 
         private bool _shouldChangeIntText, _shouldChangeRewText;
 
+        private List<Toggle> _serviceToggles;
+
         #endregion
 
         #region MonoBehavior Functions
@@ -90,6 +97,19 @@ private void Awake()
             Assert.IsNotNull(pluginVersionText);
             Assert.IsNotNull(interstitialButtonText);
             Assert.IsNotNull(rewardedVideoButtonText);
+            Assert.IsNotNull(allServicesToggle);
+            Assert.IsNotNull(adjustServiceToggle);
+            Assert.IsNotNull(appsFlyerServiceToggle);
+            Assert.IsNotNull(facebookServiceToggle);
+            Assert.IsNotNull(firebaseServiceToggle);
+
+            _serviceToggles = new List<Toggle>
+            {
+                adjustServiceToggle,
+                appsFlyerServiceToggle,
+                facebookServiceToggle,
+                firebaseServiceToggle,
+            };
         }
 
         private void Start()
@@ -142,6 +162,30 @@ public void ShowNextPanel()
             if (index + 2 >= panels.Count) nextPanelButton.interactable = false;
         }
 
+        public void OnServiceToggleValueChanged()
+        {
+            if (_serviceToggles.Any(toggle => !toggle.isOn)) return;
+
+            allServicesToggle.isOn = true;
+            _serviceToggles.ForEach(toggle => toggle.interactable = false);
+        }
+
+        public void OnAllServicesToggleValueChanged(bool isOn)
+        {
+            if (isOn)
+            {
+                _serviceToggles.ForEach(toggle =>
+                {
+                    toggle.isOn = true;
+                    toggle.interactable = false;
+                });
+            }
+            else
+            {
+                _serviceToggles.ForEach(toggle => toggle.interactable = true);
+            }
+        }
+
         #endregion
 
         #region Appodeal Monetization
@@ -302,7 +346,20 @@ public void ValidateInAppPurchase()
 
         public void LogEvent()
         {
-            Appodeal.LogEvent("test_event", new Dictionary<string, object> { { "test_key_1", 42 }, { "test_key_2", "test_value" } });
+            var eventParams = new Dictionary<string, object> { { "test_key_1", 42 }, { "test_key_2", "test_value" } };
+            if (allServicesToggle.isOn)
+            {
+                Appodeal.LogEvent("test_event", eventParams);
+            }
+            else
+            {
+                AppodealService services = 0;
+                if (adjustServiceToggle.isOn) services |= AppodealService.Adjust;
+                if (appsFlyerServiceToggle.isOn) services |= AppodealService.AppsFlyer;
+                if (facebookServiceToggle.isOn) services |= AppodealService.Facebook;
+                if (firebaseServiceToggle.isOn) services |= AppodealService.Firebase;
+                Appodeal.LogEvent("test_event", eventParams, services);
+            }
         }
 
         #endregion
@@ -385,6 +442,10 @@ private void OnInitializationFinished(object sender, SdkInitializedEventArgs e)
             networksList = Appodeal.GetNetworks(AppodealAdType.Mrec);
             output = networksList == null ? String.Empty : String.Join(", ", (networksList.ToArray()));
             Debug.Log($"[APDUnity] [Appodeal] GetNetworks() for Mrec: {output}");
+
+            pluginVersionText.text = $"Appodeal Unity Plugin v{ AppodealVersions.GetPluginVersion() } & SDK v{ Appodeal.GetNativeSDKVersion() }";
+
+            Appodeal.ShowMediationDebugger();
         }
 
         #endregion
diff --git a/Samples~/UsageSample/AppodealDemoScene.unity b/Samples~/UsageSample/AppodealDemoScene.unity
diff --git a/package.json b/package.json

Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,6 @@`
`1`	`1`	`// ReSharper Disable CheckNamespace`
`2`	`2`
	`3`	`+using System;`
`3`	`4`	`using System.Diagnostics.CodeAnalysis;`
`4`	`5`
`5`	`6`	`namespace AppodealStack.Monetization.Common`
`@@ -71,4 +72,14 @@ public enum MediationDebuggerProvider`
`71`	`72`	`{`
`72`	`73`	`AppLovinSdk,`
`73`	`74`	`}`
	`75`	`+`
	`76`	`+ [Flags]`
	`77`	`+ public enum AppodealService`
	`78`	`+ {`
	`79`	`+ Adjust = 1 << 0,`
	`80`	`+ AppsFlyer = 1 << 1,`
	`81`	`+ Facebook = 1 << 2,`
	`82`	`+ Firebase = 1 << 3,`
	`83`	`+ All = Adjust \| AppsFlyer \| Facebook \| Firebase`
	`84`	`+ }`
`74`	`85`	`}`
Original file line number	Diff line number	Diff line change
`@@ -12,7 +12,7 @@ namespace AppodealStack.Monetization.Common`
`12`	`12`	`[SuppressMessage("ReSharper", "UnusedMember.Global")]`
`13`	`13`	`public static class AppodealVersions`
`14`	`14`	`{`
`15`		`- private const string AppodealPluginVersion = "3.5.1";`
	`15`	`+ private const string AppodealPluginVersion = "3.5.2";`
`16`	`16`
`17`	`17`	`/// <summary>`
`18`	`18`	`/// Gets the current version of the Appodeal Unity Plugin.`
Original file line number	Diff line number	Diff line change
`@@ -430,11 +430,11 @@ public bool IsAutoCacheEnabled(int adType)`
`430`	`430`	`return AppodealJavaClass?.CallStatic<bool>(AndroidConstants.JavaMethodName.Appodeal.IsAutoCacheEnabled, AndroidAppodealHelper.GetJavaAdTypes(adType)) ?? false;`
`431`	`431`	`}`
`432`	`432`
`433`		`- public void LogEvent(string eventName, Dictionary<string, object> eventParams)`
	`433`	`+ public void LogEvent(string eventName, Dictionary<string, object> eventParams, AppodealService services)`
`434`	`434`	`{`
`435`	`435`	`if (eventParams == null)`
`436`	`436`	`{`
`437`		`- AppodealJavaClass?.CallStatic(AndroidConstants.JavaMethodName.Appodeal.LogEvent, eventName, null);`
	`437`	`+ AppodealJavaClass?.CallStatic(AndroidConstants.JavaMethodName.Appodeal.LogEvent, eventName, null, (int)services);`
`438`	`438`	`return;`
`439`	`439`	`}`
`440`	`440`
`@@ -451,7 +451,7 @@ public void LogEvent(string eventName, Dictionary<string, object> eventParams)`
`451`	`451`	`map.Call<AndroidJavaObject>("put", entry.Key, AndroidAppodealHelper.GetJavaObject(entry.Value));`
`452`	`452`	`}`
`453`	`453`
`454`		`- AppodealJavaClass?.CallStatic(AndroidConstants.JavaMethodName.Appodeal.LogEvent, eventName, map);`
	`454`	`+ AppodealJavaClass?.CallStatic(AndroidConstants.JavaMethodName.Appodeal.LogEvent, eventName, map, (int)services);`
`455`	`455`	`}`
`456`	`456`	`catch (Exception e)`
`457`	`457`	`{`
Original file line number	Diff line number	Diff line change
`@@ -824,7 +824,7 @@ public string GetUserId()`
`824`	`824`	`return String.Empty;`
`825`	`825`	`}`
`826`	`826`
`827`		`- public void LogEvent(string eventName, Dictionary<string, object> eventParams)`
	`827`	`+ public void LogEvent(string eventName, Dictionary<string, object> eventParams, AppodealService services)`
`828`	`828`	`{`
`829`	`829`	`if (CheckIfLoggingEnabled()) Debug.Log("Calling Appodeal.LogEvent method on an unsupported platform. Run your application on either Android or iOS device to test this method.");`
`830`	`830`	`}`
Original file line number	Diff line number	Diff line change
`@@ -745,14 +745,14 @@ public void TrackInAppPurchase(double amount, string currency)`
`745`	`745`	`AppodealObjCBridge.AppodealTrackInAppPurchase(amount, currency);`
`746`	`746`	`}`
`747`	`747`
`748`		`- public void LogEvent(string eventName, Dictionary<string, object> eventParams)`
	`748`	`+ public void LogEvent(string eventName, Dictionary<string, object> eventParams, AppodealService services)`
`749`	`749`	`{`
`750`	`750`	`var paramsFiltered = new Dictionary<string, object>();`
`751`	`751`
`752`	`752`	`eventParams?.Keys.Where(key => eventParams[key] is int \|\| eventParams[key] is double \|\| eventParams[key] is string)`
`753`	`753`	`.ToList().ForEach(key => paramsFiltered.Add(key, eventParams[key]));`
`754`	`754`
`755`		`- AppodealObjCBridge.AppodealLogEvent(eventName, DictionaryToString(paramsFiltered));`
	`755`	`+ AppodealObjCBridge.AppodealLogEvent(eventName, DictionaryToString(paramsFiltered), (int)services);`
`756`	`756`	`}`
`757`	`757`
`758`	`758`	`public void ValidateAppStoreInAppPurchase(IAppStoreInAppPurchase purchase, IInAppPurchaseValidationListener listener)`