unityads.*

类型 库
修订 2024.3703 版
关键字 广告、营销、Unity Ads
平台 Android、iOS

概述

Unity Ads 插件允许开发者通过 Unity Ads 视频插屏广告和奖励视频广告来实现用户变现。

重要提示

此为旧版 Unity Ads 插件，使用 Unity SDK v3，请参阅 Unity SDK v4

在每次应用的基础上，当 Unity 广告首次出现时，用户将看到一个横幅，可以选择退出基于行为的定向广告。此后，用户可以单击“信息”按钮再次接收退出选项。

虽然 UnityAds 会自动向用户展示退出定向广告的机会，而无需发行商进行任何操作，请查看新的 setHasUserConsent 方法以启用手动 GDPR 数据收集限制。

详情请参阅 Unity Ads GDPR 合规文档页面

注册

在您使用此插件之前，必须在 Unity Ads 上 注册。

语法

local unityads = require( "plugin.unityads" )

函数

unityads.init()

unityads.isLoaded()

unityads.show()

unityads.setHasUserConsent()

事件

adsRequest

项目设置

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

settings =
{
    iphone =
    {
        plist =
        {
            NSUserTrackingUsageDescription = "Your data will be used to provide you a better and personalized ad experience.",
            SKAdNetworkItems = {
                { SKAdNetworkIdentifier = "4dzt52r2t5.skadnetwork" },
                { SKAdNetworkIdentifier = "bvpn9ufa9b.skadnetwork" },
            },
        },
    },
    android =
    {
        minSdkVersion = "19",
    },
    plugins =
    {
        ["plugin.unityads"] =
        {
            publisherId = "com.coronalabs"
        },
    },
}
重要提示

如果您要为 Android 构建，则应从 build.settings 中 删除 ["plugin.google.play.services"] 插件的任何旧版包含项。

请注意

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

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

此外，所需的最低 Android API 级别为 19

支持