expo-tiktok-ads-events 0.1.3 → 0.1.4

package/CLAUDE.md

@@ -0,0 +1,87 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is an Expo native module that wraps the TikTok Business SDK for both iOS and Android, enabling event tracking for TikTok advertising campaigns in React Native/Expo apps.
+
+## Commands
+
+```bash
+# Build TypeScript
+npm run build
+
+# Clean build artifacts
+npm run clean
+
+# Lint code
+npm run lint
+
+# Run tests
+npm run test
+
+# Prepare for publishing
+npm run prepare
+
+# Open iOS project in Xcode
+npm run open:ios
+
+# Open Android project in Android Studio
+npm run open:android
+```
+
+## Architecture
+
+### Native Module Structure
+
+The module exports a native module named `TiktokAdsEvents` (not `ExpoTiktokAdsEvents`). Both platforms must use this exact name.
+
+```
+src/
+├── index.ts                    # Public exports
+└── ExpoTiktokAdsEventsModule.ts # TypeScript interface and helpers
+
+ios/
+├── ExpoTiktokAdsEvents.podspec  # CocoaPods spec (uses TikTokBusinessSDK)
+└── ExpoTiktokAdsEventsModule.swift # iOS implementation
+
+android/
+├── build.gradle                 # Gradle config (uses JitPack SDK)
+└── src/main/java/expo/modules/tiktokadsevents/
+    └── ExpoTiktokAdsEventsModule.kt # Android implementation
+```
+
+### Key Implementation Details
+
+- **Module Name**: Must be `TiktokAdsEvents` in both `Name()` definitions
+- **iOS SDK**: `TikTokBusinessSDK` via CocoaPods
+- **Android SDK**: `com.github.tiktok:tiktok-business-android-sdk` via JitPack
+- **Event Properties**: Passed as `List<Map<String, Any>>` (Android) or `[[String: Any]]` (iOS)
+
+### TypeScript Interface
+
+All native methods are async and must match this interface:
+- `initializeSdk(accessToken, appId, tiktokAppId, debugModeEnabled)` → `Promise<boolean>`
+- `trackTTEvent(name, properties?)` → `Promise<string>`
+- `trackCustomEvent(eventName, eventID, properties?)` → `Promise<void>`
+- `identify(externalId, externalUserName?, phoneNumber?, email?)` → `Promise<void>`
+- `getAnonymousID()` → `Promise<string>`
+- `getAccessToken()` → `Promise<string>`
+- `getTestEventCode()` → `Promise<string>`
+
+## Testing in Consumer Apps
+
+After making changes, consumer apps need:
+```bash
+npx expo prebuild --clean
+```
+
+For Android, ensure the app's `android/build.gradle` includes JitPack:
+```groovy
+allprojects {
+    repositories {
+        maven { url 'https://jitpack.io' }
+    }
+}
+```

package/android/build.gradle

@@ -9,6 +9,11 @@ applyKotlinExpoModulesCorePlugin()
 useCoreDependencies()
 useExpoPublishing()
 
+repositories {
+  maven { url 'https://jitpack.io' }
+  maven { url "https://artifact.bytedance.com/repository/pangle" }
+}
+
 // If you want to use the managed Android SDK versions from expo-modules-core, set this to true.
 // The Android SDK versions will be bumped from time to time in SDK releases and may introduce breaking changes in your module code.
 // Most of the time, you may like to manage the Android SDK versions yourself.
@@ -41,3 +46,7 @@ android {
     abortOnError false
   }
 }
+
+dependencies {
+  implementation 'com.github.tiktok:tiktok-business-android-sdk:1.6.0'
+}

package/android/src/main/AndroidManifest.xml

@@ -1,2 +1,5 @@
-<manifest>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+  <uses-permission android:name="android.permission.INTERNET" />
+  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
+  <uses-permission android:name="com.google.android.gms.permission.AD_ID" />
 </manifest>

package/android/src/main/java/expo/modules/tiktokadsevents/ExpoTiktokAdsEventsModule.kt

@@ -1,50 +1,160 @@
 package expo.modules.tiktokadsevents
 
+import android.util.Log
 import expo.modules.kotlin.modules.Module
 import expo.modules.kotlin.modules.ModuleDefinition
