@datalyr/react-native 1.1.1 → 1.2.1

package/lib/integrations/meta-integration.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Meta (Facebook) SDK Integration
+ * Uses bundled native iOS SDK for deferred deep linking, event forwarding, and Advanced Matching
+ */
+import { MetaConfig, DeferredDeepLinkResult } from '../types';
+/**
+ * Meta Integration class for handling Facebook SDK operations
+ * Uses native iOS SDK bundled via CocoaPods (no additional npm packages required)
+ */
+export declare class MetaIntegration {
+    private config;
+    private initialized;
+    private available;
+    private debug;
+    private deferredDeepLinkData;
+    /**
+     * Initialize Meta SDK with configuration
+     */
+    initialize(config: MetaConfig, debug?: boolean): Promise<void>;
+    /**
+     * Update tracking authorization status (call after ATT prompt)
+     */
+    updateTrackingAuthorization(enabled: boolean): Promise<void>;
+    /**
+     * Fetch deferred deep link from Meta SDK
+     * This captures fbclid for installs that went through App Store
+     */
+    fetchDeferredDeepLink(): Promise<DeferredDeepLinkResult | null>;
+    /**
+     * Parse deep link URL to extract attribution parameters
+     */
+    private parseDeepLinkUrl;
+    /**
+     * Log purchase event to Meta
+     */
+    logPurchase(value: number, currency: string, parameters?: Record<string, any>): Promise<void>;
+    /**
+     * Log custom event to Meta
+     */
+    logEvent(eventName: string, valueToSum?: number, parameters?: Record<string, any>): Promise<void>;
+    /**
+     * Set user data for Advanced Matching (improves conversion attribution)
+     * Note: Meta's Advanced Matching uses these specific fields - externalId is not supported
+     */
+    setUserData(userData: {
+        email?: string;
+        firstName?: string;
+        lastName?: string;
+        phone?: string;
+        dateOfBirth?: string;
+        gender?: string;
+        city?: string;
+        state?: string;
+        zip?: string;
+        country?: string;
+    }): Promise<void>;
+    /**
+     * Clear user data (call on logout)
+     */
+    clearUserData(): Promise<void>;
+    /**
+     * Get cached deferred deep link data
+     */
+    getDeferredDeepLinkData(): DeferredDeepLinkResult | null;
+    /**
+     * Check if Meta SDK is available and initialized
+     */
+    isAvailable(): boolean;
+    /**
+     * Check if Meta SDK native module is installed
+     */
+    isInstalled(): boolean;
+    private log;
+    private logError;
+}
+export declare const metaIntegration: MetaIntegration;

package/lib/integrations/meta-integration.js

