admob.*

类型
版本 版本 2024.3703
关键词 广告, advertising, AdMob
平台 Android, iOS

概述

AdMob 插件允许开发者通过 AdMob 静态插页式广告、视频插页式广告、激励视频广告和横幅广告来实现用户盈利。

重要

查看新的 hasUserConsent admob.load() 参数以启用 GDPR 数据收集限制。

新的 UMP/CMP api updateConsentFormloadConsentFormshowConsentFormgetConsentFormStatus 仅在 Solar2D Sim 2023.3686+ 上可用。

注册

在使用此插件之前,您必须在 AdMob 上注册。

语法

local admob = require( "plugin.admob" )

函数

admob.init()

admob.load()

admob.isLoaded()

admob.show()

admob.hide()

admob.height()

admob.setVideoAdVolume()

admob.updateConsentForm()

admob.loadConsentForm()

admob.showConsentForm()

admob.getConsentFormStatus()

事件

adsRequest

项目设置

要使用此插件,请在 build.settingsplugins 表中添加一个条目。添加后,构建服务器将在构建阶段集成该插件。

settings =
{
    android =
    {
        applicationChildElements =
        {
            [[
                <meta-data android:name="com.google.android.gms.ads.APPLICATION_ID"
                    android:value="[YOUR_ADMOB_APP_ID]"/>  -- replace with your app id. See: https://goo.gl/fQ2neu
            ]],
        },
    },
    iphone =
    {
        plist = {
            GADApplicationIdentifier = "[YOUR_ADMOB_APP_ID]",
            SKAdNetworkItems = {
                {
                    SKAdNetworkIdentifier = "cstr6suwn9.skadnetwork",
                },
            },
        },
    },
    plugins =
    {
        ["plugin.admob"] =
        {
            publisherId = "com.coronalabs"
        },
        -- See: http://docs.solar2d.cn/plugin/att
    },
}
重要

同时将 应用跟踪透明度 插件添加到您的项目中。

重要

如果您正在为 Android 构建,则应从 build.settings 中**删除**任何遗留的 ["plugin.google.play.services"] 插件。

注意

对于 Android,使用此插件时会自动添加以下权限/功能

  • "android.permission.INTERNET"
  • "android.permission.ACCESS_NETWORK_STATE"

Google AdMob 中介设置

AdMob 插件可用于投放来自其他网络的广告,从而提升您在 Android 上的盈利能力。

要使用此功能,您必须使用 AdMob 界面手动连接每个单独的网络。可在此处找到可用网络列表以及设置说明的链接。

大多数网络都会有“导入 SDK 和适配器”步骤。要实现它,请将 Gradle 依赖项添加到 Solar2D 项目内 AndroidResource 目录中的特殊文件 corona.gradle

例如,要使用 Facebook 和 AppLoving 网络,AndroidResources/corona.gradle 文件的内容应为

dependencies {
    implementation 'com.google.ads.mediation:facebook:6.2.0.0'
    implementation 'com.google.ads.mediation:applovin:9.14.5.0'
}

示例项目