@datalyr/react-native 1.4.9 → 1.6.0

package/CHANGELOG.md

@@ -5,6 +5,45 @@ 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.6.0] - 2026-03
+
+### Removed
+- **Meta (Facebook) SDK** - Removed FBSDKCoreKit (iOS) and facebook-android-sdk (Android) dependencies
+- **TikTok Business SDK** - Removed TikTokBusinessSDK (iOS) and tiktok-business-android-sdk (Android) dependencies
+- Removed ByteDance maven repository from Android build
+- Removed `MetaConfig`, `TikTokConfig` TypeScript interfaces
+- Removed `MetaNativeBridge`, `TikTokNativeBridge` native bridge modules
+- Removed all client-side event forwarding to Meta/TikTok
+- Removed `meta-integration.ts`, `tiktok-integration.ts`, `DatalyrObjCExceptionCatcher`
+
+### Changed
+- Conversion event routing to Meta (CAPI), TikTok (Events API), and Google Ads is now handled entirely server-side via the Datalyr postback system
+- IDFA/ATT and GAID now use native Apple/Google frameworks directly
+- `getPlatformIntegrationStatus()` returns only `appleSearchAds` and `playInstallReferrer`
+
+### Migration from v1.5.x
+Remove `meta` and `tiktok` config objects from your `initialize()` call:
+```typescript
+// Before (v1.5.x)
+await Datalyr.initialize({
+  apiKey: 'dk_...',
+  meta: { appId: 'FB_APP_ID', clientToken: '...' },     // REMOVE
+  tiktok: { appId: '...', tiktokAppId: '...' },          // REMOVE
+});
+
+// After (v1.6.0)
+await Datalyr.initialize({
+  apiKey: 'dk_...',
+});
+```
+No other code changes needed. All tracking methods (`trackPurchase`, `trackAddToCart`, etc.) work the same — events are routed to ad platforms server-side via your Datalyr postback rules.
+
+If you were importing `metaIntegration` or `tiktokIntegration` directly, remove those imports — they no longer exist.
+
+iOS: Remove from Info.plist: `FacebookAppID`, `FacebookClientToken`, `FacebookDisplayName`, and `LSApplicationQueriesSchemes` entries for TikTok.
+
+Android: No changes needed — Meta/TikTok dependencies are automatically removed on `pod install` / gradle sync.
+
 ## [1.3.1] - 2026-01
 
 ### Added

package/README.md

