docs: add cross-platform integration snippets (#1030)

Adding missing code snippets to the examples for third-party integrations (urgent requirement for two onboarding customers).

Author: andsolleiro

code_blocks/integrations/attribution/adjust_4.kt

@@ -0,0 +1,20 @@
+import com.adjust.sdk.Adjust
+import com.adjust.sdk.AdjustConfig
+import com.revenuecat.purchases.Purchases
+
+Purchases.configure(this, "public_sdk_key")
+
+// Automatically collect the $gpsAdId and $ip values
+Purchases.sharedInstance.collectDeviceIdentifiers()
+
+// Set the Adjust Id on app launch if it exists
+Adjust.getAdid()?.let {
+    Purchases.sharedInstance.setAdjustID(it)
+}
+
+// IMPORTANT: Set the Adjust Id when it becomes available, if it didn't exist on app launch
+val config = AdjustConfig(this, "yourAppToken", AdjustConfig.ENVIRONMENT_SANDBOX)
+config.onAttributionChangedListener = { attribution ->
+    Purchases.sharedInstance.collectDeviceIdentifiers()
+    Purchases.sharedInstance.setAdjustID(attribution.adid)
+}

code_blocks/integrations/attribution/adjust_5.ts

@@ -0,0 +1,16 @@
+import Purchases from 'react-native-purchases';
+import { Adjust } from 'react-native-adjust';
+
+Purchases.configure({ apiKey: 'public_sdk_key' });
+Purchases.collectDeviceIdentifiers();
+
+Adjust.getAdid().then(adid => {
+  if (adid) {
+    Purchases.setAdjustID(adid);
+  }
+});
+
+Adjust.addAttributionChangedListener(attribution => {
+  Purchases.collectDeviceIdentifiers();
+  Purchases.setAdjustID(attribution.adid);
+});

code_blocks/integrations/attribution/adjust_6.dart

@@ -0,0 +1,17 @@
+import 'package:adjust_sdk/adjust.dart';
+import 'package:purchases_flutter/purchases_flutter.dart';
+
+Future<void> init() async {
+  await Purchases.configure(PurchasesConfiguration('public_sdk_key'));
+  await Purchases.collectDeviceIdentifiers();
+
+  final adid = await Adjust.getAdid();
+  if (adid != null) {
+    await Purchases.setAdjustID(adid);
+  }
+
+  Adjust.addAttributionChangedListener((attribution) {
+    Purchases.collectDeviceIdentifiers();
+    Purchases.setAdjustID(attribution.adid);
+  });
+}

code_blocks/integrations/attribution/apple-search-ads_7.js.txt

@@ -0,0 +1,10 @@
+import Purchases from 'react-native-purchases';
+import { requestTrackingPermission } from 'react-native-tracking-transparency';
+
+async function setupAppleSearchAds() {
+  await Purchases.configure({ apiKey: 'public_sdk_key' });
+  const status = await requestTrackingPermission();
+  if (status === 'authorized') {
+    await Purchases.enableAdServicesAttributionTokenCollection();
+  }
+}

code_blocks/integrations/attribution/apple-search-ads_8.dart

@@ -0,0 +1,10 @@
+import 'package:purchases_flutter/purchases_flutter.dart';
+import 'package:app_tracking_transparency/app_tracking_transparency.dart';
+
+Future<void> setupAppleSearchAds() async {
+  await Purchases.configure(PurchasesConfiguration('public_sdk_key'));
+  final status = await AppTrackingTransparency.requestTrackingAuthorization();
+  if (status == TrackingStatus.authorized) {
+    await Purchases.enableAdServicesAttributionTokenCollection();
+  }
+}

code_blocks/integrations/attribution/appsflyer_3.ts

@@ -0,0 +1,28 @@
+import Purchases from 'react-native-purchases';
+import appsFlyer from 'react-native-appsflyer';
+
+async function initRevenueCatAndAppsFlyer() {
+  // 1. Configure RevenueCat first
+  await Purchases.configure({ apiKey: 'public_sdk_key' });
+
+  // 2. Collect device identifiers: $gpsAdId, $ip (automatically handles platform-specifics)
+  await Purchases.collectDeviceIdentifiers();
+
+  // 3. Initialize AppsFlyer before retrieving UID
+  appsFlyer.initSdk(
+    {
+      devKey: 'your_af_dev_key',
+      isDebug: false,
+      appId: 'your_ios_app_id', // required only for iOS
+    },
+    (result) => console.log('AppsFlyer initialized:', result),
+    (error) => console.error('AppsFlyer init error:', error)
+  );
+
+  // 4. Get the AppsFlyer ID and set it to RevenueCat
+  appsFlyer.getAppsFlyerUID((err, uid) => {
+    if (!err && uid) {
+      Purchases.setAppsflyerId(uid);
+    }
+  });
+}

code_blocks/integrations/attribution/appsflyer_4.dart

@@ -0,0 +1,13 @@
+import 'package:purchases_flutter/purchases_flutter.dart';
+import 'package:appsflyer_sdk/appsflyer_sdk.dart';
+
+Future<void> init() async {
+  await Purchases.configure(PurchasesConfiguration('public_sdk_key'));
+  Purchases.collectDeviceIdentifiers();
+
+  final appsflyerSdk = AppsFlyerSdk(AppsFlyerOptions(afDevKey: 'afDevKey', appId: '123'));
+  final uid = await appsflyerSdk.getAppsFlyerUID();
+  if (uid != null) {
+    await Purchases.setAppsflyerId(uid);
+  }
+}

code_blocks/integrations/attribution/branch_1.dart

@@ -0,0 +1,11 @@
+import 'package:flutter_branch_sdk/flutter_branch_sdk.dart';
+import 'package:purchases_flutter/purchases_flutter.dart';
+
+// login
+FlutterBranchSdk.setIdentity('my_app_user_id');
+
+// Optional: Use a different App User ID between Branch and RevenueCat
+Purchases.setAttributes({'\$branchId': '<custom_branch_user_id>'});
+
+// logout
+FlutterBranchSdk.logout();

code_blocks/integrations/attribution/branch_1.kt

@@ -0,0 +1,11 @@
+import io.branch.referral.Branch
+import com.revenuecat.purchases.Purchases
+
+// login
+Branch.getInstance().setIdentity("my_app_user_id")
+
+// Optional: Use a different App User ID between Branch and RevenueCat
+Purchases.sharedInstance.setAttributes(mapOf("\$branchId" to "<custom_branch_user_id>"))
+
+// logout
+Branch.getInstance().logout()

code_blocks/integrations/attribution/branch_5.dart

@@ -0,0 +1,6 @@
+import 'package:purchases_flutter/purchases_flutter.dart';
+
+Future<void> init() async {
+  await Purchases.configure(PurchasesConfiguration('public_sdk_key'));
+  await Purchases.collectDeviceIdentifiers();
+}