expo-tiktok-ads-events 0.1.0

package/.eslintrc.js

@@ -0,0 +1,5 @@
+module.exports = {
+  root: true,
+  extends: ['universe/native', 'universe/web'],
+  ignorePatterns: ['build'],
+};

package/README.md

@@ -0,0 +1,350 @@
+# expo-tiktok-ads-events
+
+Expo module for TikTok Business SDK integration, enabling event tracking for TikTok advertising campaigns.
+
+## Installation
+
+```bash
+npm install expo-tiktok-ads-events
+# or
+yarn add expo-tiktok-ads-events
+```
+
+## Setup
+
+### Initialization
+
+```typescript
+import TiktokAdsEvents from 'expo-tiktok-ads-events';
+import { requestTrackingPermissionsAsync } from 'expo-tracking-transparency';
+
+// Request tracking permission (iOS 14+)
+const { status } = await requestTrackingPermissionsAsync();
+
+// Initialize SDK
+await TiktokAdsEvents.initializeSdk(
+  'YOUR_ACCESS_TOKEN',  // TikTok Ads Manager access token
+  'YOUR_APP_ID',        // App ID
+  'YOUR_TIKTOK_APP_ID'  // TikTok App ID
+);
+```
+
+## Usage
+
+### Standard Events
+
+The module exports all TikTok standard events:
+
+```typescript
+import TiktokAdsEvents, { TikTokStandardEvents } from 'expo-tiktok-ads-events';
+
+// Track event without properties
+await TiktokAdsEvents.trackTTEvent(TikTokStandardEvents.launch_app);
+
+// Track event with properties
+await TiktokAdsEvents.trackTTEvent(TikTokStandardEvents.add_payment_info, [
+  { key: 'currency', value: 'USD' },
+  { key: 'value', value: 99.99 },
+  { key: 'payment_method', value: 'credit_card' }
+]);
+```
+
+#### Available Events
+
+- `achieve_level` - Level achieved
+- `add_payment_info` - Payment info added
+- `complete_tutorial` - Tutorial completed
+- `create_group` - Group created
+- `create_role` - Role created
+- `generate_lead` - Lead generated
+- `in_app_ad_click` - In-app ad clicked
+- `in_app_ad_impr` - In-app ad impression
+- `install_app` - App installed
+- `join_group` - Group joined
+- `launch_app` - App launched
+- `loan_application` - Loan application
+- `loan_approval` - Loan approval
+- `loan_disbursal` - Loan disbursal
+- `login` - User login
+- `rate` - Rating given
+- `registration` - User registration
+- `search` - Search performed
+- `spend_credits` - Credits spent
+- `start_trial` - Trial started
+- `subscribe` - Subscription
+- `unlock_achievement` - Achievement unlocked
+
+### Custom Events
+
+```typescript
+// Create custom event
+await TiktokAdsEvents.trackCustomEvent(
+  'custom_event_name',  // Event name
+  'EVENT_ID_123',       // Unique event ID
+  [                     // Optional properties
+    { key: 'category', value: 'gaming' },
+    { key: 'score', value: 1500 }
+  ]
+);
+```
+
+### User Identification
+
+```typescript
+import { TikTokIdentify } from 'expo-tiktok-ads-events';
+
+// Identify user
+await TikTokIdentify({
+  externalId: 'USER_123',
+  externalUserName: 'John Doe',
+  phoneNumber: '+1234567890',
+  email: 'john@example.com'
+});
+
+// Or using direct method
+await TiktokAdsEvents.identify(
+  'USER_123',           // External ID (required)
+  'John Doe',           // Name (optional)
+  '+1234567890',        // Phone (optional)
+  'john@example.com'    // Email (optional)
+);
+```
+
+### Helper Functions
+
+```typescript
+import { TikTokLaunchApp } from 'expo-tiktok-ads-events';
+
+// Helper for launch_app event
+await TikTokLaunchApp();
+
+// With properties
+await TikTokLaunchApp([
+  { key: 'source', value: 'notification' }
+]);
+```
+
+### Debug Information
+
+```typescript
+// Get anonymous user ID
+const anonymousId = await TiktokAdsEvents.getAnonymousID();
+
+// Get current access token
+const accessToken = await TiktokAdsEvents.getAccessToken();
+
+// Get test event code
+const testEventCode = await TiktokAdsEvents.getTestEventCode();
+```
+
+## Complete Example
+
+```typescript
+import { useEffect } from 'react';
+import TiktokAdsEvents, { 
+  TikTokLaunchApp, 
+  TikTokIdentify,
+  TikTokStandardEvents 
+} from 'expo-tiktok-ads-events';
+import { requestTrackingPermissionsAsync } from 'expo-tracking-transparency';
+
+export default function App() {
+  useEffect(() => {
+    (async () => {
+      // 1. Request tracking permission
+      const { status } = await requestTrackingPermissionsAsync();
+      
+      if (status === 'granted') {
+        // 2. Initialize SDK
+        await TiktokAdsEvents.initializeSdk(
+          'YOUR_ACCESS_TOKEN',
+          'YOUR_APP_ID',
+          'YOUR_TIKTOK_APP_ID'
+        );
+        
+        // 3. Identify user
+        await TikTokIdentify({
+          externalId: 'USER_123',
+          email: 'user@example.com'
+        });
+        
+        // 4. Track app launch
+        await TikTokLaunchApp();
+        
+        // 5. Get debug info
+        const anonymousId = await TiktokAdsEvents.getAnonymousID();
+        console.log('Anonymous ID:', anonymousId);
+      }
+    })();
+  }, []);
+
+  const handlePurchase = async () => {
+    // Track purchase with properties
+    await TiktokAdsEvents.trackTTEvent(TikTokStandardEvents.subscribe, [
+      { key: 'currency', value: 'USD' },
+      { key: 'value', value: 29.90 },
+      { key: 'content_type', value: 'subscription' },
+      { key: 'content_id', value: 'plan_premium' }
+    ]);
+  };
+
+  return (
+    // Your component
+  );
+}
+```
+
+## Event Properties
+
+### Common Properties
+
+- `currency` - Currency code (e.g., "USD", "EUR")
+- `value` - Monetary value
+- `content_type` - Content type
+- `content_id` - Content ID
+- `content_name` - Content name
+- `quantity` - Quantity
+- `description` - Description
+- `query` - Search query
+- `status` - Status
+
+### TypeScript Types
+
+```typescript
+type EventProperty = {
+  key: string;
+  value: string | number;
+};
+```
+
+## Testing Events
+
+1. Get test code:
+```typescript
+const testCode = await TiktokAdsEvents.getTestEventCode();
+console.log('Use this code in TikTok Events Manager:', testCode);
+```
+
+2. Go to [TikTok Events Manager](https://ads.tiktok.com/events_manager/)
+
+3. Select your pixel/app
+
+4. Navigate to "Test Events" 
+
+5. Enter the test code
+
+6. Trigger events in your app and see them in real-time
+
+## SDK Configuration
+
+The SDK is automatically configured with:
+
+- ✅ Tracking enabled
+- ✅ Launch tracking enabled  
+- ✅ Retention tracking enabled
+- ✅ SKAdNetwork enabled (iOS)
+- ✅ Debug mode enabled (development)
+
+## Compatibility
+
+- iOS 15.1+
+- Android (in development)
+- Expo SDK 54+
+
+## Troubleshooting
+
+### Events Not Appearing in TikTok
+
+1. Verify tracking permission is granted (iOS)
+2. Confirm credentials are correct
+3. Use test mode to validate events
+4. Wait up to 24 hours for production events to appear
+
+### Empty Anonymous ID
+
+Anonymous ID is generated after successful initialization. Make sure to call `initializeSdk` first.
+
+### Initialization Error
+
+Check:
+- Valid access token
+- Correct app IDs
+- Internet connection
+
+## API Reference
+
+### Methods
+
+#### `initializeSdk(accessToken, appId, tiktokAppId)`
+Initialize the TikTok Business SDK.
+
+**Parameters:**
+- `accessToken` (string): TikTok Ads Manager access token
+- `appId` (string): Your app ID
+- `tiktokAppId` (string): TikTok app ID
+
+**Returns:** Promise<string>
+
+#### `trackTTEvent(eventName, properties?)`
+Track a standard TikTok event.
+
+**Parameters:**
+- `eventName` (TikTokStandardEventValue): Event name from TikTokStandardEvents
+- `properties` (EventProperty[]): Optional array of event properties
+
+**Returns:** Promise<string>
+
+#### `trackCustomEvent(eventName, eventID, properties?)`
+Track a custom event.
+
+**Parameters:**
+- `eventName` (string): Custom event name
+- `eventID` (string): Unique event identifier
+- `properties` (EventProperty[]): Optional array of event properties
+
+**Returns:** Promise<void>
+
+#### `identify(externalId, externalUserName?, phoneNumber?, email?)`
+Identify a user.
+
+**Parameters:**
+- `externalId` (string): External user ID (required)
+- `externalUserName` (string): User name (optional)
+- `phoneNumber` (string): Phone number (optional)
+- `email` (string): Email address (optional)
+
+**Returns:** Promise<void>
+
+#### `getAnonymousID()`
+Get the anonymous user ID.
+
+**Returns:** Promise<string>
+
+#### `getAccessToken()`
+Get the current access token.
+
+**Returns:** Promise<string>
+
+#### `getTestEventCode()`
+Get the test event code for debugging.
+
+**Returns:** Promise<string>
+
+## License
+
+MIT
+
+## Author
+
+Bruno Verçosa - [Pixel Logic Apps](https://github.com/Pixel-Logic-Apps)
+
+## Contributing
+
+Contributions are welcome! Please open an issue or submit a pull request.
+
+## Links
+
+- [TikTok for Business](https://business.tiktok.com/)
+- [TikTok Ads Manager](https://ads.tiktok.com/)
+- [TikTok Events API](https://business-api.tiktok.com/portal/docs)
+- [Expo Modules Documentation](https://docs.expo.dev/modules/)

package/android/build.gradle

@@ -0,0 +1,43 @@
+apply plugin: 'com.android.library'
+
+group = 'expo.modules.tiktokadsevents'
+version = '0.1.0'
+
+def expoModulesCorePlugin = new File(project(":expo-modules-core").projectDir.absolutePath, "ExpoModulesCorePlugin.gradle")
+apply from: expoModulesCorePlugin
+applyKotlinExpoModulesCorePlugin()
+useCoreDependencies()
+useExpoPublishing()
+
+// 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.
+def useManagedAndroidSdkVersions = false
+if (useManagedAndroidSdkVersions) {
+  useDefaultAndroidSdkVersions()
+} else {
+  buildscript {
+    // Simple helper that allows the root project to override versions declared by this library.
+    ext.safeExtGet = { prop, fallback ->
+      rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
+    }
+  }
+  project.android {
+    compileSdkVersion safeExtGet("compileSdkVersion", 36)
+    defaultConfig {
+      minSdkVersion safeExtGet("minSdkVersion", 24)
+      targetSdkVersion safeExtGet("targetSdkVersion", 36)
+    }
+  }
+}
+
+android {
+  namespace "expo.modules.tiktokadsevents"
+  defaultConfig {
+    versionCode 1
+    versionName "0.1.0"
+  }
+  lintOptions {
+    abortOnError false
+  }
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest>
+</manifest>

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

@@ -0,0 +1,50 @@
+package expo.modules.tiktokadsevents
+
+import expo.modules.kotlin.modules.Module
+import expo.modules.kotlin.modules.ModuleDefinition
+import java.net.URL
+
+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.
+  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")
+
+    // Defines constant property on the module.
+    Constant("PI") {
+      Math.PI
+    }
+
+    // Defines event names that the module can send to JavaScript.
+    Events("onChange")
+
+    // Defines a JavaScript synchronous function that runs the native code on the JavaScript thread.
+    Function("hello") {
+      "Hello world! 👋"
+    }
+
+    // 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
+      ))
+    }
+
+    // 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())
+      }
+      // Defines an event that the view can send to JavaScript.
+      Events("onLoad")
+    }
+  }
+}

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

