@datalyr/react-native 1.3.0 → 1.4.0

package/CHANGELOG.md

@@ -5,6 +5,25 @@ All notable changes to the Datalyr React Native SDK will be documented in this f
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.3.1] - 2026-01
+
+### Added
+- **iOS 18.4+ Features** - Geo-level postbacks, development postbacks, overlapping windows
+- **Privacy Manifest** (`ios/PrivacyInfo.xcprivacy`) - Required for App Store compliance
+- **Network Status Detection** - Automatic online/offline handling with queue sync
+- `SKAdNetworkBridge` iOS 18.4+ methods:
+  - `isGeoPostbackAvailable()` - Check for geo-level postback support
+  - `setPostbackEnvironment()` - Configure sandbox/production mode
+  - `getEnhancedAttributionInfo()` - Full feature matrix by iOS version
+  - `updatePostbackWithWindow()` - Overlapping window support
+  - `enableDevelopmentMode()` / `disableDevelopmentMode()` - Convenience methods
+- Migration guides from AppsFlyer and Adjust
+- Comprehensive troubleshooting section in README
+
+### Changed
+- Parallel SDK initialization for faster startup
+- Enhanced TypeScript types for iOS 18.4+ responses
+
 ## [1.2.1] - 2025-01
 
 ### Added

package/README.md

