@javascriptcommon/react-native-google-mobile-ads

中文文档
16.3.10发布于 2026/11/01Apache-2.0TypeScriptESM + CJS

react-native-google-mobile-ads的分支迁移到Android上的GMA Next-Gen SDK (iOS保留了经典的谷歌Mobile Ads SDK)。支持横幅广告、插页广告和应用开放;原生广告和奖励并未移植到Android上。

中文使用文档
文档目录12 节
  1. React Native谷歌手机广告(次世代Android分支)
  2. 广告形式
  3. 应用程序打开
  4. 横幅
  5. 本地的
  6. 间质
  7. 奖励
  8. 奖励间隙
  9. 迁移到新的体系结构状态(向后兼容)
  10. 文档
  11. 贡献
  12. 许可证


React Native谷歌手机广告(次世代Android分支)

叉通知 - - - - - - @javascriptcommon/react-native-google-mobile-ads 迁移的 安卓 本地层到 GMA下一代SDK (ads-mobile-sdk). iOS是 不变(经典GMA SDK)。在Android平台上,只有横幅广告/插页广告/ app-open / 同意得到执行;原生广告和奖励广告则不然。与上游相同的JS API。

NPM downloads NPM version License

Chat on Discord Follow on Twitter Follow on Facebook


React Native谷歌移动广告 允许你通过AdMob实现应用盈利;一个React Native的包装,围绕原生的谷歌移动广告sdk的iOS和Android。

React Native b谷歌移动广告是基于三个关键原则构建的;

  • 🧪 好测试
    • 该模块经过广泛测试,覆盖率达到了95%(从react-native-firebase迁移到那里之后!)
  • 👁 好的类型
    • 包括对Typescript的第一类支持
  • 📄 良好的文档记录
    • 完整的参考和安装文档以及详细的指南和常见问题解答

广告形式

应用程序打开

应用打开广告是一种特殊的广告形式,专为希望从应用加载屏幕中获利的发行商设计。

App open ad

了解更多

横幅

横幅广告单元显示矩形广告,占据应用布局的一部分。 当用户与应用交互时,它们会留在屏幕上,或者固定在屏幕的顶部或底部,或者在用户滚动时与内容嵌在一起。 横幅广告可以在一段时间后自动刷新。

固定的自适应

全宽度和自动高度的动态大小的横幅。锚定自适应横幅预计将始终在屏幕上,锁定在屏幕的顶部或底部。

Anchored adaptive

了解更多

内联适应性

与锚定自适应横幅相比,内联自适应横幅更大、更高。 它们的高度是可变的,可以和设备屏幕一样高。 它们被放置在滚动内容中。

Inline adaptive

了解更多

可折叠的

可折叠横幅广告的目的是提高锚定广告的性能,否则是一个较小的尺寸。

Collapsible banner

了解更多

固定大小(遗留)

谷歌移动广告SDK支持固定广告大小的情况下,自适应横幅广告不能满足您的需求。 横幅(320x50),大横幅(320x100),中矩形(300x250),全横幅(468x60)和排行榜(728x90)。

了解更多

本地的

原生广告允许你自定义出现在应用中的广告的外观和感觉。 你决定它们的放置方式和位置,所以布局更符合你的应用设计。

Native

了解更多

间质

插页式广告单元在你的应用中显示整页广告。将它们放置在应用界面的自然休息和过渡处,例如在游戏应用中完成关卡后。

Interstitial

了解更多

奖励

AdMob奖励广告单元允许你为与视频广告、可玩广告和调查互动的用户提供应用内道具奖励。

Rewarded

了解更多

奖励间隙

奖励性插播广告是一种激励广告形式,允许你为在应用自然过渡期间自动出现的广告提供奖励。 与奖励广告不同的是,用户不需要选择是否观看奖励插播广告。

Rewarded interstitial

了解更多

迁移到新的体系结构状态(向后兼容)

这个包可以在The Old和 新建筑. 当使用新架构时,一些遗留代码仍然会被使用。请参阅下面的状态:

平台特征状态
iOS移动广告SDK方法(Turbo Native Module)✅完成
iOS横幅(Fabric Native Component)✅完成
iOS全屏广告(Turbo Native Module)✅完成
iOS原生广告(Turbo原生模块,Fabric原生组件)✅完成
iOS用户消息传递平台(Turbo原生模块)✅完成
iOSEventEmitter (Turbo原生模块)⏳待办事项
iOS收益精度常量(Turbo原生模块)✅完成
安卓移动广告SDK方法(Turbo Native Module)⏳待办事项
安卓横幅(Fabric Native Component)⏳待办事项
安卓全屏广告(Turbo Native Module)⏳待办事项
安卓原生广告(Turbo原生模块,Fabric原生组件)✅完成
安卓用户消息传递平台(Turbo原生模块)⏳待办事项
安卓EventEmitter (Turbo原生模块)⏳待办事项
安卓收益精度常量(Turbo原生模块)⏳待办事项

文档

贡献

许可证


建造和维护 转化酶.

版本与发布记录

@javascriptcommon/react-native-google-mobile-ads 共发布 8 个版本,首次发布于 2026/06/24;过去 12 个月发布了 8 个版本。

版本发布日期距今
16.3.10latest2026/11/012 天前
16.3.92026/09/181 个月前
16.3.82026/09/161 个月前
16.3.72026/09/051 个月前
16.3.62026/08/062 个月前
16.3.52026/07/123 个月前

关于 @javascriptcommon/react-native-google-mobile-ads 的常见问题

@javascriptcommon/react-native-google-mobile-ads 是什么?

react-native-google-mobile-ads的分支迁移到Android上的GMA Next-Gen SDK (iOS保留了经典的谷歌Mobile Ads SDK)。支持横幅广告、插页广告和应用开放;原生广告和奖励并未移植到Android上。

如何安装 @javascriptcommon/react-native-google-mobile-ads?

在项目目录运行 npm install @javascriptcommon/react-native-google-mobile-ads,或使用 pnpm add / yarn add / bun add。

@javascriptcommon/react-native-google-mobile-ads 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@javascriptcommon/react-native-google-mobile-ads 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@javascriptcommon/react-native-google-mobile-ads 可以商用吗?

@javascriptcommon/react-native-google-mobile-ads 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@javascriptcommon/react-native-google-mobile-ads 还在维护吗?

最新版本 16.3.10 发布于 2026/11/01(2 天前);至今共发布 8 个版本,其中过去 12 个月发布了 8 个;首次发布于 2026/06/24。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。