文档

​
​

Development

User Acquisition

Monetization

工业

Unity Ads 变现

Unity Ads Android SDK

Unity Ads iOS SDK

Unity Ads SDK

Unity Ads 变现

Unity Ads Monetization
​
​
Android 开发者指南
  • Android SDK 概述
  • 集成要求
  • 安装适用于 Android 的 Unity Ads SDK
  • 在 Android 中初始化 SDK
  • 在 Android 中实现插页式广告
  • 在 Android 中实现奖励广告
  • 在 Android 中实现横幅广告
Android SDK API 参考
  • Unity Ads for Android API 参考(Java)
  1. 实现游戏增长
  2. Unity Ads
  3. 适用于 Android 开发者的 Unity Ads SDK 集成指南

在 Android 中初始化 SDK

在 Android 应用程序中初始化 Unity Ads SDK。设置 Game ID(游戏 ID),配置监听器来处理初始化状态,并启用广告变现。
阅读时间2 分钟
最后更新于 2 天前

要初始化该 SDK,必须为适当平台引用项目的 Game ID(游戏 ID)。在 Unity Monetization(变现)后台的二级导航菜单中选择 current project(当前项目)> Project Settings(项目设置),即可找到该 ID。
在游戏脚本中,需要实现一个
IUnityAdsInitializationListener
接口来处理初始化回调。用于初始化 SDK 的 initialize 方法需要将此监听器作为参数。应在项目运行时的生命周期早期(在需要加载广告之前)初始化 SDK。例如:
注意
Unity Ads 需要访问当前正在运行的 Activity,所以下面的示例使用
getApplicationContext()
。 由于这可能不适合所有实现,因此可能需要进行一些定制(具体取决于集成情况)。

SDK 初始化示例

import android.os.Bundle;import androidx.appcompat.app.AppCompatActivity;import com.unity3d.ads.example.R;import com.unity3d.ads.IUnityAdsInitializationListener;import com.unity3d.ads.UnityAds;public class InitializeAdsScript extends AppCompatActivity implements IUnityAdsInitializationListener { private String unityGameID = "1234567"; private Boolean testMode = true; @Override protected void onCreate (Bundle savedInstanceState) { super.onCreate (savedInstanceState); setContentView (R.layout.activity_main); // Initialize the SDK: UnityAds.initialize(getApplicationContext(), unityGameID, testMode, this); } @Override public void onInitializationComplete() { } @Override public void onInitializationFailed(UnityAds.UnityAdsInitializationError error, String message) { }}
对于
initialize
函数,
context
参数是当前的 Android
Context
。
unityGameID
参数是位于 Monetization(变现)后台中的项目的 Unity Game ID(Unity 游戏 ID),具体而言,此 ID 位于项目的 Settings(设置)页面中。
IUnityAdsInitializationListener
是初始化调用结果的监听器。
true
布尔值表示游戏处于测试模式,只会展示测试广告。
注意
必须在监听器接口中实现每个回调方法(即使目前它们是空函数)。在以下各部分中需要的地方,使用适当的逻辑填充这些方法。如需了解每个监听器回调方法的更多信息,请参阅有关
IUnityAdsInitializationListener
API 的文档。
后续步骤:请参阅关于在 Android 中实现插页式广告的文档以继续您的集成。

Copyright © 2026 Unity Technologies
法律信息隐私政策CookiesDocumentation Terms of Use请勿出售或分享我的个人信息您的隐私选择(Cookie 设置)

“Unity”、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属公司在美国和其他地方的商标或注册商标(此处查看更多信息)。其他名称或品牌是其各自所有者的商标。

为方便起见,一些页面是机器翻译的,可能包含不准确的内容。如有信息不一致的情况,以英文版本为准。

  • 在本页上
    • SDK 初始化示例


报告此页面的问题