このガイドでは、Google Mobile Ads SDK で AdMob メディエーションを使用して PubMatic の広告を読み込んで表示する方法を説明します。入札の統合についても説明します。また、広告ユニットのメディエーション設定に PubMatic を追加する方法と、PubMatic とアダプタを Android アプリに統合する方法についても取り上げます。
サポートされている統合と広告フォーマット
PubMatic 用のメディエーション アダプタには、次の機能があります。
| 統合 | |
|---|---|
| 入札単価 | |
| ウォーターフォール | |
| フォーマット | |
| アプリ起動 | |
| バナー | |
| インタースティシャル | |
| 特典 | |
| リワード インタースティシャル | |
| ネイティブ | |
要件
- Android API レベル 23 以上
Google Mobile Ads SDK のバージョンが最新であること
メディエーションのスタートガイドの手順を完了していること
ステップ 1: PubMatic の管理画面で構成を設定する
PubMatic アカウントにログインし、[OpenWrap SDK] カードを選択します。
新しいアプリケーションを追加する
[Apps] タブに移動し、[Add App] ボタンをクリックします。
アプリのプラットフォーム、アプリストアの URL、アプリ名を選択します。
[Integration Path] で、[Android (Java / Kotlin)] を選択し、[Sub-integration Path] で [AdMob - SDK Bidding] を選択します。[Add App] ボタンをクリックします。
app-ads.txt を更新する
Authorized Sellers for Apps app-ads.txt は、承認されたチャネルでのみアプリ広告枠を販売できるようにする IAB Tech Lab が推進しているイニシアチブです。広告収益の大幅な減少を防ぐためには、app-ads.txt ファイルを実装する必要があります。まだ設定していない場合は、アプリの app-ads.txt ファイルを設定します。
アプリが確定する前に、app-ads.txt に追加する適切なエントリが表示されます。
PubMatic で app-ads.txt を実装する方法について詳しくは、app-ads.txt を実装する方法をご覧ください。
プロファイル ID
アプリを作成したら、[Apps] タブに移動し、新しく作成したアプリケーションのプロファイル ID をメモします。
広告ユニットの作成
[広告ユニット] タブで、前のセクションで作成したアプリを選択し、[広告ユニットを作成] ボタンをクリックします。
フォームに広告ユニットの詳細を入力し、[保存] をクリックします。
新しく作成した OpenWrap 広告ユニット ID をメモします。
パブリッシャー ID を取得する
[アナリティクス ダッシュボード] に移動します。プロフィール アイコンにカーソルを合わせ、ID をメモします。
ステップ 2: AdMob の管理画面で PubMatic のデマンドを設定する
広告ユニットのメディエーション設定を構成する
広告ユニットのメディエーション設定に PubMatic OpenWrap SDK を追加する必要があります。
まず、AdMob アカウントにログインします。次に、[メディエーション] タブに移動します。変更したい既存のメディエーション グループがある場合は、そのメディエーション グループの名前をクリックして編集し、広告ソースとして PubMatic OpenWrap SDK を追加するに進みます。
新しいメディエーション グループを作成するには、[メディエーション グループを作成] を選択します。
広告フォーマットとプラットフォームを入力し、[続行] をクリックします。
メディエーション グループに名前を付け、ターゲットとする地域を選択します。次に、メディエーション グループのステータスを [有効] に設定し、[広告ユニットを追加] をクリックします。
このメディエーション グループを、1 つ以上の既存の AdMob 広告ユニットに関連付けます。次に [完了] をクリックします。
選択した広告ユニットが広告ユニットカードに表示されます。
広告ソースとして PubMatic OpenWrap SDK を追加する
[広告のソース] セクションの [入札] カードで、[広告ソースを追加] を選択します。[PubMatic OpenWrap SDK] を選択します。[パートナー契約への署名手順] をクリックし、PubMatic OpenWrap SDK との入札のパートナーシップを設定します。
[確認して同意する] をクリックし、[続行] をクリックします。
PubMatic OpenWrap SDK のマッピングがすでに存在する場合は、それを選択できます。それ以外の場合は、[マッピングを追加] をクリックします。
次に、前のセクションで取得した OpenWrap 広告ユニット ID を入力します。[完了] をクリックします。
GDPR と米国の州規制の広告パートナー リストに PubMatic を追加する
欧州の規制に関する設定と米国の州の規制に関する設定の手順に沿って、AdMob 管理画面の欧州および米国の州の規制に関する広告パートナーのリストに PubMatic を追加します。
ステップ 3: PubMatic の SDK とアダプタをインポートする
Android Studio の統合（推奨）
プロジェクト レベルの settings.gradle.kts ファイルで、次のリポジトリを追加します。
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://repo.pubmatic.com/artifactory/public-repos")
}
}
}
次に、アプリレベルの build.gradle.kts ファイルで、次の実装の依存関係と構成を追加します。PubMatic SDK とアダプタの最新バージョンを使用します。
dependencies {
implementation("com.google.android.gms:play-services-ads:24.5.0")
implementation("com.google.ads.mediation:pubmatic:4.7.1.1")
}
ステップ 4: PubMatic SDK にプライバシー設定を実装する
Google の EU ユーザーの同意ポリシーに準拠するには、欧州経済領域（EEA）、英国、スイスのユーザーに対して特定の情報を開示し、法律で義務付けられている場合は、Cookie やその他のローカル ストレージの使用、広告のパーソナライズを目的とした個人データの収集、共有、使用についてユーザーの同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則（GDPR）の要件が反映されています。パブリッシャー様には、同意がメディエーション チェーン内の各広告ソースに反映されていることを確認する責任があります。
PubMatic は、UMP SDK を含む Google の追加の同意に関する仕様をサポートする同意管理プラットフォームによって設定された GDPR の同意を自動的に読み取ります。詳しくは、GDPR と GDPR 同意を渡すをご覧ください。
米国のプライバシー関連州法
米国の州のプライバシー法では、ユーザーが「個人情報」の「販売」を拒否する権利を保障することが求められています（用語は法律の定義に基づく）。「販売者」のホームページにある「個人情報を販売しない」リンクから販売を拒否することができます。米国のプライバシー関連州法遵守ガイドでは、Google 広告の配信で制限付きデータ処理を有効にできますが、Google がこの設定をメディエーション チェーン内の各広告ネットワークに適用することはできません。そのため、メディエーション チェーン内で個人情報の販売に関与する可能性のある広告ネットワークを特定し、各ネットワークのガイダンスに沿って州法を遵守する必要があります。
PubMatic は、UMP SDK を含む Google の追加同意の仕様をサポートする同意管理プラットフォームによって設定された GPP 同意を自動的に読み取ります。詳しくは、GPP の同意を渡すをご覧ください。
ステップ 5: 必要なコードを追加する
PubMatic の統合に必要な追加のコードはありません。
ステップ 6: 実装をテストする
テスト広告を有効にする
AdMob 用のテストデバイスを登録してください。
テスト広告を確認する
PubMatic OpenWrap SDK からテスト広告を受信していることを確認するには、PubMatic（入札）の広告ソースを使用して、広告インスペクタで単一の広告ソースのテストを有効にします。
省略可能な手順
ネイティブ広告
広告のレンダリング
PubMatic アダプタは、ネイティブ広告を NativeAd オブジェクトとして返します。NativeAd の次のフィールドに入力します。
| フィールド | PubMatic アダプターによって常に含まれるアセット |
|---|---|
| 広告見出し | |
| 画像 | |
| 本文 | |
| アイコン | |
| 行動を促すフレーズ | |
| 評価 | |
| ストア | |
| 価格 | |
| 広告主様 |
エラーコード
アダプタが PubMatic から広告を受信できなかった場合は、次のクラスの ResponseInfo.getAdapterResponses() を使用して、広告レスポンスから根本原因のエラーを確認できます。
com.pubmatic.sdk
com.google.ads.mediation.pubmatic
広告の読み込みに失敗した場合に PubMatic アダプタがスローするコードとメッセージは次のとおりです。
| エラーコード | ドメイン | 理由 |
|---|---|---|
| 101 | com.google.ads.mediation.pubmatic | サーバー設定に必要なパブリッシャー ID がありません。 |
| 102 | com.google.ads.mediation.pubmatic | 広告を読み込むための広告設定が無効です。 |
| 103 | com.google.ads.mediation.pubmatic | 広告の準備ができていないため、広告を表示できませんでした。 |
| 1001-5002 | PubMatic SDK によって送信されたエラーコード | PubMatic SDK がエラーを返しました。詳しくは、PubMatic のドキュメントをご覧ください。 |
PubMatic Android メディエーション アダプタの変更履歴
バージョン 4.8.0.0（開発中）
バージョン 4.7.1.1
- AdChoices アイコンの固定サイズ
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 24.4.0。
- Pubmatic SDK バージョン 4.7.1。
バージョン 4.7.1.0
- Pubmatic SDK 4.7.1 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 24.4.0。
- Pubmatic SDK バージョン 4.7.1。
バージョン 4.7.0.1
- 内部依存関係を修正しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 24.4.0。
- Pubmatic SDK バージョン 4.7.0。
バージョン 4.7.0.0
- 初回リリース。
- バナー、インタースティシャル、リワード、ネイティブの広告フォーマットの入札サポートを追加しました。
- Pubmatic SDK 4.7.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 24.4.0。
- Pubmatic SDK バージョン 4.7.0。