feat: add custom events support (#845)

Co-authored-by: github-actions[bot] <noreply@onesignal.com>

Author: fadi-george

.github/workflows/create-release-pr.yml

@@ -125,7 +125,7 @@ jobs:
 
       - name: Update Unity SDK version
         run: |
-          PADDED_VERSION=$(printf "%06d" $(echo "${{ inputs.unity_version }}" | sed 's/[^0-9]//g'))
+          PADDED_VERSION=$(echo "${{ inputs.unity_version }}" | awk -F. '{printf "%02d%02d%02d", $1, $2, $3}')
           printf "%s" "${{ inputs.unity_version }}" > OneSignalExample/Assets/OneSignal/VERSION
           for file in com.onesignal.unity.core/package.json com.onesignal.unity.android/package.json com.onesignal.unity.ios/package.json; do
             sed -i "s/\"version\": \".*\"/\"version\": \"${{ inputs.unity_version }}\"/" "$file"

.gitignore

@@ -4,3 +4,6 @@ OneSignalExample/.utmp/
 OneSignalExample/Packages/com.unity.asset-store-tools/
 
 .DS_Store
+.gradle/
+
+**/GvhProjectSettings.xml

OneSignalExample/.gitignore

@@ -2,13 +2,15 @@
 #
 # Get latest from https://github.com/github/gitignore/blob/master/Unity.gitignore
 #
+/.utmp/
 /[Ll]ibrary/
 /[Tt]emp/
 /[Oo]bj/
 /[Bb]uild/
 /[Bb]uilds/
 /[Ll]ogs/
 /[Mm]emoryCaptures/
+/UserSettings/
 
 # Asset meta data should only be ignored when the corresponding asset is also ignored
 !/[Aa]ssets/**/*.meta
@@ -58,3 +60,12 @@ sysinfo.txt
 # Crashlytics generated file
 crashlytics-build.properties
 
+# User-specific Unity Editor settings
+/[Uu]serSettings/
+
+# Gradle template backup files
+*.backup
+*.backup.meta
+*.backup2
+*.backup2.meta
+

OneSignalExample/Assets/OneSignal/Example/OneSignalExampleBehaviour.cs

@@ -461,6 +461,60 @@ public void GetTags()
         _log($"Get all user tags " + dictionaryString.TrimEnd(',', ' ') + "}");
     }
 
+    public void TrackEvent()
+    {
+        // Detect platform
+        string platform =
+            Application.platform == RuntimePlatform.Android ? "android"
+            : Application.platform == RuntimePlatform.IPhonePlayer ? "ios"
+            : "unknown";
+
+        // Track event without properties
+        _log($"Tracking an event <b>Unity-{platform}-noprops</b> without properties");
+        OneSignal.User.TrackEvent($"Unity-{platform}-noprops");
+
+        // Track event with comprehensive properties
+        var properties = new Dictionary<string, object>
+        {
+            { "someNum", 123 },
+            { "someFloat", 3.14159f },
+            { "someString", "abc" },
+            { "someBool", true },
+            {
+                "someObject",
+                new Dictionary<string, object>
+                {
+                    { "abc", "123" },
+                    {
+                        "nested",
+                        new Dictionary<string, object> { { "def", "456" } }
+                    },
+                    { "ghi", null },
+                }
+            },
+            {
+                "someArray",
+                new List<object> { 1, 2 }
+            },
+            {
+                "someMixedArray",
+                new List<object>
+                {
+                    1,
+                    "2",
+                    new Dictionary<string, object> { { "abc", "123" } },
+                    null,
+                }
+            },
+            { "someNull", null },
+        };
+
+        _log(
+            $"Tracking an event <b>Unity-{platform}</b> with properties: {Json.Serialize(properties)}"
+        );
+        OneSignal.User.TrackEvent($"Unity-{platform}", properties);
+    }
+
     /*
      * Outcomes
      */