iOS Privacy-First
Measurement Playbook

import 'package:appsflyer_sdk/appsflyer_sdk.dart'; import 'package:app_tracking_transparency/app_tracking_transparency.dart'; import 'package:shared_preferences/shared_preferences.dart'; import 'dart:async'; import 'dart:io' show Platform; /// Complete AppsFlyer SKAN Manager /// Handles: Consent Granted (A), Consent Denied (B), Runtime Changes (C) class AppsFlyerSKANManager { static final AppsFlyerSKANManager _instance = AppsFlyerSKANManager._internal(); factory AppsFlyerSKANManager() => _instance; AppsFlyerSKANManager._internal(); AppsflyerSdk? _appsflyerSdk; bool _isInitialized = false; bool _hasConsent = false; bool _isStopped = false; TrackingStatus? _currentTrackingStatus; final _consentStateController = StreamController<bool>.broadcast(); Stream<bool> get consentStateStream => _consentStateController.stream; static const String AF_DEV_KEY = 'YOUR_APPSFLYER_DEV_KEY'; static const String APP_ID = 'YOUR_APP_STORE_ID'; Future<void> initialize() async { if (!Platform.isIOS || _isInitialized) return; await _checkAndHandleTrackingStatus(); _isInitialized = true; } Future<void> _checkAndHandleTrackingStatus() async { _currentTrackingStatus = await AppTrackingTransparency.trackingAuthorizationStatus; switch (_currentTrackingStatus) { case TrackingStatus.notDetermined: await _requestTrackingPermission(); break; case TrackingStatus.authorized: await _initializeWithConsent(); break; default: await _initializeWithoutConsent(); } } // ── SCENARIO A: CONSENT GRANTED ────────────────────────────────── Future<void> _initializeWithConsent() async { _hasConsent = true; _consentStateController.add(true); final options = AppsFlyerOptions( afDevKey: AF_DEV_KEY, appId: APP_ID, showDebug: true, timeToWaitForATTUserAuthorization: 10.0, disableIDFACollection: false, // IDFA ON disableAdvertisingIdentifier: false, disableCollectASA: false, // Apple Search Ads ON ); _appsflyerSdk = AppsflyerSdk(options); _appsflyerSdk!.initSdk( registerConversionDataCallback: true, registerOnAppOpenAttributionCallback: true, registerOnDeepLinkingCallback: true, ); _appsflyerSdk!.onInstallConversionData((data) { print('Attribution: ${data['af_status']}'); }); _appsflyerSdk!.startSDK(); _isStopped = false; } // ── SCENARIO B: CONSENT DENIED ─────────────────────────────────── Future<void> _initializeWithoutConsent() async { _hasConsent = false; _consentStateController.add(false); final options = AppsFlyerOptions( afDevKey: AF_DEV_KEY, appId: APP_ID, showDebug: false, timeToWaitForATTUserAuthorization: 0.0, disableIDFACollection: true, // IDFA OFF disableAdvertisingIdentifier: true, disableCollectASA: true, // ASA OFF ); _appsflyerSdk = AppsflyerSdk(options); _appsflyerSdk!.initSdk(registerConversionDataCallback: false); _appsflyerSdk!.anonymizeUser(true); // SKAN-only mode _appsflyerSdk!.startSDK(); _isStopped = false; } // ── SCENARIO C: RUNTIME CONSENT CHANGES ────────────────────────── Future<void> handleConsentChange(bool newConsentStatus) async { if (_hasConsent == newConsentStatus) return; _appsflyerSdk?.stop(true); _isStopped = true; await Future.delayed(Duration(milliseconds: 500)); if (newConsentStatus) { await _initializeWithConsent(); } else { _appsflyerSdk?.anonymizeUser(true); await _initializeWithoutConsent(); } } Future<void> logEvent(String eventName, Map<String, dynamic> params) async { if (_appsflyerSdk == null || _isStopped) return; if (_hasConsent) { _appsflyerSdk!.logEvent(eventName, params); } else { // Strip PII in SKAN-only mode final safe = Map.fromEntries( params.entries.where((e) => ['value','success','category','type'].contains(e.key)) ); _appsflyerSdk!.logEvent(eventName, safe); } } bool get hasConsent => _hasConsent; bool get isInitialized => _isInitialized; void dispose() { _consentStateController.close(); _appsflyerSdk?.stop(false); } }

class EventTracker { final _manager = AppsFlyerSKANManager(); Future<void> trackPurchase({required double revenue, required String currency, required String productId, String? userId}) async { final params = <String, dynamic>{'af_revenue': revenue, 'af_currency': currency}; if (_manager.hasConsent) { params['af_content_id'] = productId; if (userId != null) params['customer_user_id'] = userId; } await _manager.logEvent('af_purchase', params); } Future<void> trackHBBRevenue(double amount) async { await _manager.logEvent('hbb_purchase', {'af_revenue': amount, 'af_currency': 'USD', 'channel': 'HBB'}); } Future<void> trackMobileRevenue(double amount) async { await _manager.logEvent('mobile_purchase', {'af_revenue': amount, 'af_currency': 'USD', 'platform': 'mobile'}); } Future<void> trackSignUp(String method, String? email) async { final params = <String, dynamic>{'af_registration_method': method}; if (_manager.hasConsent && email != null) { params['email_hash'] = email.hashCode.toString(); } await _manager.logEvent('af_complete_registration', params); } Future<void> trackAddToCart(String productId, double price) async { await _manager.logEvent('af_add_to_cart', { 'af_price': price, 'af_currency': 'USD', if (_manager.hasConsent) 'af_content_id': productId, }); } Future<void> trackCheckout(double total, int items) async { await _manager.logEvent('af_initiated_checkout', { 'af_price': total, 'af_currency': 'USD', 'af_quantity': items, }); } }

