feat: Add LiveOps - User Profile methods [TENJIN-25844]

IonicCapacitorTenjin.podspec

@@ -14,6 +14,6 @@ Pod::Spec.new do |s|
   s.static_framework = true
   s.ios.deployment_target  = '13.0'
   s.dependency 'Capacitor'
-  s.dependency 'TenjinSDK', '1.14.9'
+  s.dependency 'TenjinSDK', '1.15.1'
   s.swift_version = '5.1'
 end

README.md

@@ -165,6 +165,60 @@ Tenjin.getAnalyticsInstallationId()
 ```
 Returns: `string`
 
+### User Profile - LiveOps Metrics
+
+The Tenjin SDK automatically tracks user engagement metrics to help you understand player behavior and lifetime value. These metrics are collected automatically and can be accessed programmatically.
+
+#### Automatic Tracking
+
+The SDK automatically tracks:
+- **Session metrics**: Session count, duration, first/last session dates
+- **In-App Purchases (IAP)**: Transaction count, revenue by currency, purchased product IDs
+- **Ad Revenue (ILRD)**: Impression-level revenue from supported ad networks
+
+#### Get User Profile Dictionary
+
+Retrieve the user profile as a dictionary with all metrics:
+
+```javascript
+const profile = await Tenjin.getUserProfileDictionary();
+console.log('Session Count:', profile.session_count);
+console.log('Total Session Time (ms):', profile.total_session_time);
+console.log('Average Session Length (ms):', profile.average_session_length);
+console.log('IAP Transaction Count:', profile.iap_transaction_count);
+console.log('Total ILRD Revenue USD:', profile.total_ilrd_revenue_usd);
+```
+
+**Dictionary Keys (Always Present):**
+
+| Key | Type | Description |
+|-----|------|-------------|
+| `session_count` | `number` | Total sessions |
+| `total_session_time` | `number` | Total time (milliseconds) |
+| `average_session_length` | `number` | Average session (milliseconds) |
+| `last_session_length` | `number` | Last session (milliseconds) |
+| `iap_transaction_count` | `number` | Total IAP count |
+| `total_ilrd_revenue_usd` | `number` | Total ad revenue USD |
+
+**Dictionary Keys (Conditional - only if available):**
+
+| Key | Type | Description |
+|-----|------|-------------|
+| `first_session_date` | `string` | ISO8601 formatted date |
+| `last_session_date` | `string` | ISO8601 formatted date |
+| `current_session_length` | `number` | Active session duration (milliseconds) |
+| `iap_revenue_by_currency` | `object` | Map of currency -> revenue |
+| `purchased_product_ids` | `array` | Sorted array of product IDs |
+| `ilrd_revenue_by_network` | `object` | Map of network -> revenue |
+
+#### Reset User Profile
+
+Clear all user profile data (useful for testing or user logout):
+
+```javascript
+Tenjin.resetUserProfile();
+```
+
 ### Send Google DMA Parameters
 ```javascript
 Tenjin.setGoogleDMAParametersWithAdPersonalization(adPersonalization, adUserData)

android/build.gradle

@@ -52,7 +52,7 @@ dependencies {
     implementation fileTree(dir: 'libs', include: ['*.jar'])
     implementation project(':capacitor-android')
     implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
-    implementation 'com.tenjin:android-sdk:1.16.7'
+    implementation 'com.tenjin:android-sdk:1.17.2'
     testImplementation "junit:junit:$junitVersion"
     androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
     androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"

android/src/main/java/com/tenjin/plugins/capacitor/Tenjin.java

@@ -119,4 +119,12 @@ public String getAnalyticsInstallationId() {
     public void setGoogleDMAParameters(boolean adPersonalization, boolean adUserData) {
         instance.setGoogleDMAParameters(adPersonalization, adUserData);
     }
+
+    public java.util.Map<String, Object> getUserProfileDictionary() {
+        return instance.getUserProfileDictionary();
+    }
+
+    public void resetUserProfile() {
+        instance.resetUserProfile();
+    }
 }

android/src/main/java/com/tenjin/plugins/capacitor/TenjinPlugin.java

@@ -223,4 +223,36 @@ public void updatePostbackConversionValueCoarseValueLockWindow(PluginCall call)
         Log.d("TENJIN", "Method not available on Android");
         call.resolve();
     }
