@react-native-google-mobile-ads/facebook 16.5.0

package/LICENSE

@@ -0,0 +1,32 @@
+Apache-2.0 License
+------------------
+
+Copyright (c) 2021-present Invertase Limited <oss@invertase.io>
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this library except in compliance with the License.
+
+You may obtain a copy of the Apache-2.0 License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+
+Creative Commons Attribution 3.0 License
+----------------------------------------
+
+Copyright (c) 2016-present Invertase Limited <oss@invertase.io>
+
+Documentation and other instructional materials provided for this project
+(including on a separate documentation repository or it's documentation website) are
+licensed under the Creative Commons Attribution 3.0 License. Code samples/blocks
+contained therein are licensed under the Apache License, Version 2.0 (the "License"), as above.
+
+You may obtain a copy of the Creative Commons Attribution 3.0 License at
+
+    https://creativecommons.org/licenses/by/3.0/

package/README.md

@@ -0,0 +1,70 @@
+# `@react-native-google-mobile-ads/facebook`
+
+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.
+
+## Install
+
+```bash
+yarn add @react-native-google-mobile-ads/facebook
+# peer: react-native-google-mobile-ads
+```
+
+Autolinking pulls in the native mediation artifacts. Rebuild the app after install.
+
+## Native adapter class names (GAM / AdMob UI)
+
+| Platform | Class name |
+| -------- | ---------- |
+| Android | `com.google.ads.mediation.facebook.FacebookMediationAdapter` |
+| iOS | `GADMediationAdapterFacebook` |
+
+Also exported from JS:
+
+```ts
+import {
+  nativeAdapterClassName,
+  networkSlug,
+} from '@react-native-google-mobile-ads/facebook';
+```
+
+## Mediation dependencies (pinned in this package)
+
+| Platform | Coordinate | Version pin |
+| -------- | ---------- | ----------- |
+| Android | `com.google.ads.mediation:facebook` | `6.22.0.0` |
+| iOS | CocoaPods `GoogleMobileAdsMediationFacebook` | `6.22.0.0` |
+
+Citations (verify at upgrade time):
+
+- Android: https://developers.google.com/admob/android/mediation/meta
+- iOS: https://developers.google.com/admob/ios/mediation/meta
+- CocoaPods: https://cocoapods.org/pods/GoogleMobileAdsMediationFacebook
+
+Core continues to own `play-services-ads` / `Google-Mobile-Ads-SDK`. This package does not re-pin the GMA SDK.
+
+Platform floors align with core: iOS **15.1** and Android minSdk **24**. The Meta Audience Network mediation adapter `6.22.0.0` requires iOS 15.0, below the React Native-driven product floor.
+
+> Google’s mediation guide permits Android minSdk 23 upstream; this product advertises 24 to match core.
+
+## Expo (optional)
+
+```js
+// app.json / app.config.js plugins
+[
+  '@react-native-google-mobile-ads/facebook',
+  {
+    // Pass Meta Audience Network SKAdNetwork IDs from Meta’s current docs
+    skAdNetworkItems: [/* ... */],
+  },
+]
+```
+
+App IDs stay in the core Expo plugin.
+
+## Out of scope
+
+- AppLovin MAX host SDK
+- CloudX / other non-GAM hosts
+- Fyber/DT Exchange (no Google GAM adapter — do not invent)

package/RNGoogleMobileAdsAdapterFacebook.podspec

@@ -0,0 +1,35 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+gam_adapter = package['gamAdapter']
+mediation_pod = gam_adapter['iosPod']
+mediation_version = package['sdkVersions']['ios']['googleMobileAdsMediation']
+
+Pod::Spec.new do |s|
+  s.name         = "RNGoogleMobileAdsAdapterFacebook"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.description  = package["description"]
+  s.homepage     = "https://github.com/invertase/react-native-google-mobile-ads"
+  s.license      = package["license"]
+  s.authors      = "Invertase Limited"
+  s.source       = {
+    :git => "#{package["repository"]["url"]}.git",
+    :tag => "v#{s.version}"
+  }
+  # Core requires iOS 15.1+; Meta Audience Network mediation adapter 6.22.0.0 requires iOS 15.0+.
+  # https://developers.google.com/admob/ios/mediation/meta
+  s.platforms    = { :ios => "15.1" }
+  s.source_files = "ios/**/*.{h,m,mm,swift}"
+
+  if respond_to?(:install_modules_dependencies, true)
+    install_modules_dependencies(s)
+  else
+    s.dependency "React-Core"
+  end
+
+  # Google-published Meta Audience Network GAM mediation adapter.
+  # https://developers.google.com/admob/ios/mediation/meta
+  # https://cocoapods.org/pods/GoogleMobileAdsMediationFacebook
+  s.dependency mediation_pod, mediation_version
+end

package/android/build.gradle

@@ -0,0 +1,67 @@
+import groovy.json.JsonSlurper
+
+buildscript {
+  ext.getExtOrDefault = { name, fallback ->
+    return rootProject.ext.has(name) ? rootProject.ext.get(name) : fallback
+  }
+
+  // AGP is only required when opening this android/ folder stand-alone.
+  if (project == rootProject) {
+    repositories {
+      google()
+      mavenCentral()
+    }
+    dependencies {
+      classpath("com.android.tools.build:gradle:8.6.0")
+    }
+  }
+}
+
+apply plugin: "com.android.library"
+
+def packageJson = new JsonSlurper().parseText(file("${projectDir}/../package.json").text)
+def gamAdapter = packageJson.gamAdapter
+def sdkVersions = packageJson.sdkVersions.android
+def mediationArtifact = "${gamAdapter.androidArtifact}:${sdkVersions.googleMobileAdsMediation}"
+
+android {
+  namespace "io.invertase.googlemobileads.adapters.facebook"
+
+  compileSdkVersion sdkVersions.compileSdk as Integer
+  buildToolsVersion sdkVersions.buildTools
+
+  defaultConfig {
+    minSdkVersion sdkVersions.minSdk as Integer
+    targetSdkVersion sdkVersions.targetSdk as Integer
+    buildConfigField "String", "GAM_ADAPTER_NETWORK", "\"${gamAdapter.network}\""
+    buildConfigField "String", "GAM_ADAPTER_ANDROID_CLASS", "\"${gamAdapter.androidAdapterClassName}\""
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+
+  buildFeatures {
+    buildConfig true
+  }
+
+  sourceSets {
+    main {
+      java.srcDirs = ["src/main/java"]
+    }
+  }
+}
+
+repositories {
+  google()
+  mavenCentral()
+}
+
+dependencies {
+  // 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).
+  // 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

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  GAM adapter packages carry Google mediation artifacts only.
+  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/AdapterPackageMarker.java

@@ -0,0 +1,10 @@
+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/app.plugin.js

@@ -0,0 +1 @@
+module.exports = require('./plugin/build');

package/ios/RNGoogleMobileAdsAdapterFacebookMarker.m

@@ -0,0 +1,11 @@
+#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

package/lib/commonjs/index.js

@@ -0,0 +1,31 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.networkSlug = exports.nativeAdapterClassName = void 0;
+/**
+ * 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).
+ *
+ * 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. */
+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'
+};
+//# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -0,0 +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":[]}

package/lib/commonjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/lib/module/index.js

@@ -0,0 +1,27 @@
+"use strict";
+
+/**
+ * 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).
+ *
+ * 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. */
+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'
+};
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +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":[]}

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

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

@@ -0,0 +1,24 @@
+/**
+ * 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).
+ *
+ * Native mediation is linked via Google's published adapter:
+ * - Android: `com.google.ads.mediation:facebook`
+ * - iOS: `GoogleMobileAdsMediationFacebook`
+ */
+export type NativeAdapterClassName = {
+    android: string;
+    ios: string;
+};
+/** Network slug for this Character 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;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/lib/typescript/commonjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

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

@@ -0,0 +1,24 @@
+/**
+ * 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).
+ *
+ * Native mediation is linked via Google's published adapter:
+ * - Android: `com.google.ads.mediation:facebook`
+ * - iOS: `GoogleMobileAdsMediationFacebook`
+ */
+export type NativeAdapterClassName = {
+    android: string;
+    ios: string;
+};
+/** Network slug for this Character 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;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/lib/typescript/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/package.json

@@ -0,0 +1,131 @@
+{
+  "name": "@react-native-google-mobile-ads/facebook",
+  "version": "16.5.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.",
+  "author": "Invertase <oss@invertase.io> (http://invertase.io)",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/invertase/react-native-google-mobile-ads",
+    "directory": "packages/facebook"
+  },
+  "keywords": [
+    "react-native",
+    "google-mobile-ads",
+    "admob",
+    "mediation",
+    "gam",
+    "facebook",
+    "meta",
+    "audience-network"
+  ],
+  "main": "lib/commonjs/index.js",
+  "module": "lib/module/index.js",
+  "react-native": "src/index.ts",
+  "types": "lib/typescript/commonjs/index.d.ts",
+  "exports": {
+    ".": {
+      "react-native": {
+        "types": "./lib/typescript/module/index.d.ts",
+        "default": "./src/index.ts"
+      },
+      "source": {
+        "types": "./lib/typescript/module/index.d.ts",
+        "default": "./src/index.ts"
+      },
+      "import": {
+        "types": "./lib/typescript/module/index.d.ts",
+        "default": "./lib/module/index.js"
+      },
+      "require": {
+        "types": "./lib/typescript/commonjs/index.d.ts",
+        "default": "./lib/commonjs/index.js"
+      },
+      "default": "./lib/commonjs/index.js"
+    },
+    "./app.plugin": "./app.plugin.js",
+    "./app.plugin.js": "./app.plugin.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "/android/",
+    "/ios/",
+    "/lib/",
+    "/plugin/",
+    "/src/",
+    "/LICENSE",
+    "/RNGoogleMobileAdsAdapterFacebook.podspec",
+    "/app.plugin.js",
+    "/react-native.config.js"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "gamAdapter": {
+    "network": "facebook",
+    "androidArtifact": "com.google.ads.mediation:facebook",
+    "androidAdapterClassName": "com.google.ads.mediation.facebook.FacebookMediationAdapter",
+    "iosPod": "GoogleMobileAdsMediationFacebook",
+    "iosAdapterClassName": "GADMediationAdapterFacebook"
+  },
+  "sdkVersions": {
+    "ios": {
+      "googleMobileAdsMediation": "6.22.0.0"
+    },
+    "android": {
+      "minSdk": 24,
+      "targetSdk": 36,
+      "compileSdk": 36,
+      "buildTools": "36.0.0",
+      "googleMobileAdsMediation": "6.22.0.0"
+    }
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "commonjs",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      "typescript"
+    ]
+  },
+  "scripts": {
+    "prepare": "yarn build && yarn build:plugin",
+    "build": "bob build",
+    "build:clean": "rimraf android/build && rimraf ios/build && rimraf lib && rimraf plugin/build",
+    "build:plugin": "yarn tsc --build plugin"
+  },
+  "peerDependencies": {
+    "@expo/config-plugins": ">=5.0.0",
+    "expo": ">=47.0.0",
+    "react": "*",
+    "react-native": ">=0.76",
+    "react-native-google-mobile-ads": ">=17.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@expo/config-plugins": {
+      "optional": true
+    },
+    "expo": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@expo/config-plugins": "^54.0.4",
+    "react-native-builder-bob": "^0.40.13",
+    "react-native-google-mobile-ads": "16.5.0",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.9.3"
+  },
+  "gitHead": "5229e2daf94d943a9aa6c8501dd31bf9c554cd0b"
+}

package/plugin/build/index.d.ts

@@ -0,0 +1,15 @@
+import { ConfigPlugin } from '@expo/config-plugins';
+type PluginParameters = {
+    /**
+     * Meta Audience Network SKAdNetwork identifiers to merge into Info.plist.
+     * Core's Expo plugin owns app IDs; this adapter only merges mediation network rows.
+     * Pass identifiers from Meta's current SKAdNetwork documentation at integrate time.
+     */
+    skAdNetworkItems?: string[];
+};
+/**
+ * Optional Expo config plugin for `@react-native-google-mobile-ads/facebook`.
+ * Does not set GMA app IDs (core plugin).
+ */
+declare const withRNGoogleMobileAdsAdapterFacebook: ConfigPlugin<PluginParameters>;
+export default withRNGoogleMobileAdsAdapterFacebook;

