/** * Google Play Install Referrer Integration * * Provides Android install attribution via the Google Play Install Referrer API. * This captures UTM parameters and click IDs passed through Google Play Store. * * How it works: * 1. User clicks ad/link with UTM parameters * 2. Google Play Store stores the referrer URL * 3. On first app launch, SDK retrieves the referrer * 4. Attribution data (utm_source, utm_medium, gclid, etc.) is extracted * * Requirements: * - Android only (returns null on iOS) * - Requires Google Play Install Referrer Library in build.gradle: * implementation 'com.android.installreferrer:installreferrer:2.2' * * Attribution data captured: * - referrer_url: Full referrer URL from Play Store * - referrer_click_timestamp: When the referrer link was clicked * - install_begin_timestamp: When the install began * - gclid: Google Ads click ID (standard) * - gbraid: Google Ads privacy-safe click ID (iOS App campaigns) * - wbraid: Google Ads privacy-safe click ID (Web-to-App campaigns) * - utm_source, utm_medium, utm_campaign, etc. */ export interface PlayInstallReferrer { referrerUrl: string; referrerClickTimestamp: number; installBeginTimestamp: number; installCompleteTimestamp?: number; gclid?: string; gbraid?: string; wbraid?: string; utmSource?: string; utmMedium?: string; utmCampaign?: string; utmTerm?: string; utmContent?: string; [key: string]: any; } /** * Google Play Install Referrer Integration * * Retrieves install attribution data from Google Play Store. * Only available on Android. */ declare class PlayInstallReferrerIntegration { private referrerData; private initialized; /** * Check if Play Install Referrer is available */ isAvailable(): boolean; /** * Initialize and fetch install referrer data * Should be called once on first app launch */ initialize(): Promise; /** * Fetch install referrer from Play Store */ fetchInstallReferrer(): Promise; /** * Parse referrer URL to extract UTM parameters and click IDs */ private parseReferrerUrl; /** * Get cached install referrer data */ getReferrerData(): PlayInstallReferrer | null; /** * Get attribution data in standard format */ getAttributionData(): Record; } export declare const playInstallReferrerIntegration: PlayInstallReferrerIntegration; export {};