+
+    @PluginMethod
+    public void getUserProfileDictionary(PluginCall call) {
+        java.util.Map<String, Object> profileDict = implementation.getUserProfileDictionary();
+        if (profileDict != null) {
+            try {
+                JSObject result = new JSObject();
+                for (java.util.Map.Entry<String, Object> entry : profileDict.entrySet()) {
+                    Object value = entry.getValue();
+                    if (value instanceof java.util.Map) {
+                        result.put(entry.getKey(), new JSONObject((java.util.Map<?, ?>) value));
+                    } else if (value instanceof java.util.List) {
+                        result.put(entry.getKey(), new org.json.JSONArray((java.util.List<?>) value));
+                    } else {
+                        result.put(entry.getKey(), value);
+                    }
+                }
+                call.resolve(result);
+            } catch (Exception e) {
+                e.printStackTrace();
+                call.resolve(new JSObject());
+            }
+        } else {
+            call.resolve(new JSObject());
+        }
+    }
+
+    @PluginMethod
+    public void resetUserProfile(PluginCall call) {
+        implementation.resetUserProfile();
+        call.resolve();
+    }
 }

ionic-example/.browserslistrc

@@ -3,13 +3,13 @@
 # https://github.com/browserslist/browserslist#queries
 
 # For the full list of supported browsers by the Angular framework, please see:
-# https://angular.io/guide/browser-support
+# https://angular.dev/reference/versions
 
 # You can see what browsers were selected by your queries by running:
 #   npx browserslist
 
-Chrome >=60
-Firefox >=63
-Edge >=79
-Safari >=13
-iOS >=13
+last 2 Chrome versions
+last 2 Firefox versions
+last 2 Edge versions
+last 2 Safari versions
+last 2 iOS versions

ionic-example/android/.gitignore

@@ -0,0 +1,101 @@
+# Using Android gitignore template: https://github.com/github/gitignore/blob/HEAD/Android.gitignore
+
+# Built application files
+*.apk
+*.aar
+*.ap_
+*.aab
+
+# Files for the ART/Dalvik VM
+*.dex
+
+# Java class files
+*.class
+
+# Generated files
+bin/
+gen/
+out/
+#  Uncomment the following line in case you need and you don't have the release build type files in your app
+# release/
+
+# Gradle files
+.gradle/
+build/
+
+# Local configuration file (sdk path, etc)
+local.properties
+
+# Proguard folder generated by Eclipse
+proguard/
+
+# Log Files
+*.log
+
+# Android Studio Navigation editor temp files
+.navigation/
+
+# Android Studio captures folder
+captures/
+
+# IntelliJ
+*.iml
+.idea/workspace.xml
+.idea/tasks.xml
+.idea/gradle.xml
+.idea/assetWizardSettings.xml
+.idea/dictionaries
+.idea/libraries
+# Android Studio 3 in .gitignore file.
+.idea/caches
+.idea/modules.xml
+# Comment next line if keeping position of elements in Navigation Editor is relevant for you
+.idea/navEditor.xml
+
+# Keystore files
+# Uncomment the following lines if you do not want to check your keystore files in.
+#*.jks
+#*.keystore
+
+# External native build folder generated in Android Studio 2.2 and later
+.externalNativeBuild
+.cxx/
+
+# Google Services (e.g. APIs or Firebase)
+# google-services.json
+
+# Freeline
+freeline.py
+freeline/
+freeline_project_description.json
+
+# fastlane
+fastlane/report.xml
+fastlane/Preview.html
+fastlane/screenshots
+fastlane/test_output
+fastlane/readme.md
+
+# Version control
+vcs.xml
+
+# lint
+lint/intermediates/
+lint/generated/
+lint/outputs/
+lint/tmp/
+# lint/reports/
+
+# Android Profiling
+*.hprof
+
+# Cordova plugins for Capacitor
+capacitor-cordova-android-plugins
+
+# Copied web assets
+app/src/main/assets/public
+
+# Generated Config files
+app/src/main/assets/capacitor.config.json
+app/src/main/assets/capacitor.plugins.json
+app/src/main/res/xml/config.xml

