@datalyr/react-native 1.1.1 → 1.2.1

package/datalyr-react-native.podspec

@@ -0,0 +1,31 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name         = "datalyr-react-native"
+  s.version      = package['version']
+  s.summary      = package['description']
+  s.description  = <<-DESC
+    Datalyr SDK for React Native with bundled Meta (Facebook) and TikTok SDKs.
+    Provides deferred deep linking, event forwarding, and advanced attribution
+    without requiring users to install additional packages.
+  DESC
+  s.homepage     = package['homepage']
+  s.license      = package['license']
+  s.author       = package['author']
+  s.platform     = :ios, "13.0"
+  s.source       = { :git => package['repository']['url'], :tag => "v#{s.version}" }
+  s.source_files = "ios/**/*.{h,m,swift}"
+  s.swift_version = "5.0"
+
+  s.dependency "React-Core"
+  s.dependency "FBSDKCoreKit", "~> 17.0"
+  s.dependency "TikTokBusinessSDK", "~> 1.4"
+
+  # Disable bitcode (required for TikTok SDK)
+  s.pod_target_xcconfig = {
+    'ENABLE_BITCODE' => 'NO',
+    'DEFINES_MODULE' => 'YES'
+  }
+end

package/ios/DatalyrNative.m

@@ -0,0 +1,74 @@
+#import <React/RCTBridgeModule.h>
+
+@interface RCT_EXTERN_MODULE(DatalyrNative, NSObject)
+
+// Meta SDK Methods
+RCT_EXTERN_METHOD(initializeMetaSDK:(NSString *)appId
+                  clientToken:(NSString *)clientToken
+                  advertiserTrackingEnabled:(BOOL)advertiserTrackingEnabled
+                  resolve:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(fetchDeferredAppLink:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(logMetaEvent:(NSString *)eventName
+                  valueToSum:(NSNumber *)valueToSum
+                  parameters:(NSDictionary *)parameters
+                  resolve:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(logMetaPurchase:(double)amount
+                  currency:(NSString *)currency
+                  parameters:(NSDictionary *)parameters
+                  resolve:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(setMetaUserData:(NSDictionary *)userData
+                  resolve:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(clearMetaUserData:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(updateMetaTrackingAuthorization:(BOOL)enabled
+                  resolve:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+
+// TikTok SDK Methods
+RCT_EXTERN_METHOD(initializeTikTokSDK:(NSString *)appId
+                  tiktokAppId:(NSString *)tiktokAppId
+                  accessToken:(NSString *)accessToken
+                  debug:(BOOL)debug
+                  resolve:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(trackTikTokEvent:(NSString *)eventName
+                  eventId:(NSString *)eventId
+                  properties:(NSDictionary *)properties
+                  resolve:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(identifyTikTokUser:(NSString *)externalId
+                  externalUserName:(NSString *)externalUserName
+                  phoneNumber:(NSString *)phoneNumber
+                  email:(NSString *)email
+                  resolve:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(logoutTikTok:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(updateTikTokTrackingAuthorization:(BOOL)enabled
+                  resolve:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+
+// SDK Availability Check
+RCT_EXTERN_METHOD(getSDKAvailability:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+
+// Apple Search Ads Attribution
+RCT_EXTERN_METHOD(getAppleSearchAdsAttribution:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+
+@end

package/ios/DatalyrNative.swift

@@ -0,0 +1,332 @@
+import Foundation
+import FBSDKCoreKit
+import TikTokBusinessSDK
+import AdServices
+
+@objc(DatalyrNative)
+class DatalyrNative: NSObject {
+
+  @objc static func requiresMainQueueSetup() -> Bool {
+    return false
+  }
+
+  // MARK: - Meta (Facebook) SDK Methods
+
+  @objc func initializeMetaSDK(
+    _ appId: String,
+    clientToken: String?,
+    advertiserTrackingEnabled: Bool,
+    resolve: @escaping RCTPromiseResolveBlock,
+    reject: @escaping RCTPromiseRejectBlock
+  ) {
+    DispatchQueue.main.async {
+      Settings.shared.appID = appId
+
+      if let token = clientToken, !token.isEmpty {
+        Settings.shared.clientToken = token
+      }
+
+      Settings.shared.isAdvertiserTrackingEnabled = advertiserTrackingEnabled
+      Settings.shared.isAdvertiserIDCollectionEnabled = advertiserTrackingEnabled
+
+      ApplicationDelegate.shared.application(
+        UIApplication.shared,
+        didFinishLaunchingWithOptions: nil
+      )
+
+      resolve(true)
+    }
+  }
+
+  @objc func fetchDeferredAppLink(
+    _ resolve: @escaping RCTPromiseResolveBlock,
+    reject: @escaping RCTPromiseRejectBlock
+  ) {
+    AppLinkUtility.fetchDeferredAppLink { url, error in
+      if error != nil {
+        // Don't reject - deferred deep link not available is expected in many cases
+        // Error is normal when no deferred link exists
+        resolve(nil)
+        return
+      }
+
+      if let url = url {
+        resolve(url.absoluteString)
+      } else {
+        resolve(nil)
+      }
+    }
+  }
+
+  @objc func logMetaEvent(
+    _ eventName: String,
+    valueToSum: NSNumber?,
+    parameters: NSDictionary?,
+    resolve: @escaping RCTPromiseResolveBlock,
+    reject: @escaping RCTPromiseRejectBlock
+  ) {
+    var params: [AppEvents.ParameterName: Any] = [:]
+
+    if let dict = parameters as? [String: Any] {
+      for (key, value) in dict {
+        params[AppEvents.ParameterName(key)] = value
+      }
+    }
+
+    if let value = valueToSum?.doubleValue {
+      AppEvents.shared.logEvent(AppEvents.Name(eventName), valueToSum: value, parameters: params)
+    } else if params.isEmpty {
+      AppEvents.shared.logEvent(AppEvents.Name(eventName))
+    } else {
+      AppEvents.shared.logEvent(AppEvents.Name(eventName), parameters: params)
+    }
+
+    resolve(true)
+  }
+
+  @objc func logMetaPurchase(
+    _ amount: Double,
+    currency: String,
+    parameters: NSDictionary?,
+    resolve: @escaping RCTPromiseResolveBlock,
+    reject: @escaping RCTPromiseRejectBlock
+  ) {
+    var params: [AppEvents.ParameterName: Any] = [:]
+
+    if let dict = parameters as? [String: Any] {
+      for (key, value) in dict {
+        params[AppEvents.ParameterName(key)] = value
+      }
+    }
+
+    AppEvents.shared.logPurchase(amount: amount, currency: currency, parameters: params)
+    resolve(true)
+  }
+
+  @objc func setMetaUserData(
+    _ userData: NSDictionary,
+    resolve: @escaping RCTPromiseResolveBlock,
+    reject: @escaping RCTPromiseRejectBlock
+  ) {
+    AppEvents.shared.setUserData(
+      userData["email"] as? String,
+      forType: .email
+    )
+    AppEvents.shared.setUserData(
+      userData["firstName"] as? String,
+      forType: .firstName
+    )
+    AppEvents.shared.setUserData(
+      userData["lastName"] as? String,
+      forType: .lastName
+    )
+    AppEvents.shared.setUserData(
+      userData["phone"] as? String,
+      forType: .phone
+    )
+    AppEvents.shared.setUserData(
+      userData["dateOfBirth"] as? String,
+      forType: .dateOfBirth
+    )
+    AppEvents.shared.setUserData(
+      userData["gender"] as? String,
+      forType: .gender
+    )
+    AppEvents.shared.setUserData(
+      userData["city"] as? String,
+      forType: .city
+    )
+    AppEvents.shared.setUserData(
+      userData["state"] as? String,
+      forType: .state
+    )
+    AppEvents.shared.setUserData(
+      userData["zip"] as? String,
+      forType: .zip
+    )
+    AppEvents.shared.setUserData(
+      userData["country"] as? String,
+      forType: .country
+    )
+
+    resolve(true)
+  }
+
+  @objc func clearMetaUserData(
+    _ resolve: @escaping RCTPromiseResolveBlock,
+    reject: @escaping RCTPromiseRejectBlock
+  ) {
+    AppEvents.shared.clearUserData()
+    resolve(true)
+  }
+
+  @objc func updateMetaTrackingAuthorization(
+    _ enabled: Bool,
+    resolve: @escaping RCTPromiseResolveBlock,
+    reject: @escaping RCTPromiseRejectBlock
+  ) {
+    Settings.shared.isAdvertiserTrackingEnabled = enabled
+    Settings.shared.isAdvertiserIDCollectionEnabled = enabled
+    resolve(true)
+  }
+
+  // MARK: - TikTok SDK Methods
+
+  @objc func initializeTikTokSDK(
+    _ appId: String,
+    tiktokAppId: String,
+    accessToken: String?,
+    debug: Bool,
+    resolve: @escaping RCTPromiseResolveBlock,
+    reject: @escaping RCTPromiseRejectBlock
+  ) {
+    DispatchQueue.main.async {
+      let config = TikTokConfig(appId: appId, tiktokAppId: tiktokAppId)
+
+      if let token = accessToken, !token.isEmpty {
+        config?.accessToken = token
+      }
+
+      if debug {
+        config?.setLogLevel(.debug)
+      }
+
+      if let validConfig = config {
+        TikTokBusiness.initializeSdk(validConfig)
+        resolve(true)
+      } else {
+        reject("tiktok_init_error", "Failed to create TikTok config", nil)
+      }
+    }
+  }
+
+  @objc func trackTikTokEvent(
+    _ eventName: String,
+    eventId: String?,
+    properties: NSDictionary?,
+    resolve: @escaping RCTPromiseResolveBlock,
+    reject: @escaping RCTPromiseRejectBlock
+  ) {
+    // Use TikTokBaseEvent for modern API (trackEvent methods are deprecated)
+    let event: TikTokBaseEvent
+
+    if let eid = eventId, !eid.isEmpty {
+      event = TikTokBaseEvent(eventName: eventName, eventId: eid)
+    } else {
+      event = TikTokBaseEvent(eventName: eventName)
+    }
+
+    // Add properties to the event
+    if let dict = properties as? [String: Any] {
+      for (key, value) in dict {
+        event.addProperty(withKey: key, value: value)
+      }
+    }
+
+    TikTokBusiness.trackTTEvent(event)
+    resolve(true)
+  }
+
+  @objc func identifyTikTokUser(
+    _ externalId: String,
+    externalUserName: String,
+    phoneNumber: String,
+    email: String,
+    resolve: @escaping RCTPromiseResolveBlock,
+    reject: @escaping RCTPromiseRejectBlock
+  ) {
+    // Method signature: identifyWithExternalID:externalUserName:phoneNumber:email:
+    TikTokBusiness.identify(
+      withExternalID: externalId.isEmpty ? nil : externalId,
+      externalUserName: externalUserName.isEmpty ? nil : externalUserName,
+      phoneNumber: phoneNumber.isEmpty ? nil : phoneNumber,
+      email: email.isEmpty ? nil : email
+    )
+    resolve(true)
+  }
+
+  @objc func logoutTikTok(
+    _ resolve: @escaping RCTPromiseResolveBlock,
+    reject: @escaping RCTPromiseRejectBlock
+  ) {
+    TikTokBusiness.logout()
+    resolve(true)
+  }
+
+  @objc func updateTikTokTrackingAuthorization(
+    _ enabled: Bool,
+    resolve: @escaping RCTPromiseResolveBlock,
+    reject: @escaping RCTPromiseRejectBlock
+  ) {
+    // TikTok SDK handles ATT automatically, but we track the change
+    resolve(true)
+  }
+
+  // MARK: - SDK Availability Check
+
+  @objc func getSDKAvailability(
+    _ resolve: @escaping RCTPromiseResolveBlock,
+    reject: @escaping RCTPromiseRejectBlock
+  ) {
+    resolve([
+      "meta": true,
+      "tiktok": true,
+      "appleSearchAds": true
+    ])
+  }
+
+  // MARK: - Apple Search Ads Attribution
+
+  @objc func getAppleSearchAdsAttribution(
+    _ resolve: @escaping RCTPromiseResolveBlock,
+    reject: @escaping RCTPromiseRejectBlock
+  ) {
+    // AdServices is available on iOS 14.3+
+    if #available(iOS 14.3, *) {
+      do {
+        // Get the attribution token from AdServices
+        let token = try AAAttribution.attributionToken()
+
+        // Send token to Apple's API to get attribution data
+        var request = URLRequest(url: URL(string: "https://api-adservices.apple.com/api/v1/")!)
+        request.httpMethod = "POST"
+        request.setValue("text/plain", forHTTPHeaderField: "Content-Type")
+        request.httpBody = token.data(using: .utf8)
+
+        let task = URLSession.shared.dataTask(with: request) { data, response, error in
+          if let error = error {
+            // Network error - resolve with nil instead of rejecting
+            resolve(nil)
+            return
+          }
+
+          guard let data = data else {
+            resolve(nil)
+            return
+          }
+
+          do {
+            if let json = try JSONSerialization.jsonObject(with: data) as? [String: Any] {
+              // Return attribution data
+              // Includes: attribution, orgId, orgName, campaignId, campaignName,
+              // adGroupId, adGroupName, clickDate, conversionType, etc.
+              resolve(json)
+            } else {
+              resolve(nil)
+            }
+          } catch {
+            resolve(nil)
+          }
+        }
+        task.resume()
+
+      } catch {
+        // Attribution token not available (user didn't come from Apple Search Ads)
+        resolve(nil)
+      }
+    } else {
+      // iOS version too old
+      resolve(nil)
+    }
+  }
+}

package/ios/DatalyrSKAdNetwork.m

@@ -0,0 +1,26 @@
+#import <React/RCTBridgeModule.h>
+#import <StoreKit/StoreKit.h>
+
+@interface DatalyrSKAdNetwork : NSObject <RCTBridgeModule>
+@end
+
+@implementation DatalyrSKAdNetwork
+
+RCT_EXPORT_MODULE();
+
+RCT_EXPORT_METHOD(updateConversionValue:(NSInteger)value
+                  resolve:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject) {
+    if (@available(iOS 14.0, *)) {
+        @try {
+            [SKAdNetwork updateConversionValue:value];
+            resolve(@(YES));
+        } @catch (NSException *exception) {
+            reject(@"skadnetwork_error", exception.reason, nil);
+        }
+    } else {
+        reject(@"ios_version_error", @"SKAdNetwork requires iOS 14.0+", nil);
+    }
+}
+
+@end 

package/lib/datalyr-sdk.d.ts

@@ -1,6 +1,7 @@
-import { DatalyrConfig, EventData, UserProperties, AutoEventConfig } from './types';
+import { DatalyrConfig, EventData, UserProperties, AutoEventConfig, DeferredDeepLinkResult } from './types';
 import { AttributionData } from './attribution';
 import { SessionData } from './auto-events';
+import { AppleSearchAdsAttribution } from './native/DatalyrNativeBridge';
 export declare class DatalyrSDK {
     private state;
     private httpClient;
@@ -93,13 +94,67 @@ export declare class DatalyrSDK {
      */
     trackWithSKAdNetwork(event: string, properties?: EventData): Promise<void>;
     /**
-     * Track purchase with automatic revenue encoding
+     * Track purchase with automatic revenue encoding and platform forwarding
      */
     trackPurchase(value: number, currency?: string, productId?: string): Promise<void>;
     /**
-     * Track subscription with automatic revenue encoding
+     * Track subscription with automatic revenue encoding and platform forwarding
      */
     trackSubscription(value: number, currency?: string, plan?: string): Promise<void>;
+    /**
+     * Track add to cart event
+     */
+    trackAddToCart(value: number, currency?: string, productId?: string, productName?: string): Promise<void>;
+    /**
+     * Track view content/product event
+     */
+    trackViewContent(contentId?: string, contentName?: string, contentType?: string, value?: number, currency?: string): Promise<void>;
+    /**
+     * Track initiate checkout event
+     */
+    trackInitiateCheckout(value: number, currency?: string, numItems?: number, productIds?: string[]): Promise<void>;
+    /**
+     * Track complete registration event
+     */
+    trackCompleteRegistration(method?: string): Promise<void>;
+    /**
+     * Track search event
+     */
+    trackSearch(query: string, resultIds?: string[]): Promise<void>;
+    /**
+     * Track lead/contact form submission
+     */
+    trackLead(value?: number, currency?: string): Promise<void>;
+    /**
+     * Track add payment info event
+     */
+    trackAddPaymentInfo(success?: boolean): Promise<void>;
+    /**
+     * Get deferred attribution data from platform SDKs
+     */
+    getDeferredAttributionData(): DeferredDeepLinkResult | null;
+    /**
+     * Get platform integration status
+     */
+    getPlatformIntegrationStatus(): {
+        meta: boolean;
+        tiktok: boolean;
+        appleSearchAds: boolean;
+    };
+    /**
+     * Get Apple Search Ads attribution data
+     * Returns attribution if user installed via Apple Search Ads, null otherwise
+     */
+    getAppleSearchAdsAttribution(): AppleSearchAdsAttribution | null;
+    /**
+     * Update tracking authorization status on all platform SDKs
+     * Call this AFTER the user responds to the ATT permission dialog
+     */
+    updateTrackingAuthorization(enabled: boolean): Promise<void>;
+    /**
+     * Handle deferred deep link data from platform SDKs
+     */
+    private handleDeferredDeepLink;
     /**
      * Get conversion value for testing (doesn't send to Apple)
      */
@@ -175,5 +230,20 @@ export declare class Datalyr {
     static trackAppUpdate(previousVersion: string, currentVersion: string): Promise<void>;
     static trackRevenue(eventName: string, properties?: EventData): Promise<void>;
     static updateAutoEventsConfig(config: Partial<AutoEventConfig>): void;
+    static trackAddToCart(value: number, currency?: string, productId?: string, productName?: string): Promise<void>;
+    static trackViewContent(contentId?: string, contentName?: string, contentType?: string, value?: number, currency?: string): Promise<void>;
+    static trackInitiateCheckout(value: number, currency?: string, numItems?: number, productIds?: string[]): Promise<void>;
+    static trackCompleteRegistration(method?: string): Promise<void>;
+    static trackSearch(query: string, resultIds?: string[]): Promise<void>;
+    static trackLead(value?: number, currency?: string): Promise<void>;
+    static trackAddPaymentInfo(success?: boolean): Promise<void>;
+    static getDeferredAttributionData(): DeferredDeepLinkResult | null;
+    static getPlatformIntegrationStatus(): {
+        meta: boolean;
+        tiktok: boolean;
+        appleSearchAds: boolean;
+    };
+    static getAppleSearchAdsAttribution(): AppleSearchAdsAttribution | null;
+    static updateTrackingAuthorization(enabled: boolean): Promise<void>;
 }
 export default datalyr;