@@ -0,0 +1,218 @@
+/**
+ * Meta (Facebook) SDK Integration
+ * Uses bundled native iOS SDK for deferred deep linking, event forwarding, and Advanced Matching
+ */
+import { Platform } from 'react-native';
+import { MetaNativeBridge, isNativeModuleAvailable } from '../native/DatalyrNativeBridge';
+/**
+ * Meta Integration class for handling Facebook SDK operations
+ * Uses native iOS SDK bundled via CocoaPods (no additional npm packages required)
+ */
+export class MetaIntegration {
+    constructor() {
+        this.config = null;
+        this.initialized = false;
+        this.available = false;
+        this.debug = false;
+        this.deferredDeepLinkData = null;
+    }
+    /**
+     * Initialize Meta SDK with configuration
+     */
+    async initialize(config, debug = false) {
+        var _a;
+        this.debug = debug;
+        this.config = config;
+        // Only available on iOS via native module
+        if (Platform.OS !== 'ios') {
+            this.log('Meta SDK only available on iOS');
+            return;
+        }
+        this.available = isNativeModuleAvailable();
+        if (!this.available) {
+            this.log('Meta native module not available');
+            return;
+        }
+        try {
+            const success = await MetaNativeBridge.initialize(config.appId, config.clientToken, (_a = config.advertiserTrackingEnabled) !== null && _a !== void 0 ? _a : false);
+            if (success) {
+                this.initialized = true;
+                this.log(`Meta SDK initialized with App ID: ${config.appId}`);
+            }
+        }
+        catch (error) {
+            this.logError('Failed to initialize Meta SDK:', error);
+        }
+    }
+    /**
+     * Update tracking authorization status (call after ATT prompt)
+     */
+    async updateTrackingAuthorization(enabled) {
+        if (!this.available || !this.initialized)
+            return;
+        try {
+            await MetaNativeBridge.updateTrackingAuthorization(enabled);
+            this.log(`Meta ATT status updated: ${enabled ? 'authorized' : 'not authorized'}`);
+        }
+        catch (error) {
+            this.logError('Failed to update Meta tracking authorization:', error);
+        }
+    }
+    /**
+     * Fetch deferred deep link from Meta SDK
+     * This captures fbclid for installs that went through App Store
+     */
+    async fetchDeferredDeepLink() {
+        var _a;
+        if (!this.available || !this.initialized) {
+            return null;
+        }
+        if (((_a = this.config) === null || _a === void 0 ? void 0 : _a.enableDeferredDeepLink) === false) {
+            return null;
+        }
+        try {
+            const url = await MetaNativeBridge.fetchDeferredAppLink();
+            if (!url) {
+                this.log('No deferred deep link available from Meta');
+                return null;
+            }
+            // Parse the URL for attribution parameters
+            const result = this.parseDeepLinkUrl(url);
+            this.deferredDeepLinkData = result;
+            this.log(`Meta deferred deep link fetched: ${url}`);
+            return result;
+        }
+        catch (error) {
+            // This is expected to fail in some scenarios - log but don't treat as error
+            this.log('Could not fetch Meta deferred deep link (may not be available)');
+            return null;
+        }
+    }
+    /**
+     * Parse deep link URL to extract attribution parameters
+     */
+    parseDeepLinkUrl(urlString) {
+        const result = {
+            url: urlString,
+            source: 'meta',
+        };
+        try {
+            const url = new URL(urlString);
+            const params = url.searchParams;
+            // Extract known parameters
+            if (params.get('fbclid'))
+                result.fbclid = params.get('fbclid');
+            if (params.get('utm_source'))
+                result.utmSource = params.get('utm_source');
+            if (params.get('utm_medium'))
+                result.utmMedium = params.get('utm_medium');
+            if (params.get('utm_campaign'))
+                result.utmCampaign = params.get('utm_campaign');
+            if (params.get('utm_content'))
+                result.utmContent = params.get('utm_content');
+            if (params.get('utm_term'))
+                result.utmTerm = params.get('utm_term');
+            if (params.get('campaign_id'))
+                result.campaignId = params.get('campaign_id');
+            if (params.get('adset_id'))
+                result.adsetId = params.get('adset_id');
+            if (params.get('ad_id'))
+                result.adId = params.get('ad_id');
+        }
+        catch (error) {
+            this.logError('Failed to parse deep link URL:', error);
+        }
+        return result;
+    }
+    /**
+     * Log purchase event to Meta
+     */
+    async logPurchase(value, currency, parameters) {
+        var _a;
+        if (!this.available || !this.initialized)
+            return;
+        if (((_a = this.config) === null || _a === void 0 ? void 0 : _a.enableAppEvents) === false)
+            return;
+        try {
+            await MetaNativeBridge.logPurchase(value, currency, parameters);
+            this.log(`Meta purchase event logged: ${value} ${currency}`);
+        }
+        catch (error) {
+            this.logError('Failed to log Meta purchase:', error);
+        }
+    }
+    /**
+     * Log custom event to Meta
+     */
+    async logEvent(eventName, valueToSum, parameters) {
+        var _a;
+        if (!this.available || !this.initialized)
+            return;
+        if (((_a = this.config) === null || _a === void 0 ? void 0 : _a.enableAppEvents) === false)
+            return;
+        try {
+            await MetaNativeBridge.logEvent(eventName, valueToSum, parameters);
+            this.log(`Meta event logged: ${eventName}`);
+        }
+        catch (error) {
+            this.logError('Failed to log Meta event:', error);
+        }
+    }
+    /**
+     * Set user data for Advanced Matching (improves conversion attribution)
+     * Note: Meta's Advanced Matching uses these specific fields - externalId is not supported
+     */
+    async setUserData(userData) {
+        if (!this.available || !this.initialized)
+            return;
+        try {
+            await MetaNativeBridge.setUserData(userData);
+            this.log('Meta user data set for Advanced Matching');
+        }
+        catch (error) {
+            this.logError('Failed to set Meta user data:', error);
+        }
+    }
+    /**
+     * Clear user data (call on logout)
+     */
+    async clearUserData() {
+        if (!this.available || !this.initialized)
+            return;
+        try {
+            await MetaNativeBridge.clearUserData();
+            this.log('Meta user data cleared');
+        }
+        catch (error) {
+            this.logError('Failed to clear Meta user data:', error);
+        }
+    }
+    /**
+     * Get cached deferred deep link data
+     */
+    getDeferredDeepLinkData() {
+        return this.deferredDeepLinkData;
+    }
+    /**
+     * Check if Meta SDK is available and initialized
+     */
+    isAvailable() {
+        return this.available && this.initialized;
+    }
+    /**
+     * Check if Meta SDK native module is installed
+     */
+    isInstalled() {
+        return this.available;
+    }
+    log(message, data) {
+        if (this.debug) {
+            console.log(`[Datalyr/Meta] ${message}`, data || '');
+        }
+    }
+    logError(message, error) {
+        console.error(`[Datalyr/Meta] ${message}`, error);
+    }
+}
+// Export singleton instance
+export const metaIntegration = new MetaIntegration();

