unityads.v4.*

类型 库
版本 发布 2024.3703
关键词 广告，Unity 广告
平台 安卓, iOS

概述

通过 Unity Ads 插件，开发者可以展示 Unity Ads 附加视频和奖励视频广告来实现用户变现。

重要

此文档适用于新的 Unity Ads SDK(v4)，点击查看 Unity Ads 遗留插件

与旧插件相比的显著变化包括现在需要通过 unityads.load() 加载展示位 ID，并且移除了 placementStatus event.phase。

对于每个应用，当 Unity 广告第一次出现时，用户会看到一个窗口，选择是否退出基于行为定向的广告。之后，用户可以点击信息按钮再次退出。尽管 UnityAds 会自动为用户提供退出定向广告的机会，无需发布商进行实施，但请查看新的 setHasUserConsent 方法来启用手动 GDPR 数据收集限制。

请参阅 Unity Ads 隐私同意文档了解更多信息。

注册

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

语法

local unityads = require( "plugin.unityads.v4" )

函数

unityads.init()

unityads.isLoaded()

unityads.load()

unityads.show()

unityads.setHasUserConsent()

unityads.setPersonalizedAds()

unityads.setPrivacyMode()

事件

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.v4"] =
        {
            publisherId = "com.solar2d"
        },
    },
}
重要

如果要为 Android 构建，则应从 build.settings 中移除 ["plugin.google.play.services"] 插件的所有旧包含项。

注意

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

  • "android.permission.INTERNET"
  • "android.permission.ACCESS_NETWORK_STATE"
  • "com.google.android.gms.permission.AD_ID"

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

支持