このガイドでは、Google Mobile Ads SDK を使用してメディエーションで PubMatic の広告を読み込んで表示する方法を、入札の統合を含めて説明します。また、広告ユニットのメディエーション設定に PubMatic OpenWrap SDK を追加する方法と、PubMatic OpenWrap SDK とアダプタを iOS アプリに統合する方法についても取り上げます。
サポートされている統合と広告フォーマット
PubMatic 用のメディエーション アダプタには、次の機能があります。
| 統合 | |
|---|---|
| 入札 | |
| ウォーターフォール | |
| フォーマット | |
| アプリ起動時 | |
| バナー | |
| インタースティシャル | 1 |
| 特典 | 1 |
| リワード インタースティシャル | |
| ネイティブ | 1 |
1 このフォーマットはベータ版です。アクセス権をリクエストするには、アカウント マネージャーにお問い合わせください。
要件
- iOS のデプロイ対象のバージョンが 13.0 以降であること
最新の Google Mobile Ads SDK。
メディエーションのスタートガイドの手順を完了していること
ステップ 1: PubMatic の管理画面で構成を設定する
[Sign up] or [Log in] to your PubMatic account and select the [OpenWrap SDK] card.
新しいアプリケーションを追加する
[Apps] タブに移動し、[Add App] ボタンをクリックします。
アプリの [Platform]、[App Store URL]、[App Name] を選択します。
[Integration Path] で [iOS (Objective-C / Swift)] を選択し、[Sub-integration Path] で [AdMob - SDK 入札] を選択します。次に、[Add App] ボタンをクリックします。
app-ads.txt を更新する
アプリの認定販売者 app-ads.txt は、IAB Tech Lab が推進するイニシアチブで、承認されたチャネルでのみアプリ広告枠を販売できるようにするものです。広告収入の大幅な減少を防ぐためには、app-ads.txt
ファイルを実装する必要があります。
まだ設定していない場合は、
アド マネージャーの app-ads.txt ファイルを作成します。
アプリが完成する前に、app-ads.txt に追加する適切なエントリが表示されます。
PubMatic の app-ads.txt を実装する方法について詳しくは、
app-ads.txt を実装する方法をご覧ください。
プロファイル ID
アプリを作成したら、[Apps] タブに移動し、新しく作成したアプリケーションの [Profile ID] をメモします。
広告ユニットの作成
[Ad Units] タブで、前のセクションで作成したアプリを選択し、[Create Ad Unit] ボタンをクリックします。
フォームに広告ユニットの詳細を入力して [Save] をクリックします。
新しく作成した OpenWrap Ad Unit ID をメモします。
パブリッシャー ID を取得する
アナリティクス ダッシュボードに移動します。 プロフィール アイコンにカーソルを合わせ、ID をメモします。
ステップ 2: アド マネージャーの管理画面で PubMatic のデマンドを設定する
アド マネージャー アカウントにログインします。
セキュア シグナルの共有を有効にする
[管理者] > [全般設定] に移動します。[Ad Exchange アカウントの設定] タブに移動し、[セキュア シグナルの共有] を確認してオンに切り替えます。[保存] をクリックします。
入札リクエストでセキュア シグナルを共有する
[広告枠] > [セキュア シグナル] に移動します。[セキュア シグナル] で、 [PubMatic OpenWrap SDK] を検索し、[アプリ統合を有効にする] をオンにします。
[保存] をクリックします。
SDK 入札のセキュア シグナルの共有を許可する
[配信] > [デマンド チャネルの設定] に移動します。[デフォルト設定] タブで、[SDK 入札] の [セキュア シグナルの共有を許可する] をオンにします。
[保存] をクリックします。
PubMatic の入札を設定する
[配信] > [入札者（ビッダー）] に移動し、[SDK 入札に移動] をクリックします。
[新しいビッダー] をクリックします。
ビッダーとして [PubMatic OpenWrap SDK] を選択します。
[続行] をクリックして、このビッダーの SDK 入札を有効にします。
[完了] をクリックします。
広告ユニットのマッピングを設定する
[配信] > [入札者（ビッダー）] に移動し、[SDK 入札に移動] をクリックします。
PubMatic OpenWrap SDK で使用する会社を選択します。
[広告ユニットのマッピング] タブに移動し、[新しい広告ユニットのマッピング] をクリックします。
[特定の広告ユニット] を選択します。広告ユニットと広告フォーマットを選択します。[モバイルアプリ] を [広告枠のタイプ] として選択し、対象の [モバイルアプリ] を選択します。次に、前のセクションで取得した OpenWrap Ad Unit ID を入力します。
アド マネージャーの管理画面で リワード インタースティシャル広告の広告ユニットのマッピングを設定する場合は、[リワード] フォーマットを選択し、リワード インタースティシャル プレースメント ID を使用します。
最後に [保存] をクリックします。
GDPR と米国の州規制の広告パートナー リストに PubMatic を追加する
欧州の規制に関する設定と米国の州の規制に関する設定の手順に沿って、アド マネージャーの管理画面で欧州および米国の州の規制に関する広告パートナーのリストにPubMaticを追加します。
ステップ 3: PubMatic OpenWrap SDK とアダプタをインポートする
Swift Package Manager を使用する
続行する前に、サポートされている最小アダプタ バージョン 4.10.0.0 が必要です。
プロジェクトにパッケージの依存関係 を追加するには、次の手順を行います。
Xcode で、[File] > [Add Package Dependencies...] の順に移動します。
表示されたプロンプトで、次のパッケージ URL を検索します。
https://github.com/googleads/googleads-mobile-ios-mediation-pubmatic.git[Dependency Rule] で [Branch] を選択します。
テキスト フィールドに「
main」と入力します。
CocoaPods を使用する
プロジェクトの Podfile に次の行を追加します。
pod 'GoogleMobileAdsMediationPubMatic'コマンドラインで次のコマンドを実行します。
pod install --repo-update
手動による統合
iOS 用の PubMatic OpenWrap SDK の最新バージョンをダウンロードし、プロジェクト内のすべての
.xcframeworkファイルとバンドルをリンクします。変更履歴のダウンロード リンクから PubMatic アダプタの最新バージョンをダウンロードし、プロジェクトに Changelog とリンク
PubMaticAdapter.xcframeworkします。
ステップ 4: PubMatic にプライバシー設定を実装する
Google の EU ユーザーの同意ポリシーに準拠する には、欧州経済領域（EEA）、英国、スイスの ユーザーに対して特定の情報を開示し、法律で 義務付けられている場合は、Cookie やその他のローカル ストレージの使用、広告の パーソナライズを目的とした個人データの収集、共有、使用について ユーザーの同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則（GDPR）の要件が反映されています。パブリッシャー様には、同意がメディエーション チェーン内の各広告のソースに反映されていることを確認する責任があります。
PubMatic は、Google の追加同意仕様をサポートする同意管理プラットフォームによって設定された GDPR 同意を自動的に読み取ります。 UMP SDK などが含まれます。詳しくは、 GDPR と GDPR 同意をご覧ください。
米国のプライバシー関連州法
米国のプライバシー関連州法では、ユーザーが「個人情報」の「販売」をオプトアウトする権利を付与することが義務付けられています（用語は法律の定義に基づく）。「販売者」のホームページには、「個人情報を第三者に売却しない」ことを明記したリンクを目立つように表示することによってオプトアウトの手段を提供する必要があります。米国のプライバシー関連州法遵守ガイドでは、Google 広告の配信で制限付きデータ処理を有効にできますが、Google がこの設定をメディエーション チェーン内の各広告ネットワークに適用することはできません。そのため、メディエーション チェーン内で個人情報の販売に関与する可能性のある広告ネットワークを特定し、各ネットワークのガイダンスに沿って州法を遵守する必要があります。
PubMatic は、UMP SDK など、Google の追加同意仕様をサポートする同意管理 プラットフォームによって設定された GPP の同意を自動的に読み取ります。詳しくは、 GPP の同意を渡すをご覧ください。
ステップ 5: 必要なコードを追加する
SKAdNetwork を実装する
PubMatic のドキュメント
に沿って、SKAdNetwork 識別子をプロジェクトの Info.plist ファイルに追加します。
ステップ 6: 実装をテストする
テスト広告を有効にする
アド マネージャー用のテストデバイスを 登録 してください。
テスト広告を確認する
PubMatic OpenWrap SDK からテスト広告を受信していることを確認するには、 PubMatic（入札） の広告のソースを使用して、広告インスペクタで 単一の広告ソースのテスト を有効にします。
オプション ステップ
ネイティブ広告
広告レンダリング
PubMatic アダプタは、ネイティブ広告を
GADNativeAd
オブジェクトとして返します。次の
フィールド
に
GADNativeAdを入力します。
| フィールド | PubMatic アダプタによって常に含まれるアセット |
|---|---|
| 広告見出し | |
| 画像 | |
| 本文 | |
| アイコン | |
| 行動を促すフレーズ | |
| 評価 | |
| ストア | |
| 価格 | |
| 広告主様 |
エラーコード
アダプタが PubMatic から広告を受け取れない場合は、
次のクラスの
GADResponseInfo.adNetworkInfoArray
を使用して、広告レスポンスからエラーの詳細を確認できます。
GADMediationAdapterPubMatic
広告の読み込みに失敗した場合に PubMatic アダプタがスローするコードとメッセージは次のとおりです。
| エラーコード | ドメイン | 理由 |
|---|---|---|
| 101 | com.google.ads.mediation.pubmatic | サーバー構成に必要なパブリッシャー ID がありません。 |
| 102 | com.google.ads.mediation.pubmatic | リクエスト パラメータで複数のフォーマット、フォーマットなし、またはサポートされていないフォーマットが指定されたため、入札シグナルの収集リクエストが失敗しました。 |
| 103 | com.google.ads.mediation.pubmatic | 広告を読み込むための広告構成が無効です。 |
| 104 | com.google.ads.mediation.pubmatic | 広告の準備ができていないため、インタースティシャル広告を表示できませんでした。 |
| 105 | com.google.ads.mediation.pubmatic | 広告の準備ができていないため、リワード広告を表示できませんでした。 |
| 106 | com.google.ads.mediation.pubmatic | ネイティブ広告の画像ソースのいずれかを読み込めませんでした。 |
| 1001-5002 | PubMatic SDK によって送信されたエラーコード | PubMatic SDK がエラーを返しました。詳しくは、PubMatic の ドキュメント をご覧ください。 |
PubMatic iOS メディエーション アダプタの変更履歴
バージョン 5.0.0.0（開発中）
バージョン 4.12.0.0
- PubMatic OpenWrap SDK バージョン 4.12.0 との互換性を確認しました。
- Google Mobile Ads SDK の依存関係をバージョン 13.0.0 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 13.0.0。
- PubMatic OpenWrap SDK バージョン 4.12.0。
バージョン 4.11.0.2
- CocoaPods の最小 iOS バージョンを
13.0に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 13.0.0。
- PubMatic OpenWrap SDK バージョン 4.11.0。
バージョン 4.11.0.1
tagForChildDirectedTreatmentパラメータとtagForUnderAgeOfConsentパラメータの Google Mobile Ads SDK パラメータを PubMatic OpenWrap SDK に転送するサポートを追加しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 12.14.0。
- PubMatic OpenWrap SDK バージョン 4.11.0。
バージョン 4.11.0.0
- PubMatic OpenWrap SDK バージョン 4.11.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 12.14.0。
- PubMatic OpenWrap SDK バージョン 4.11.0。
バージョン 4.10.0.0
- PubMatic OpenWrap SDK バージョン 4.10.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 12.12.0。
- PubMatic OpenWrap SDK バージョン 4.10.0。
バージョン 4.9.0.0
- バナー、インタースティシャル、リワード、ネイティブの広告フォーマットのウォーターフォール サポートを追加しました。
- ネイティブ広告のデリゲートが正しく設定されないバグを修正しました。
GADMediationAdapterPubMaticExtrasクラスにテストモード プロパティを追加します。- PubMatic OpenWrap SDK バージョン 4.9.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 12.12.0。
- PubMatic OpenWrap SDK バージョン 4.9.0。
バージョン 4.8.1.0
- PubMatic OpenWrap SDK バージョン 4.8.1 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 12.9.0。
- PubMatic OpenWrap SDK バージョン 4.8.1。
バージョン 4.8.0.0
- PubMatic OpenWrap SDK バージョン 4.8.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 12.8.0。
- PubMatic OpenWrap SDK バージョン 4.8.0。
バージョン 4.7.0.0
- 初回リリース。
- バナー、インタースティシャル、リワード、ネイティブの広告フォーマットの入札をサポートしています。
- PubMatic OpenWrap SDK バージョン 4.7.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 12.6.0。
- PubMatic OpenWrap SDK バージョン 4.7.0。