import 'package:flutter/material.dart'; import 'package:shared_preferences/shared_preferences.dart'; import 'appsflyer_skan_manager.dart'; class PrivacySettingsScreen extends StatefulWidget { @override _PrivacySettingsScreenState createState() => _PrivacySettingsScreenState(); } class _PrivacySettingsScreenState extends State<PrivacySettingsScreen> { final _manager = AppsFlyerSKANManager(); bool _trackingEnabled = false; bool _isLoading = false; @override void initState() { super.initState(); _loadSettings(); _manager.consentStateStream.listen((hasConsent) { if (mounted) setState(() => _trackingEnabled = hasConsent); }); } Future<void> _loadSettings() async { final prefs = await SharedPreferences.getInstance(); setState(() => _trackingEnabled = prefs.getBool('tracking_consent') ?? false); } Future<void> _handleConsentToggle(bool newValue) async { setState(() => _isLoading = true); final confirmed = await showDialog<bool>( context: context, builder: (ctx) => AlertDialog( title: Text(newValue ? 'Enable Full Tracking?' : 'Disable Tracking?'), content: Text(newValue ? 'Enable IDFA collection and full analytics.' : 'Switch to SKAN-only mode. No personal data collected.'), actions: [ TextButton(onPressed: () => Navigator.pop(ctx, false), child: Text('Cancel')), ElevatedButton(onPressed: () => Navigator.pop(ctx, true), child: Text('Confirm')), ], ), ); if (confirmed == true) { final prefs = await SharedPreferences.getInstance(); await prefs.setBool('tracking_consent', newValue); await _manager.handleConsentChange(newValue); setState(() => _trackingEnabled = newValue); ScaffoldMessenger.of(context).showSnackBar(SnackBar( content: Text(newValue ? '✅ Full tracking enabled' : '🔒 SKAN-only mode active'), )); } setState(() => _isLoading = false); } @override Widget build(BuildContext context) { return Scaffold( appBar: AppBar(title: Text('Privacy Settings')), body: ListView( padding: EdgeInsets.all(16), children: [ Card(child: SwitchListTile( title: Text(_trackingEnabled ? 'Full Tracking Mode' : 'SKAN-Only Mode'), subtitle: Text(_trackingEnabled ? 'IDFA collection and full analytics enabled.' : 'Anonymous SKAN tracking. Privacy protected.'), value: _trackingEnabled, onChanged: _isLoading ? null : _handleConsentToggle, )), Card(child: Padding(padding: EdgeInsets.all(16), child: Column( crossAxisAlignment: CrossAxisAlignment.start, children: [ Text('Mode Details', style: TextStyle(fontWeight: FontWeight.bold)), SizedBox(height: 8), Text('• Scenario A: Consent Granted → Full IDFA tracking'), Text('• Scenario B: Consent Denied → SKAN-only, anonymised'), Text('• Scenario C: Runtime toggle → Smooth SDK transition'), ], ))), ], ), ); } }

import 'package:flutter/material.dart'; import 'appsflyer_skan_manager.dart'; import 'event_tracker.dart'; import 'privacy_settings.dart'; void main() async { WidgetsFlutterBinding.ensureInitialized(); await AppsFlyerSKANManager().initialize(); runApp(MyApp()); } class MyApp extends StatelessWidget { @override Widget build(BuildContext context) { return MaterialApp( title: 'AppsFlyer SKAN Demo', home: HomeScreen(), ); } } class HomeScreen extends StatelessWidget { final _tracker = EventTracker(); @override Widget build(BuildContext context) { return Scaffold( appBar: AppBar( title: Text('AppsFlyer SKAN Demo'), actions: [ IconButton(icon: Icon(Icons.privacy_tip), onPressed: () { Navigator.push(context, MaterialPageRoute(builder: (_) => PrivacySettingsScreen())); }), ], ), body: Center(child: Column( mainAxisAlignment: MainAxisAlignment.center, children: [ ElevatedButton(onPressed: () => _tracker.trackPurchase(revenue: 99.99, currency: 'USD', productId: 'PRD123'), child: Text('Track Purchase')), SizedBox(height: 16), ElevatedButton(onPressed: () => _tracker.trackSignUp('email', 'user@example.com'), child: Text('Track Sign Up')), SizedBox(height: 16), ElevatedButton(onPressed: () => _tracker.trackAddToCart('PRD123', 29.99), child: Text('Track Add to Cart')), SizedBox(height: 16), ElevatedButton(onPressed: () => _tracker.trackHBBRevenue(49.99), child: Text('Track HBB Revenue')), ], )), ); } }