package/plugin/build/index.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_plugins_1 = require("@expo/config-plugins");
+const withAdapterSkAdNetworkItems = (config, skAdNetworkItems) => {
+    if (skAdNetworkItems === undefined || skAdNetworkItems.length === 0) {
+        return config;
+    }
+    return (0, config_plugins_1.withInfoPlist)(config, config => {
+        config.modResults.SKAdNetworkItems = config.modResults.SKAdNetworkItems ?? [];
+        const existingIdentifiers = config.modResults.SKAdNetworkItems.map((item) => item.SKAdNetworkIdentifier);
+        const missingIdentifiers = skAdNetworkItems.filter(identifier => !existingIdentifiers.includes(identifier));
+        config.modResults.SKAdNetworkItems.push(...missingIdentifiers.map(identifier => ({
+            SKAdNetworkIdentifier: identifier,
+        })));
+        return config;
+    });
+};
+/**
+ * Optional Expo config plugin for `@react-native-google-mobile-ads/facebook`.
+ * Does not set GMA app IDs (core plugin).
+ */
+const withRNGoogleMobileAdsAdapterFacebook = (config, { skAdNetworkItems } = {}) => {
+    return (0, config_plugins_1.withPlugins)(config, [[withAdapterSkAdNetworkItems, skAdNetworkItems]]);
+};
+exports.default = withRNGoogleMobileAdsAdapterFacebook;

