
广告
@capacitor-community/admob
本地 AdMob 的电容社区插件 .
维护者
| 维护者 | GitHub 图像 | 社会 | 网站 |
|---|---|---|---|
| 坂原正彦 | 德语 | @rdlabo (中文(简体) ) | (原始内容存档于2018-10-21). rdlabo.dev |
| 萨尼恩·萨拉斯·迪亚斯 | 萨尼恩·萨拉斯·迪亚斯 | 萨宁萨拉斯 | —— 说 |
维持状况:积极维持
贡献者
制造的 贡献者-img。 。 。 .
演示
截图
| 横幅 | 暂停 | 奖励 | App 打开 | |
|---|---|---|---|---|
| iOS系统 | ![]() | ![]() | ![]() | ![]() |
| 机器人 | ![]() | ![]() | ![]() | ![]() |
概览
本地 AdMob 的电容社区插件 。 这个插件将Google Mobile Ads SDK包为iOS和Android,这样你就可以在Capacitor apps上显示横幅,间距,奖励,奖励间距,并应用开口的广告. 它还涵盖Google用户消息平台(UMP)的同意和iOS上的App Track透明帮助.
安装
这个插件已经将 Google Mobile Ads SDK 载入 。 安装软件包, 然后添加您的 AdMob 应用程序 在AndroidManifest/Info.plist中识别身份. Google 开始的指南 机器人 财务报告和审定财务报表 iOS系统 解释 app ID 和 SKadNetwork 标识符( Apple 的广告转换 ID); 不添加第二个 Mobile Ad 依赖性 .
此插件目标 @capacitor-community/admob 页:1 和8.5或更后(在v8之内) 它支持iOS 15或后期和Android API 24或后期.
npm install @capacitor-community/admob
npx cap sync
如果您仍然使用 Capacitor 7, 安装 @capacitor-community/admob@7。 。 。 .
谷歌移动广告 SDK 版本
这个主要版本的针头 Google Mobile Ads SDK 25.4.x 信息技术 机器人和 13.11.0 国家 在 iOS (Swift 软件包管理器和CocoaPods) 上。 离开这些版本 除非你有特别的需要。 谷歌的音乐 Android 的下个 Gen SDK 等待到下一个插件主机。 见 移徙 因为针后的政策.
Android 配置
单位 android/app/src/main/AndroidManifest.xml,在 <application>数字 :
<meta-data
android:name="com.google.android.gms.ads.APPLICATION_ID"
android:value="@string/admob_app_id" />
单位 android/app/src/main/res/values/strings.xml数字 :
<string name="admob_app_id">[APP_ID]</string>
替换 [APP_ID] 与您的广告移动 应用程序 身份证 不是广告单位的身份证.
变量
你可以离开这些未设置。 在你的应用程序中覆盖它们 variables.gradle 只有在您需要特定的文物版本时:
| 变量 | 艺术 | 默认 |
|---|---|---|
playServicesAdsVersion | com.google.android.gms:play-services-ads | 25.4.+ |
userMessagingPlatformVersion | com.google.android.ump:user-messaging-platform | 4.0.0 |
androidxCoreKTXVersion | androidx.core:core-ktx | 1.15.0 |
iOS 配置
在最外侧处添加以下内容 <dict> 内 ios/App/App/Info.plist数字 :
<key>GADIsAdManagerApp</key>
<true/>
<key>GADApplicationIdentifier</key>
<string>[APP_ID]</string>
<key>SKAdNetworkItems</key>
<array>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>cstr6suwn9.skadnetwork</string>
</dict>
</array>
<key>NSUserTrackingUsageDescription</key>
<string>This identifier will be used to deliver personalized ads to you.</string>
替换 [APP_ID] 使用您的 AdMob 应用程序标识,并描述您在 NSUserTrackingUsageDescription。 。 。 .
这个 SKAdNetworkItems 片段包括谷歌自己的标识符. 从 Google 添加其他ID iOS 设置指南。 。 。 .
解决问题
如果可可花不能解决 Google-Mobile-Ads-SDK数字 :
[error] Error running update: Analyzing dependencies
[!] CocoaPods could not find compatible versions for pod "Google-Mobile-Ads-SDK":
运行 pod repo update 内 ios/,则 npx cap sync ios 再来一次.
首个测试横幅
在安装和平台设置后,请求同意,在可能请求发布广告时初始化SDK,并显示Google演示横幅. 使用平台横幅 ID 测试——不要为首次检查创建自己的广告单位.
打电话 startAdMob 从用户动作或UI准备就绪后(例如按钮或后导航钩),而不仅仅是在模块评价时间.
import { Capacitor } from '@capacitor/core';
import { AdMob, AdmobConsentStatus, BannerAdOptions, BannerAdSize, BannerAdPosition } from '@capacitor-community/admob';
const bannerAdId =
Capacitor.getPlatform() === 'ios'
? 'ca-app-pub-3940256099942544/2934735716'
: 'ca-app-pub-3940256099942544/6300978111';
async function startAdMob() {
let consentInfo = await AdMob.requestConsentInfo();
if (consentInfo.isConsentFormAvailable && consentInfo.status === AdmobConsentStatus.REQUIRED) {
consentInfo = await AdMob.showConsentForm();
}
if (!consentInfo.canRequestAds) {
// Consent not ready — no banner is shown.
return;
}
await AdMob.initialize();
const options: BannerAdOptions = {
adId: bannerAdId,
adSize: BannerAdSize.ADAPTIVE_BANNER,
position: BannerAdPosition.BOTTOM_CENTER,
margin: 0,
};
await AdMob.showBanner(options);
}
预期结果:何时 canRequestAds 真实的, 在本地屏幕下方出现 Google 测试横幅 。 何时 canRequestAds 是不正确的,函数返回,没有显示横幅。 横幅坐落在WebView之上,可以覆盖 HTML - 见 广告 设置您的布局 。 细节 : 配置, (中文(简体) ), 同意,以及 测试。 。 。 .
通过广告目标选择
| 目标 | 临时格式 | 指南 |
|---|---|---|
| 在应用内容旁保持广告可见度 | 横幅 | 广告 |
| 在自然休息时显示全屏广告而不给予奖励 | 暂停 | 暂停 |
| 提供一份专门的奖励经验 | 奖励 | 奖励广告 |
| 在自然过渡时提供奖励 | 奖励的间歇 | 奖励广告 |
| 将一个开放的应用体验货币化 | App 打开 | App 打开广告 |
文档
开始 安装 以上,则 配置 财务报告和审定财务报表 同意。运行第一个测试横幅,然后使用 测试 用于演示单元和设备。 从上表中选择一个广告格式。 同样的指南也载于 文档网站 (英语和日语). 如果您在 npm 打开了这个 README, 请使用该站点来向导 docs/ 文件也包含在软件包中。 方法签名见以下API部分.
- 配置 —— 说
AdMob.initialize和SDK选项. - 同意 ——隐私同意和iOS跟踪授权.
- 测试 演示广告单位、测试装置和同意测试.
- 广告 ——旗帜选项,生命周期,事件.
- 土著广告 ——饲料放置,造型,生命周期等活动.
- 全屏广告:
- App 打开广告 ——负载并呈现在前地过渡上.
- 特别活动 共享生命周期事件、错误和收入数据.
- 移徙指南 ——在v8.2.0和早期版本中升级步骤和行为变化.
指数
initialize(...)trackingAuthorizationStatus()requestTrackingAuthorization()setApplicationMuted(...)setApplicationVolume(...)loadAppOpen(...)showAppOpen(...)isAppOpenLoaded(...)addListener(AppOpenAdPluginEvents.Loaded, ...)addListener(AppOpenAdPluginEvents.FailedToLoad, ...)addListener(AppOpenAdPluginEvents.Opened, ...)addListener(AppOpenAdPluginEvents.Closed, ...)addListener(AppOpenAdPluginEvents.FailedToShow, ...)addListener(AppOpenAdPluginEvents.AdImpression, ...)showBanner(...)hideBanner()resumeBanner()removeBanner()prepareBanner(...)getAdaptiveBannerSize(...)getBannerSize()addListener(BannerAdPluginEvents.SizeChanged, ...)addListener(BannerAdPluginEvents.Loaded, ...)addListener(BannerAdPluginEvents.FailedToLoad, ...)addListener(BannerAdPluginEvents.Opened, ...)addListener(BannerAdPluginEvents.Closed, ...)addListener(BannerAdPluginEvents.AdImpression, ...)addListener(BannerAdPluginEvents.AdPaid, ...)requestConsentInfo(...)showPrivacyOptionsForm()showConsentForm()resetConsentInfo()prepareInterstitial(...)showInterstitial(...)addListener(InterstitialAdPluginEvents.FailedToLoad, ...)addListener(InterstitialAdPluginEvents.Loaded, ...)addListener(InterstitialAdPluginEvents.Dismissed, ...)addListener(InterstitialAdPluginEvents.FailedToShow, ...)addListener(InterstitialAdPluginEvents.Showed, ...)addListener(InterstitialAdPluginEvents.AdImpression, ...)prepareRewardVideoAd(...)showRewardVideoAd(...)addListener(RewardAdPluginEvents.adClicked, ...)addListener(RewardAdPluginEvents.FailedToLoad, ...)addListener(RewardAdPluginEvents.Loaded, ...)addListener(RewardAdPluginEvents.Rewarded, ...)addListener(RewardAdPluginEvents.Dismissed, ...)addListener(RewardAdPluginEvents.FailedToShow, ...)addListener(RewardAdPluginEvents.Showed, ...)addListener(RewardAdPluginEvents.AdImpression, ...)prepareRewardInterstitialAd(...)showRewardInterstitialAd(...)addListener(RewardInterstitialAdPluginEvents.FailedToLoad, ...)addListener(RewardInterstitialAdPluginEvents.Loaded, ...)addListener(RewardInterstitialAdPluginEvents.Rewarded, ...)addListener(RewardInterstitialAdPluginEvents.Dismissed, ...)addListener(RewardInterstitialAdPluginEvents.FailedToShow, ...)addListener(RewardInterstitialAdPluginEvents.Showed, ...)addListener(RewardInterstitialAdPluginEvents.AdImpression, ...)- 接口
- 类型异名
- 数字
API 密码
初始化(...)
initialize(options?: AdMobInitializationOptions | undefined) => Promise<void>
初始化了Google移动ads SDK.
| 参数 | 类型 | 说明 |
|---|---|---|
options | AdMobInitializationOptions | 可选 SDK 初始化设置 . |
自: 1.1.2 国家
认证状态 ()
trackingAuthorizationStatus() => Promise<TrackingAuthorizationStatusInterface>
返回当前 iOS 14 的 App Track 透明化授权状态 .
回返 authorized 在早期的iOS版本,Android,和Web.
回返情况: Promise<TrackingAuthorizationStatusInterface>
自: 3.1.0 (中文(简体) )
跟踪认证( )
requestTrackingAuthorization() => Promise<void>
请求在iOS 14上及以后的App跟踪透明授权. 决心不采取行动 之前的iOS版本,Android,和网络.
自: 5.2.0 (中文(简体) )
设置 应用
setApplicationMuted(options: ApplicationMutedOptions) => Promise<void>
向Google Mobile Ads SDK报告应用程序音频是否变音.
| 参数 | 类型 |
|---|---|
options | ApplicationMutedOptions |
自: 4.1.1 国家
应用程序卷(...)
setApplicationVolume(options: ApplicationVolumeOptions) => Promise<void>
向Google Mobile Ads SDK报告应用音频量.
| 参数 | 类型 |
|---|---|
options | ApplicationVolumeOptions |
自: 4.1.1 国家
加载App Open (...)
loadAppOpen(options: AppOpenAdOptions) => Promise<AdLoadInfo>
装入 App Open 广告并返回已装入的广告单位ID .
| 参数 | 类型 |
|---|---|
options | AppOpenAdOptions |
回返情况: Promise<AdLoadInfo>
显示 App 打开(...)
showAppOpen(options?: AdShowOptions | undefined) => Promise<void>
显示装入的 App Open 广告 .
| 参数 | 类型 | 说明 |
|---|---|---|
options | AdShowOptions | 可选的 Pass { adId } 显示一个特定的已准备好的广告, 而不是最近的广告 . |
是 App OpenLoaded (...) 移动
isAppOpenLoaded(options?: AdShowOptions | undefined) => Promise<{ value: boolean; }>
检查是否装入 App Open 广告 .
| 参数 | 类型 | 说明 |
|---|---|---|
options | AdShowOptions | 可选的 通过一个广告来检查一个特定的准备的广告,而不是最近的广告. |
回返情况: Promise<{ value: boolean; }>
添加倾听器( App OpenAdPluginEvents ) 。 已装入,... )
addListener(eventName: AppOpenAdPluginEvents.Loaded, listenerFunc: (info: AdLoadInfo) => void) => Promise<PluginListenerHandle>
收听 App Open 广告加载事件.
| 参数 | 类型 |
|---|---|
eventName | AppOpenAdPluginEvents.Loaded |
listenerFunc | (info: AdLoadInfo) => void |
回返情况: Promise<PluginListenerHandle>
添加倾听器( App OpenAdPluginEvents. 失败的ToLoad,...)
addListener(eventName: AppOpenAdPluginEvents.FailedToLoad, listenerFunc: (error: AdMobError) => void) => Promise<PluginListenerHandle>
听取 App Open 广告装入失败 .
| 参数 | 类型 |
|---|---|
eventName | AppOpenAdPluginEvents.FailedToLoad |
listenerFunc | (error: AdMobError) => void |
回返情况: Promise<PluginListenerHandle>
添加倾听器( App OpenAdPluginEvents ) 。 已打开,... )
addListener(eventName: AppOpenAdPluginEvents.Opened, listenerFunc: () => void) => Promise<PluginListenerHandle>
听App Open广告打开事件.
| 参数 | 类型 |
|---|---|
eventName | AppOpenAdPluginEvents.Opened |
listenerFunc | () => void |
回返情况: Promise<PluginListenerHandle>
添加倾听器( App OpenAdPluginEvents ) 。 关闭,... )
addListener(eventName: AppOpenAdPluginEvents.Closed, listenerFunc: () => void) => Promise<PluginListenerHandle>
听App公开广告 关闭事件.
| 参数 | 类型 |
|---|---|
eventName | AppOpenAdPluginEvents.Closed |
listenerFunc | () => void |
回返情况: Promise<PluginListenerHandle>
添加收听器( App OpenAdPluginEvents. 失败的ToShow,...)
addListener(eventName: AppOpenAdPluginEvents.FailedToShow, listenerFunc: (error: AdMobError) => void) => Promise<PluginListenerHandle>
收听App Open广告显示失败.
| 参数 | 类型 |
|---|---|
eventName | AppOpenAdPluginEvents.FailedToShow |
listenerFunc | (error: AdMobError) => void |
回返情况: Promise<PluginListenerHandle>
添加倾听器( App OpenAdPluginEvents ) 。 叹为观止. )
addListener(eventName: AppOpenAdPluginEvents.AdImpression, listenerFunc: (data: AdMobRevenueData) => void) => Promise<PluginListenerHandle>
听App Open印象级广告收入事件.
| 参数 | 类型 |
|---|---|
eventName | AppOpenAdPluginEvents.AdImpression |
listenerFunc | (data: AdMobRevenueData) => void |
回返情况: Promise<PluginListenerHandle>
显示 Banner (...)
showBanner(options: BannerAdOptions) => Promise<void>
显示横幅广告.
| 参数 | 类型 | 说明 |
|---|---|---|
options | BannerAdOptions | 备选 |
自: 1.1.2 国家
隐藏 Banner ()
hideBanner() => Promise<void>
隐藏当前旗帜而不破坏它.
自: 1.1.2 国家
复选 Banner ()
resumeBanner() => Promise<void>
显示先前隐藏的横幅 .
自: 1.1.2 国家
删除 Banner ()
removeBanner() => Promise<void>
销毁当前横幅并删除屏幕上的横幅.
自: 1.1.2 国家
准备 Banner (...)
prepareBanner(options: BannerAdOptions) => Promise<void>
在不改变当前显示的情况下预装下一条横幅. 装入时决定 。 呼叫显示 Banner () 有匹配选项来显示它 . 准备再次替换先前的准备; 删除 Banner () 取消它 .
| 参数 | 类型 |
|---|---|
options | BannerAdOptions |
获得Adaptive BannerSize(...)
getAdaptiveBannerSize(options?: { width?: number | undefined; } | undefined) => Promise<AdMobBannerSize>
在不创建或装入广告的情况下计算嵌入式适应性横幅大小. 使用当前安全区域可使用的宽度,除非提供宽度. 尺寸在Android上为dp,在iOS上为分. 旋转后重新计算 或可用宽度变化。 明确的宽度不会改变显示 Banner () 的大小 .
| 参数 | 类型 |
|---|---|
options | { width?: number; } |
回返情况: Promise<AdMobBannerSize>
获取 BannerSize ()
getBannerSize() => Promise<AdMobBannerSize>
返回 Dp (Android) 或点 (iOS) 中当前显示的横幅大小 . 在装入或隐藏、删除或失败之前返回零维. 不创建、加载或显示广告.
回返情况: Promise<AdMobBannerSize>
添加倾听器( BannerAdPluginEvents) 。 大小变化,. )
addListener(eventName: BannerAdPluginEvents.SizeChanged, listenerFunc: (info: AdMobBannerSize) => void) => Promise<PluginListenerHandle>
监听显示的横幅尺寸的更改 .
| 参数 | 类型 | 说明 |
|---|---|---|
eventName | BannerAdPluginEvents.SizeChanged | 横幅 |
listenerFunc | (info: AdMobBannerSize) => void |
回返情况: Promise<PluginListenerHandle>
自: 3.0.0 (单位:千美元)
添加倾听器( BannerAdPluginEvents) 。 已装入,... )
addListener(eventName: BannerAdPluginEvents.Loaded, listenerFunc: () => void) => Promise<PluginListenerHandle>
听旗下广告加载事件.
| 参数 | 类型 | 说明 |
|---|---|---|
eventName | BannerAdPluginEvents.Loaded | 旗下标记 |
listenerFunc | () => void |
回返情况: Promise<PluginListenerHandle>
自: 3.0.0 (单位:千美元)
添加收听器( BannerAdPluginEvents. fault ToLoad,...)
addListener(eventName: BannerAdPluginEvents.FailedToLoad, listenerFunc: (info: AdMobError) => void) => Promise<PluginListenerHandle>
听旗下广告装入失败.
| 参数 | 类型 | 说明 |
|---|---|---|
eventName | BannerAdPluginEvents.FailedToLoad | 横幅已失败 |
listenerFunc | (info: AdMobError) => void |
回返情况: Promise<PluginListenerHandle>
自: 3.0.0 (单位:千美元)
添加倾听器( BannerAdPluginEvents) 。 已打开,... )
addListener(eventName: BannerAdPluginEvents.Opened, listenerFunc: () => void) => Promise<PluginListenerHandle>
听旗子覆盖打开的事件.
| 参数 | 类型 | 说明 |
|---|---|---|
eventName | BannerAdPluginEvents.Opened | 已打开 |
listenerFunc | () => void |
回返情况: Promise<PluginListenerHandle>
自: 3.0.0 (单位:千美元)
添加倾听器( BannerAdPluginEvents) 。 关闭,... )
addListener(eventName: BannerAdPluginEvents.Closed, listenerFunc: () => void) => Promise<PluginListenerHandle>
听旗子 覆盖关闭的事件.
| 参数 | 类型 | 说明 |
|---|---|---|
eventName | BannerAdPluginEvents.Closed | 已关闭 |
listenerFunc | () => void |
回返情况: Promise<PluginListenerHandle>
自: 3.0.0 (单位:千美元)
添加倾听器( BannerAdPluginEvents. Adimpression,...)
addListener(eventName: BannerAdPluginEvents.AdImpression, listenerFunc: () => void) => Promise<PluginListenerHandle>
听旗下印象事件.
| 参数 | 类型 | 说明 |
|---|---|---|
eventName | BannerAdPluginEvents.AdImpression | 图像 |
listenerFunc | () => void |
回返情况: Promise<PluginListenerHandle>
自: 3.0.0 (单位:千美元)
添加倾听器( BannerAdPluginEvents.AdPaid,...)
addListener(eventName: BannerAdPluginEvents.AdPaid, listenerFunc: (data: AdMobRevenueData) => void) => Promise<PluginListenerHandle>
听旗下印象级广告收入事件.
| 参数 | 类型 |
|---|---|
eventName | BannerAdPluginEvents.AdPaid |
listenerFunc | (data: AdMobRevenueData) => void |
回返情况: Promise<PluginListenerHandle>
请求同意信息(...)
requestConsentInfo(options?: AdmobConsentRequestOptions | undefined) => Promise<AdmobConsentInfo>
请求用户同意信息
| 参数 | 类型 | 说明 |
|---|---|---|
options | AdmobConsentRequestOptions | 同意请求 |
回返情况: Promise<AdmobConsentInfo>
自: 5.0.0 (单位:千美元)
显示空闲选项格式( )
showPrivacyOptionsForm() => Promise<void>
显示一个 google 隐私选项表( 由您的 GDPR 信件配置) .
自: 7.0.3 信息技术
显示同意格式 ()
showConsentForm() => Promise<AdmobConsentInfo>
显示 google 用户同意表(从您的 GDPR 信件配置中提交) .
回返情况: Promise<AdmobConsentInfo>
自: 5.0.0 (单位:千美元)
重新设置 ConsentInfo ()
resetConsentInfo() => Promise<void>
恢复UMP SDK状态. 调用请求 ConsentInfo 函数再次允许用户修改其同意
自: 5.0.0 (单位:千美元)
准备 Interstital (...)
prepareInterstitial(options: AdOptions) => Promise<AdLoadInfo>
装入相间广告并返回已装入的广告单位ID.
SDK 载入失败用本地错误消息和一个字符串拒绝 code。 。 。 .
代码是特定平台的;失败的ToLoad事件暴露出与数字相同的代码.
| 参数 | 类型 | 说明 |
|---|---|---|
options | AdOptions | 备选 |
回返情况: Promise<AdLoadInfo>
自: 1.1.2 国家
显示中间(...)
showInterstitial(options?: AdShowOptions | undefined) => Promise<void>
显示已装入的间歇性广告 .
| 参数 | 类型 | 说明 |
|---|---|---|
options | AdShowOptions | 可选的 Pass { adId } 显示一个特定的已准备好的广告, 而不是最近的广告 . |
自: 1.1.2 国家
添加倾听器( Interstitual AdPluginEvents. fault ToLoad,...)
addListener(eventName: InterstitialAdPluginEvents.FailedToLoad, listenerFunc: (error: AdMobError) => void) => Promise<PluginListenerHandle>
监听间歇式加载失败 .
| 参数 | 类型 |
|---|---|
eventName | InterstitialAdPluginEvents.FailedToLoad |
listenerFunc | (error: AdMobError) => void |
回返情况: Promise<PluginListenerHandle>
添加倾听器( InterstitalAdPluginEvents) 。 已装入,... )
addListener(eventName: InterstitialAdPluginEvents.Loaded, listenerFunc: (info: AdLoadInfo) => void) => Promise<PluginListenerHandle>
静态加载事件.
| 参数 | 类型 |
|---|---|
eventName | InterstitialAdPluginEvents.Loaded |
listenerFunc | (info: AdLoadInfo) => void |
回返情况: Promise<PluginListenerHandle>
添加倾听器( InterstitalAdPluginEvents) 。 解职. )
addListener(eventName: InterstitialAdPluginEvents.Dismissed, listenerFunc: () => void) => Promise<PluginListenerHandle>
静静地接听 驳回事件.
| 参数 | 类型 |
|---|---|
eventName | InterstitialAdPluginEvents.Dismissed |
listenerFunc | () => void |
回返情况: Promise<PluginListenerHandle>
添加倾听器( InterstitalAdPluginEvents) 。 显示失败,...)
addListener(eventName: InterstitialAdPluginEvents.FailedToShow, listenerFunc: (error: AdMobError) => void) => Promise<PluginListenerHandle>
静听广告显示失败.
| 参数 | 类型 |
|---|---|
eventName | InterstitialAdPluginEvents.FailedToShow |
listenerFunc | (error: AdMobError) => void |
回返情况: Promise<PluginListenerHandle>
添加倾听器( InterstitalAdPluginEvents) 。 现出. )
addListener(eventName: InterstitialAdPluginEvents.Showed, listenerFunc: () => void) => Promise<PluginListenerHandle>
静态广告的监听显示事件.
| 参数 | 类型 |
|---|---|
eventName | InterstitialAdPluginEvents.Showed |
listenerFunc | () => void |
回返情况: Promise<PluginListenerHandle>
添加倾听器( InterstitalAdPluginEvents) 。 叹为观止. )
addListener(eventName: InterstitialAdPluginEvents.AdImpression, listenerFunc: (data: AdMobRevenueData) => void) => Promise<PluginListenerHandle>
倾听间印象级广告收入事件.
| 参数 | 类型 |
|---|---|
eventName | InterstitialAdPluginEvents.AdImpression |
listenerFunc | (data: AdMobRevenueData) => void |
回返情况: Promise<PluginListenerHandle>
准备 RewardVideoAd(...)
prepareRewardVideoAd(options: RewardAdOptions) => Promise<AdLoadInfo>
装入奖励广告并返回已装入的广告单位ID.
SDK 载入失败用本地错误消息和一个字符串拒绝 code。 。 。 .
代码是特定平台的;失败的ToLoad事件暴露出与数字相同的代码.
| 参数 | 类型 | 说明 |
|---|---|---|
options | RewardAdOptions | 奖励选项 |
回返情况: Promise<AdLoadInfo>
自: 1.1.2 国家
显示奖励视频(...)
showRewardVideoAd(options?: AdShowOptions | undefined) => Promise<AdMobRewardItem>
显示已加载的奖励广告,并在用户获得奖励时解决.
| 参数 | 类型 | 说明 |
|---|---|---|
options | AdShowOptions | 可选的 Pass { adId } 显示一个特定的已准备好的广告, 而不是最近的广告 . |
回返情况: Promise<AdMobRewardItem>
自: 1.1.2 国家
添加倾听器( RewardAdPluginEvents.ad) 点击,...)
addListener(eventName: RewardAdPluginEvents.adClicked, listenerFunc: () => void) => Promise<PluginListenerHandle>
收听被奖励广告SDK所收录的点击,包括获得奖励后. 点击并不意味着用户获得了奖励.
| 参数 | 类型 |
|---|---|
eventName | RewardAdPluginEvents.adClicked |
listenerFunc | () => void |
回返情况: Promise<PluginListenerHandle>
添加倾听器( RewardAdPluginEvents.faultToLoad,...)
addListener(eventName: RewardAdPluginEvents.FailedToLoad, listenerFunc: (error: AdMobError) => void) => Promise<PluginListenerHandle>
收听奖励广告装入失败.
| 参数 | 类型 |
|---|---|
eventName | RewardAdPluginEvents.FailedToLoad |
listenerFunc | (error: AdMobError) => void |
回返情况: Promise<PluginListenerHandle>
添加 listener( RewardAdPluginEvents) 键盘。 已装入,... )
addListener(eventName: RewardAdPluginEvents.Loaded, listenerFunc: (info: AdLoadInfo) => void) => Promise<PluginListenerHandle>
收听奖励广告加载事件.
| 参数 | 类型 |
|---|---|
eventName | RewardAdPluginEvents.Loaded |
listenerFunc | (info: AdLoadInfo) => void |
回返情况: Promise<PluginListenerHandle>
添加 listener( RewardAdPluginEvents) 键盘。 获赏. )
addListener(eventName: RewardAdPluginEvents.Rewarded, listenerFunc: (reward: AdMobRewardItem) => void) => Promise<PluginListenerHandle>
收听挣取的奖励活动.
| 参数 | 类型 |
|---|---|
eventName | RewardAdPluginEvents.Rewarded |
listenerFunc | (reward: AdMobRewardItem) => void |
回返情况: Promise<PluginListenerHandle>
添加 listener( RewardAdPluginEvents) 键盘。 解职. )
addListener(eventName: RewardAdPluginEvents.Dismissed, listenerFunc: () => void) => Promise<PluginListenerHandle>
收听奖赏广告 解雇事件.
| 参数 | 类型 |
|---|---|
eventName | RewardAdPluginEvents.Dismissed |
listenerFunc | () => void |
回返情况: Promise<PluginListenerHandle>
添加收听器( RewardAdPluginEvents. 失败的ToShow,...)
addListener(eventName: RewardAdPluginEvents.FailedToShow, listenerFunc: (error: AdMobError) => void) => Promise<PluginListenerHandle>
收听奖励广告显示失败.
| 参数 | 类型 |
|---|---|
eventName | RewardAdPluginEvents.FailedToShow |
listenerFunc | (error: AdMobError) => void |
回返情况: Promise<PluginListenerHandle>
添加 listener( RewardAdPluginEvents) 键盘。 现出. )
addListener(eventName: RewardAdPluginEvents.Showed, listenerFunc: () => void) => Promise<PluginListenerHandle>
收听奖励广告 显示事件.
| 参数 | 类型 |
|---|---|
eventName | RewardAdPluginEvents.Showed |
listenerFunc | () => void |
回返情况: Promise<PluginListenerHandle>
添加倾听器( RewardAdPluginEvents.Adimpression,...)
addListener(eventName: RewardAdPluginEvents.AdImpression, listenerFunc: (data: AdMobRevenueData) => void) => Promise<PluginListenerHandle>
收听奖赏级广告收入事件.
| 参数 | 类型 |
|---|---|
eventName | RewardAdPluginEvents.AdImpression |
listenerFunc | (data: AdMobRevenueData) => void |
回返情况: Promise<PluginListenerHandle>
准备 RewardInterstitalAd (...)
prepareRewardInterstitialAd(options: RewardInterstitialAdOptions) => Promise<AdLoadInfo>
装入奖励的间歇广告并返回已装入的广告单位ID.
SDK 载入失败用本地错误消息和一个字符串拒绝 code。 。 。 .
代码是特定平台的;失败的ToLoad事件暴露出与数字相同的代码.
| 参数 | 类型 | 说明 |
|---|---|---|
options | RewardInterstitialAdOptions | 奖励内部 备选 |
回返情况: Promise<AdLoadInfo>
自: 1.1.2 国家
显示 RewardInterstitionAd(...)
showRewardInterstitialAd(options?: AdShowOptions | undefined) => Promise<AdMobRewardInterstitialItem>
显示一个已加载的悬疑广告,并在用户获得悬疑奖时解决.
| 参数 | 类型 | 说明 |
|---|---|---|
options | AdShowOptions | 可选的 Pass { adId } 显示一个特定的已准备好的广告, 而不是最近的广告 . |
回返情况: Promise<AdMobRewardInterstitialItem>
自: 1.1.2 国家
添加倾听器( RewardInterstial AdPluginEvents.faultToLoad,...)
addListener(eventName: RewardInterstitialAdPluginEvents.FailedToLoad, listenerFunc: (error: AdMobError) => void) => Promise<PluginListenerHandle>
收听有奖的间歇性广告 装入失败.
| 参数 | 类型 |
|---|---|
eventName | RewardInterstitialAdPluginEvents.FailedToLoad |
listenerFunc | (error: AdMobError) => void |
回返情况: Promise<PluginListenerHandle>
添加Listener( RewardInterstial AdPluginEvents) 键盘。 已装入,... )
addListener(eventName: RewardInterstitialAdPluginEvents.Loaded, listenerFunc: (info: AdLoadInfo) => void) => Promise<PluginListenerHandle>
收听受奖的间歇式广告.
| 参数 | 类型 |
|---|---|
eventName | RewardInterstitialAdPluginEvents.Loaded |
listenerFunc | (info: AdLoadInfo) => void |
回返情况: Promise<PluginListenerHandle>
添加Listener( RewardInterstial AdPluginEvents) 键盘。 获赏. )
addListener(eventName: RewardInterstitialAdPluginEvents.Rewarded, listenerFunc: (reward: AdMobRewardInterstitialItem) => void) => Promise<PluginListenerHandle>
收听挣取的奖励活动.
| 参数 | 类型 |
|---|---|
eventName | RewardInterstitialAdPluginEvents.Rewarded |
listenerFunc | (reward: AdMobRewardInterstitialItem) => void |
回返情况: Promise<PluginListenerHandle>
添加Listener( RewardInterstial AdPluginEvents) 键盘。 解职. )
addListener(eventName: RewardInterstitialAdPluginEvents.Dismissed, listenerFunc: () => void) => Promise<PluginListenerHandle>
听到的奖励 暂停事件.
| 参数 | 类型 |
|---|---|
eventName | RewardInterstitialAdPluginEvents.Dismissed |
listenerFunc | () => void |
回返情况: Promise<PluginListenerHandle>
添加倾听器( RewardInterstial AdPluginEvents. 失败了ToShow,...)
addListener(eventName: RewardInterstitialAdPluginEvents.FailedToShow, listenerFunc: (error: AdMobError) => void) => Promise<PluginListenerHandle>
收听有奖的间歇性广告显示失败.
| 参数 | 类型 |
|---|---|
eventName | RewardInterstitialAdPluginEvents.FailedToShow |
listenerFunc | (error: AdMobError) => void |
回返情况: Promise<PluginListenerHandle>
添加Listener( RewardInterstial AdPluginEvents) 键盘。 现出. )
addListener(eventName: RewardInterstitialAdPluginEvents.Showed, listenerFunc: () => void) => Promise<PluginListenerHandle>
收听有奖的暂停广告 显示的事件.
| 参数 | 类型 |
|---|---|
eventName | RewardInterstitialAdPluginEvents.Showed |
listenerFunc | () => void |
回返情况: Promise<PluginListenerHandle>
添加收听器( RewardInterstitional AdPluginEvents.AdImpress,...)
addListener(eventName: RewardInterstitialAdPluginEvents.AdImpression, listenerFunc: (data: AdMobRevenueData) => void) => Promise<PluginListenerHandle>
收听悬赏性印象级广告收入事件.
| 参数 | 类型 |
|---|---|
eventName | RewardInterstitialAdPluginEvents.AdImpression |
listenerFunc | (data: AdMobRevenueData) => void |
回返情况: Promise<PluginListenerHandle>
接口
自动启动选项
| Prop | 类型 | 说明 | 默认 | 自兹 |
|---|---|---|---|---|
testingDevices | string[] | 当 QQlink 时作为测试设备注册的设备ID AdMob Initialization 选项。初始化{\fn华文楷体\fs16\1che0e0e0}是 true。注册设备的请求接收测试广告,不会产生无效流量. | 1.2.0 (中文(简体) ) | |
initializeForTesting | boolean | 是否注册QQlink AdMob Initialization 选项.测试 设备作为测试设备. | false | 1.2.0 (中文(简体) ) |
tagForChildDirectedTreatment | boolean | 为了《儿童在线隐私保护法》的目的,有一个名为“儿童指导治疗”的设置. | 3.1.0 (中文(简体) ) | |
tagForUnderAgeOfConsent | boolean | 使用此功能时,将在未来所有广告请求中包含一个欧洲同意年龄下的用户标记参数(TFUA). | 3.1.0 (中文(简体) ) | |
maxAdContentRating | MaxAdContentRating | 广告内容的最高评级适用于所有广告请求. 评分较高的广告不包括在内. | 3.1.0 (中文(简体) ) |
跟踪认证状态
目前iOS App跟踪透明授权状态.
| Prop | 类型 | 说明 |
|---|---|---|
status | 'authorized' | 'denied' | 'notDetermined' | 'restricted' | App Track Intelligence报告的授权状态. |
应用程序选中选项
| Prop | 类型 | 说明 | 自兹 |
|---|---|---|---|
muted | boolean | 告知SDK应用音量已变音. 注:当应用卷被报告为哑音或被设定为0. 这可能会限制更广泛的视频广告集的子集服务. | 4.1.1 国家 |
应用程序Volume 选项
| Prop | 类型 | 说明 | 自兹 |
|---|---|---|---|
volume | 0 | 1 | 0.1 | 0.2 | 0.3 | 0.4 | 0.5 | 0.6 | 0.7 | 0.8 | 0.9 | 如果您的应用有自己的音量控制(如自定义音乐或音效音量),向Google Mobile Ads SDK披露应用音量,允许视频广告尊重应用音量设置. 使用支持值从 0.0( silent)到 1.0( 完整音量) . | 4.1.1 国家 |
AdLoadInfo 数据
广告装入成功后返回信息 .
| Prop | 类型 | 说明 |
|---|---|---|
adUnitId | string | 装入广告的广告单位标识. |
应用程序打开选项
装入 App Open 广告的选项 .
| Prop | 类型 | 说明 |
|---|---|---|
adId | string | 要加载的 App Open 广告单位 ID . |
显示选项
选择先前装入的广告以显示或检查的选项 .
**************************************************************************************************************************************************************************************************************************************************************** |--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ------ ------------- --- ---- - --