@@ -0,0 +1,30 @@
+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)
+  }
+}

package/build/ExpoTiktokAdsEventsModule.d.ts

@@ -0,0 +1,50 @@
+import { NativeModule } from 'expo';
+export declare const TikTokStandardEvents: {
+    readonly achieve_level: "achieve_level";
+    readonly add_payment_info: "add_payment_info";
+    readonly complete_tutorial: "complete_tutorial";
+    readonly create_group: "create_group";
+    readonly create_role: "create_role";
+    readonly generate_lead: "generate_lead";
+    readonly in_app_ad_click: "in_app_ad_click";
+    readonly in_app_ad_impr: "in_app_ad_impr";
+    readonly install_app: "install_app";
+    readonly join_group: "join_group";
+    readonly launch_app: "launch_app";
+    readonly loan_application: "loan_application";
+    readonly loan_approval: "loan_approval";
+    readonly loan_disbursal: "loan_disbursal";
+    readonly login: "login";
+    readonly rate: "rate";
+    readonly registration: "registration";
+    readonly search: "search";
+    readonly spend_credits: "spend_credits";
+    readonly start_trial: "start_trial";
+    readonly subscribe: "subscribe";
+    readonly unlock_achievement: "unlock_achievement";
+};
+export type TikTokStandardEventKey = keyof typeof TikTokStandardEvents;
+export type TikTokStandardEventValue = typeof TikTokStandardEvents[TikTokStandardEventKey];
+export type EventProperty = {
+    key: string;
+    value: string | number;
+};
+declare class TiktokAdsEventsModule extends NativeModule {
+    initializeSdk(accessToken: string, appId: string, tiktokAppId: string): Promise<string>;
+    trackTTEvent(name: TikTokStandardEventValue, properties?: EventProperty[]): Promise<string>;
+    trackCustomEvent(eventName: string, eventID: string, properties?: EventProperty[]): Promise<void>;
+    identify(externalId: string, externalUserName?: string, phoneNumber?: string, email?: string): Promise<void>;
+    getAnonymousID(): Promise<string>;
+    getAccessToken(): Promise<string>;
+    getTestEventCode(): Promise<string>;
+}
+declare const TiktokAdsEvents: TiktokAdsEventsModule;
+export default TiktokAdsEvents;
+export declare function TikTokLaunchApp(properties?: EventProperty[]): Promise<string>;
+export declare function TikTokIdentify(params: {
+    externalId: string;
+    externalUserName?: string;
+    phoneNumber?: string;
+    email?: string;
+}): Promise<void>;
+//# sourceMappingURL=ExpoTiktokAdsEventsModule.d.ts.map

package/build/ExpoTiktokAdsEventsModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpoTiktokAdsEventsModule.d.ts","sourceRoot":"","sources":["../src/ExpoTiktokAdsEventsModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,MAAM,CAAC;AAEzD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;CAuBvB,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,MAAM,OAAO,oBAAoB,CAAC;AACvE,MAAM,MAAM,wBAAwB,GAAG,OAAO,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;AAC3F,MAAM,MAAM,aAAa,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC;AAEpE,OAAO,OAAO,qBAAsB,SAAQ,YAAY;IACtD,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACvF,YAAY,CAAC,IAAI,EAAE,wBAAwB,EAAE,UAAU,CAAC,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAC3F,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IACjG,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAC5G,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IACjC,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IACjC,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;CACpC;AAED,QAAA,MAAM,eAAe,uBAAgE,CAAC;AACtF,eAAe,eAAe,CAAC;AAE/B,wBAAsB,eAAe,CAAC,UAAU,CAAC,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAEnF;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGpJ"}

package/build/ExpoTiktokAdsEventsModule.js

@@ -0,0 +1,35 @@
+import { requireNativeModule } from 'expo';
+export const TikTokStandardEvents = {
+    achieve_level: 'achieve_level',
+    add_payment_info: 'add_payment_info',
+    complete_tutorial: 'complete_tutorial',
+    create_group: 'create_group',
+    create_role: 'create_role',
+    generate_lead: 'generate_lead',
+    in_app_ad_click: 'in_app_ad_click',
+    in_app_ad_impr: 'in_app_ad_impr',
+    install_app: 'install_app',
+    join_group: 'join_group',
+    launch_app: 'launch_app',
+    loan_application: 'loan_application',
+    loan_approval: 'loan_approval',
+    loan_disbursal: 'loan_disbursal',
+    login: 'login',
+    rate: 'rate',
+    registration: 'registration',
+    search: 'search',
+    spend_credits: 'spend_credits',
+    start_trial: 'start_trial',
+    subscribe: 'subscribe',
+    unlock_achievement: 'unlock_achievement',
+};
+const TiktokAdsEvents = requireNativeModule('TiktokAdsEvents');
+export default TiktokAdsEvents;
+export async function TikTokLaunchApp(properties) {
+    return TiktokAdsEvents.trackTTEvent(TikTokStandardEvents.launch_app, properties);
+}
+export async function TikTokIdentify(params) {
+    const { externalId, externalUserName, phoneNumber, email } = params;
+    return TiktokAdsEvents.identify(externalId, externalUserName, phoneNumber, email);
+}
+//# sourceMappingURL=ExpoTiktokAdsEventsModule.js.map

package/build/ExpoTiktokAdsEventsModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpoTiktokAdsEventsModule.js","sourceRoot":"","sources":["../src/ExpoTiktokAdsEventsModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAEzD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,aAAa,EAAE,eAAe;IAC9B,gBAAgB,EAAE,kBAAkB;IACpC,iBAAiB,EAAE,mBAAmB;IACtC,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;IAC1B,aAAa,EAAE,eAAe;IAC9B,eAAe,EAAE,iBAAiB;IAClC,cAAc,EAAE,gBAAgB;IAChC,WAAW,EAAE,aAAa;IAC1B,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;IACxB,gBAAgB,EAAE,kBAAkB;IACpC,aAAa,EAAE,eAAe;IAC9B,cAAc,EAAE,gBAAgB;IAChC,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,YAAY,EAAE,cAAc;IAC5B,MAAM,EAAE,QAAQ;IAChB,aAAa,EAAE,eAAe;IAC9B,WAAW,EAAE,aAAa;IAC1B,SAAS,EAAE,WAAW;IACtB,kBAAkB,EAAE,oBAAoB;CAChC,CAAC;AAgBX,MAAM,eAAe,GAAG,mBAAmB,CAAwB,iBAAiB,CAAC,CAAC;AACtF,eAAe,eAAe,CAAC;AAE/B,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,UAA4B;IAChE,OAAO,eAAe,CAAC,YAAY,CAAC,oBAAoB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAgG;IACnI,MAAM,EAAE,UAAU,EAAE,gBAAgB,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IACpE,OAAO,eAAe,CAAC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;AACpF,CAAC","sourcesContent":["import { NativeModule, requireNativeModule } from 'expo';\n\nexport const TikTokStandardEvents = {\n  achieve_level: 'achieve_level',\n  add_payment_info: 'add_payment_info',\n  complete_tutorial: 'complete_tutorial',\n  create_group: 'create_group',\n  create_role: 'create_role',\n  generate_lead: 'generate_lead',\n  in_app_ad_click: 'in_app_ad_click',\n  in_app_ad_impr: 'in_app_ad_impr',\n  install_app: 'install_app',\n  join_group: 'join_group',\n  launch_app: 'launch_app',\n  loan_application: 'loan_application',\n  loan_approval: 'loan_approval',\n  loan_disbursal: 'loan_disbursal',\n  login: 'login',\n  rate: 'rate',\n  registration: 'registration',\n  search: 'search',\n  spend_credits: 'spend_credits',\n  start_trial: 'start_trial',\n  subscribe: 'subscribe',\n  unlock_achievement: 'unlock_achievement',\n} as const;\n\nexport type TikTokStandardEventKey = keyof typeof TikTokStandardEvents;\nexport type TikTokStandardEventValue = typeof TikTokStandardEvents[TikTokStandardEventKey];\nexport type EventProperty = { key: string; value: string | number };\n\ndeclare class TiktokAdsEventsModule extends NativeModule {\n  initializeSdk(accessToken: string, appId: string, tiktokAppId: string): Promise<string>;\n  trackTTEvent(name: TikTokStandardEventValue, properties?: EventProperty[]): Promise<string>;\n  trackCustomEvent(eventName: string, eventID: string, properties?: EventProperty[]): Promise<void>;\n  identify(externalId: string, externalUserName?: string, phoneNumber?: string, email?: string): Promise<void>;\n  getAnonymousID(): Promise<string>;\n  getAccessToken(): Promise<string>;\n  getTestEventCode(): Promise<string>;\n}\n\nconst TiktokAdsEvents = requireNativeModule<TiktokAdsEventsModule>('TiktokAdsEvents');\nexport default TiktokAdsEvents;\n\nexport async function TikTokLaunchApp(properties?: EventProperty[]): Promise<string> {\n  return TiktokAdsEvents.trackTTEvent(TikTokStandardEvents.launch_app, properties);\n}\n\nexport async function TikTokIdentify(params: { externalId: string; externalUserName?: string; phoneNumber?: string; email?: string; }): Promise<void> {\n  const { externalId, externalUserName, phoneNumber, email } = params;\n  return TiktokAdsEvents.identify(externalId, externalUserName, phoneNumber, email);\n}\n"]}