@@ -553,24 +553,160 @@ import {
 
 ---
 
+## Migrating from AppsFlyer / Adjust
+
+Datalyr provides similar functionality with a simpler integration.
+
+### From AppsFlyer
+
+```typescript
+// BEFORE: AppsFlyer
+import appsFlyer from 'react-native-appsflyer';
+appsFlyer.logEvent('af_purchase', { af_revenue: 99.99, af_currency: 'USD' });
+
+// AFTER: Datalyr
+import { Datalyr } from '@datalyr/react-native';
+await Datalyr.trackPurchase(99.99, 'USD', 'product_id');
+```
+
+### From Adjust
+
+```typescript
+// BEFORE: Adjust
+import { Adjust, AdjustEvent } from 'react-native-adjust';
+const event = new AdjustEvent('abc123');
+event.setRevenue(99.99, 'USD');
+Adjust.trackEvent(event);
+
+// AFTER: Datalyr
+import { Datalyr } from '@datalyr/react-native';
+await Datalyr.trackPurchase(99.99, 'USD');
+```
+
+### Event Mapping
+
+| AppsFlyer | Adjust | Datalyr |
+|-----------|--------|---------|
+| `af_purchase` | `PURCHASE` | `trackPurchase()` |
+| `af_add_to_cart` | `ADD_TO_CART` | `trackAddToCart()` |
+| `af_initiated_checkout` | `INITIATE_CHECKOUT` | `trackInitiateCheckout()` |
+| `af_complete_registration` | `COMPLETE_REGISTRATION` | `trackCompleteRegistration()` |
+| `af_content_view` | `VIEW_CONTENT` | `trackViewContent()` |
+| `af_subscribe` | `SUBSCRIBE` | `trackSubscription()` |
+
+### Migration Checklist
+
+- [ ] Remove old SDK: `npm uninstall react-native-appsflyer`
+- [ ] Install Datalyr: `npm install @datalyr/react-native`
+- [ ] Run `cd ios && pod install`
+- [ ] Replace initialization and event tracking code
+- [ ] Verify events in Datalyr dashboard
+
+---
+
 ## Troubleshooting
 
-### Events not appearing
+### Events Not Appearing
+
+**1. Check SDK Status**
+```typescript
+const status = Datalyr.getStatus();
+console.log('Initialized:', status.initialized);
+console.log('Queue size:', status.queueStats.queueSize);
+console.log('Online:', status.queueStats.isOnline);
+```
+
+**2. Enable Debug Mode**
+```typescript
+await Datalyr.initialize({
+  apiKey: 'dk_your_api_key',
+  debug: true,
+});
+```
+
+**3. Force Flush**
+```typescript
+await Datalyr.flush();
+```
+
+**4. Verify API Key** - Should start with `dk_`
 
-1. Check API key starts with `dk_`
-2. Enable `debug: true`
-3. Check `Datalyr.getStatus()` for queue info
-4. Verify network connectivity
+### iOS Build Errors
 
-### iOS build errors
+```bash
+cd ios
+pod deintegrate
+pod cache clean --all
+pod install
+```
 
+**Clean Reset**
 ```bash
-cd ios && pod deintegrate && pod install
+rm -rf node_modules ios/Pods ios/Podfile.lock
+npm install && cd ios && pod install
+```
+
+### Android Build Errors
+
+```bash
+cd android && ./gradlew clean
+npx react-native run-android
+```
+
+### Meta SDK Not Working
+
+Verify Info.plist:
+```xml
+<key>FacebookAppID</key>
+<string>YOUR_APP_ID</string>
+<key>FacebookClientToken</key>
+<string>YOUR_CLIENT_TOKEN</string>
+```
+
+Check status: `Datalyr.getPlatformIntegrationStatus()`
+
+### TikTok SDK Not Working
+
+```typescript
+await Datalyr.initialize({
+  apiKey: 'dk_your_api_key',
+  tiktok: {
+    appId: 'your_app_id',
+    tiktokAppId: '7123456789012345',
+  },
+});
+```
+
+### SKAdNetwork Not Updating
+
+1. iOS 14.0+ required (16.1+ for SKAN 4.0)
+2. Set `skadTemplate` in config
+3. Use `trackWithSKAdNetwork()` instead of `track()`
+
+### Attribution Not Captured
+
+```typescript
+await Datalyr.initialize({
+  apiKey: 'dk_your_api_key',
+  enableAttribution: true,
+});
+
+// Check data
+const attribution = Datalyr.getAttributionData();
+```
+
+### App Tracking Transparency (iOS 14.5+)
+
+```typescript
+import { requestTrackingPermissionsAsync } from 'expo-tracking-transparency';
+
+const { status } = await requestTrackingPermissionsAsync();
+await Datalyr.updateTrackingAuthorization(status === 'granted');
 ```
 
-### Meta/TikTok not working
+### Debug Logging
 
-Verify Info.plist contains required keys (see Installation).
+Look for `[Datalyr]` prefixed messages in console.
 
 ---
 

package/datalyr-react-native.podspec

@@ -19,7 +19,7 @@ Pod::Spec.new do |s|
   s.source_files = "ios/**/*.{h,m,swift}"
   s.swift_version = "5.0"
 
-  s.dependency "React-Core"
+  s.dependency "ExpoModulesCore"
   s.dependency "FBSDKCoreKit", "~> 18.0"
   s.dependency "TikTokBusinessSDK", "~> 1.6"
 

package/expo-module.config.json

@@ -0,0 +1,6 @@
+{
+  "platforms": ["ios"],
+  "ios": {
+    "modules": ["DatalyrNativeModule", "DatalyrSKAdNetworkModule"]
+  }
+}

package/ios/DatalyrNativeModule.swift

@@ -0,0 +1,221 @@
+import ExpoModulesCore
+import FBSDKCoreKit
+import TikTokBusinessSDK
+import AdServices
+
+public class DatalyrNativeModule: Module {
+  public func definition() -> ModuleDefinition {
+    Name("DatalyrNative")
+
+    // MARK: - Meta (Facebook) SDK Methods
+
+    AsyncFunction("initializeMetaSDK") { (appId: String, clientToken: String?, advertiserTrackingEnabled: Bool, promise: Promise) in
+      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
+        )
+
+        promise.resolve(true)
+      }
+    }
+
+    AsyncFunction("fetchDeferredAppLink") { (promise: Promise) in
+      AppLinkUtility.fetchDeferredAppLink { url, error in
+        if error != nil {
+          promise.resolve(nil)
+          return
+        }
+
+        if let url = url {
+          promise.resolve(url.absoluteString)
+        } else {
+          promise.resolve(nil)
+        }
+      }
+    }
+
+    AsyncFunction("logMetaEvent") { (eventName: String, valueToSum: Double?, parameters: [String: Any]?, promise: Promise) in
+      var params: [AppEvents.ParameterName: Any] = [:]
+
+      if let dict = parameters {
+        for (key, value) in dict {
+          params[AppEvents.ParameterName(key)] = value
+        }
+      }
+
+      if let value = valueToSum {
+        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)
+      }
+
+      promise.resolve(true)
+    }
+
+    AsyncFunction("logMetaPurchase") { (amount: Double, currency: String, parameters: [String: Any]?, promise: Promise) in
+      var params: [AppEvents.ParameterName: Any] = [:]
+
+      if let dict = parameters {
+        for (key, value) in dict {
+          params[AppEvents.ParameterName(key)] = value
+        }
+      }
+
+      AppEvents.shared.logPurchase(amount: amount, currency: currency, parameters: params)
+      promise.resolve(true)
+    }
+
+    AsyncFunction("setMetaUserData") { (userData: [String: Any], promise: Promise) in
+      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)
+
+      promise.resolve(true)
+    }
+
+    AsyncFunction("clearMetaUserData") { (promise: Promise) in
+      AppEvents.shared.clearUserData()
+      promise.resolve(true)
+    }
+
+    AsyncFunction("updateMetaTrackingAuthorization") { (enabled: Bool, promise: Promise) in
+      Settings.shared.isAdvertiserTrackingEnabled = enabled
+      Settings.shared.isAdvertiserIDCollectionEnabled = enabled
+      promise.resolve(true)
+    }
+
+    // MARK: - TikTok SDK Methods
+
+    AsyncFunction("initializeTikTokSDK") { (appId: String, tiktokAppId: String, accessToken: String?, debug: Bool, promise: Promise) in
+      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)
+          promise.resolve(true)
+        } else {
+          promise.reject("tiktok_init_error", "Failed to create TikTok config")
+        }
+      }
+    }
+
+    AsyncFunction("trackTikTokEvent") { (eventName: String, eventId: String?, properties: [String: Any]?, promise: Promise) in
+      let event: TikTokBaseEvent
+
+      if let eid = eventId, !eid.isEmpty {
+        event = TikTokBaseEvent(eventName: eventName, eventId: eid)
+      } else {
+        event = TikTokBaseEvent(eventName: eventName)
+      }
+
+      if let dict = properties {
+        for (key, value) in dict {
+          event.addProperty(withKey: key, value: value)
+        }
+      }
+
+      TikTokBusiness.trackTTEvent(event)
+      promise.resolve(true)
+    }
+
+    AsyncFunction("identifyTikTokUser") { (externalId: String, externalUserName: String, phoneNumber: String, email: String, promise: Promise) in
+      TikTokBusiness.identify(
+        withExternalID: externalId.isEmpty ? nil : externalId,
+        externalUserName: externalUserName.isEmpty ? nil : externalUserName,
+        phoneNumber: phoneNumber.isEmpty ? nil : phoneNumber,
+        email: email.isEmpty ? nil : email
+      )
+      promise.resolve(true)
+    }
+
+    AsyncFunction("logoutTikTok") { (promise: Promise) in
+      TikTokBusiness.logout()
+      promise.resolve(true)
+    }
+
+    AsyncFunction("updateTikTokTrackingAuthorization") { (enabled: Bool, promise: Promise) in
+      // TikTok SDK handles ATT automatically, but we track the change
+      promise.resolve(true)
+    }
+
+    // MARK: - SDK Availability Check
+
+    AsyncFunction("getSDKAvailability") { (promise: Promise) in
+      promise.resolve([
+        "meta": true,
+        "tiktok": true,
+        "appleSearchAds": true
+      ])
+    }
+
+    // MARK: - Apple Search Ads Attribution
+
+    AsyncFunction("getAppleSearchAdsAttribution") { (promise: Promise) in
+      if #available(iOS 14.3, *) {
+        do {
+          let token = try AAAttribution.attributionToken()
+
+          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 error != nil {
+              promise.resolve(nil)
+              return
+            }
+
+            guard let data = data else {
+              promise.resolve(nil)
+              return
+            }
+
+            do {
+              if let json = try JSONSerialization.jsonObject(with: data) as? [String: Any] {
+                promise.resolve(json)
+              } else {
+                promise.resolve(nil)
+              }
+            } catch {
+              promise.resolve(nil)
+            }
+          }
+          task.resume()
+
+        } catch {
+          promise.resolve(nil)
+        }
+      } else {
+        promise.resolve(nil)
+      }
+    }
+  }
+}