feat: add fetchDeferredAppLink method for Facebook ad attribution

.gitignore

@@ -12,3 +12,4 @@ build/
 **/Package.resolved
 
 **/*/Flutter/ephemeral
+.osgrep

android/src/main/kotlin/id/oddbit/flutter/facebook_app_events/FacebookAppEventsPlugin.kt

@@ -16,6 +16,8 @@ import io.flutter.plugin.common.MethodChannel.MethodCallHandler
 import io.flutter.plugin.common.MethodChannel.Result
 import java.util.Currency
 import com.facebook.LoggingBehavior
+import com.facebook.applinks.AppLinkData
+import android.net.Uri
 
 /** FacebookAppEventsPlugin */
 class FacebookAppEventsPlugin: FlutterPlugin, MethodCallHandler {
@@ -61,6 +63,9 @@ class FacebookAppEventsPlugin: FlutterPlugin, MethodCallHandler {
       "getAnonymousId" -> handleGetAnonymousId(call, result)
       "logPurchase" -> handlePurchased(call, result)
       "setAdvertiserTracking" -> handleSetAdvertiserTracking(call, result)
+      "fetchDeferredAppLink" -> handleFetchDeferredAppLink(call, result)
+      "setDebugEnabled" -> handleSetDebugEnabled(call, result)
+      "recordAndUpdateAEMEvent" -> result.success(null) // AEM is iOS-only, no-op on Android
 
       else -> result.notImplemented()
     }
@@ -138,6 +143,24 @@ class FacebookAppEventsPlugin: FlutterPlugin, MethodCallHandler {
     result.success(null)
   }
 
+  private fun handleSetDebugEnabled(call: MethodCall, result: Result) {
+    val enabled = call.arguments as? Boolean ?: false
+
+    FacebookSdk.setIsDebugEnabled(enabled)
+
+    if (enabled) {
+      FacebookSdk.addLoggingBehavior(LoggingBehavior.APP_EVENTS)
+      FacebookSdk.addLoggingBehavior(LoggingBehavior.REQUESTS)
+      FacebookSdk.addLoggingBehavior(LoggingBehavior.INCLUDE_RAW_RESPONSES)
+    } else {
+      FacebookSdk.removeLoggingBehavior(LoggingBehavior.APP_EVENTS)
+      FacebookSdk.removeLoggingBehavior(LoggingBehavior.REQUESTS)
+      FacebookSdk.removeLoggingBehavior(LoggingBehavior.INCLUDE_RAW_RESPONSES)
+    }
+
+    result.success(null)
+  }
+
   private fun handleLogEvent(call: MethodCall, result: Result) {
     val eventName = call.argument<String>("name")
     if (eventName == null) {
@@ -251,4 +274,57 @@ class FacebookAppEventsPlugin: FlutterPlugin, MethodCallHandler {
     appEventsLogger.logPurchase(amount, currency, parameterBundle)
     result.success(null)
   }
+
+  private fun handleFetchDeferredAppLink(call: MethodCall, result: Result) {
+    val context = application
+    if (context == null) {
+      result.success(null)
+      return
+    }
+
+    AppLinkData.fetchDeferredAppLinkData(context) { appLinkData ->
+      if (appLinkData == null) {
+        result.success(null)
+        return@fetchDeferredAppLinkData
+      }
+
+      val targetUri = appLinkData.targetUri
+      if (targetUri == null) {
+        result.success(null)
+        return@fetchDeferredAppLinkData
+      }
+
+      val data = mutableMapOf<String, Any>(
+        "targetUrl" to targetUri.toString()
+      )
+
+      // Extract query parameters from the target URI
+      val queryParams = mutableMapOf<String, String>()
+      targetUri.queryParameterNames?.forEach { paramName ->
+        targetUri.getQueryParameter(paramName)?.let { paramValue ->
+          queryParams[paramName] = paramValue
+
+          // Extract known Facebook parameters
+          if (paramName == "fb_click_time_utc") {
+            data["clickTimestamp"] = paramValue
+          }
+        }
+      }
+      if (queryParams.isNotEmpty()) {
+        data["queryParameters"] = queryParams
+      }
+
+      // Add promotion code if available
+      appLinkData.promotionCode?.let { promoCode ->
+        data["promotionCode"] = promoCode
+      }
+
+      // Add referrer data if available
+      appLinkData.ref?.let { ref ->
+        data["ref"] = ref
+      }
+
+      result.success(data)
+    }
+  }
 }

example/android/settings.gradle

@@ -18,7 +18,7 @@ pluginManagement {
 
 plugins {
     id "dev.flutter.flutter-plugin-loader" version "1.0.0"
-    id "com.android.application" version "8.1.1" apply false
+    id "com.android.application" version "8.2.1" apply false
     id "org.jetbrains.kotlin.android" version "1.8.22" apply false
 }
 

example/ios/Flutter/AppFrameworkInfo.plist

@@ -21,6 +21,6 @@
   <key>CFBundleVersion</key>
   <string>1.0</string>
   <key>MinimumOSVersion</key>
-  <string>12.0</string>
+  <string>13.0</string>
 </dict>
 </plist>

example/ios/Podfile

@@ -1,5 +1,5 @@
 # Uncomment this line to define a global platform for your project
-# platform :ios, '12.0'
+# platform :ios, '13.0'
 
 # CocoaPods analytics sends network stats synchronously affecting flutter build latency.
 ENV['COCOAPODS_DISABLE_STATS'] = 'true'

example/ios/Podfile.lock

@@ -1,5 +1,5 @@
 PODS:
-  - facebook_app_events (0.20.0):
+  - facebook_app_events (0.24.0):
     - FBSDKCoreKit (~> 18.0)
     - Flutter
   - FBAEMKit (18.0.0):
@@ -27,12 +27,12 @@ EXTERNAL SOURCES:
     :path: Flutter
 
 SPEC CHECKSUMS:
-  facebook_app_events: cfa07e73912a052992b5f218f79a19a66a99bf1a
+  facebook_app_events: 58a1b62fd50f6009907bd167fc26b3d043e97197
   FBAEMKit: e34530df538b8eb8aeb53c35867715ba6c63ef0c
   FBSDKCoreKit: d3f479a69127acebb1c6aad91c1a33907bcf6c2f
   FBSDKCoreKit_Basics: 017b6dc2a1862024815a8229e75661e627ac1e29
-  Flutter: e0871f40cf51350855a761d2e70bf5af5b9b5de7
+  Flutter: cabc95a1d2626b1b06e7179b784ebcf0c0cde467
 
-PODFILE CHECKSUM: c4c93c5f6502fe2754f48404d3594bf779584011
+PODFILE CHECKSUM: 0dbd5a87e0ace00c9610d2037ac22083a01f861d
 
 COCOAPODS: 1.16.2

example/ios/Runner.xcodeproj/project.pbxproj

@@ -355,7 +355,7 @@
 				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
 				GCC_WARN_UNUSED_FUNCTION = YES;
 				GCC_WARN_UNUSED_VARIABLE = YES;
-				IPHONEOS_DEPLOYMENT_TARGET = 12.0;
+				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
 				MTL_ENABLE_DEBUG_INFO = NO;
 				SDKROOT = iphoneos;
 				SUPPORTED_PLATFORMS = iphoneos;
@@ -377,7 +377,7 @@
 					"$(PROJECT_DIR)/Flutter",
 				);
 				INFOPLIST_FILE = Runner/Info.plist;
-				IPHONEOS_DEPLOYMENT_TARGET = 12.0;
+				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
 				LD_RUNPATH_SEARCH_PATHS = (
 					"$(inherited)",
 					"@executable_path/Frameworks",
@@ -441,7 +441,7 @@
 				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
 				GCC_WARN_UNUSED_FUNCTION = YES;
 				GCC_WARN_UNUSED_VARIABLE = YES;
-				IPHONEOS_DEPLOYMENT_TARGET = 12.0;
+				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
 				MTL_ENABLE_DEBUG_INFO = YES;
 				ONLY_ACTIVE_ARCH = YES;
 				SDKROOT = iphoneos;
@@ -490,7 +490,7 @@
 				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
 				GCC_WARN_UNUSED_FUNCTION = YES;
 				GCC_WARN_UNUSED_VARIABLE = YES;
-				IPHONEOS_DEPLOYMENT_TARGET = 12.0;
+				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
 				MTL_ENABLE_DEBUG_INFO = NO;
 				SDKROOT = iphoneos;
 				SUPPORTED_PLATFORMS = iphoneos;
@@ -513,7 +513,7 @@
 					"$(PROJECT_DIR)/Flutter",
 				);
 				INFOPLIST_FILE = Runner/Info.plist;
-				IPHONEOS_DEPLOYMENT_TARGET = 12.0;
+				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
 				LD_RUNPATH_SEARCH_PATHS = (
 					"$(inherited)",
 					"@executable_path/Frameworks",
@@ -544,7 +544,7 @@
 					"$(PROJECT_DIR)/Flutter",
 				);
 				INFOPLIST_FILE = Runner/Info.plist;
-				IPHONEOS_DEPLOYMENT_TARGET = 12.0;
+				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
 				LD_RUNPATH_SEARCH_PATHS = (
 					"$(inherited)",
 					"@executable_path/Frameworks",

example/ios/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme

@@ -50,6 +50,7 @@
       ignoresPersistentStateOnLaunch = "NO"
       debugDocumentVersioning = "YES"
       debugServiceExtension = "internal"
+      enableGPUValidationMode = "1"
       allowLocationSimulation = "YES">
       <BuildableProductRunnable
          runnableDebuggingMode = "0">