package/plugin/src/index.ts

@@ -0,0 +1,52 @@
+import { ConfigPlugin, withInfoPlist, withPlugins } from '@expo/config-plugins';
+
+type PluginParameters = {
+  /**
+   * Meta Audience Network SKAdNetwork identifiers to merge into Info.plist.
+   * Core's Expo plugin owns app IDs; this adapter only merges mediation network rows.
+   * Pass identifiers from Meta's current SKAdNetwork documentation at integrate time.
+   */
+  skAdNetworkItems?: string[];
+};
+
+const withAdapterSkAdNetworkItems: ConfigPlugin<PluginParameters['skAdNetworkItems']> = (
+  config,
+  skAdNetworkItems,
+) => {
+  if (skAdNetworkItems === undefined || skAdNetworkItems.length === 0) {
+    return config;
+  }
+
+  return withInfoPlist(config, config => {
+    config.modResults.SKAdNetworkItems = config.modResults.SKAdNetworkItems ?? [];
+
+    const existingIdentifiers = config.modResults.SKAdNetworkItems.map(
+      (item: { SKAdNetworkIdentifier: string }) => item.SKAdNetworkIdentifier,
+    );
+
+    const missingIdentifiers = skAdNetworkItems.filter(
+      identifier => !existingIdentifiers.includes(identifier),
+    );
+
+    config.modResults.SKAdNetworkItems.push(
+      ...missingIdentifiers.map(identifier => ({
+        SKAdNetworkIdentifier: identifier,
+      })),
+    );
+
+    return config;
+  });
+};
+
+/**
+ * Optional Expo config plugin for `@react-native-google-mobile-ads/facebook`.
+ * Does not set GMA app IDs (core plugin).
+ */
+const withRNGoogleMobileAdsAdapterFacebook: ConfigPlugin<PluginParameters> = (
+  config,
+  { skAdNetworkItems } = {},
+) => {
+  return withPlugins(config, [[withAdapterSkAdNetworkItems, skAdNetworkItems]]);
+};
+
+export default withRNGoogleMobileAdsAdapterFacebook;

package/plugin/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "expo-module-scripts/tsconfig.plugin",
+  "compilerOptions": {
+    "outDir": "build",
+    "rootDir": "src"
+  },
+  "include": ["./src"],
+  "exclude": ["**/__mocks__/*", "**/__tests__/*"]
+}

package/plugin/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["./src/index.ts"],"version":"5.9.3"}

package/react-native.config.js

@@ -0,0 +1,12 @@
+/**
+ * Autolinking entry for the GAM adapter package.
+ * Adapters ship native mediation artifacts only — no TurboModule / Fabric view.
+ */
+module.exports = {
+  dependency: {
+    platforms: {
+      android: {},
+      ios: {},
+    },
+  },
+};

package/src/index.ts

@@ -0,0 +1,29 @@
+/**
+ * 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).
+ *
+ * Native mediation is linked via Google's published adapter:
+ * - Android: `com.google.ads.mediation:facebook`
+ * - iOS: `GoogleMobileAdsMediationFacebook`
+ */
+
+export type NativeAdapterClassName = {
+  android: string;
+  ios: string;
+};
+
+/** Network slug for this Character 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',
+};