ionic-example/android/app/.gitignore

@@ -0,0 +1,2 @@
+/build/*
+!/build/.npmkeep

ionic-example/android/app/build.gradle

@@ -0,0 +1,54 @@
+apply plugin: 'com.android.application'
+
+android {
+    namespace "io.ionic.starter"
+    compileSdkVersion rootProject.ext.compileSdkVersion
+    defaultConfig {
+        applicationId "io.ionic.starter"
+        minSdkVersion rootProject.ext.minSdkVersion
+        targetSdkVersion rootProject.ext.targetSdkVersion
+        versionCode 1
+        versionName "1.0"
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+        aaptOptions {
+             // Files and dirs to omit from the packaged assets dir, modified to accommodate modern web apps.
+             // Default: https://android.googlesource.com/platform/frameworks/base/+/282e181b58cf72b6ca770dc7ca5f91f135444502/tools/aapt/AaptAssets.cpp#61
+            ignoreAssetsPattern '!.svn:!.git:!.ds_store:!*.scc:.*:!CVS:!thumbs.db:!picasa.ini:!*~'
+        }
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+}
+
+repositories {
+    flatDir{
+        dirs '../capacitor-cordova-android-plugins/src/main/libs', 'libs'
+    }
+}
+
+dependencies {
+    implementation fileTree(include: ['*.jar'], dir: 'libs')
+    implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
+    implementation "androidx.coordinatorlayout:coordinatorlayout:$androidxCoordinatorLayoutVersion"
+    implementation "androidx.core:core-splashscreen:$coreSplashScreenVersion"
+    implementation project(':capacitor-android')
+    testImplementation "junit:junit:$junitVersion"
+    androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
+    androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
+    implementation project(':capacitor-cordova-android-plugins')
+}
+
+apply from: 'capacitor.build.gradle'
+
+try {
+    def servicesJSON = file('google-services.json')
+    if (servicesJSON.text) {
+        apply plugin: 'com.google.gms.google-services'
+    }
+} catch(Exception e) {
+    logger.info("google-services.json not found, google-services plugin not applied. Push Notifications won't work")
+}

ionic-example/android/app/capacitor.build.gradle

@@ -0,0 +1,23 @@
+// DO NOT EDIT THIS FILE! IT IS GENERATED EACH TIME "capacitor update" IS RUN
+
+android {
+  compileOptions {
+      sourceCompatibility JavaVersion.VERSION_17
+      targetCompatibility JavaVersion.VERSION_17
+  }
+}
+
+apply from: "../capacitor-cordova-android-plugins/cordova.variables.gradle"
+dependencies {
+    implementation project(':capacitor-app')
+    implementation project(':capacitor-haptics')
+    implementation project(':capacitor-keyboard')
+    implementation project(':capacitor-status-bar')
+    implementation project(':ionic-capacitor-tenjin')
+
+}
+
+
+if (hasProperty('postBuildExtras')) {
+  postBuildExtras()
+}

ionic-example/android/app/proguard-rules.pro

@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile

ionic-example/android/app/src/androidTest/java/com/getcapacitor/myapp/ExampleInstrumentedTest.java

@@ -0,0 +1,26 @@
+package com.getcapacitor.myapp;
+
+import static org.junit.Assert.*;
+
+import android.content.Context;
+import androidx.test.ext.junit.runners.AndroidJUnit4;
+import androidx.test.platform.app.InstrumentationRegistry;
+import org.junit.Test;
+import org.junit.runner.RunWith;
+
+/**
+ * Instrumented test, which will execute on an Android device.
+ *
+ * @see <a href="http://d.android.com/tools/testing">Testing documentation</a>
+ */
+@RunWith(AndroidJUnit4.class)
+public class ExampleInstrumentedTest {
+
+    @Test
+    public void useAppContext() throws Exception {
+        // Context of the app under test.
+        Context appContext = InstrumentationRegistry.getInstrumentation().getTargetContext();
+
+        assertEquals("com.getcapacitor.app", appContext.getPackageName());
+    }
+}