@react-native-google-mobile-ads/facebook 17.2.0 → 17.3.0

package/README.md

@@ -2,7 +2,7 @@
 
 Meta Audience Network (Facebook) **Google Ad Manager / AdMob mediation** adapter package for [`react-native-google-mobile-ads`](https://github.com/invertase/react-native-google-mobile-ads).
 
-This package links Google’s official Meta Audience Network mediation adapter on Android and iOS. It does **not** ship AppLovin MAX, CloudX, or any JS ad APIs — use core `initialize()` / adapter status for discovery.
+This package links Google’s official Meta Audience Network mediation adapter on Android and iOS. It does **not** ship AppLovin MAX, CloudX, or JS ad-format APIs — use core `initialize()` / adapter status for discovery. It **does** expose Meta privacy hooks that must run before GMA initialize.
 
 ## Install
 
@@ -13,6 +13,42 @@ yarn add @react-native-google-mobile-ads/facebook
 
 Autolinking pulls in the native mediation artifacts. Rebuild the app after install.
 
+## Advertiser tracking (call before `initialize`)
+
+On **iOS versions below 17**, Meta’s Audience Network expects advertiser tracking to be set **before**
+Google Mobile Ads initialize. After App Tracking Transparency resolves (when you use it), call:
+
+```ts
+import mobileAds from 'react-native-google-mobile-ads';
+import { setAdvertiserTrackingEnabled } from '@react-native-google-mobile-ads/facebook';
+
+// After ATT (e.g. expo-tracking-transparency) resolves:
+setAdvertiserTrackingEnabled(true); // or false when tracking is denied
+await mobileAds().initialize();
+```
+
+| Platform | Behavior |
+| -------- | -------- |
+| iOS | Calls `FBAdSettings.setAdvertiserTrackingEnabled`. On **iOS 17+** with Audience Network **6.15.0+**, Meta marks this setter deprecated and unused — the SDK uses `ATTrackingManager.trackingAuthorizationStatus` instead (verified from local `FBAdSettings.h` in FBAudienceNetwork 6.17.1 / 6.22.0). |
+| Android | No-op — Meta’s Android `AdSettings` (audience-network-sdk 6.22.0) has no advertiser-tracking setter |
+
+Optional Limited Data Use / data-processing options:
+
+```ts
+import { setDataProcessingOptions } from '@react-native-google-mobile-ads/facebook';
+
+setDataProcessingOptions(['LDU']);
+// or with geography:
+setDataProcessingOptions(['LDU'], /* country */ 1, /* state */ 1000);
+```
+
+| Platform | Behavior |
+| -------- | -------- |
+| Android | `AdSettings.setDataProcessingOptions` |
+| iOS | `FBAdSettings.setDataProcessingOptions` |
+
+These are **runtime JS APIs**, not Expo plugin keys. Passing `metaAdvertiserTrackingEnabled` (or similar) to the core or facebook Expo plugin is ignored with a warning.
+
 ## Native adapter class names (GAM / AdMob UI)
 
 | Platform | Class name |
@@ -33,7 +69,7 @@ import {
 
 | Platform | Coordinate | Version pin |
 | -------- | ---------- | ----------- |
-| Android | `com.google.ads.mediation:facebook` | `6.22.0.0` |
+| Android | `com.google.ads.mediation:facebook` | `6.22.0.1` |
 | iOS | CocoaPods `GoogleMobileAdsMediationFacebook` | `6.22.0.0` |
 
 Citations (verify at upgrade time):
@@ -61,10 +97,28 @@ Platform floors align with core: iOS **15.1** and Android minSdk **24**. The Met
 ]
 ```
 
-App IDs stay in the core Expo plugin.
+App IDs stay in the core Expo plugin. Advertiser tracking stays in JS (`setAdvertiserTrackingEnabled`) — ATT status is not knowable at prebuild time.
+
+## iOS launch abort when this adapter is linked
+
+`GoogleMobileAdsMediationFacebook` embeds Meta’s `FBAudienceNetwork`. That framework can `SIGABRT` during
+its own early main-queue `dispatch_once` work — **before any ad request and before JS**. One reported
+exception reason is an unrecognized selector involving format string `%s` on `NSString`.
+
+That is **not** a bug in this package’s `RNGoogleMobileAdsAdapterFacebook` bridge (those methods only run
+when JS calls them). This package’s `setAdvertiserTrackingEnabled` / `setDataProcessingOptions` helpers
+therefore cannot prevent a process-start abort inside Meta’s binary.
+
+Checklist when only Meta mediation crashes at launch (AppLovin / Unity OK):
+
+1. AdMob / GAM `GADApplicationIdentifier` via the **core** Expo plugin (missing AdMob App ID is a separate start crash).
+2. `NSUserTrackingUsageDescription` when using ATT (`userTrackingUsageDescription` on the core plugin).
+3. Use this package’s pin (`6.22.0.0`) instead of an older `expo-build-properties` Facebook mediation pod.
+4. Retest on a shipping iOS release (not a beta), then escalate to Meta / Google’s Meta adapter with the crash report if it still aborts.
 
 ## Out of scope
 
 - AppLovin MAX host SDK
 - CloudX / other non-GAM hosts
 - Fyber/DT Exchange (no Google GAM adapter — do not invent)
+- Invented Expo keys such as `metaAudienceNetworkEnabled` (enablement is “adapter installed + AdMob UI”)

package/android/build.gradle

@@ -60,8 +60,11 @@ repositories {
 }
 
 dependencies {
+  // React Native bridge for Meta privacy hooks (AdSettings / advertiser-tracking JS API).
+  api("com.facebook.react:react-android")
+
   // Google-published Meta Audience Network GAM mediation adapter.
-  // Pin: package.json sdkVersions.android.googleMobileAdsMediation (docs: 6.22.0.0 as of package publish; verify against current docs/Maven).
+  // Pin: package.json sdkVersions.android.googleMobileAdsMediation (docs: 6.22.0.1 as of package publish; verify against current docs/Maven).
   // Core GMA is provided by react-native-google-mobile-ads; do not re-pin it here.
   // https://developers.google.com/admob/android/mediation/meta
   api(mediationArtifact) {

package/android/src/main/AndroidManifest.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!--
-  GAM adapter packages carry Google mediation artifacts only.
+  GAM facebook adapter: mediation artifact + Meta privacy NativeModule.
   App ID / measurement flags live in core (react-native-google-mobile-ads).
 -->
 <manifest xmlns:android="http://schemas.android.com/apk/res/android" />

package/android/src/main/java/io/invertase/googlemobileads/adapters/facebook/RNGoogleMobileAdsAdapterFacebookModule.java

@@ -0,0 +1,65 @@
+package io.invertase.googlemobileads.adapters.facebook;
+
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import com.facebook.ads.AdSettings;
+import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.bridge.ReactContextBaseJavaModule;
+import com.facebook.react.bridge.ReactMethod;
+import com.facebook.react.bridge.ReadableArray;
+import com.facebook.react.module.annotations.ReactModule;
+
+/**
+ * Meta Audience Network privacy hooks for GAM mediation.
+ *
+ * <p>{@code setAdvertiserTrackingEnabled} is an iOS-only Meta API. Android
+ * {@link AdSettings} (audience-network-sdk 6.22.0) exposes {@code setDataProcessingOptions}
+ * instead — verified from the local AAR.
+ */
+@ReactModule(name = RNGoogleMobileAdsAdapterFacebookModule.NAME)
+public class RNGoogleMobileAdsAdapterFacebookModule extends ReactContextBaseJavaModule {
+  public static final String NAME = "RNGoogleMobileAdsAdapterFacebook";
+
+  public RNGoogleMobileAdsAdapterFacebookModule(ReactApplicationContext reactContext) {
+    super(reactContext);
+  }
+
+  @NonNull
+  @Override
+  public String getName() {
+    return NAME;
+  }
+
+  /**
+   * No-op on Android: Meta Audience Network Android SDK has no advertiser-tracking setter.
+   * Kept so a single JS call site works on both platforms before GMA initialize.
+   */
+  @ReactMethod
+  public void setAdvertiserTrackingEnabled(boolean enabled) {
+    // Intentionally empty — see class javadoc.
+  }
+
+  @ReactMethod
+  public void setDataProcessingOptions(@Nullable ReadableArray options) {
+    AdSettings.setDataProcessingOptions(toStringArray(options));
+  }
+
+  @ReactMethod
+  public void setDataProcessingOptionsWithLocation(
+      @Nullable ReadableArray options, int country, int state) {
+    AdSettings.setDataProcessingOptions(toStringArray(options), country, state);
+  }
+
+  @NonNull
+  private static String[] toStringArray(@Nullable ReadableArray options) {
+    if (options == null || options.size() == 0) {
+      return new String[0];
+    }
+    String[] result = new String[options.size()];
+    for (int i = 0; i < options.size(); i++) {
+      String value = options.getString(i);
+      result[i] = value != null ? value : "";
+    }
+    return result;
+  }
+}

package/android/src/main/java/io/invertase/googlemobileads/adapters/facebook/RNGoogleMobileAdsAdapterFacebookPackage.java

@@ -0,0 +1,24 @@
+package io.invertase.googlemobileads.adapters.facebook;
+
+import androidx.annotation.NonNull;
+import com.facebook.react.ReactPackage;
+import com.facebook.react.bridge.NativeModule;
+import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.uimanager.ViewManager;
+import java.util.Collections;
+import java.util.List;
+
+/** Registers {@link RNGoogleMobileAdsAdapterFacebookModule} for autolinking. */
+public class RNGoogleMobileAdsAdapterFacebookPackage implements ReactPackage {
+  @NonNull
+  @Override
+  public List<NativeModule> createNativeModules(@NonNull ReactApplicationContext reactContext) {
+    return Collections.singletonList(new RNGoogleMobileAdsAdapterFacebookModule(reactContext));
+  }
+
+  @NonNull
+  @Override
+  public List<ViewManager> createViewManagers(@NonNull ReactApplicationContext reactContext) {
+    return Collections.emptyList();
+  }
+}

package/ios/RNGoogleMobileAdsAdapterFacebook.h

@@ -0,0 +1,4 @@
+#import <React/RCTBridgeModule.h>
+
+@interface RNGoogleMobileAdsAdapterFacebook : NSObject <RCTBridgeModule>
+@end

package/ios/RNGoogleMobileAdsAdapterFacebook.m

@@ -0,0 +1,31 @@
+#import "RNGoogleMobileAdsAdapterFacebook.h"
+
+#import <FBAudienceNetwork/FBAdSettings.h>
+
+@implementation RNGoogleMobileAdsAdapterFacebook
+
+RCT_EXPORT_MODULE();
+
+/**
+ * Meta requires advertiser tracking to be set before Google Mobile Ads initialize.
+ * Calls FBAdSettings.setAdvertiserTrackingEnabled (FBAudienceNetwork via
+ * GoogleMobileAdsMediationFacebook).
+ */
+RCT_EXPORT_METHOD(setAdvertiserTrackingEnabled : (BOOL)enabled) {
+  [FBAdSettings setAdvertiserTrackingEnabled:enabled];
+}
+
+RCT_EXPORT_METHOD(setDataProcessingOptions : (NSArray<NSString *> *)options) {
+  [FBAdSettings setDataProcessingOptions:options ?: @[]];
+}
+
+RCT_EXPORT_METHOD(setDataProcessingOptionsWithLocation
+                  : (NSArray<NSString *> *)options country
+                  : (double)country state
+                  : (double)state) {
+  [FBAdSettings setDataProcessingOptions:options ?: @[]
+                                 country:(NSInteger)country
+                                   state:(NSInteger)state];
+}
+
+@end

package/lib/commonjs/index.js

@@ -4,28 +4,84 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.networkSlug = exports.nativeAdapterClassName = void 0;
+exports.setAdvertiserTrackingEnabled = setAdvertiserTrackingEnabled;
+exports.setDataProcessingOptions = setDataProcessingOptions;
+var _reactNative = require("react-native");
 /**
  * Meta Audience Network (Facebook) GAM mediation adapter package public surface.
  *
- * Exports adapter class-name constants for GAM UI paste / docs only. Does **not**
- * add JS ad APIs — core `initialize()` adapter statuses remain the discovery
- * signal (API design §5.3).
+ * Exports adapter class-name constants for GAM UI paste / docs, plus Meta SDK
+ * privacy hooks that must run before core `mobileAds().initialize()`:
+ * - iOS: `FBAdSettings.setAdvertiserTrackingEnabled`
+ * - Android: `AdSettings.setDataProcessingOptions` (no advertiser-tracking API on
+ *   audience-network-sdk 6.22.0 — verified from the local AAR)
  *
  * Native mediation is linked via Google's published adapter:
  * - Android: `com.google.ads.mediation:facebook`
  * - iOS: `GoogleMobileAdsMediationFacebook`
  */
 
-/** Network slug for this Character GAM adapter package. */
+/** Network slug for this GAM adapter package. */
 const networkSlug = exports.networkSlug = 'facebook';
 
 /**
  * Fully-qualified native mediation adapter class names for AdMob / GAM console paste.
- * @see https://developers.google.com/admob/android/mediation/meta
- * @see https://developers.google.com/admob/ios/mediation/meta
  */
 const nativeAdapterClassName = exports.nativeAdapterClassName = {
   android: 'com.google.ads.mediation.facebook.FacebookMediationAdapter',
   ios: 'GADMediationAdapterFacebook'
 };
+const LINKING_ERROR = `RNGoogleMobileAdsAdapterFacebook native module is not linked. ` + `Rebuild the app after installing @react-native-google-mobile-ads/facebook` + (_reactNative.Platform.OS === 'ios' ? ` (pod install).` : `.`);
+const NativeFacebookAdapter = _reactNative.NativeModules.RNGoogleMobileAdsAdapterFacebook ?? new Proxy({}, {
+  get() {
+    throw new Error(LINKING_ERROR);
+  }
+});
+
+/**
+ * Set Meta Audience Network advertiser tracking (iOS ATT flag) before GMA initialize.
+ *
+ * On iOS this calls `FBAdSettings.setAdvertiserTrackingEnabled`. On **iOS 17+** with
+ * Audience Network **6.15.0+**, Meta’s `FBAdSettings.h` marks that setter deprecated and
+ * unused — the SDK reads `ATTrackingManager.trackingAuthorizationStatus` instead. On Android
+ * this is a documented no-op — Meta's Android `AdSettings` has no advertiser-tracking setter
+ * (audience-network-sdk 6.22.0).
+ *
+ * Call after resolving App Tracking Transparency (when applicable on older iOS) and **before**
+ * `mobileAds().initialize()`. This JS hook cannot prevent Meta `FBAudienceNetwork` process-start
+ * aborts that run before the bridge is up.
+ */
+function setAdvertiserTrackingEnabled(enabled) {
+  if (typeof enabled !== 'boolean') {
+    throw new Error("setAdvertiserTrackingEnabled(*) 'enabled' expected a boolean value.");
+  }
+  NativeFacebookAdapter.setAdvertiserTrackingEnabled(enabled);
+}
+
+/**
+ * Set Meta Audience Network data-processing options (e.g. Limited Data Use).
+ *
+ * On Android this calls `AdSettings.setDataProcessingOptions`. On iOS this calls
+ * `FBAdSettings.setDataProcessingOptions` when the Audience Network SDK is linked.
+ *
+ * Prefer calling before `mobileAds().initialize()`.
+ */
+function setDataProcessingOptions(options, country, state) {
+  if (!Array.isArray(options) || options.some(item => typeof item !== 'string')) {
+    throw new Error("setDataProcessingOptions(*) 'options' expected an array of strings.");
+  }
+  const hasCountry = country !== undefined;
+  const hasState = state !== undefined;
+  if (hasCountry !== hasState) {
+    throw new Error("setDataProcessingOptions(*) 'country' and 'state' must both be provided or both omitted.");
+  }
+  if (hasCountry && hasState) {
+    if (typeof country !== 'number' || typeof state !== 'number') {
+      throw new Error("setDataProcessingOptions(*) 'country' and 'state' expected number values.");
+    }
+    NativeFacebookAdapter.setDataProcessingOptionsWithLocation(options, country, state);
+    return;
+  }
+  NativeFacebookAdapter.setDataProcessingOptions(options);
+}
 //# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["networkSlug","exports","nativeAdapterClassName","android","ios"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAOA;AACO,MAAMA,WAAW,GAAAC,OAAA,CAAAD,WAAA,GAAG,UAAmB;;AAE9C;AACA;AACA;AACA;AACA;AACO,MAAME,sBAA8C,GAAAD,OAAA,CAAAC,sBAAA,GAAG;EAC5DC,OAAO,EAAE,4DAA4D;EACrEC,GAAG,EAAE;AACP,CAAC","ignoreList":[]}
+{"version":3,"names":["_reactNative","require","networkSlug","exports","nativeAdapterClassName","android","ios","LINKING_ERROR","Platform","OS","NativeFacebookAdapter","NativeModules","RNGoogleMobileAdsAdapterFacebook","Proxy","get","Error","setAdvertiserTrackingEnabled","enabled","setDataProcessingOptions","options","country","state","Array","isArray","some","item","hasCountry","undefined","hasState","setDataProcessingOptionsWithLocation"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAOA;AACO,MAAMC,WAAW,GAAAC,OAAA,CAAAD,WAAA,GAAG,UAAmB;;AAE9C;AACA;AACA;AACO,MAAME,sBAA8C,GAAAD,OAAA,CAAAC,sBAAA,GAAG;EAC5DC,OAAO,EAAE,4DAA4D;EACrEC,GAAG,EAAE;AACP,CAAC;AAQD,MAAMC,aAAa,GACjB,gEAAgE,GAChE,2EAA2E,IAC1EC,qBAAQ,CAACC,EAAE,KAAK,KAAK,GAAG,iBAAiB,GAAG,GAAG,CAAC;AAEnD,MAAMC,qBAAkD,GACrDC,0BAAa,CAACC,gCAAgC,IAC/C,IAAIC,KAAK,CAAC,CAAC,CAAC,EAAiC;EAC3CC,GAAGA,CAAA,EAAG;IACJ,MAAM,IAAIC,KAAK,CAACR,aAAa,CAAC;EAChC;AACF,CAAC,CAAC;;AAEJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASS,4BAA4BA,CAACC,OAAgB,EAAQ;EACnE,IAAI,OAAOA,OAAO,KAAK,SAAS,EAAE;IAChC,MAAM,IAAIF,KAAK,CACb,qEACF,CAAC;EACH;EACAL,qBAAqB,CAACM,4BAA4B,CAACC,OAAO,CAAC;AAC7D;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,wBAAwBA,CACtCC,OAAiB,EACjBC,OAAgB,EAChBC,KAAc,EACR;EACN,IAAI,CAACC,KAAK,CAACC,OAAO,CAACJ,OAAO,CAAC,IAAIA,OAAO,CAACK,IAAI,CAACC,IAAI,IAAI,OAAOA,IAAI,KAAK,QAAQ,CAAC,EAAE;IAC7E,MAAM,IAAIV,KAAK,CACb,qEACF,CAAC;EACH;EAEA,MAAMW,UAAU,GAAGN,OAAO,KAAKO,SAAS;EACxC,MAAMC,QAAQ,GAAGP,KAAK,KAAKM,SAAS;EACpC,IAAID,UAAU,KAAKE,QAAQ,EAAE;IAC3B,MAAM,IAAIb,KAAK,CACb,0FACF,CAAC;EACH;EAEA,IAAIW,UAAU,IAAIE,QAAQ,EAAE;IAC1B,IAAI,OAAOR,OAAO,KAAK,QAAQ,IAAI,OAAOC,KAAK,KAAK,QAAQ,EAAE;MAC5D,MAAM,IAAIN,KAAK,CACb,2EACF,CAAC;IACH;IACAL,qBAAqB,CAACmB,oCAAoC,CAACV,OAAO,EAAEC,OAAO,EAAEC,KAAK,CAAC;IACnF;EACF;EAEAX,qBAAqB,CAACQ,wBAAwB,CAACC,OAAO,CAAC;AACzD","ignoreList":[]}

package/lib/module/index.js

@@ -1,27 +1,82 @@
 "use strict";
 
+import { NativeModules, Platform } from 'react-native';
+
 /**
  * Meta Audience Network (Facebook) GAM mediation adapter package public surface.
  *
- * Exports adapter class-name constants for GAM UI paste / docs only. Does **not**
- * add JS ad APIs — core `initialize()` adapter statuses remain the discovery
- * signal (API design §5.3).
+ * Exports adapter class-name constants for GAM UI paste / docs, plus Meta SDK
+ * privacy hooks that must run before core `mobileAds().initialize()`:
+ * - iOS: `FBAdSettings.setAdvertiserTrackingEnabled`
+ * - Android: `AdSettings.setDataProcessingOptions` (no advertiser-tracking API on
+ *   audience-network-sdk 6.22.0 — verified from the local AAR)
  *
  * Native mediation is linked via Google's published adapter:
  * - Android: `com.google.ads.mediation:facebook`
  * - iOS: `GoogleMobileAdsMediationFacebook`
  */
 
-/** Network slug for this Character GAM adapter package. */
+/** Network slug for this GAM adapter package. */
 export const networkSlug = 'facebook';
 
 /**
  * Fully-qualified native mediation adapter class names for AdMob / GAM console paste.
- * @see https://developers.google.com/admob/android/mediation/meta
- * @see https://developers.google.com/admob/ios/mediation/meta
  */
 export const nativeAdapterClassName = {
   android: 'com.google.ads.mediation.facebook.FacebookMediationAdapter',
   ios: 'GADMediationAdapterFacebook'
 };
+const LINKING_ERROR = `RNGoogleMobileAdsAdapterFacebook native module is not linked. ` + `Rebuild the app after installing @react-native-google-mobile-ads/facebook` + (Platform.OS === 'ios' ? ` (pod install).` : `.`);
+const NativeFacebookAdapter = NativeModules.RNGoogleMobileAdsAdapterFacebook ?? new Proxy({}, {
+  get() {
+    throw new Error(LINKING_ERROR);
+  }
+});
+
+/**
+ * Set Meta Audience Network advertiser tracking (iOS ATT flag) before GMA initialize.
+ *
+ * On iOS this calls `FBAdSettings.setAdvertiserTrackingEnabled`. On **iOS 17+** with
+ * Audience Network **6.15.0+**, Meta’s `FBAdSettings.h` marks that setter deprecated and
+ * unused — the SDK reads `ATTrackingManager.trackingAuthorizationStatus` instead. On Android
+ * this is a documented no-op — Meta's Android `AdSettings` has no advertiser-tracking setter
+ * (audience-network-sdk 6.22.0).
+ *
+ * Call after resolving App Tracking Transparency (when applicable on older iOS) and **before**
+ * `mobileAds().initialize()`. This JS hook cannot prevent Meta `FBAudienceNetwork` process-start
+ * aborts that run before the bridge is up.
+ */
+export function setAdvertiserTrackingEnabled(enabled) {
+  if (typeof enabled !== 'boolean') {
+    throw new Error("setAdvertiserTrackingEnabled(*) 'enabled' expected a boolean value.");
+  }
+  NativeFacebookAdapter.setAdvertiserTrackingEnabled(enabled);
+}
+
+/**
+ * Set Meta Audience Network data-processing options (e.g. Limited Data Use).
+ *
+ * On Android this calls `AdSettings.setDataProcessingOptions`. On iOS this calls
+ * `FBAdSettings.setDataProcessingOptions` when the Audience Network SDK is linked.
+ *
+ * Prefer calling before `mobileAds().initialize()`.
+ */
+export function setDataProcessingOptions(options, country, state) {
+  if (!Array.isArray(options) || options.some(item => typeof item !== 'string')) {
+    throw new Error("setDataProcessingOptions(*) 'options' expected an array of strings.");
+  }
+  const hasCountry = country !== undefined;
+  const hasState = state !== undefined;
+  if (hasCountry !== hasState) {
+    throw new Error("setDataProcessingOptions(*) 'country' and 'state' must both be provided or both omitted.");
+  }
+  if (hasCountry && hasState) {
+    if (typeof country !== 'number' || typeof state !== 'number') {
+      throw new Error("setDataProcessingOptions(*) 'country' and 'state' expected number values.");
+    }
+    NativeFacebookAdapter.setDataProcessingOptionsWithLocation(options, country, state);
+    return;
+  }
+  NativeFacebookAdapter.setDataProcessingOptions(options);
+}
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["networkSlug","nativeAdapterClassName","android","ios"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAOA;AACA,OAAO,MAAMA,WAAW,GAAG,UAAmB;;AAE9C;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,sBAA8C,GAAG;EAC5DC,OAAO,EAAE,4DAA4D;EACrEC,GAAG,EAAE;AACP,CAAC","ignoreList":[]}
+{"version":3,"names":["NativeModules","Platform","networkSlug","nativeAdapterClassName","android","ios","LINKING_ERROR","OS","NativeFacebookAdapter","RNGoogleMobileAdsAdapterFacebook","Proxy","get","Error","setAdvertiserTrackingEnabled","enabled","setDataProcessingOptions","options","country","state","Array","isArray","some","item","hasCountry","undefined","hasState","setDataProcessingOptionsWithLocation"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,SAASA,aAAa,EAAEC,QAAQ,QAAQ,cAAc;;AAEtD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAOA;AACA,OAAO,MAAMC,WAAW,GAAG,UAAmB;;AAE9C;AACA;AACA;AACA,OAAO,MAAMC,sBAA8C,GAAG;EAC5DC,OAAO,EAAE,4DAA4D;EACrEC,GAAG,EAAE;AACP,CAAC;AAQD,MAAMC,aAAa,GACjB,gEAAgE,GAChE,2EAA2E,IAC1EL,QAAQ,CAACM,EAAE,KAAK,KAAK,GAAG,iBAAiB,GAAG,GAAG,CAAC;AAEnD,MAAMC,qBAAkD,GACrDR,aAAa,CAACS,gCAAgC,IAC/C,IAAIC,KAAK,CAAC,CAAC,CAAC,EAAiC;EAC3CC,GAAGA,CAAA,EAAG;IACJ,MAAM,IAAIC,KAAK,CAACN,aAAa,CAAC;EAChC;AACF,CAAC,CAAC;;AAEJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASO,4BAA4BA,CAACC,OAAgB,EAAQ;EACnE,IAAI,OAAOA,OAAO,KAAK,SAAS,EAAE;IAChC,MAAM,IAAIF,KAAK,CACb,qEACF,CAAC;EACH;EACAJ,qBAAqB,CAACK,4BAA4B,CAACC,OAAO,CAAC;AAC7D;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,wBAAwBA,CACtCC,OAAiB,EACjBC,OAAgB,EAChBC,KAAc,EACR;EACN,IAAI,CAACC,KAAK,CAACC,OAAO,CAACJ,OAAO,CAAC,IAAIA,OAAO,CAACK,IAAI,CAACC,IAAI,IAAI,OAAOA,IAAI,KAAK,QAAQ,CAAC,EAAE;IAC7E,MAAM,IAAIV,KAAK,CACb,qEACF,CAAC;EACH;EAEA,MAAMW,UAAU,GAAGN,OAAO,KAAKO,SAAS;EACxC,MAAMC,QAAQ,GAAGP,KAAK,KAAKM,SAAS;EACpC,IAAID,UAAU,KAAKE,QAAQ,EAAE;IAC3B,MAAM,IAAIb,KAAK,CACb,0FACF,CAAC;EACH;EAEA,IAAIW,UAAU,IAAIE,QAAQ,EAAE;IAC1B,IAAI,OAAOR,OAAO,KAAK,QAAQ,IAAI,OAAOC,KAAK,KAAK,QAAQ,EAAE;MAC5D,MAAM,IAAIN,KAAK,CACb,2EACF,CAAC;IACH;IACAJ,qBAAqB,CAACkB,oCAAoC,CAACV,OAAO,EAAEC,OAAO,EAAEC,KAAK,CAAC;IACnF;EACF;EAEAV,qBAAqB,CAACO,wBAAwB,CAACC,OAAO,CAAC;AACzD","ignoreList":[]}

package/lib/typescript/commonjs/index.d.ts

@@ -1,9 +1,11 @@
 /**
  * Meta Audience Network (Facebook) GAM mediation adapter package public surface.
  *
- * Exports adapter class-name constants for GAM UI paste / docs only. Does **not**
- * add JS ad APIs — core `initialize()` adapter statuses remain the discovery
- * signal (API design §5.3).
+ * Exports adapter class-name constants for GAM UI paste / docs, plus Meta SDK
+ * privacy hooks that must run before core `mobileAds().initialize()`:
+ * - iOS: `FBAdSettings.setAdvertiserTrackingEnabled`
+ * - Android: `AdSettings.setDataProcessingOptions` (no advertiser-tracking API on
+ *   audience-network-sdk 6.22.0 — verified from the local AAR)
  *
  * Native mediation is linked via Google's published adapter:
  * - Android: `com.google.ads.mediation:facebook`
@@ -13,12 +15,33 @@ export type NativeAdapterClassName = {
     android: string;
     ios: string;
 };
-/** Network slug for this Character GAM adapter package. */
+/** Network slug for this GAM adapter package. */
 export declare const networkSlug: "facebook";
 /**
  * Fully-qualified native mediation adapter class names for AdMob / GAM console paste.
- * @see https://developers.google.com/admob/android/mediation/meta
- * @see https://developers.google.com/admob/ios/mediation/meta
  */
 export declare const nativeAdapterClassName: NativeAdapterClassName;
+/**
+ * Set Meta Audience Network advertiser tracking (iOS ATT flag) before GMA initialize.
+ *
+ * On iOS this calls `FBAdSettings.setAdvertiserTrackingEnabled`. On **iOS 17+** with
+ * Audience Network **6.15.0+**, Meta’s `FBAdSettings.h` marks that setter deprecated and
+ * unused — the SDK reads `ATTrackingManager.trackingAuthorizationStatus` instead. On Android
+ * this is a documented no-op — Meta's Android `AdSettings` has no advertiser-tracking setter
+ * (audience-network-sdk 6.22.0).
+ *
+ * Call after resolving App Tracking Transparency (when applicable on older iOS) and **before**
+ * `mobileAds().initialize()`. This JS hook cannot prevent Meta `FBAudienceNetwork` process-start
+ * aborts that run before the bridge is up.
+ */
+export declare function setAdvertiserTrackingEnabled(enabled: boolean): void;
+/**
+ * Set Meta Audience Network data-processing options (e.g. Limited Data Use).
+ *
+ * On Android this calls `AdSettings.setDataProcessingOptions`. On iOS this calls
+ * `FBAdSettings.setDataProcessingOptions` when the Audience Network SDK is linked.
+ *
+ * Prefer calling before `mobileAds().initialize()`.
+ */
+export declare function setDataProcessingOptions(options: string[], country?: number, state?: number): void;
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,2DAA2D;AAC3D,eAAO,MAAM,WAAW,EAAG,UAAmB,CAAC;AAE/C;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,sBAGpC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,iDAAiD;AACjD,eAAO,MAAM,WAAW,EAAG,UAAmB,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,sBAGpC,CAAC;AAqBF;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAOnE;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,CA0BN"}

package/lib/typescript/module/index.d.ts

@@ -1,9 +1,11 @@
 /**
  * Meta Audience Network (Facebook) GAM mediation adapter package public surface.
  *
- * Exports adapter class-name constants for GAM UI paste / docs only. Does **not**
- * add JS ad APIs — core `initialize()` adapter statuses remain the discovery
- * signal (API design §5.3).
+ * Exports adapter class-name constants for GAM UI paste / docs, plus Meta SDK
+ * privacy hooks that must run before core `mobileAds().initialize()`:
+ * - iOS: `FBAdSettings.setAdvertiserTrackingEnabled`
+ * - Android: `AdSettings.setDataProcessingOptions` (no advertiser-tracking API on
+ *   audience-network-sdk 6.22.0 — verified from the local AAR)
  *
  * Native mediation is linked via Google's published adapter:
  * - Android: `com.google.ads.mediation:facebook`
@@ -13,12 +15,33 @@ export type NativeAdapterClassName = {
     android: string;
     ios: string;
 };
-/** Network slug for this Character GAM adapter package. */
+/** Network slug for this GAM adapter package. */
 export declare const networkSlug: "facebook";
 /**
  * Fully-qualified native mediation adapter class names for AdMob / GAM console paste.
- * @see https://developers.google.com/admob/android/mediation/meta
- * @see https://developers.google.com/admob/ios/mediation/meta
  */
 export declare const nativeAdapterClassName: NativeAdapterClassName;
+/**
+ * Set Meta Audience Network advertiser tracking (iOS ATT flag) before GMA initialize.
+ *
+ * On iOS this calls `FBAdSettings.setAdvertiserTrackingEnabled`. On **iOS 17+** with
+ * Audience Network **6.15.0+**, Meta’s `FBAdSettings.h` marks that setter deprecated and
+ * unused — the SDK reads `ATTrackingManager.trackingAuthorizationStatus` instead. On Android
+ * this is a documented no-op — Meta's Android `AdSettings` has no advertiser-tracking setter
+ * (audience-network-sdk 6.22.0).
+ *
+ * Call after resolving App Tracking Transparency (when applicable on older iOS) and **before**
+ * `mobileAds().initialize()`. This JS hook cannot prevent Meta `FBAudienceNetwork` process-start
+ * aborts that run before the bridge is up.
+ */
+export declare function setAdvertiserTrackingEnabled(enabled: boolean): void;
+/**
+ * Set Meta Audience Network data-processing options (e.g. Limited Data Use).
+ *
+ * On Android this calls `AdSettings.setDataProcessingOptions`. On iOS this calls
+ * `FBAdSettings.setDataProcessingOptions` when the Audience Network SDK is linked.
+ *
+ * Prefer calling before `mobileAds().initialize()`.
+ */
+export declare function setDataProcessingOptions(options: string[], country?: number, state?: number): void;
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,2DAA2D;AAC3D,eAAO,MAAM,WAAW,EAAG,UAAmB,CAAC;AAE/C;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,sBAGpC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,iDAAiD;AACjD,eAAO,MAAM,WAAW,EAAG,UAAmB,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,sBAGpC,CAAC;AAqBF;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAOnE;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,CA0BN"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@react-native-google-mobile-ads/facebook",
-  "version": "17.2.0",
-  "description": "Meta Audience Network (Facebook) Google Mobile Ads (GAM) mediation adapter for react-native-google-mobile-ads. Links the official Google mediation adapter on Android and iOS; does not add JS ad APIs.",
+  "version": "17.3.0",
+  "description": "Meta Audience Network (Facebook) Google Mobile Ads (GAM) mediation adapter for react-native-google-mobile-ads. Links the official Google mediation adapter on Android and iOS, and exposes Meta privacy hooks (advertiser tracking / data-processing options) for use before GMA initialize.",
   "author": "Invertase <oss@invertase.io> (http://invertase.io)",
   "license": "Apache-2.0",
   "repository": {
@@ -77,7 +77,7 @@
       "targetSdk": 36,
       "compileSdk": 36,
       "buildTools": "36.0.0",
-      "googleMobileAdsMediation": "6.22.0.0"
+      "googleMobileAdsMediation": "6.22.0.1"
     }
   },
   "react-native-builder-bob": {
@@ -123,9 +123,9 @@
   "devDependencies": {
     "@expo/config-plugins": "^54.0.4",
     "react-native-builder-bob": "^0.40.13",
-    "react-native-google-mobile-ads": "17.2.0",
+    "react-native-google-mobile-ads": "17.3.0",
     "rimraf": "^6.0.1",
     "typescript": "^5.9.3"
   },
-  "gitHead": "054a88b0d42727b32e74b09191f51c469c53f417"
+  "gitHead": "84973e83de32daede263f2add5fbf07df5b22df4"
 }

package/plugin/__tests__/plugin.test.ts

@@ -0,0 +1,45 @@
+import {
+  KNOWN_PLUGIN_PARAMETER_KEYS,
+  warnUnknownPluginParameters,
+} from '../src';
+
+describe('facebook Expo plugin unknown parameters', () => {
+  let warnSpy: jest.SpyInstance;
+
+  beforeEach(() => {
+    warnSpy = jest.spyOn(console, 'warn').mockImplementation(() => undefined);
+  });
+
+  afterEach(() => {
+    warnSpy.mockRestore();
+  });
+
+  it('exports skAdNetworkItems as the only known key', () => {
+    expect(KNOWN_PLUGIN_PARAMETER_KEYS).toEqual(['skAdNetworkItems']);
+  });
+
+  it('does not warn for skAdNetworkItems', () => {
+    warnUnknownPluginParameters({ skAdNetworkItems: ['abc.skadnetwork'] });
+    expect(warnSpy).not.toHaveBeenCalled();
+  });
+
+  it('warns that Meta advertiser-tracking keys are runtime JS APIs', () => {
+    warnUnknownPluginParameters({
+      metaAdvertiserTrackingEnabled: true,
+      advertiserTrackingEnabled: false,
+    });
+
+    expect(warnSpy).toHaveBeenCalled();
+    const message = warnSpy.mock.calls.map(call => call[0]).join('\n');
+    expect(message).toMatch(/metaAdvertiserTrackingEnabled|advertiserTrackingEnabled/);
+    expect(message).toMatch(/setAdvertiserTrackingEnabled/);
+    expect(message).toMatch(/before mobileAds\(\)\.initialize/);
+  });
+
+  it('warns for other unknown keys', () => {
+    warnUnknownPluginParameters({ fooBar: 1 });
+    expect(warnSpy).toHaveBeenCalledTimes(1);
+    expect(warnSpy.mock.calls[0][0]).toMatch(/fooBar/);
+    expect(warnSpy.mock.calls[0][0]).toMatch(/skAdNetworkItems/);
+  });
+});

package/plugin/build/index.d.ts

@@ -7,9 +7,17 @@ type PluginParameters = {
      */
     skAdNetworkItems?: string[];
 };
+/** Keys accepted by the facebook adapter Expo config plugin. */
+export declare const KNOWN_PLUGIN_PARAMETER_KEYS: readonly ["skAdNetworkItems"];
+/**
+ * Warn when Expo plugin options include keys this adapter plugin does not apply.
+ * Exported for unit tests.
+ */
+export declare function warnUnknownPluginParameters(params: Record<string, unknown> | undefined): void;
 /**
  * Optional Expo config plugin for `@react-native-google-mobile-ads/facebook`.
- * Does not set GMA app IDs (core plugin).
+ * Does not set GMA app IDs (core plugin). Does not set advertiser tracking
+ * (runtime JS — ATT status is not knowable at prebuild time).
  */
 declare const withRNGoogleMobileAdsAdapterFacebook: ConfigPlugin<PluginParameters>;
 export default withRNGoogleMobileAdsAdapterFacebook;

package/plugin/build/index.js

@@ -1,6 +1,35 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.KNOWN_PLUGIN_PARAMETER_KEYS = void 0;
+exports.warnUnknownPluginParameters = warnUnknownPluginParameters;
 const config_plugins_1 = require("@expo/config-plugins");
+/** Keys accepted by the facebook adapter Expo config plugin. */
+exports.KNOWN_PLUGIN_PARAMETER_KEYS = ['skAdNetworkItems'];
+const RUNTIME_META_KEYS_HINT = 'Advertiser tracking and data-processing options are runtime JS APIs on ' +
+    '@react-native-google-mobile-ads/facebook (setAdvertiserTrackingEnabled / setDataProcessingOptions), ' +
+    'not Expo plugin config. Call them before mobileAds().initialize().';
+/**
+ * Warn when Expo plugin options include keys this adapter plugin does not apply.
+ * Exported for unit tests.
+ */
+function warnUnknownPluginParameters(params) {
+    if (params == null || typeof params !== 'object' || Array.isArray(params)) {
+        return;
+    }
+    const known = new Set(exports.KNOWN_PLUGIN_PARAMETER_KEYS);
+    const unknownKeys = Object.keys(params).filter(key => !known.has(key));
+    if (unknownKeys.length === 0) {
+        return;
+    }
+    const runtimeKeys = unknownKeys.filter(key => /^(meta)?(AdvertiserTrackingEnabled|DataProcessingOptions|AudienceNetworkEnabled)$/i.test(key));
+    const otherKeys = unknownKeys.filter(key => !runtimeKeys.includes(key));
+    if (runtimeKeys.length > 0) {
+        console.warn(`[@react-native-google-mobile-ads/facebook] Ignoring Expo plugin option(s): ${runtimeKeys.join(', ')}. ${RUNTIME_META_KEYS_HINT}`);
+    }
+    if (otherKeys.length > 0) {
+        console.warn(`[@react-native-google-mobile-ads/facebook] Ignoring unknown Expo plugin option(s): ${otherKeys.join(', ')}. Known keys: ${exports.KNOWN_PLUGIN_PARAMETER_KEYS.join(', ')}.`);
+    }
+}
 const withAdapterSkAdNetworkItems = (config, skAdNetworkItems) => {
     if (skAdNetworkItems === undefined || skAdNetworkItems.length === 0) {
         return config;
@@ -17,9 +46,12 @@ const withAdapterSkAdNetworkItems = (config, skAdNetworkItems) => {
 };
 /**
  * Optional Expo config plugin for `@react-native-google-mobile-ads/facebook`.
- * Does not set GMA app IDs (core plugin).
+ * Does not set GMA app IDs (core plugin). Does not set advertiser tracking
+ * (runtime JS — ATT status is not knowable at prebuild time).
  */
-const withRNGoogleMobileAdsAdapterFacebook = (config, { skAdNetworkItems } = {}) => {
+const withRNGoogleMobileAdsAdapterFacebook = (config, props = {}) => {
+    warnUnknownPluginParameters(props);
+    const { skAdNetworkItems } = props;
     return (0, config_plugins_1.withPlugins)(config, [[withAdapterSkAdNetworkItems, skAdNetworkItems]]);
 };
 exports.default = withRNGoogleMobileAdsAdapterFacebook;

package/plugin/src/index.ts

@@ -9,6 +9,55 @@ type PluginParameters = {
   skAdNetworkItems?: string[];
 };
 
+/** Keys accepted by the facebook adapter Expo config plugin. */
+export const KNOWN_PLUGIN_PARAMETER_KEYS = ['skAdNetworkItems'] as const;
+
+const RUNTIME_META_KEYS_HINT =
+  'Advertiser tracking and data-processing options are runtime JS APIs on ' +
+  '@react-native-google-mobile-ads/facebook (setAdvertiserTrackingEnabled / setDataProcessingOptions), ' +
+  'not Expo plugin config. Call them before mobileAds().initialize().';
+
+/**
+ * Warn when Expo plugin options include keys this adapter plugin does not apply.
+ * Exported for unit tests.
+ */
+export function warnUnknownPluginParameters(
+  params: Record<string, unknown> | undefined,
+): void {
+  if (params == null || typeof params !== 'object' || Array.isArray(params)) {
+    return;
+  }
+
+  const known = new Set<string>(KNOWN_PLUGIN_PARAMETER_KEYS);
+  const unknownKeys = Object.keys(params).filter(key => !known.has(key));
+  if (unknownKeys.length === 0) {
+    return;
+  }
+
+  const runtimeKeys = unknownKeys.filter(key =>
+    /^(meta)?(AdvertiserTrackingEnabled|DataProcessingOptions|AudienceNetworkEnabled)$/i.test(
+      key,
+    ),
+  );
+  const otherKeys = unknownKeys.filter(key => !runtimeKeys.includes(key));
+
+  if (runtimeKeys.length > 0) {
+    console.warn(
+      `[@react-native-google-mobile-ads/facebook] Ignoring Expo plugin option(s): ${runtimeKeys.join(
+        ', ',
+      )}. ${RUNTIME_META_KEYS_HINT}`,
+    );
+  }
+
+  if (otherKeys.length > 0) {
+    console.warn(
+      `[@react-native-google-mobile-ads/facebook] Ignoring unknown Expo plugin option(s): ${otherKeys.join(
+        ', ',
+      )}. Known keys: ${KNOWN_PLUGIN_PARAMETER_KEYS.join(', ')}.`,
+    );
+  }
+}
+
 const withAdapterSkAdNetworkItems: ConfigPlugin<PluginParameters['skAdNetworkItems']> = (
   config,
   skAdNetworkItems,
@@ -40,12 +89,16 @@ const withAdapterSkAdNetworkItems: ConfigPlugin<PluginParameters['skAdNetworkIte
 
 /**
  * Optional Expo config plugin for `@react-native-google-mobile-ads/facebook`.
- * Does not set GMA app IDs (core plugin).
+ * Does not set GMA app IDs (core plugin). Does not set advertiser tracking
+ * (runtime JS — ATT status is not knowable at prebuild time).
  */
 const withRNGoogleMobileAdsAdapterFacebook: ConfigPlugin<PluginParameters> = (
   config,
-  { skAdNetworkItems } = {},
+  props = {},
 ) => {
+  warnUnknownPluginParameters(props as Record<string, unknown>);
+
+  const { skAdNetworkItems } = props;
   return withPlugins(config, [[withAdapterSkAdNetworkItems, skAdNetworkItems]]);
 };
 

package/react-native.config.js

@@ -1,11 +1,15 @@
 /**
- * Autolinking entry for the GAM adapter package.
- * Adapters ship native mediation artifacts only — no TurboModule / Fabric view.
+ * Autolinking entry for the GAM facebook adapter package.
+ * Registers the Meta privacy NativeModule (advertiser tracking / data-processing options).
  */
 module.exports = {
   dependency: {
     platforms: {
-      android: {},
+      android: {
+        packageImportPath:
+          'import io.invertase.googlemobileads.adapters.facebook.RNGoogleMobileAdsAdapterFacebookPackage;',
+        packageInstance: 'new RNGoogleMobileAdsAdapterFacebookPackage()',
+      },
       ios: {},
     },
   },

package/src/index.ts

@@ -1,9 +1,13 @@
+import { NativeModules, Platform } from 'react-native';
+
 /**
  * Meta Audience Network (Facebook) GAM mediation adapter package public surface.
  *
- * Exports adapter class-name constants for GAM UI paste / docs only. Does **not**
- * add JS ad APIs — core `initialize()` adapter statuses remain the discovery
- * signal (API design §5.3).
+ * Exports adapter class-name constants for GAM UI paste / docs, plus Meta SDK
+ * privacy hooks that must run before core `mobileAds().initialize()`:
+ * - iOS: `FBAdSettings.setAdvertiserTrackingEnabled`
+ * - Android: `AdSettings.setDataProcessingOptions` (no advertiser-tracking API on
+ *   audience-network-sdk 6.22.0 — verified from the local AAR)
  *
  * Native mediation is linked via Google's published adapter:
  * - Android: `com.google.ads.mediation:facebook`
@@ -15,15 +19,94 @@ export type NativeAdapterClassName = {
   ios: string;
 };
 
-/** Network slug for this Character GAM adapter package. */
+/** Network slug for this GAM adapter package. */
 export const networkSlug = 'facebook' as const;
 
 /**
  * Fully-qualified native mediation adapter class names for AdMob / GAM console paste.
- * @see https://developers.google.com/admob/android/mediation/meta
- * @see https://developers.google.com/admob/ios/mediation/meta
  */
 export const nativeAdapterClassName: NativeAdapterClassName = {
   android: 'com.google.ads.mediation.facebook.FacebookMediationAdapter',
   ios: 'GADMediationAdapterFacebook',
 };
+
+type NativeFacebookAdapterModule = {
+  setAdvertiserTrackingEnabled(enabled: boolean): void;
+  setDataProcessingOptions(options: string[]): void;
+  setDataProcessingOptionsWithLocation(options: string[], country: number, state: number): void;
+};
+
+const LINKING_ERROR =
+  `RNGoogleMobileAdsAdapterFacebook native module is not linked. ` +
+  `Rebuild the app after installing @react-native-google-mobile-ads/facebook` +
+  (Platform.OS === 'ios' ? ` (pod install).` : `.`);
+
+const NativeFacebookAdapter: NativeFacebookAdapterModule =
+  (NativeModules.RNGoogleMobileAdsAdapterFacebook as NativeFacebookAdapterModule | undefined) ??
+  new Proxy({} as NativeFacebookAdapterModule, {
+    get() {
+      throw new Error(LINKING_ERROR);
+    },
+  });
+
+/**
+ * Set Meta Audience Network advertiser tracking (iOS ATT flag) before GMA initialize.
+ *
+ * On iOS this calls `FBAdSettings.setAdvertiserTrackingEnabled`. On **iOS 17+** with
+ * Audience Network **6.15.0+**, Meta’s `FBAdSettings.h` marks that setter deprecated and
+ * unused — the SDK reads `ATTrackingManager.trackingAuthorizationStatus` instead. On Android
+ * this is a documented no-op — Meta's Android `AdSettings` has no advertiser-tracking setter
+ * (audience-network-sdk 6.22.0).
+ *
+ * Call after resolving App Tracking Transparency (when applicable on older iOS) and **before**
+ * `mobileAds().initialize()`. This JS hook cannot prevent Meta `FBAudienceNetwork` process-start
+ * aborts that run before the bridge is up.
+ */
+export function setAdvertiserTrackingEnabled(enabled: boolean): void {
+  if (typeof enabled !== 'boolean') {
+    throw new Error(
+      "setAdvertiserTrackingEnabled(*) 'enabled' expected a boolean value.",
+    );
+  }
+  NativeFacebookAdapter.setAdvertiserTrackingEnabled(enabled);
+}
+
+/**
+ * Set Meta Audience Network data-processing options (e.g. Limited Data Use).
+ *
+ * On Android this calls `AdSettings.setDataProcessingOptions`. On iOS this calls
+ * `FBAdSettings.setDataProcessingOptions` when the Audience Network SDK is linked.
+ *
+ * Prefer calling before `mobileAds().initialize()`.
+ */
+export function setDataProcessingOptions(
+  options: string[],
+  country?: number,
+  state?: number,
+): void {
+  if (!Array.isArray(options) || options.some(item => typeof item !== 'string')) {
+    throw new Error(
+      "setDataProcessingOptions(*) 'options' expected an array of strings.",
+    );
+  }
+
+  const hasCountry = country !== undefined;
+  const hasState = state !== undefined;
+  if (hasCountry !== hasState) {
+    throw new Error(
+      "setDataProcessingOptions(*) 'country' and 'state' must both be provided or both omitted.",
+    );
+  }
+
+  if (hasCountry && hasState) {
+    if (typeof country !== 'number' || typeof state !== 'number') {
+      throw new Error(
+        "setDataProcessingOptions(*) 'country' and 'state' expected number values.",
+      );
+    }
+    NativeFacebookAdapter.setDataProcessingOptionsWithLocation(options, country, state);
+    return;
+  }
+
+  NativeFacebookAdapter.setDataProcessingOptions(options);
+}

package/android/src/main/java/io/invertase/googlemobileads/adapters/facebook/AdapterPackageMarker.java

@@ -1,10 +0,0 @@
-package io.invertase.googlemobileads.adapters.facebook;
-
-/**
- * Package marker so the Android library module has a compilable source root.
- * This package does not expose a TurboModule — mediation is linked via Gradle
- * ({@code com.google.ads.mediation:facebook}).
- */
-public final class AdapterPackageMarker {
-  private AdapterPackageMarker() {}
-}

package/ios/RNGoogleMobileAdsAdapterFacebookMarker.m

@@ -1,11 +0,0 @@
-#import <Foundation/Foundation.h>
-
-/**
- * Package marker so the podspec has a compilable source file.
- * Mediation is linked via the GoogleMobileAdsMediationFacebook pod dependency.
- */
-@interface RNGoogleMobileAdsAdapterFacebookMarker : NSObject
-@end
-
-@implementation RNGoogleMobileAdsAdapterFacebookMarker
-@end