admob.load()

类型 函数
返回值 无
修订版本 版本 2024.3703
关键词 广告, advertising, AdMob, 加载
另请参阅 admob.show()
admob.isLoaded()
admob.*

概述

预加载 AdMob 插页式广告、横幅广告、激励式插页式广告或激励式视频广告，以便在将来调用 admob.show() 时立即显示。

重要

在调用此函数之前，您必须调用 admob.init() 并等待 "init" 事件 阶段。

启用测试模式时，激励式视频广告将**不会**加载。在这种情况下，当您尝试加载激励式视频时，您将收到一个 "failed" 阶段。有关如何启用/禁用测试模式的说明，请参阅 admob.init()。

语法

admob.load( adType, params )
adType （必填）

字符串。以下广告类型值之一

  • "interstitial"  （包括静态插页式广告和视频插页式广告）
  • "banner"
  • "rewardedVideo"
  • "rewardedInterstitial"
  • "appOpen"
params （必填）

表。包含指定广告类型的其他参数的表 — 有关详细信息，请参阅下一节。

参数参考

params 表包含指定广告类型的参数。

adUnitId （必填）

字符串。从 AdMob 控制面板 收集的指定广告类型的广告单元 ID。

childSafe （可选）

布尔值。将其设置为 true 以确保仅加载COPPA 兼容的广告。默认为 false。

designedForFamilies （可选）

布尔值。仅在 Android 上可用（在 iOS 上被忽略）。与 childSafe 选项一起使用时，您可以请求符合 Google 的 “Designed for Families” 计划的广告。实际上，当看到 designedForFamilies 和 childSafe 都设置为 true 时，AdMob 将返回符合计划的广告以响应广告请求。但是请注意，同时使用这些选项可能会限制所投放广告的填充率，尤其是在非美国地区。

keywords （可选）

数组。要提供给 AdMob 请求用作关键字的字符串数组。指定关键字可能会提高您的点击率。

hasUserConsent （可选）

布尔值。如果设置为 false，Admob 将启用 GDPR 数据收集限制，设置为 true 则相反。

maxAdContentRating （可选）

字符串。广告内容的最高评级。应为 "G"、"PG"、"T" 或 "MA" 之一。有关详细信息，请参阅官方 文档。

示例

local admob = require( "plugin.admob" )

-- AdMob listener function
local function adListener( event )

    if ( event.phase == "init" ) then  -- Successful initialization
        -- Load an AdMob interstitial ad
        admob.load( "interstitial", { adUnitId="YOUR_ADMOB_AD_UNIT_ID" } )
    end
end

-- Initialize the AdMob plugin
admob.init( adListener, { appId="YOUR_ADMOB_APP_ID" } )