@datalyr/react-native 1.6.0 → 1.6.1

package/README.md

@@ -23,7 +23,14 @@ Mobile analytics and attribution SDK for React Native and Expo. Track events, id
 - [Auto Events](#auto-events)
 - [SKAdNetwork](#skadnetwork)
 - [Platform Integrations](#platform-integrations)
+  - [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)
@@ -414,7 +421,52 @@ await Datalyr.trackPurchase(99.99, 'USD');
 
 ## Platform Integrations
 
-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.
+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)
+
+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
+
+Conversions are sent to TikTok via the [Events API](https://business-api.tiktok.com/portal/docs?id=1741601162187777).
+
+**What the SDK does:** Captures `ttclid` from ad click URLs and collects device identifiers (IDFA on iOS, GAID on Android).
+
+**What the backend does:** Hashes user data, formats the Events API payload, and sends conversions with the `ttclid` and `_ttp` cookie for matching.
+
+**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
 
@@ -535,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

package/lib/datalyr-sdk.d.ts

@@ -176,7 +176,17 @@ export declare class DatalyrSDK {
      */
     getPlayInstallReferrer(): Record<string, any> | null;
     /**
-     * Update tracking authorization status on all platform SDKs
+     * Get attribution data formatted for Superwall's setUserAttributes()
+     * Returns a flat Record<string, string> with only non-empty values
+     */
+    getSuperwallAttributes(): Record<string, string>;
+    /**
+     * Get attribution data formatted for RevenueCat's Purchases.setAttributes()
+     * Returns a flat Record<string, string> with $-prefixed reserved keys
+     */
+    getRevenueCatAttributes(): Record<string, string>;
+    /**
+     * Update tracking authorization status
      * Call this AFTER the user responds to the ATT permission dialog
      */
     updateTrackingAuthorization(enabled: boolean): Promise<void>;
@@ -279,5 +289,7 @@ export declare class Datalyr {
     };
     static getAppleSearchAdsAttribution(): AppleSearchAdsAttribution | null;
     static updateTrackingAuthorization(enabled: boolean): Promise<void>;
+    static getSuperwallAttributes(): Record<string, string>;
+    static getRevenueCatAttributes(): Record<string, string>;
 }
 export default datalyr;

package/lib/datalyr-sdk.js

@@ -177,7 +177,7 @@ export class DatalyrSDK {
                 const installData = await attributionManager.trackInstall();
                 await this.track('app_install', {
                     platform: Platform.OS === 'ios' || Platform.OS === 'android' ? Platform.OS : 'android',
-                    sdk_version: '1.6.0',
+                    sdk_version: '1.6.1',
                     ...installData,
                 });
             }
@@ -702,8 +702,83 @@ export class DatalyrSDK {
         const data = playInstallReferrerIntegration.getReferrerData();
         return data ? playInstallReferrerIntegration.getAttributionData() : null;
     }
+    // MARK: - Third-Party Integration Methods
     /**
-     * Update tracking authorization status on all platform SDKs
+     * Get attribution data formatted for Superwall's setUserAttributes()
+     * Returns a flat Record<string, string> with only non-empty values
+     */
+    getSuperwallAttributes() {
+        const attribution = attributionManager.getAttributionData();
+        const advertiser = this.cachedAdvertiserInfo;
+        const attrs = {};
+        const set = (key, value) => {
+            if (value != null && String(value) !== '')
+                attrs[key] = String(value);
+        };
+        set('datalyr_id', this.state.visitorId);
+        set('media_source', attribution.utm_source);
+        set('campaign', attribution.utm_campaign);
+        set('adgroup', attribution.adset_id || attribution.utm_content);
+        set('ad', attribution.ad_id);
+        set('keyword', attribution.keyword);
+        set('network', attribution.network);
+        set('utm_source', attribution.utm_source);
+        set('utm_medium', attribution.utm_medium);
+        set('utm_campaign', attribution.utm_campaign);
+        set('utm_term', attribution.utm_term);
+        set('utm_content', attribution.utm_content);
+        set('lyr', attribution.lyr);
+        set('fbclid', attribution.fbclid);
+        set('gclid', attribution.gclid);
+        set('ttclid', attribution.ttclid);
+        set('idfa', advertiser === null || advertiser === void 0 ? void 0 : advertiser.idfa);
+        set('gaid', advertiser === null || advertiser === void 0 ? void 0 : advertiser.gaid);
+        set('att_status', advertiser === null || advertiser === void 0 ? void 0 : advertiser.att_status);
+        return attrs;
+    }
+    /**
+     * Get attribution data formatted for RevenueCat's Purchases.setAttributes()
+     * Returns a flat Record<string, string> with $-prefixed reserved keys
+     */
+    getRevenueCatAttributes() {
+        const attribution = attributionManager.getAttributionData();
+        const advertiser = this.cachedAdvertiserInfo;
+        const attrs = {};
+        const set = (key, value) => {
+            if (value != null && String(value) !== '')
+                attrs[key] = String(value);
+        };
+        // Reserved attributes ($ prefix)
+        set('$datalyrId', this.state.visitorId);
+        set('$mediaSource', attribution.utm_source);
+        set('$campaign', attribution.utm_campaign);
+        set('$adGroup', attribution.adset_id);
+        set('$ad', attribution.ad_id);
+        set('$keyword', attribution.keyword);
+        set('$idfa', advertiser === null || advertiser === void 0 ? void 0 : advertiser.idfa);
+        set('$gpsAdId', advertiser === null || advertiser === void 0 ? void 0 : advertiser.gaid);
+        if ((advertiser === null || advertiser === void 0 ? void 0 : advertiser.att_status) != null) {
+            const statusMap = { 0: 'notDetermined', 1: 'restricted', 2: 'denied', 3: 'authorized' };
+            set('$attConsentStatus', statusMap[advertiser.att_status] || String(advertiser.att_status));
+        }
+        // Custom attributes
+        set('utm_source', attribution.utm_source);
+        set('utm_medium', attribution.utm_medium);
+        set('utm_campaign', attribution.utm_campaign);
+        set('utm_term', attribution.utm_term);
+        set('utm_content', attribution.utm_content);
+        set('lyr', attribution.lyr);
+        set('fbclid', attribution.fbclid);
+        set('gclid', attribution.gclid);
+        set('ttclid', attribution.ttclid);
+        set('wbraid', attribution.wbraid);
+        set('gbraid', attribution.gbraid);
+        set('network', attribution.network);
+        set('creative_id', attribution.creative_id);
+        return attrs;
+    }
+    /**
+     * Update tracking authorization status
      * Call this AFTER the user responds to the ATT permission dialog
      */
     async updateTrackingAuthorization(enabled) {
@@ -821,7 +896,7 @@ export class DatalyrSDK {
                 carrier: deviceInfo.carrier,
                 network_type: getNetworkType(),
                 timestamp: Date.now(),
-                sdk_version: '1.6.0',
+                sdk_version: '1.6.1',
                 // Advertiser data (IDFA/GAID, ATT status) for server-side postback
                 ...(advertiserInfo ? {
                     idfa: advertiserInfo.idfa,
@@ -1117,6 +1192,13 @@ export class Datalyr {
     static async updateTrackingAuthorization(enabled) {
         await datalyr.updateTrackingAuthorization(enabled);
     }
+    // Third-party integration methods
+    static getSuperwallAttributes() {
+        return datalyr.getSuperwallAttributes();
+    }
+    static getRevenueCatAttributes() {
+        return datalyr.getRevenueCatAttributes();
+    }
 }
 // Export default instance for backward compatibility
 export default datalyr;

package/lib/types.d.ts

@@ -187,3 +187,7 @@ export interface AttributionData {
     clickId?: string;
     installTime?: string;
 }
+/** Flat dictionary for Superwall's setUserAttributes() */
+export type SuperwallAttributes = Record<string, string>;
+/** Flat dictionary for RevenueCat's Purchases.setAttributes() */
+export type RevenueCatAttributes = Record<string, string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datalyr/react-native",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "description": "Datalyr SDK for React Native & Expo - Server-side attribution tracking for iOS and Android",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

package/src/datalyr-sdk-expo.ts

@@ -196,7 +196,7 @@ export class DatalyrSDKExpo {
         const installData = await attributionManager.trackInstall();
         await this.track('app_install', {
           platform: Platform.OS,
-          sdk_version: '1.6.0',
+          sdk_version: '1.6.1',
           sdk_variant: 'expo',
           ...installData,
         });
@@ -606,6 +606,87 @@ export class DatalyrSDKExpo {
     return appleSearchAdsIntegration.getAttributionData();
   }
 
+  // MARK: - Third-Party Integration Methods
+
+  /**
+   * Get attribution data formatted for Superwall's setUserAttributes()
+   */
+  getSuperwallAttributes(): Record<string, string> {
+    const attribution = attributionManager.getAttributionData();
+    const advertiser = this.cachedAdvertiserInfo;
+    const attrs: Record<string, string> = {};
+
+    const set = (key: string, value: any) => {
+      if (value != null && String(value) !== '') attrs[key] = String(value);
+    };
+
+    set('datalyr_id', this.state.visitorId);
+    set('media_source', attribution.utm_source);
+    set('campaign', attribution.utm_campaign);
+    set('adgroup', attribution.adset_id || attribution.utm_content);
+    set('ad', attribution.ad_id);
+    set('keyword', attribution.keyword);
+    set('network', attribution.network);
+    set('utm_source', attribution.utm_source);
+    set('utm_medium', attribution.utm_medium);
+    set('utm_campaign', attribution.utm_campaign);
+    set('utm_term', attribution.utm_term);
+    set('utm_content', attribution.utm_content);
+    set('lyr', attribution.lyr);
+    set('fbclid', attribution.fbclid);
+    set('gclid', attribution.gclid);
+    set('ttclid', attribution.ttclid);
+    set('idfa', advertiser?.idfa);
+    set('gaid', advertiser?.gaid);
+    set('att_status', advertiser?.att_status);
+
+    return attrs;
+  }
+
+  /**
+   * Get attribution data formatted for RevenueCat's Purchases.setAttributes()
+   */
+  getRevenueCatAttributes(): Record<string, string> {
+    const attribution = attributionManager.getAttributionData();
+    const advertiser = this.cachedAdvertiserInfo;
+    const attrs: Record<string, string> = {};
+
+    const set = (key: string, value: any) => {
+      if (value != null && String(value) !== '') attrs[key] = String(value);
+    };
+
+    // Reserved attributes ($ prefix)
+    set('$datalyrId', this.state.visitorId);
+    set('$mediaSource', attribution.utm_source);
+    set('$campaign', attribution.utm_campaign);
+    set('$adGroup', attribution.adset_id);
+    set('$ad', attribution.ad_id);
+    set('$keyword', attribution.keyword);
+    set('$idfa', advertiser?.idfa);
+    set('$gpsAdId', advertiser?.gaid);
+    if (advertiser?.att_status != null) {
+      const statusMap: Record<number, string> = { 0: 'notDetermined', 1: 'restricted', 2: 'denied', 3: 'authorized' };
+      set('$attConsentStatus', statusMap[advertiser.att_status] || String(advertiser.att_status));
+    }
+
+    // Custom attributes
+    set('utm_source', attribution.utm_source);
+    set('utm_medium', attribution.utm_medium);
+    set('utm_campaign', attribution.utm_campaign);
+    set('utm_term', attribution.utm_term);
+    set('utm_content', attribution.utm_content);
+    set('lyr', attribution.lyr);
+    set('fbclid', attribution.fbclid);
+    set('gclid', attribution.gclid);
+    set('ttclid', attribution.ttclid);
+    set('wbraid', attribution.wbraid);
+    set('gbraid', attribution.gbraid);
+    set('network', attribution.network);
+    set('creative_id', attribution.creative_id);
+
+    return attrs;
+  }
+
   async updateTrackingAuthorization(authorized: boolean): Promise<void> {
     // Refresh cached advertiser info after ATT status change
     try {
@@ -700,7 +781,7 @@ export class DatalyrSDKExpo {
         carrier: deviceInfo.carrier,
         network_type: networkType,
         timestamp: Date.now(),
-        sdk_version: '1.6.0',
+        sdk_version: '1.6.1',
         sdk_variant: 'expo',
         // Advertiser data (IDFA/GAID, ATT status) for server-side postback
         ...(advertiserInfo ? {
@@ -960,6 +1041,16 @@ export class DatalyrExpo {
   static async updateTrackingAuthorization(authorized: boolean): Promise<void> {
     await datalyrExpo.updateTrackingAuthorization(authorized);
   }
+
+  // Third-party integration methods
+
+  static getSuperwallAttributes(): Record<string, string> {
+    return datalyrExpo.getSuperwallAttributes();
+  }
+
+  static getRevenueCatAttributes(): Record<string, string> {
+    return datalyrExpo.getRevenueCatAttributes();
+  }
 }
 
 export default datalyrExpo;

package/src/datalyr-sdk.ts

@@ -228,7 +228,7 @@ export class DatalyrSDK {
         const installData = await attributionManager.trackInstall();
         await this.track('app_install', {
           platform: Platform.OS === 'ios' || Platform.OS === 'android' ? Platform.OS : 'android',
-          sdk_version: '1.6.0',
+          sdk_version: '1.6.1',
           ...installData,
         });
       }
@@ -862,8 +862,91 @@ export class DatalyrSDK {
     return data ? playInstallReferrerIntegration.getAttributionData() : null;
   }
 
+  // MARK: - Third-Party Integration Methods
+
   /**
-   * Update tracking authorization status on all platform SDKs
+   * Get attribution data formatted for Superwall's setUserAttributes()
+   * Returns a flat Record<string, string> with only non-empty values
+   */
+  getSuperwallAttributes(): Record<string, string> {
+    const attribution = attributionManager.getAttributionData();
+    const advertiser = this.cachedAdvertiserInfo;
+    const attrs: Record<string, string> = {};
+
+    const set = (key: string, value: any) => {
+      if (value != null && String(value) !== '') attrs[key] = String(value);
+    };
+
+    set('datalyr_id', this.state.visitorId);
+    set('media_source', attribution.utm_source);
+    set('campaign', attribution.utm_campaign);
+    set('adgroup', attribution.adset_id || attribution.utm_content);
+    set('ad', attribution.ad_id);
+    set('keyword', attribution.keyword);
+    set('network', attribution.network);
+    set('utm_source', attribution.utm_source);
+    set('utm_medium', attribution.utm_medium);
+    set('utm_campaign', attribution.utm_campaign);
+    set('utm_term', attribution.utm_term);
+    set('utm_content', attribution.utm_content);
+    set('lyr', attribution.lyr);
+    set('fbclid', attribution.fbclid);
+    set('gclid', attribution.gclid);
+    set('ttclid', attribution.ttclid);
+    set('idfa', advertiser?.idfa);
+    set('gaid', advertiser?.gaid);
+    set('att_status', advertiser?.att_status);
+
+    return attrs;
+  }
+
+  /**
+   * Get attribution data formatted for RevenueCat's Purchases.setAttributes()
+   * Returns a flat Record<string, string> with $-prefixed reserved keys
+   */
+  getRevenueCatAttributes(): Record<string, string> {
+    const attribution = attributionManager.getAttributionData();
+    const advertiser = this.cachedAdvertiserInfo;
+    const attrs: Record<string, string> = {};
+
+    const set = (key: string, value: any) => {
+      if (value != null && String(value) !== '') attrs[key] = String(value);
+    };
+
+    // Reserved attributes ($ prefix)
+    set('$datalyrId', this.state.visitorId);
+    set('$mediaSource', attribution.utm_source);
+    set('$campaign', attribution.utm_campaign);
+    set('$adGroup', attribution.adset_id);
+    set('$ad', attribution.ad_id);
+    set('$keyword', attribution.keyword);
+    set('$idfa', advertiser?.idfa);
+    set('$gpsAdId', advertiser?.gaid);
+    if (advertiser?.att_status != null) {
+      const statusMap: Record<number, string> = { 0: 'notDetermined', 1: 'restricted', 2: 'denied', 3: 'authorized' };
+      set('$attConsentStatus', statusMap[advertiser.att_status] || String(advertiser.att_status));
+    }
+
+    // Custom attributes
+    set('utm_source', attribution.utm_source);
+    set('utm_medium', attribution.utm_medium);
+    set('utm_campaign', attribution.utm_campaign);
+    set('utm_term', attribution.utm_term);
+    set('utm_content', attribution.utm_content);
+    set('lyr', attribution.lyr);
+    set('fbclid', attribution.fbclid);
+    set('gclid', attribution.gclid);
+    set('ttclid', attribution.ttclid);
+    set('wbraid', attribution.wbraid);
+    set('gbraid', attribution.gbraid);
+    set('network', attribution.network);
+    set('creative_id', attribution.creative_id);
+
+    return attrs;
+  }
+
+  /**
+   * Update tracking authorization status
    * Call this AFTER the user responds to the ATT permission dialog
    */
   async updateTrackingAuthorization(enabled: boolean): Promise<void> {
@@ -991,7 +1074,7 @@ export class DatalyrSDK {
         carrier: deviceInfo.carrier,
         network_type: getNetworkType(),
         timestamp: Date.now(),
-        sdk_version: '1.6.0',
+        sdk_version: '1.6.1',
         // Advertiser data (IDFA/GAID, ATT status) for server-side postback
         ...(advertiserInfo ? {
           idfa: advertiserInfo.idfa,
@@ -1364,6 +1447,16 @@ export class Datalyr {
   static async updateTrackingAuthorization(enabled: boolean): Promise<void> {
     await datalyr.updateTrackingAuthorization(enabled);
   }
+
+  // Third-party integration methods
+
+  static getSuperwallAttributes(): Record<string, string> {
+    return datalyr.getSuperwallAttributes();
+  }
+
+  static getRevenueCatAttributes(): Record<string, string> {
+    return datalyr.getRevenueCatAttributes();
+  }
 }
 
 // Export default instance for backward compatibility

package/src/types.ts

@@ -227,4 +227,12 @@ export interface AttributionData {
   content?: string;
   clickId?: string;
   installTime?: string;
-} 
+}
+
+// Third-Party Integration Attributes
+
+/** Flat dictionary for Superwall's setUserAttributes() */
+export type SuperwallAttributes = Record<string, string>;
+
+/** Flat dictionary for RevenueCat's Purchases.setAttributes() */
+export type RevenueCatAttributes = Record<string, string>;