-import java.net.URL
+import expo.modules.kotlin.Promise
+import com.tiktok.TikTokBusinessSdk
+import com.tiktok.TikTokBusinessSdk.TTConfig
+import com.tiktok.TikTokBusinessSdk.LogLevel
+import org.json.JSONObject
 
 class ExpoTiktokAdsEventsModule : Module() {
-  // Each module class must implement the definition function. The definition consists of components
-  // that describes the module's functionality and behavior.
-  // See https://docs.expo.dev/modules/module-api for more details about available components.
+
+  // Store accessToken since Android SDK doesn't expose it like iOS
+  private var storedAccessToken: String = ""
+
+  private val standardEventMap = mapOf(
+    "achieve_level" to "AchieveLevel",
+    "add_payment_info" to "AddPaymentInfo",
+    "complete_tutorial" to "CompleteTutorial",
+    "create_group" to "CreateGroup",
+    "create_role" to "CreateRole",
+    "generate_lead" to "GenerateLead",
+    "in_app_ad_click" to "InAppADClick",
+    "in_app_ad_impr" to "InAppADImpr",
+    "install_app" to "InstallApp",
+    "join_group" to "JoinGroup",
+    "launch_app" to "LaunchAPP",
+    "loan_application" to "LoanApplication",
+    "loan_approval" to "LoanApproval",
+    "loan_disbursal" to "LoanDisbursal",
+    "login" to "Login",
+    "rate" to "Rate",
+    "registration" to "Registration",
+    "search" to "Search",
+    "spend_credits" to "SpendCredits",
+    "start_trial" to "StartTrial",
+    "subscribe" to "Subscribe",
+    "unlock_achievement" to "UnlockAchievement"
+  )
+
+  private fun buildPropertiesJson(properties: List<Map<String, Any>>?): JSONObject? {
+    if (properties == null || properties.isEmpty()) return null
+    val json = JSONObject()
+    properties.forEach { prop ->
+      val key = prop["key"] as? String
+      val value = prop["value"]
+      if (key != null && value != null) {
+        json.put(key, value)
+      }
+    }
+    return json
+  }
+
   override fun definition() = ModuleDefinition {
-    // Sets the name of the module that JavaScript code will use to refer to the module. Takes a string as an argument.
-    // Can be inferred from module's class name, but it's recommended to set it explicitly for clarity.
-    // The module will be accessible from `requireNativeModule('ExpoTiktokAdsEvents')` in JavaScript.
-    Name("ExpoTiktokAdsEvents")
+    Name("TiktokAdsEvents")
+
+    AsyncFunction("initializeSdk") { accessToken: String, appId: String, tiktokAppId: String, debugModeEnabled: Boolean, promise: Promise ->
+      try {
+        val context = appContext.reactContext ?: throw Exception("React context is null")
+
+        // Store accessToken for later retrieval
+        storedAccessToken = accessToken
+
+        val configBuilder = TTConfig(context)
+          .setAppId(appId)
+          .setTTAppId(tiktokAppId)
+
+        if (debugModeEnabled) {
+          configBuilder.setLogLevel(LogLevel.DEBUG)
+          configBuilder.openDebugMode()
+        }
+
+        TikTokBusinessSdk.initializeSdk(configBuilder)
+        promise.resolve(true)
+      } catch (e: Exception) {
+        Log.e("TiktokAdsEvents", "Error initializing SDK: ${e.message}", e)
+        promise.reject("INIT_ERROR", e.message, e)
+      }
+    }
+
+    AsyncFunction("getAnonymousID") { promise: Promise ->
+      try {
+        // Android SDK uses getSessionID() as equivalent to iOS anonymousID
+        val sessionId = TikTokBusinessSdk.getSessionID() ?: ""
+        promise.resolve(sessionId)
+      } catch (e: Exception) {
+        promise.reject("ERROR", e.message, e)
+      }
+    }
 
-    // Defines constant property on the module.
-    Constant("PI") {
-      Math.PI
+    AsyncFunction("getAccessToken") { promise: Promise ->
+      try {
+        // Return the stored accessToken from initialization
+        promise.resolve(storedAccessToken)
+      } catch (e: Exception) {
+        promise.reject("ERROR", e.message, e)
+      }
     }
 
-    // Defines event names that the module can send to JavaScript.
-    Events("onChange")
+    AsyncFunction("getTestEventCode") { promise: Promise ->
+      try {
+        val code = TikTokBusinessSdk.getTestEventCode() ?: ""
+        promise.resolve(code)
+      } catch (e: Exception) {
+        promise.reject("ERROR", e.message, e)
+      }
+    }
 
-    // Defines a JavaScript synchronous function that runs the native code on the JavaScript thread.
-    Function("hello") {
-      "Hello world! 👋"
+    AsyncFunction("trackCustomEvent") { eventName: String, eventID: String, properties: List<Map<String, Any>>?, promise: Promise ->
+      try {
+        val propsJson = buildPropertiesJson(properties)
+        if (propsJson != null) {
+          TikTokBusinessSdk.trackEvent(eventName, propsJson)
+        } else {
+          TikTokBusinessSdk.trackEvent(eventName)
+        }
+        TikTokBusinessSdk.flush()
+        promise.resolve(null)
+      } catch (e: Exception) {
+        Log.e("TiktokAdsEvents", "Error tracking custom event: ${e.message}", e)
+        promise.reject("TRACK_ERROR", e.message, e)
+      }
     }
 
-    // Defines a JavaScript function that always returns a Promise and whose native code
-    // is by default dispatched on the different thread than the JavaScript runtime runs on.
-    AsyncFunction("setValueAsync") { value: String ->
-      // Send an event to JavaScript.
-      sendEvent("onChange", mapOf(
-        "value" to value
-      ))
+    AsyncFunction("trackTTEvent") { eventKey: String, properties: List<Map<String, Any>>?, promise: Promise ->
+      try {
+        val resolved = standardEventMap[eventKey] ?: eventKey
+        val propsJson = buildPropertiesJson(properties)
+
+        if (propsJson != null) {
+          TikTokBusinessSdk.trackEvent(resolved, propsJson)
+        } else {
+          TikTokBusinessSdk.trackEvent(resolved)
+        }
+        TikTokBusinessSdk.flush()
+
+        promise.resolve(resolved)
+      } catch (e: Exception) {
+        Log.e("TiktokAdsEvents", "Error tracking event: ${e.message}", e)
+        promise.reject("TRACK_ERROR", e.message, e)
+      }
     }
 
-    // Enables the module to be used as a native view. Definition components that are accepted as part of
-    // the view definition: Prop, Events.
-    View(ExpoTiktokAdsEventsView::class) {
-      // Defines a setter for the `url` prop.
-      Prop("url") { view: ExpoTiktokAdsEventsView, url: URL ->
-        view.webView.loadUrl(url.toString())
+    AsyncFunction("identify") { externalId: String, externalUserName: String?, phoneNumber: String?, email: String?, promise: Promise ->
+      try {
+        TikTokBusinessSdk.identify(
+          externalId,
+          externalUserName ?: "",
+          phoneNumber ?: "",
+          email ?: ""
+        )
+        promise.resolve(null)
+      } catch (e: Exception) {
+        Log.e("TiktokAdsEvents", "Error identifying user: ${e.message}", e)
+        promise.reject("IDENTIFY_ERROR", e.message, e)
       }
-      // Defines an event that the view can send to JavaScript.
-      Events("onLoad")
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-tiktok-ads-events",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Expo Tiktok SDK Events",
   "main": "build/index.js",
   "types": "build/index.d.ts",

package/android/src/main/java/expo/modules/tiktokadsevents/ExpoTiktokAdsEventsView.kt

@@ -1,30 +0,0 @@
-package expo.modules.tiktokadsevents
-
-import android.content.Context
-import android.webkit.WebView
-import android.webkit.WebViewClient
-import expo.modules.kotlin.AppContext
-import expo.modules.kotlin.viewevent.EventDispatcher
-import expo.modules.kotlin.views.ExpoView
-
-class ExpoTiktokAdsEventsView(context: Context, appContext: AppContext) : ExpoView(context, appContext) {
-  // Creates and initializes an event dispatcher for the `onLoad` event.
-  // The name of the event is inferred from the value and needs to match the event name defined in the module.
-  private val onLoad by EventDispatcher()
-
-  // Defines a WebView that will be used as the root subview.
-  internal val webView = WebView(context).apply {
-    layoutParams = LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT)
-    webViewClient = object : WebViewClient() {
-      override fun onPageFinished(view: WebView, url: String) {
-        // Sends an event to JavaScript. Triggers a callback defined on the view component in JavaScript.
-        onLoad(mapOf("url" to url))
-      }
-    }
-  }
-
-  init {
-    // Adds the WebView to the view hierarchy.
-    addView(webView)
-  }
-}