# 在 Android 中初始化 SDK

> 在 Android 应用程序中初始化 Unity Ads SDK。设置 Game ID（游戏 ID），配置监听器来处理初始化状态，并启用广告变现。

> **Important:**
>
> 必须在 SDK 初始化之前或期间配置用户同意。在某些地区，未经同意配置投放广告服务可能会违反隐私法规。

要初始化该 SDK，必须为适当平台引用项目的 Game ID（游戏 ID）。在 [Unity Ads Monetization（变现）后台](https://cloud.unity.com/monetization)的二级导航菜单中选择 **CURRENT PROJECT（当前项目）**> **Project Settings（项目设置）**，即可找到该 ID。

在游戏脚本中，需要实现一个 `IUnityAdsInitializationListener` 接口来处理初始化回调。用于初始化 SDK 的 initialize 方法需要将此监听器作为参数。应在项目运行时的生命周期早期（在需要加载广告之前）初始化 SDK。例如：

> **Note:**
>
> Unity Ads 需要访问当前正在运行的 Activity，所以下面的示例使用 `getApplicationContext()`。
> 由于这可能不适合所有实现，因此可能需要进行一些定制（具体取决于集成情况）。

## SDK 初始化示例##sdk-initialization-example

1. **Java**

   ```java
   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`](https://developer.android.com/reference/android/content/Context)。`unityGameID` 参数是位于 [Monetization（变现）后台](https://cloud.unity.com/monetization)中的项目的 Unity Game ID（Unity 游戏 ID），具体而言，此 ID 位于项目的 Settings（设置）页面中。`IUnityAdsInitializationListener` 是初始化调用结果的监听器。`true` 布尔值表示游戏处于测试模式，只会展示测试广告。

> **Note:**
>
> 必须在监听器接口中实现每个回调方法（即使目前它们是空函数）。在以下各部分中需要的地方，使用适当的逻辑填充这些方法。如需了解每个监听器回调方法的更多信息，请参阅有关 `IUnityAdsInitializationListener` API 的文档。

**后续步骤**：请参阅关于[在 Android 中实现插页式广告](/monetization/sdk-integration/android-sdk/interstitial-ads.md)的文档以继续您的集成。