package/build/index.d.ts

@@ -0,0 +1,4 @@
+export { default, TikTokLaunchApp, TikTokIdentify } from './ExpoTiktokAdsEventsModule';
+export { default as ExpoTiktokAdsEvents } from './ExpoTiktokAdsEventsModule';
+export { TikTokStandardEvents, TikTokStandardEventKey, TikTokStandardEventValue } from './ExpoTiktokAdsEventsModule';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC"}

package/build/index.js

@@ -0,0 +1,4 @@
+export { default, TikTokLaunchApp, TikTokIdentify } from './ExpoTiktokAdsEventsModule';
+export { default as ExpoTiktokAdsEvents } from './ExpoTiktokAdsEventsModule';
+export { TikTokStandardEvents } from './ExpoTiktokAdsEventsModule';
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAoD,MAAM,6BAA6B,CAAC","sourcesContent":["export { default, TikTokLaunchApp, TikTokIdentify } from './ExpoTiktokAdsEventsModule';\nexport { default as ExpoTiktokAdsEvents } from './ExpoTiktokAdsEventsModule';\nexport { TikTokStandardEvents, TikTokStandardEventKey, TikTokStandardEventValue } from './ExpoTiktokAdsEventsModule';\n"]}

package/expo-module.config.json

@@ -0,0 +1,9 @@
+{
+  "platforms": ["apple", "android", "web"],
+  "apple": {
+    "modules": ["ExpoTiktokAdsEventsModule"]
+  },
+  "android": {
+    "modules": ["expo.modules.tiktokadsevents.ExpoTiktokAdsEventsModule"]
+  }
+}

