PubMatic をメディエーションと統合する

このガイドでは、Google Mobile Ads SDK で AdMob メディエーションを使用して PubMatic の広告を読み込んで表示する方法を説明します。入札の統合についても説明します。また、広告ユニットのメディエーション設定に PubMatic を追加する方法と、PubMatic SDK とアダプタを Flutter アプリに統合する方法についても取り上げます。

サポートされている統合と広告フォーマット

PubMatic 用の AdMob メディエーション アダプタには、次の機能があります。

統合
入札単価
ウォーターフォール
フォーマット
アプリの起動
バナー
インタースティシャル
特典
リワード インタースティシャル
ネイティブ

要件

  • Google Mobile Ads SDK のバージョンが最新であること
  • Flutter 3.7.0 以降
  • Android にデプロイするには
    • Android API レベル 23 以上
  • iOS にデプロイする場合
    • iOS のデプロイ対象のバージョンが 12.0 以降であること
  • Google Mobile Ads SDK で構成された動作中の Flutter プロジェクト。詳しくは、スタートガイドをご覧ください。
  • メディエーションのスタートガイドの手順を完了していること

ステップ 1: PubMatic の管理画面で構成を設定する

PubMatic アカウントにログインし、[OpenWrap SDK] カードを選択します。

新しいアプリケーションを追加する

[Apps] タブに移動し、[Add App] ボタンをクリックします。

アプリ ダッシュボード

アプリのプラットフォーム、アプリストアの URL、アプリ名を選択します。

Android

[Integration Path] で [Flutter] を選択し、[Sub-integration Path] で [AdMob - SDK Bidding] を選択します。[Add App] ボタンをクリックします。

新しいアプリフォーム

iOS

[Integration Path] で [Flutter] を選択し、[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 に追加する適切なエントリが表示されます。

app-aps.txt

PubMatic で app-ads.txt を実装する方法について詳しくは、app-ads.txt を実装する方法をご覧ください。

プロファイル ID

アプリを作成したら、[Apps] タブに移動し、新しく作成したアプリケーションのプロファイル ID をメモします。

アプリ プロファイル ID

広告ユニットの作成

[広告ユニット] タブで、前のセクションで作成したアプリを選択し、[広告ユニットを作成] ボタンをクリックします。

広告ユニットを作成する

フォームに広告ユニットの詳細を入力し、[保存] をクリックします。

広告ユニットの作成フォーム

新しく作成した OpenWrap 広告ユニット ID をメモします。

アプリの広告ユニット ID

パブリッシャー ID を取得する

[アナリティクス ダッシュボード] に移動します。プロフィール アイコンにカーソルを合わせ、ID をメモします。

パブリッシャー ID

ステップ 2: AdMob の管理画面で PubMatic のデマンドを設定する

広告ユニットのメディエーション設定を構成する

Android

手順については、Android のガイドの手順 2 をご覧ください。

iOS

手順については、iOS のガイドの手順 2 をご覧ください。

GDPR と米国の州規制の広告パートナー リストに PubMatic を追加する

欧州の規制に関する設定と米国の州の規制に関する設定の手順に沿って、AdMob 管理画面の欧州および米国の州の規制に関する広告パートナーのリストに PubMatic を追加します。

ステップ 3: PubMatic の SDK とアダプタをインポートする

pub.dev を介した統合

（Android のみ）プロジェクトの android ディレクトリ内の build.gradle ファイルに次のリポジトリを追加します。

  repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://repo.pubmatic.com/artifactory/public-repos")
      }
  }

パッケージの pubspec.yaml ファイルに、PubMatic OpenWrap SDK SDK とアダプタの最新バージョンを含む次の依存関係を追加します。

dependencies:
  gma_mediation_pubmatic: ^

手動による統合

PubMatic OpenWrap SDK 用の Google モバイル広告メディエーション プラグインの最新バージョンをダウンロードし、ダウンロードしたファイルを解凍して、解凍したプラグイン フォルダ（およびそのコンテンツ）を Flutter プロジェクトに追加します。次に、次の依存関係を追加して、pubspec.yaml ファイルでプラグインを参照します。

dependencies:
  gma_mediation_pubmatic:
    path: path/to/local/package

ステップ 4: PubMatic SDK にプライバシー設定を実装する

Google の EU ユーザーの同意ポリシーに準拠するには、欧州経済領域（EEA）、英国、スイスのユーザーに対して特定の情報を開示し、法律で義務付けられている場合は、Cookie やその他のローカル ストレージの使用、広告のパーソナライズを目的とした個人データの収集、共有、使用についてユーザーの同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則（GDPR）の要件が反映されています。パブリッシャー様には、同意がメディエーション チェーン内の各広告ソースに反映されていることを確認する責任があります。 Google は、同意に関するユーザーの選択をそのようなネットワークに自動的に渡すことはできません。

PubMatic は、UMP SDK を含む Google の追加の同意に関する仕様をサポートする同意管理プラットフォームによって設定された GDPR の同意を自動的に読み取ります。詳しくは、GDPR と GDPR の同意を渡すをご覧ください。

米国のプライバシー関連州法

米国の州のプライバシー法では、ユーザーが「個人情報」の「販売」を拒否する権利を保障することが求められています（用語は法律の定義に基づく）。「販売者」のホームページにある「個人情報を販売しない」リンクから販売を拒否することができます。米国のプライバシー関連州法遵守ガイドでは、Google 広告の配信で制限付きデータ処理を有効にできますが、Google がこの設定をメディエーション チェーン内の各広告ネットワークに適用することはできません。そのため、メディエーション チェーン内で個人情報の販売に関与する可能性のある広告ネットワークを特定し、各ネットワークのガイダンスに沿って州法を遵守する必要があります。

PubMatic は、UMP SDK を含む Google の追加同意の仕様をサポートする同意管理プラットフォームによって設定された CCPA の同意を自動的に読み取ります。詳しくは、CCPA 文字列を設定するをご覧ください。

ステップ 5: 必要なコードを追加する

Android

PubMatic との統合に、追加のコードは必要ありません。

iOS

SKAdNetwork の統合

PubMatic のドキュメントに沿って、プロジェクトの Info.plist ファイルに SKAdNetwork 識別子を追加します。

ステップ 6: 実装をテストする

テスト広告を有効にする

AdMob 用のテストデバイスを登録してください。

テスト広告を確認する

PubMatic OpenWrap SDK からテスト広告を受信していることを確認するには、PubMatic（入札）の広告ソースを使用して、広告インスペクタで単一の広告ソースのテストを有効にします。

エラーコード

アダプタが PubMatic から広告を受信できなかった場合は、次のクラスの ResponseInfo を使用して、広告レスポンスから根本原因のエラーを確認できます。

Android

com.pubmatic.sdk
com.google.ads.mediation.pubmatic

iOS

GADMediationAdapterPubMatic

広告の読み込みに失敗した場合に PubMatic アダプタがスローするコードとメッセージは次のとおりです。

Android

エラーコード ドメイン 理由
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 のドキュメントをご覧ください。

iOS

エラーコード ドメイン 理由
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 Flutter メディエーション アダプタの変更履歴

バージョン 1.1.0

バージョン 1.0.0