开始使用

1. 安装插件

   npm

   npm i @capgo/capacitor-admob

   pnpm

   pnpm add @capgo/capacitor-admob

   yarn

   yarn add @capgo/capacitor-admob

   bun

   bun add @capgo/capacitor-admob

2. 同步原生项目

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

初始化 SDK

import { AdMob, MaxAdContentRating } from '@capgo/capacitor-admob';

// 在应用程序引导中启动 Mobile Ads SDK 一次
await AdMob.start();

// 可选:配置全局请求设置
await AdMob.configure({
  appMuted: false,
  appVolume: 1,
});

await AdMob.configRequest({
  maxAdContentRating: MaxAdContentRating.T,
  tagForChildDirectedTreatment: false,
  tagForUnderAgeOfConsent: false,
});

显示横幅广告

import { BannerAd } from '@capgo/capacitor-admob';

const banner = new BannerAd({
  adUnitId: 'ca-app-pub-xxxxxxxxxxxxxxxx/banner',
  position: 'bottom',
});

await banner.show();

插页式或奖励广告

import { InterstitialAd, RewardedAd } from '@capgo/capacitor-admob';

const interstitial = new InterstitialAd({
  adUnitId: 'ca-app-pub-xxxxxxxxxxxxxxxx/interstitial',
});
await interstitial.load();
await interstitial.show();

const rewarded = new RewardedAd({
  adUnitId: 'ca-app-pub-xxxxxxxxxxxxxxxx/rewarded',
});
await rewarded.load();
await rewarded.show();

监听广告事件

import { AdMob } from '@capgo/capacitor-admob';

const handle = await AdMob.addListener('adImpression', (event) => {
  console.log('广告展示', event);
});

// 稍后清理时
await handle.remove();

平台注意事项

• iOS:在 Info.plist 中的 GADApplicationIdentifier 键下添加您的 AdMob 应用 ID,并包含您依赖的任何 SKAdNetwork ID。
• Android:通过在 <application> 标签内添加 com.google.android.gms.ads.APPLICATION_ID 在 AndroidManifest.xml 中声明您的 AdMob 应用 ID。
• 同意和隐私:在 iOS 14+ 上使用 requestTrackingAuthorization(),并使用 configRequest() 儿童导向标志以符合区域隐私规则。