始める

Google Mobile Ads SDK のアプリへの統合は、 広告を表示して収益を得ることができます。SDK を統合すると、次のことが可能になります。 広告フォーマット(ネイティブ動画、リワード動画など)を選択し、手順に沿って 実装します。

始める前に

アプリを準備するには、以下のセクションに示す手順を完了します。

アプリの前提条件

  • アプリのビルドファイルで次の値が使用されていることを確認します。

    • 最小 SDK バージョン 21 以上
    • SDK のバージョンをコンパイルする 33 以上

アプリを設定する

  1. Gradle の設定ファイルに、 Google の Maven リポジトリ Maven セントラル リポジトリ:

    Kotlin

    pluginManagement {
      repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
      }
    }
    
    dependencyResolutionManagement {
      repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
      repositories {
        google()
        mavenCentral()
      }
    }
    
    rootProject.name = "My Application"
    include(":app")

    Groovy

    pluginManagement {
      repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
      }
    }
    
    dependencyResolutionManagement {
      repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
      repositories {
        google()
        mavenCentral()
      }
    }
    
    rootProject.name = "My Application"
    include ':app'
  2. Google Mobile Ads SDK の依存関係をアプリレベルのビルドに追加する ファイル:

    Kotlin

    dependencies {
      implementation("com.google.android.gms:play-services-ads:23.3.0")
    }

    Groovy

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:23.3.0'
    }
  3. Ad Manager アプリ ID を Ad Manager ウェブ インターフェースを使用して、 AndroidManifest.xml ファイル。これを行うには、<meta-data> タグを追加します。 android:name="com.google.android.gms.ads.APPLICATION_ID"。詳しくは、 ウェブ インターフェースでアプリ ID を確認します。 Ad Manager 対象 android:value 様、ご自身の Ad Manager アプリ ID を挿入してください、 引用符で囲みます。

    <manifest>
      <application>
        <!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
      </application>
    </manifest>
    

    実際のアプリでは、サンプルアプリ ID を実際の Ad Manager アプリ ID。次の場合にサンプル ID を使用できます。 Hello World アプリで SDK を試すだけなので

    また、示された結果どおり <meta-data> タグを追加していないことに注意してください。 次のメッセージが表示されてクラッシュします。

    Missing application ID.
    

    (省略可)宣言 以前のバージョンを Android で動作させるための AD_ID 権限 13.

    アプリで Google Mobile Ads SDK バージョン 20.4.0 または SDK が自動的に宣言するので、このステップは com.google.android.gms.permission.AD_ID 権限があり、 (利用可能な場合)に広告 ID にアクセスできるようにする必要があります。

    Google Mobile Ads SDK バージョン 20.3.0 または Android 13 を対象としている場合は、 に対する com.google.android.gms.permission.AD_ID 権限 Google Mobile Ads SDK の AndroidManifest.xml ファイルを変更して、 広告 ID にアクセスする:

    <manifest>
     <application>
       <meta-data
           android:name="com.google.android.gms.ads.APPLICATION_ID"
           android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    
       <!-- For apps targeting Android 13 or higher & GMA SDK version 20.3.0 or lower -->
       <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
    
     </application>
    </manifest>

    詳しくは、 com.google.android.gms.permission.AD_ID 権限の申告、 詳しくは、こちらの Play コンソールに関する記事をご覧ください。

Google Mobile Ads SDK を初期化する

広告を読み込む前に、次を呼び出して Google Mobile Ads SDK を初期化します。 MobileAds.initialize()

このメソッドは SDK を初期化し、完了リスナーの呼び出しと完了後に完了リスナーを呼び出します。 Google Mobile Ads SDK とアダプタの初期化が完了しているか、初期化が行われた後 30 秒のタイムアウト。この処理は 1 回だけ行います(アプリの起動時に行うのが理想的です)。

Google Mobile Ads SDK またはメディエーション パートナーの SDK によって広告がプリロードされる場合があります 初期化時に行われます。ヨーロッパのユーザーから同意を取得する必要がある場合 経済地域(EEA)では、 setTagForChildDirectedTreatment() または setTagForUnderAgeOfConsent(), または 広告を読み込む前にアクションを実行する場合は、必ず初期化前に行ってください。 Google Mobile Ads SDK を使用します

バックグラウンドで initialize() メソッドを呼び出す方法の例を次に示します。 あります。

Java

import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;

public class MainActivity extends AppCompatActivity {
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    new Thread(
            () -> {
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(this, initializationStatus -> {});
            })
        .start();
  }
}

Kotlin

import com.google.android.gms.ads.MobileAds
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(this@MainActivity) {}
    }
  }
}

広告フォーマットの選択

これで Google Mobile Ads SDK がインポートされ、広告を実装できるようになりました。 Ad Manager さまざまな広告フォーマットが用意されているため、 アプリのユーザー エクスペリエンスに最適なものを選択できます。

バナー広告ユニットには、アプリの画面の一部に表示される長方形の広告が表示されます できます。一定時間の経過後に自動更新される。つまり ユーザーが同じことを続けていても、定期的に新しい広告が表示される クリックします。最も簡単に実装できる広告フォーマットでもあります。

バナー広告を実装する

インタースティシャル

インタースティシャル広告ユニットでは、アプリに全画面広告が表示されます。自然な位置に配置する アプリのインターフェースでの中断や遷移(レベルクリア後など) ゲームアプリで利用できます。

インタースティシャル広告を実装する

ネイティブ

ネイティブ広告では、広告見出しや説明文などのアセットの方法をカスタマイズできる 行動を促すフレーズがアプリに表示されている。広告のスタイルをご自身で設定すると リッチ ユーザーの興味を引き付ける、自然で目立たない広告プレゼンテーションを作成できる 体験できます

Google アド マネージャーではネイティブ広告を実装する方法として、ネイティブ スタイルと 表示できるようになります

ネイティブ スタイルは、ネイティブ広告、 初めてフォーマットを使用するのに最適ですカスタム レンダリングは プレゼンテーション作成の自由度を最大限に高めることができます。

ネイティブ スタイルを実装する ネイティブ広告を実装する(カスタム レンダリング)

特典

リワード広告を使用すると、ユーザーがゲームで遊んだり、アンケートに回答したり、動画を視聴したりして、 コイン、追加ライフ、ポイントなどのアプリ内特典を獲得する。広告の 広告ユニットごとに異なる報酬を設定し、報酬の値と アイテム。

リワード広告を実装する

リワード インタースティシャル

リワード インタースティシャルは、報酬に基づく新しいタイプの広告フォーマットで、 自動的に表示される広告でコインや追加ライフなどの報酬を提供する アプリの画面が切り替わる際に 非常に効果的です

リワード広告とは異なり、ユーザーはリワード広告の表示にオプトインする必要はありません。 表示できます。

リワード広告では、オプトイン プロンプトの代わりに、リワード インタースティシャル広告を表示する必要があります。 特典について告知し、特典を無効化する機会をユーザーに提供するイントロ画面 決定します

リワード インタースティシャル広告を実装する

アプリ起動

アプリ起動時広告は、ユーザーがアプリを開いたとき、またはアプリに切り替えたときに表示される広告フォーマットです。 。広告が読み込み画面に重ねて表示されます。

アプリ起動時広告を実装する

参考情報

GitHub の Google モバイル広告リポジトリに さまざまな広告フォーマットを 使用する方法を学びます