package/ios/ExpoTiktokAdsEvents.podspec

@@ -0,0 +1,30 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, '..', 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name           = 'ExpoTiktokAdsEvents'
+  s.version        = package['version']
+  s.summary        = package['description']
+  s.description    = package['description']
+  s.license        = package['license']
+  s.author         = package['author']
+  s.homepage       = package['homepage']
+  s.platforms      = {
+    :ios => '15.1',
+    :tvos => '15.1'
+  }
+  s.swift_version  = '5.9'
+  s.source         = { git: 'https://github.com/Pixel-Logic-Apps/expo-tiktok-ads-events' }
+  s.static_framework = true
+
+  s.dependency 'ExpoModulesCore'
+  s.dependency 'TikTokBusinessSDK'
+
+  # Swift/Objective-C compatibility
+  s.pod_target_xcconfig = {
+    'DEFINES_MODULE' => 'YES',
+  }
+
+  s.source_files = "**/*.{h,m,mm,swift,hpp,cpp}"
+end

package/ios/ExpoTiktokAdsEventsModule.swift

@@ -0,0 +1,99 @@
+import ExpoModulesCore
+import TikTokBusinessSDK
+
+public class ExpoTiktokAdsEventsModule: Module {
+  
+  private func addPropertiesToEvent(_ event: TikTokBaseEvent, properties: [[String: Any]]?) {
+    properties?.forEach { prop in
+        if let key = prop["key"] as? String,
+           let value = prop["value"] {
+            event.addProperty(withKey: key, value: value)
+        }
+    }
+  }
+
+  public func definition() -> ModuleDefinition {
+    Name("TiktokAdsEvents")
+
+    AsyncFunction("initializeSdk") { (accessToken: String, appId: String, tiktokAppId: String, promise: Promise) in
+        let config = TikTokConfig.init(accessToken: accessToken, appId: appId, tiktokAppId: tiktokAppId)
+        config?.trackingEnabled = true
+        config?.launchTrackingEnabled = true
+        config?.retentionTrackingEnabled = true
+        config?.skAdNetworkSupportEnabled = true
+        config?.debugModeEnabled = true
+        TikTokBusiness.initializeSdk(config){ success, error in
+          if (success) {
+              promise.resolve("initialization successful")
+          } else {
+              let message = error?.localizedDescription ?? "unknown"
+              promise.reject("ERR_TIKTOK_INIT", message)
+          }
+        }
+    }
+    
+    AsyncFunction("getAnonymousID") { () -> String in
+      TikTokBusiness.getInstance().anonymousID
+    }
+
+    AsyncFunction("getAccessToken") { () -> String in
+      TikTokBusiness.getInstance().accessToken
+    }
+
+    AsyncFunction("getTestEventCode") { () -> String in
+      TikTokBusiness.getTestEventCode()
+    }
+
+    AsyncFunction("trackCustomEvent") { (eventName: String, eventID: String, properties: [[String: Any]]?) in
+        let customEvent = TikTokBaseEvent(eventName: eventName, eventId: eventID)
+        self.addPropertiesToEvent(customEvent, properties: properties)
+        TikTokBusiness.trackTTEvent(customEvent)
+    }
+    
+    AsyncFunction("trackTTEvent") { (eventKey: String, properties: [[String: Any]]?) -> String in
+        let map: [String: String] = [
+            "achieve_level": TTEventName.achieveLevel.rawValue,
+            "add_payment_info": TTEventName.addPaymentInfo.rawValue,
+            "complete_tutorial": TTEventName.completeTutorial.rawValue,
+            "create_group": TTEventName.createGroup.rawValue,
+            "create_role": TTEventName.createRole.rawValue,
+            "generate_lead": TTEventName.generateLead.rawValue,
+            "in_app_ad_click": TTEventName.inAppADClick.rawValue,
+            "in_app_ad_impr": TTEventName.inAppADImpr.rawValue,
+            "install_app": TTEventName.installApp.rawValue,
+            "join_group": TTEventName.joinGroup.rawValue,
+            "launch_app": TTEventName.launchAPP.rawValue,
+            "loan_application": TTEventName.loanApplication.rawValue,
+            "loan_approval": TTEventName.loanApproval.rawValue,
+            "loan_disbursal": TTEventName.loanDisbursal.rawValue,
+            "login": TTEventName.login.rawValue,
+            "rate": TTEventName.rate.rawValue,
+            "registration": TTEventName.registration.rawValue,
+            "search": TTEventName.search.rawValue,
+            "spend_credits": TTEventName.spendCredits.rawValue,
+            "start_trial": TTEventName.startTrial.rawValue,
+            "subscribe": TTEventName.subscribe.rawValue,
+            "unlock_achievement": TTEventName.unlockAchievement.rawValue
+        ]
+        let resolved = map[eventKey] ?? eventKey
+        let event = TikTokBaseEvent(name: resolved)
+        self.addPropertiesToEvent(event, properties: properties)
+        TikTokBusiness.trackTTEvent(event)
+        return resolved
+    }
+
+      
+      
+    AsyncFunction("anonymousID") { () -> String in
+        return TikTokBusiness().anonymousID + "asdasd"
+    }
+
+    AsyncFunction("identify") { (externalId: String, externalUserName: String?, phoneNumber: String?, email: String?) in
+        let name = externalUserName ?? ""
+        let phone = phoneNumber ?? ""
+        let mail = email ?? ""
+        TikTokBusiness.identify(withExternalID: externalId, externalUserName: name, phoneNumber: phone, email: mail)
+    }
+      
+  }
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "expo-tiktok-ads-events",
+  "version": "0.1.0",
+  "description": "Expo Tiktok SDK Events",
+  "main": "build/index.js",
+  "types": "build/index.d.ts",
+  "scripts": {
+    "build": "expo-module build",
+    "clean": "expo-module clean",
+    "lint": "expo-module lint",
+    "test": "expo-module test",
+    "prepare": "expo-module prepare",
+    "prepublishOnly": "expo-module prepublishOnly",
+    "expo-module": "expo-module",
+    "open:ios": "xed example/ios",
+    "open:android": "open -a \"Android Studio\" example/android"
+  },
+  "keywords": [
+    "react-native",
+    "expo",
+    "expo-tiktok-ads-events",
+    "ExpoTiktokAdsEvents"
+  ],
+  "repository": "https://github.com/Pixel-Logic-Apps/expo-tiktok-ads-events",
+  "bugs": {
+    "url": "https://github.com/Pixel-Logic-Apps/expo-tiktok-ads-events/issues"
+  },
+  "author": "Bruno Verçosa <bruno.vmartins@hotmail.com> (https://github.com/Pixel-Logic-Apps)",
+  "license": "MIT",
+  "homepage": "https://github.com/Pixel-Logic-Apps/expo-tiktok-ads-events#readme",
+  "dependencies": {},
+  "devDependencies": {
+    "@types/react": "~19.1.0",
+    "expo-module-scripts": "^5.0.7",
+    "expo": "^54.0.7",
+    "react-native": "0.81.4"
+  },
+  "peerDependencies": {
+    "expo": "*",
+    "react": "*",
+    "react-native": "*"
+  }
+}