package/lib/integrations/tiktok-integration.d.ts

@@ -0,0 +1,82 @@
+/**
+ * TikTok Business SDK Integration
+ * Uses bundled native iOS SDK for event forwarding and user identification
+ */
+import { TikTokConfig } from '../types';
+/**
+ * TikTok Integration class for handling TikTok Business SDK operations
+ * Uses native iOS SDK bundled via CocoaPods (no additional npm packages required)
+ */
+export declare class TikTokIntegration {
+    private config;
+    private initialized;
+    private available;
+    private debug;
+    /**
+     * Initialize TikTok SDK with configuration
+     */
+    initialize(config: TikTokConfig, debug?: boolean): Promise<void>;
+    /**
+     * Update tracking authorization status (call after ATT prompt)
+     */
+    updateTrackingAuthorization(enabled: boolean): Promise<void>;
+    /**
+     * Log purchase event to TikTok (uses Purchase - TikTok's current standard event)
+     */
+    logPurchase(value: number, currency: string, contentId?: string, contentType?: string, parameters?: Record<string, any>): Promise<void>;
+    /**
+     * Log subscription event to TikTok
+     */
+    logSubscription(value: number, currency: string, plan?: string): Promise<void>;
+    /**
+     * Log add to cart event
+     */
+    logAddToCart(value: number, currency: string, contentId?: string, contentType?: string): Promise<void>;
+    /**
+     * Log view content event
+     */
+    logViewContent(contentId?: string, contentName?: string, contentType?: string): Promise<void>;
+    /**
+     * Log initiate checkout event
+     */
+    logInitiateCheckout(value: number, currency: string, numItems?: number): Promise<void>;
+    /**
+     * Log complete registration event
+     */
+    logCompleteRegistration(method?: string): Promise<void>;
+    /**
+     * Log search event
+     */
+    logSearch(query: string): Promise<void>;
+    /**
+     * Log lead event (uses Lead - current standard, SubmitForm is legacy)
+     */
+    logLead(value?: number, currency?: string): Promise<void>;
+    /**
+     * Log add payment info event
+     */
+    logAddPaymentInfo(success: boolean): Promise<void>;
+    /**
+     * Log custom event to TikTok
+     */
+    trackEvent(eventName: string, properties?: Record<string, any>): Promise<void>;
+    /**
+     * Identify user for improved attribution matching
+     */
+    identify(email?: string, phone?: string, externalId?: string): Promise<void>;
+    /**
+     * Clear user session (call on logout)
+     */
+    logout(): Promise<void>;
+    /**
+     * Check if TikTok SDK is available and initialized
+     */
+    isAvailable(): boolean;
+    /**
+     * Check if TikTok SDK native module is installed
+     */
+    isInstalled(): boolean;
+    private log;
+    private logError;
+}
+export declare const tiktokIntegration: TikTokIntegration;