@@ -18,13 +18,11 @@ Mobile analytics and attribution SDK for React Native and Expo. Track events, id
   - [User Properties](#user-properties)
 - [Attribution](#attribution)
   - [Automatic Capture](#automatic-capture)
-  - [Deferred Deep Links](#deferred-deep-links)
+  - [Web-to-App Attribution](#web-to-app-attribution)
 - [Event Queue](#event-queue)
 - [Auto Events](#auto-events)
 - [SKAdNetwork](#skadnetwork)
 - [Platform Integrations](#platform-integrations)
-  - [Meta](#meta-facebook)
-  - [TikTok](#tiktok)
   - [Apple Search Ads](#apple-search-ads)
 - [Expo Support](#expo-support)
 - [TypeScript](#typescript)
@@ -45,38 +43,6 @@ npm install @datalyr/react-native
 cd ios && pod install
 ```
 
-This installs the SDK with bundled Meta and TikTok native SDKs.
-
-Add to `ios/YourApp/Info.plist`:
-
-```xml
-<!-- Meta SDK -->
-<key>FacebookAppID</key>
-<string>YOUR_FACEBOOK_APP_ID</string>
-<key>FacebookClientToken</key>
-<string>YOUR_CLIENT_TOKEN</string>
-<key>FacebookDisplayName</key>
-<string>Your App Name</string>
-
-<key>CFBundleURLTypes</key>
-<array>
-  <dict>
-    <key>CFBundleURLSchemes</key>
-    <array>
-      <string>fbYOUR_FACEBOOK_APP_ID</string>
-    </array>
-  </dict>
-</array>
-
-<!-- TikTok SDK -->
-<key>LSApplicationQueriesSchemes</key>
-<array>
-  <string>tiktok</string>
-  <string>snssdk1180</string>
-  <string>snssdk1233</string>
-</array>
-```
-
 ### Android Setup
 
 No additional setup required.
@@ -170,9 +136,6 @@ await Datalyr.initialize({
   // iOS
   skadTemplate?: 'ecommerce' | 'gaming' | 'subscription',
 
-  // Platform SDKs
-  meta?: MetaConfig,
-  tiktok?: TikTokConfig,
 });
 ```
 
@@ -220,7 +183,7 @@ await Datalyr.screen('Product Details', {
 
 ### E-Commerce Events
 
-Standard e-commerce events that also forward to Meta and TikTok:
+Standard e-commerce events:
 
 ```typescript
 // View product
@@ -282,7 +245,6 @@ await Datalyr.identify('user_123', {
 After `identify()`:
 - All future events include `user_id`
 - Historical anonymous events can be linked server-side
-- User data is forwarded to Meta/TikTok for Advanced Matching
 
 ### User Properties
 
@@ -335,26 +297,22 @@ Captured parameters:
 | Click IDs | `fbclid`, `gclid`, `ttclid`, `twclid`, `li_click_id`, `msclkid` |
 | Campaign | `campaign_id`, `adset_id`, `ad_id` |
 
-### Deferred Deep Links
+### Web-to-App Attribution
 
-Capture attribution from App Store installs (iOS):
+Automatically recover attribution from a web prelander when users install the app from an ad.
 
-```typescript
-await Datalyr.initialize({
-  apiKey: 'dk_your_api_key',
-  meta: {
-    appId: '1234567890',
-    enableDeferredDeepLink: true,
-  },
-});
+**How it works:**
+- **Android**: Attribution params are passed through the Play Store `referrer` URL parameter (set by the web SDK's `trackAppDownloadClick()`). The mobile SDK reads these via the Play Install Referrer API — deterministic, ~95% accuracy.
+- **iOS**: On first install, the SDK calls the Datalyr API to match the device's IP against recent `$app_download_click` web events within 24 hours — ~90%+ accuracy for immediate installs.
 
-// Check for deferred attribution
-const deferred = Datalyr.getDeferredAttributionData();
-if (deferred) {
-  console.log(deferred.fbclid);      // Facebook click ID
-  console.log(deferred.campaignId);  // Campaign ID
-}
-```
+No additional mobile code is needed. Attribution is recovered automatically during `initialize()` on first install, before the `app_install` event fires.
+
+After a match, the SDK:
+1. Merges web attribution (click IDs, UTMs, cookies) into the mobile session
+2. Tracks a `$web_attribution_matched` event for analytics
+3. All subsequent events (including purchases) carry the matched attribution
+
+**Fallback:** If IP matching misses (e.g., VPN toggle during install), email-based attribution is still recovered when `identify()` is called with the user's email.
 
 ### Manual Attribution
 
@@ -456,46 +414,7 @@ await Datalyr.trackPurchase(99.99, 'USD');
 
 ## Platform Integrations
 
-Bundled Meta and TikTok SDKs for iOS. No extra npm packages needed.
-
-### Meta (Facebook)
-
-```typescript
-await Datalyr.initialize({
-  apiKey: 'dk_your_api_key',
-  meta: {
-    appId: '1234567890',
-    clientToken: 'abc123',
-    enableDeferredDeepLink: true,
-    enableAppEvents: true,
-  },
-});
-```
-
-### TikTok
-
-```typescript
-await Datalyr.initialize({
-  apiKey: 'dk_your_api_key',
-  tiktok: {
-    appId: 'your_app_id',                    // Events API App ID
-    tiktokAppId: '7123456789',               // TikTok App ID (Developer Portal)
-    accessToken: 'your_access_token',        // Events API Access Token
-    enableAppEvents: true,
-  },
-});
-```
-
-**Where to find your TikTok credentials:**
-
-| Credential | Where to get it |
-|------------|----------------|
-| `tiktokAppId` | [TikTok Developer Portal](https://developers.tiktok.com) → Your App → App ID |
-| `appId` | TikTok Business Center → Assets → Events → Your App → App ID |
-| `accessToken` | TikTok Business Center → Assets → Events → Your App → Settings → Access Token |
-
-> **Note:** The `accessToken` enables client-side TikTok SDK features (enhanced attribution, real-time event forwarding). Without it, events are still tracked server-side via Datalyr postbacks — you'll see a warning in debug mode.
-```
+Conversion event routing to Meta, TikTok, and Google is handled server-side via the postback system. No client-side SDK configuration is needed for these platforms.
 
 ### Apple Search Ads
 
@@ -536,7 +455,7 @@ await Datalyr.updateTrackingAuthorization(status === 'granted');
 
 ```typescript
 const status = Datalyr.getPlatformIntegrationStatus();
-// { meta: true, tiktok: true, appleSearchAds: true }
+// { appleSearchAds: true }
 ```
 
 ---
@@ -665,35 +584,6 @@ 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
-
-1. Make sure you have all three TikTok credentials (see [TikTok setup](#tiktok))
-2. The `accessToken` is required for client-side SDK — without it, you'll see a warning but server-side tracking still works
-3. Check status: `Datalyr.getPlatformIntegrationStatus()`
-
-```typescript
-await Datalyr.initialize({
-  apiKey: 'dk_your_api_key',
-  tiktok: {
-    appId: 'your_app_id',
-    tiktokAppId: '7123456789012345',
-    accessToken: 'your_access_token',
-  },
-});
-```
-
 ### SKAdNetwork Not Updating
 
 1. iOS 14.0+ required (16.1+ for SKAN 4.0)

package/android/build.gradle

@@ -36,19 +36,12 @@ android {
 repositories {
     google()
     mavenCentral()
-    maven { url "https://artifact.bytedance.com/repository/pangle" } // TikTok SDK
 }
 
 dependencies {
     // React Native
     implementation "com.facebook.react:react-native:+"
 
-    // Meta (Facebook) SDK - Updated Jan 2026
-    implementation 'com.facebook.android:facebook-android-sdk:18.1.3'
-
-    // TikTok Business SDK - Updated Jan 2026
-    implementation 'com.tiktok.business.sdk:tiktok-business-android-sdk:1.6.0'
-
     // Google Play Install Referrer
     implementation 'com.android.installreferrer:installreferrer:2.2'