@datalyr/react-native 1.5.0 → 1.6.1

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,15 +18,19 @@ 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)
+  - [Meta (Facebook)](#meta-facebook)
   - [TikTok](#tiktok)
+  - [Google Ads](#google-ads)
   - [Apple Search Ads](#apple-search-ads)
+- [Third-Party Integrations](#third-party-integrations)
+  - [Superwall](#superwall)
+  - [RevenueCat](#revenuecat)
+- [Migrating from AppsFlyer / Adjust](#migrating-from-appsflyer--adjust)
 - [Expo Support](#expo-support)
 - [TypeScript](#typescript)
 - [Troubleshooting](#troubleshooting)
@@ -46,38 +50,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.
@@ -171,9 +143,6 @@ await Datalyr.initialize({
   // iOS
   skadTemplate?: 'ecommerce' | 'gaming' | 'subscription',
 
-  // Platform SDKs
-  meta?: MetaConfig,
-  tiktok?: TikTokConfig,
 });
 ```
 
@@ -221,7 +190,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
@@ -283,7 +252,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
 
@@ -336,27 +304,6 @@ Captured parameters:
 | Click IDs | `fbclid`, `gclid`, `ttclid`, `twclid`, `li_click_id`, `msclkid` |
 | Campaign | `campaign_id`, `adset_id`, `ad_id` |
 
-### Deferred Deep Links
-
-Capture attribution from App Store installs (iOS):
-
-```typescript
-await Datalyr.initialize({
-  apiKey: 'dk_your_api_key',
-  meta: {
-    appId: '1234567890',
-    enableDeferredDeepLink: true,
-  },
-});
-
-// Check for deferred attribution
-const deferred = Datalyr.getDeferredAttributionData();
-if (deferred) {
-  console.log(deferred.fbclid);      // Facebook click ID
-  console.log(deferred.campaignId);  // Campaign ID
-}
-```
-
 ### Web-to-App Attribution
 
 Automatically recover attribution from a web prelander when users install the app from an ad.
@@ -474,46 +421,52 @@ await Datalyr.trackPurchase(99.99, 'USD');
 
 ## Platform Integrations
 
-Bundled Meta and TikTok SDKs for iOS. No extra npm packages needed.
+Conversion events are routed to ad platforms server-side via the Datalyr postback system. No client-side ad SDKs (Facebook SDK, TikTok SDK, etc.) are needed in your app. The SDK captures click IDs and attribution data from ad URLs, then the backend handles hashing, formatting, and sending conversions to each platform's API.
 
 ### Meta (Facebook)
 
-```typescript
-await Datalyr.initialize({
-  apiKey: 'dk_your_api_key',
-  meta: {
-    appId: '1234567890',
-    clientToken: 'abc123',
-    enableDeferredDeepLink: true,
-    enableAppEvents: true,
-  },
-});
-```
+Conversions are sent to Meta via the [Conversions API (CAPI)](https://developers.facebook.com/docs/marketing-api/conversions-api/).
+
+**What the SDK does:** Captures `fbclid` from ad click URLs, collects IDFA (when ATT authorized on iOS), and sends user data (email, phone) with events.
+
+**What the backend does:** Hashes PII (SHA-256), formats the CAPI payload, and sends conversions with the `fbclid` and `_fbc`/`_fbp` cookies for matching.
+
+**Setup:**
+1. Connect your Meta ad account in the Datalyr dashboard (Settings > Connections)
+2. Select your Meta Pixel
+3. Create postback rules to map events (e.g., `purchase` → `Purchase`, `lead` → `Lead`)
+
+No Facebook SDK needed in your app. No `Info.plist` changes, no `FacebookAppID`.
 
 ### 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,
-  },
-});
-```
+Conversions are sent to TikTok via the [Events API](https://business-api.tiktok.com/portal/docs?id=1741601162187777).
 
-**Where to find your TikTok credentials:**
+**What the SDK does:** Captures `ttclid` from ad click URLs and collects device identifiers (IDFA on iOS, GAID on Android).
 
-| 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 |
+**What the backend does:** Hashes user data, formats the Events API payload, and sends conversions with the `ttclid` and `_ttp` cookie for matching.
 
-> **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.
-```
+**Setup:**
+1. Connect your TikTok Ads account in the Datalyr dashboard (Settings > Connections)
+2. Select your TikTok Pixel
+3. Create postback rules to map events (e.g., `purchase` → `CompletePayment`, `add_to_cart` → `AddToCart`)
+
+No TikTok SDK needed in your app. No access tokens, no native configuration.
+
+### Google Ads
+
+Conversions are sent to Google via the [Google Ads API](https://developers.google.com/google-ads/api/docs/conversions/overview).
+
+**What the SDK does:** Captures `gclid`, `gbraid`, and `wbraid` from ad click URLs. Collects user data for enhanced conversions.
+
+**What the backend does:** Hashes user data, maps events to Google conversion actions, and sends conversions with click IDs for attribution.
+
+**Setup:**
+1. Connect your Google Ads account in the Datalyr dashboard (Settings > Connections)
+2. Select your conversion actions
+3. Create postback rules to map events (e.g., `purchase` → your Google conversion action)
+
+No Google SDK needed in your app beyond the Play Install Referrer (already included for Android).
 
 ### Apple Search Ads
 
@@ -554,7 +507,7 @@ await Datalyr.updateTrackingAuthorization(status === 'granted');
 
 ```typescript
 const status = Datalyr.getPlatformIntegrationStatus();
-// { meta: true, tiktok: true, appleSearchAds: true }
+// { appleSearchAds: true }
 ```
 
 ---
@@ -634,6 +587,43 @@ await Datalyr.trackPurchase(99.99, 'USD');
 
 ---
 
+## Third-Party Integrations
+
+### Superwall
+
+Pass Datalyr attribution data to Superwall to personalize paywalls by ad source, campaign, ad set, and keyword.
+
+```typescript
+import Datalyr from '@datalyr/react-native';
+import Superwall from '@superwall/react-native-superwall';
+
+// After both SDKs are initialized
+Superwall.setUserAttributes(Datalyr.getSuperwallAttributes());
+
+// Your placements will now have attribution data available as filters
+Superwall.register({ placement: 'onboarding_paywall' });
+```
+
+Call after `Datalyr.initialize()` completes. If using ATT on iOS, call again after the user responds to the ATT prompt to include the IDFA.
+
+### RevenueCat
+
+Pass Datalyr attribution data to RevenueCat for revenue attribution and offering targeting.
+
+```typescript
+import Datalyr from '@datalyr/react-native';
+import Purchases from 'react-native-purchases';
+
+// After both SDKs are configured
+Purchases.setAttributes(Datalyr.getRevenueCatAttributes());
+```
+
+Call after configuring the Purchases SDK and before the first purchase. If using ATT, call again after permission is granted to include IDFA.
+
+> Datalyr also receives Superwall and RevenueCat events via server-side webhooks for analytics. The SDK methods and webhook integration are independent — you can use one or both.
+
+---
+
 ## Troubleshooting
 
 ### Events Not Appearing
@@ -683,35 +673,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'