package/src/ExpoTiktokAdsEventsModule.ts

@@ -0,0 +1,52 @@
+import { NativeModule, requireNativeModule } from 'expo';
+
+export const TikTokStandardEvents = {
+  achieve_level: 'achieve_level',
+  add_payment_info: 'add_payment_info',
+  complete_tutorial: 'complete_tutorial',
+  create_group: 'create_group',
+  create_role: 'create_role',
+  generate_lead: 'generate_lead',
+  in_app_ad_click: 'in_app_ad_click',
+  in_app_ad_impr: 'in_app_ad_impr',
+  install_app: 'install_app',
+  join_group: 'join_group',
+  launch_app: 'launch_app',
+  loan_application: 'loan_application',
+  loan_approval: 'loan_approval',
+  loan_disbursal: 'loan_disbursal',
+  login: 'login',
+  rate: 'rate',
+  registration: 'registration',
+  search: 'search',
+  spend_credits: 'spend_credits',
+  start_trial: 'start_trial',
+  subscribe: 'subscribe',
+  unlock_achievement: 'unlock_achievement',
+} as const;
+
+export type TikTokStandardEventKey = keyof typeof TikTokStandardEvents;
+export type TikTokStandardEventValue = typeof TikTokStandardEvents[TikTokStandardEventKey];
+export type EventProperty = { key: string; value: string | number };
+
+declare class TiktokAdsEventsModule extends NativeModule {
+  initializeSdk(accessToken: string, appId: string, tiktokAppId: string): Promise<string>;
+  trackTTEvent(name: TikTokStandardEventValue, properties?: EventProperty[]): Promise<string>;
+  trackCustomEvent(eventName: string, eventID: string, properties?: EventProperty[]): Promise<void>;
+  identify(externalId: string, externalUserName?: string, phoneNumber?: string, email?: string): Promise<void>;
+  getAnonymousID(): Promise<string>;
+  getAccessToken(): Promise<string>;
+  getTestEventCode(): Promise<string>;
+}
+
+const TiktokAdsEvents = requireNativeModule<TiktokAdsEventsModule>('TiktokAdsEvents');
+export default TiktokAdsEvents;
+
+export async function TikTokLaunchApp(properties?: EventProperty[]): Promise<string> {
+  return TiktokAdsEvents.trackTTEvent(TikTokStandardEvents.launch_app, properties);
+}
+
+export async function TikTokIdentify(params: { externalId: string; externalUserName?: string; phoneNumber?: string; email?: string; }): Promise<void> {
+  const { externalId, externalUserName, phoneNumber, email } = params;
+  return TiktokAdsEvents.identify(externalId, externalUserName, phoneNumber, email);
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export { default, TikTokLaunchApp, TikTokIdentify } from './ExpoTiktokAdsEventsModule';
+export { default as ExpoTiktokAdsEvents } from './ExpoTiktokAdsEventsModule';
+export { TikTokStandardEvents, TikTokStandardEventKey, TikTokStandardEventValue } from './ExpoTiktokAdsEventsModule';

package/tsconfig.json

@@ -0,0 +1,9 @@
+// @generated by expo-module-scripts
+{
+  "extends": "expo-module-scripts/tsconfig.base",
+  "compilerOptions": {
+    "outDir": "./build"
+  },
+  "include": ["./src"],
+  "exclude": ["**/__mocks__/*", "**/__tests__/*", "**/__rsc_tests__/*"]
+}