@amos-sdk/react-native-admob

中文文档
2.2.1发布于 2026/11/03TypeScriptCommonJS近 30 天下载 1746

反应原生AdMob包装和钩子为AMOS所管理的广告.

中文使用文档

AMOS 反应原生广告

AdMob付费活动收入被本地的AMOS包装机自动捕获. 使用 getRevenueHealth() 从本地模块或 useAmos() 上下文检查待处理、重试、确认和排队能力诊断.

对AMOS管理的AdMob广告加上AMOS核心决定,事件和度量衡进行回放.

当 AMOS 应当配置、 预装、 请求并显示 AdMob 位置时使用此软件包 .

import {
  AmosBannerAd,
  AmosProvider,
  BannerAdSize,
  useAmosRewardedAd,
} from '@amos-sdk/react-native-admob';

export function Root() {
  return (
    <AmosProvider
      config={{
        apiKey: 'AMOS_API_KEY',
        appId: 'app_example',
        userId: 'publisher-user-123',
        lifecycle: {
          automatic: true,
          sessionTimeoutSeconds: 1800,
          configRefreshIntervalSeconds: 300,
        },
        admob: {
          rewardedGroups: {
            default: { unitIds: ['ca-app-pub-xxx/111'], preloadOnInit: true },
            watermark_remove: {
              unitIds: ['ca-app-pub-xxx/222'],
              preloadOnInit: true,
              allowFallbackToDefault: true,
            },
          },
        },
      }}
    >
      <App />
    </AmosProvider>
  );
}

function RemoveWatermarkButton() {
  const rewarded = useAmosRewardedAd('watermark_remove');
  return <Button title="Watch ad" onPress={() => rewarded.show()} />;
}

function HomeBanner() {
  return <AmosBannerAd size={BannerAdSize.ANCHORED_ADAPTIVE_BANNER} />;
}

生命周期块是可选的;上面的值是默认值. Android生命周期处理是自动的,包括 stale policy 刷新和不活动会话翻转. 不要从反应原生状态结束 AMOS 会话 AppState 听着 打电话 refreshConfiguration() 从 useAmos() 仅用于即刻的质量保证或关键政策更新.

谷歌游戏购买

提供者的背景也暴露 recordGooglePlayPurchasePlay Billing 报告成功购买后

await useAmos().recordGooglePlayPurchase({
  clientEventId: `gplay:${purchase.productId}:${purchase.transactionId}`,
  packageName: 'com.example.app',
  productId: purchase.productId,
  productType: 'ONE_TIME',
  purchaseToken: purchase.purchaseToken,
});

结果证实了持久的本地队列;RTDN和开发者API验证决定了最终的购买生命周期.

导出 AdMob 助手 :

  • AmosBannerAd
  • AmosNativeAdCard
  • AmosAppOpenAdGate
  • useAmosInterstitialAd
  • useAmosRewardedAd
  • useAmosAppOpenAd
  • useAmosAdMobRequest
  • BannerAdSize

Android包装器解决了这个包里的 AdMob Maven文物 amosSdkVersion 字段 :

implementation("com.amostack:amos-sdk-admob:<amosSdkVersion>")

对于没有AMOS管理广告的决定和跟踪,安装 @amos-sdk/react-native。 。 。 .

原生软件包命名空间保留 com.amostack.amos... 用于Android兼容性.

版本与发布记录

@amos-sdk/react-native-admob 共发布 23 个版本,首次发布于 2026/10/03;过去 12 个月发布了 23 个版本。

版本发布日期距今
2.2.1latest2026/11/037 天前
2.2.02026/11/018 天前
2.1.02026/10/2813 天前
2.0.02026/10/2119 天前
1.0.192026/10/1724 天前
1.0.182026/10/1624 天前

关于 @amos-sdk/react-native-admob 的常见问题

@amos-sdk/react-native-admob 是什么?

反应原生AdMob包装和钩子为AMOS所管理的广告.

如何安装 @amos-sdk/react-native-admob?

在项目目录运行 npm install @amos-sdk/react-native-admob,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(*)、react-native(*)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@amos-sdk/react-native-admob 支持 TypeScript 吗?

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

@amos-sdk/react-native-admob 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@amos-sdk/react-native-admob 可以商用吗?

@amos-sdk/react-native-admob 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@amos-sdk/react-native-admob 的下载量有多少?

根据 npm 官方下载统计,@amos-sdk/react-native-admob 在 2026/10/06 – 2026/11/04 这 30 天内被下载 1,746 次,日均约 58 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@amos-sdk/react-native-admob 还在维护吗?

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