Marketing Campaign Attribution Tracker

A React Native utility that tracks app installation attribution from marketing campaigns using Google Play Store install referrer data.

Requirements

Build a utility module that retrieves and parses installation attribution data from the Google Play Store. The module should extract campaign information from the install referrer URL and make it accessible to the application for analytics purposes.

Capabilities

Retrieve install referrer data

• The module exports an async function getInstallAttribution() that retrieves install referrer information from the Play Store @test
• When the install referrer is unavailable or unsupported, the function returns an object with all fields set to null @test

Parse UTM parameters

• The function parses utm_source from the referrer URL and includes it in the returned object @test
• The function parses utm_medium from the referrer URL and includes it in the returned object @test
• The function parses utm_campaign from the referrer URL and includes it in the returned object @test
• When a UTM parameter is not present in the referrer URL, its value is null in the returned object @test

Implementation

@generates

API

/**
 * Attribution data extracted from the install referrer
 */
export interface AttributionData {
  utm_source: string | null;
  utm_medium: string | null;
  utm_campaign: string | null;
  rawReferrer: string | null;
}

/**
 * Retrieves and parses install attribution data from the Google Play Store.
 * Returns attribution information including UTM parameters and the raw referrer string.
 * On platforms other than Android or when referrer data is unavailable, returns null values.
 */
export async function getInstallAttribution(): Promise<AttributionData>;

Dependencies { .dependencies }

expo-application { .dependency }

Provides access to native application information including install referrer data.

@satisfied-by