Android 用 Unity Ads SDK のインストール

Gradle の依存関係を使用して、Unity Ads SDK を統合できます。Unity では、Android 4.4 "KitKat" (API レベル 19) 以降をサポートしています。

ノート: SDK バージョン 4.5.0 以降では、Unity Ads に新しい依存関係があります。(すべてのメタデータ、Android マニフェスト、classes.jar、ProGuard ルールなどを含む) リンクされた aar ファイルを手動で追加すると、依存関係が適切に解決されていない場合にランタイムエラーが発生します。Gradle などのパッケージ管理システムを使用して依存関係を管理することをお勧めします。詳細については、Android SDK のインテグレーション手順 を参照してください。

プロジェクトへの Unity Ads SDK の追加

警告: Unity Ads SDK バージョン 4.7.0 以降では、Java 8+ のターゲティングが必要です。

  1. アプリレベルの build.gradle ファイルの repositories セクションに、以下のコードを追加します。
    repositories {
        mavenCentral()
    }
  2. dependencies セクションに以下のコードを追加します。
    dependencies {
        implementation 'com.unity3d.ads:unity-ads:4.7.0'
    }
  3. プロジェクトで Java 8+ をまだ使用していない場合は、build.gradlecompileOptions セクションで、Java バージョンを 8 に設定します。
    android { 
       compileOptions {
                sourceCompatibility = JavaVersion.VERSION_1_8
                targetCompatibility = JavaVersion.VERSION_1_8
        }
    }

広告 ID

ノート: アプリで Unity Ads SDK バージョン 4.1 以降を使用している場合は、SDK によってパーミッションが自動的に宣言され、広告 ID にアクセスできるため (使用可能な場合)、この手順をスキップできます。Unity Ads SDK バージョン 4.0.1 以前を使用しているアプリでは、宣言を手動で含める必要があります。

Android ユーザーが関心ベースの広告または広告のパーソナライゼーションをオプトアウトすると、広告 ID は使用できなくなります。パブリッシャーは、ID の代わりにゼロの文字列を受け取ります。

また、アプリがターゲットを Android 13 以降に更新した場合は、以下のように、マニフェストファイル内で Google Play サービスの標準パーミッションを宣言する必要があります。

<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

重要: Google は、2022 年 4 月 1 日からこの宣言を適用します。詳細については、広告 ID に関する Google Play Console ヘルプドキュメントを参照してください。

次のステップ: インテグレーションを継続するために、Android での SDK の初期化 に関するドキュメントを参照します。