feat: add setGroup API support (#114)

Author: qingzhuozhen

Assets/Amplitude/Amplitude.cs

@@ -9,7 +9,7 @@
 
 public class Amplitude {
 	private static readonly string UnityLibraryName = "amplitude-unity";
-	private static readonly string UnityLibraryVersion = "2.5.1";
+	private static readonly string UnityLibraryVersion = "2.6.0";
 
 	private static Dictionary<string, Amplitude> instances;
 	private static readonly object instanceLock = new object();
@@ -40,6 +40,10 @@ public class Amplitude {
 	[DllImport ("__Internal")]
 	private static extern void _Amplitude_setUserProperties(string instanceName, string propertiesJson);
 	[DllImport ("__Internal")]
+	private static extern void _Amplitude_setGroup(string instanceName, string groupType, string groupName);
+	[DllImport ("__Internal")]
+	private static extern void _Amplitude_setGroupWithStringArray(string instanceName, string groupType, string[] groupName, int length);
+	[DllImport ("__Internal")]
 	private static extern void _Amplitude_setOptOut(string instanceName, bool enabled);
 	[DllImport ("__Internal")]
 	private static extern void _Amplitude_setMinTimeBetweenSessionsMillis(string instanceName, long minTimeBetweenSessionsMillis);
@@ -568,6 +572,52 @@ public void setUserProperties(IDictionary<string, object> properties) {
 #endif
 	}
 
+	/// <summary>
+	/// Adds a user to a group or groups. You need to specify a groupType and groupName(s).
+	/// For example you can group people by their organization. In that case groupType is "orgId", and groupName would be the actual ID(s). groupName can be a string or an array of strings to indicate a user in multiple groups. 
+	/// You can also call setGroup multiple times with different groupTypes to track multiple types of groups (up to 5 per app).
+	/// **Note:** this will also set groupType: groupName as a user property.
+	/// </summary>
+	/// <param name="groupType"You need to specify a group type (for example orgId).</param>
+	/// <param name="groupName"The value for the group name, can be a string. (for example for groupType orgId, the groupName would be the actual id number, like 15).</param>
+	public void setGroup(string groupType, string groupName) {
+		Log (string.Format("C# setGroup"));
+#if (UNITY_IPHONE || UNITY_TVOS)
+		if (Application.platform == RuntimePlatform.IPhonePlayer || Application.platform == RuntimePlatform.tvOS) {
+			_Amplitude_setGroup(instanceName, groupType, groupName);
+		}
+#endif
+
+#if UNITY_ANDROID
+		if (Application.platform == RuntimePlatform.Android) {
+			pluginClass.CallStatic("setGroup", instanceName, groupType, groupName);
+		}
+#endif
+	}
+
+	/// <summary>
+	/// Adds a user to a group or groups. You need to specify a groupType and groupName(s).
+	/// For example you can group people by their organization. In that case groupType is "orgId", and groupName would be the actual ID(s). groupName can be a string or an array of strings to indicate a user in multiple groups. 
+	/// You can also call setGroup multiple times with different groupTypes to track multiple types of groups (up to 5 per app).
+	/// **Note:** this will also set groupType: groupName as a user property.
+	/// </summary>
+	/// <param name="groupType"You need to specify a group type (for example sports).</param>
+	/// <param name="groupName"The value for the group name, can be an array of strings. (for example for groupType orgId, the groupName would be array of sport, like [soccer, tennis]).</param>
+	public void setGroup(string groupType, string[] groupName) {
+		Log (string.Format("C# setGroup"));
+#if (UNITY_IPHONE || UNITY_TVOS)
+		if (Application.platform == RuntimePlatform.IPhonePlayer || Application.platform == RuntimePlatform.tvOS) {
+			_Amplitude_setGroupWithStringArray(instanceName, groupType, groupName, groupName.Length);
+		}
+#endif
+
+#if UNITY_ANDROID
+		if (Application.platform == RuntimePlatform.Android) {
+			pluginClass.CallStatic("setGroup", instanceName, groupType, groupName);
+		}
+#endif
+	}
+
 	/// <summary>
 	/// Enables tracking opt out.
 	/// If the user wants to opt out of all tracking, use this method to enable opt out for them. 

Assets/Editor/AmplitudeDependencies.xml

@@ -4,7 +4,7 @@
       <repository>https://repo.maven.apache.org/maven2</repository>
     </repositories>
 
-    <androidPackage spec="com.amplitude:android-sdk:2.37.0">
+    <androidPackage spec="com.amplitude:android-sdk:2.38.3">
       <repositories>
         <repository>https://maven.google.com</repository>
       </repositories>

Assets/Plugins/Android/com.amplitude.android-sdk-2.37.0.aar

@@ -145,6 +145,19 @@ void _Amplitude_setUserProperties(const char* instanceName, const char* properti
     [[Amplitude instanceWithName:ToNSString(instanceName)] setUserProperties:ToNSDictionary(properties)];
 }
 
+void _Amplitude_setGroup(const char* instanceName, const char* groupType, const char* groupName) {
+    [[Amplitude instanceWithName:ToNSString(instanceName)] setGroup:ToNSString(groupType) groupName:ToNSString(groupName)];
+}
+
+void _Amplitude_setGroupWithStringArray(const char* instanceName, const char* groupType, const char* groupName[], const int length) {
+    if (length == 0) return;
+    NSMutableArray *array = [NSMutableArray arrayWithCapacity:length];
+    for (int i = 0; i < length; i++) {
+        [array addObject:ToNSString(groupName[i])];
+    }
+    [[Amplitude instanceWithName:ToNSString(instanceName)] setGroup:ToNSString(groupType) groupName:array];
+}
+
 void _Amplitude_setOptOut(const char* instanceName, const bool enabled) {
     [[Amplitude instanceWithName:ToNSString(instanceName)] setOptOut:enabled];
 }

Assets/Plugins/Android/com.amplitude.android-sdk-2.38.3.aar

@@ -51,6 +51,8 @@ void Start() {
 		amplitude.removeUserProperty("longArray", new long[]{ 1111,2222,3333,4444,5555,6666});
 		amplitude.setUserProperty("floatArray", new float[]{123.45f, 678.9f});
 		amplitude.setUserProperty("doubleArray", new double[]{123.45, 678.9});
+		amplitude.setGroup("sdk", "unity");
+		amplitude.setGroup("sports", new string[]{"soccer", "tennis"});
 
 		Dictionary<string, object> dictValue = new Dictionary<string, object>()
 		{

Assets/Plugins/Android/com.amplitude.android-sdk-2.37.0.aar.meta Assets/Plugins/Android/com.amplitude.android-sdk-2.38.3.aar.meta

@@ -1,6 +1,6 @@
 {
     "name": "com.amplitude.unityplugin",
-    "version": "2.5.1",
+    "version": "2.6.0",
     "displayName": "Amplitude Unity SDK",
     "description": "A plugin to simplify the integration of Amplitude iOS and Android SDKs into your Unity project. This repository also contains a sample project with the Unity plugin integrated.",
     "unity": "2021.3",

Assets/Plugins/iOS/Amplitude/AmplitudeCWrapper.m

@@ -1,5 +1,9 @@
 # Versioned Releases
 
+## 2.6.0
+* Upgrade nativeAndroid SDK to v2.38.3.
+* Add `setGroup` API support.
+
 ## 2.5.1
 * Upgrade nativeAndroid SDK to v2.37.0.
 * Upgrade native iOS SDK to v8.10.0.

Assets/Scripts/AmplitudeDemo.cs

@@ -1,11 +1,11 @@
 <dependencies>
   <packages>
-    <package>com.amplitude:android-sdk:2.37.0</package>
+    <package>com.amplitude:android-sdk:2.38.3</package>
     <package>com.squareup.okhttp3:okhttp:4.2.2</package>
   </packages>
   <files>
     <file>Assets/Plugins/Android/com.amplitude.analytics-connector-1.0.0.aar</file>
-    <file>Assets/Plugins/Android/com.amplitude.android-sdk-2.37.0.aar</file>
+    <file>Assets/Plugins/Android/com.amplitude.android-sdk-2.38.3.aar</file>
     <file>Assets/Plugins/Android/com.squareup.okhttp3.okhttp-4.2.2.jar</file>
     <file>Assets/Plugins/Android/com.squareup.okio.okio-2.2.2.jar</file>
     <file>Assets/Plugins/Android/org.jetbrains.annotations-13.0.jar</file>