Google Mobile Ads SDK のアプリへの統合は、広告を表示して収益を得るための第一歩です。SDK を統合したら、広告フォーマット(ネイティブ動画、リワード動画など)を選択し、手順に沿って実装してください。
始める前に
アプリを準備するには、以下のセクションに示す手順を完了します。
アプリの前提条件
アプリのビルドファイルで次の値が使用されていることを確認します。
- 最小 SDK バージョン:
21
以降 - SDK バージョン
33
以降をコンパイルする
- 最小 SDK バージョン:
アプリを設定する
プロジェクト レベルの
build.gradle
ファイルで、buildscript
セクションとallprojects
セクションの両方に Google の Maven リポジトリと Maven セントラル リポジトリを含めます。buildscript { repositories { google() mavenCentral() } } allprojects { repositories { google() mavenCentral() } }
Google Mobile Ads SDK の依存関係をモジュールのアプリレベルの Gradle ファイル(通常は
app/build.gradle
)に追加します。dependencies { implementation 'com.google.android.gms:play-services-ads:23.1.0' }
Ad Manager アプリ ID(Ad Managerウェブ インターフェースで識別される)をアプリの
AndroidManifest.xml
ファイルに追加します。そのためには、android:name="com.google.android.gms.ads.APPLICATION_ID"
を持つ<meta-data>
タグを追加します。アプリ 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 に置き換えます。Hello World アプリで SDK を試すだけの場合は、サンプル ID を使用できます。
また、示したとおりに
<meta-data>
タグを追加しないと、クラッシュして次のメッセージが表示されます。Missing application ID.
(省略可)以前のバージョンが Android 13 で動作するように
AD_ID
権限を宣言します。アプリで 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 をターゲットとするアプリの場合、広告 ID にアクセスするには、Google Mobile Ads SDK の
AndroidManifest.xml
ファイルにcom.google.android.gms.permission.AD_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
権限の申告について詳しくは、こちらの Google Play Console の記事をご覧ください。
Google Mobile Ads SDK を初期化する
広告を読み込む前に、MobileAds.initialize()
を呼び出して Google Mobile Ads SDK を初期化します。
このメソッドは 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 アド マネージャーでは、ネイティブ広告を実装する方法として、ネイティブ スタイルと、カスタム レンダリングによる標準のネイティブ広告の 2 種類があります。
ネイティブ スタイルはネイティブ広告を簡単に実装できるように設計されているため、このフォーマットを初めて使用する場合に最適です。カスタム レンダリングは、プレゼンテーションをより自由に作成できるように設計されています。
ネイティブ スタイルを実装する ネイティブ広告を実装する(カスタム レンダリング)
特典
リワード広告ユニットを使用すると、ユーザーはゲームをプレイしたり、アンケートに回答したり、動画を視聴したりして、コイン、追加ライフ、ポイントなどのアプリ内報酬を獲得できます。広告ユニットごとに異なる報酬を設定し、報酬の値やユーザーが受け取るアイテムを指定できます。
リワード インタースティシャル
リワード インタースティシャルは、新しいタイプのインセンティブ広告フォーマットで、アプリの画面が切り替わる自然なタイミングで自動的に表示される広告に対して、コインや追加ライフなどの報酬を提供できます。
リワード広告とは異なり、ユーザーはリワード インタースティシャル広告を表示するためにオプトインする必要はありません。
リワード広告のオプトイン メッセージの代わりに、リワード インタースティシャルでは、報酬を発表し、ユーザーがオプトアウトする機会を提供するイントロ画面が必要です。
アプリ起動
アプリ起動時広告は、ユーザーがアプリを開いたとき、またはアプリに戻ったときに表示される広告フォーマットで、読み込み画面に重なって表示されます。
参考情報
GitHub の Google モバイル広告リポジトリは、この API に用意されているさまざまな広告フォーマットの使い方を示しています。