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

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

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

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

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

1 このフォーマットはベータ版です。 アクセス権をリクエストするには、アカウント マネージャーにご連絡ください。

前提条件

続行する前に、次のことを確認してください。

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

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

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

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

アプリ ダッシュボード

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

Android

[Integration Path] で [React Native] を選択し、[Sub-integration Path] として [AdMob - SDK 入札] を選択します。[アプリを追加] ボタンをクリックします。

新しいアプリのフォーム

iOS

[Integration Path] で [React Native] を選択し、[Sub-integration Path] として [AdMob - SDK 入札] を選択します。[アプリを追加] ボタンをクリックします。

新しいアプリのフォーム

app-ads.txt を更新する

アプリの認定販売者 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

広告ユニットの作成

[Ad Units] タブで、前のセクションで作成したアプリを選択し、[Create Ad Unit] ボタンをクリックします。

広告ユニットを作成する

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

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

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

アプリ広告ユニット ID

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

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

パブリッシャー ID

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

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

Android

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

iOS

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

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

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

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

プロジェクトのルート ディレクトリに、PubMatic OpenWrap SDK 用の Google Mobile Ads SDK for React Native メディエーション アダプタをインストールします。次の手順に沿って操作します。

  1. Google Mobile Ads SDK for React Native アダプタの tar ファイルを gma-sdk-react-native/adapters/pubmatic/ ディレクトリからプロジェクトの local_packages/ ディレクトリにコピーします。adapters フォルダがない場合は、前提条件をご覧ください。

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/pubmatic/gma-mediation-pubmatic-0.1.0.tgz local_packages/

    EXTRACT_DIR は、アーカイブを抽出したディレクトリのパスに置き換えます。

  2. 任意のパッケージ マネージャーを使用して、アダプタ パッケージをインストールします。

    npm

    npm install ./local_packages/gma-mediation-pubmatic-0.1.0.tgz

    毛糸

    yarn add ./local_packages/gma-mediation-pubmatic-0.1.0.tgz

  3. Android 向けにビルドする場合は、プロジェクトの android ディレクトリにある build.gradle ファイルに次のリポジトリを追加します。

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

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

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

PubMatic OpenWrap SDK React Native アダプタ バージョン 0.1.0 以降では、IAB の透明性と同意に関するフレームワーク（TCF）と統合された同意管理プラットフォームから PubMatic OpenWrap SDK SDK に GDPR 同意シグナルを渡すことができます。詳細については、GDPR と GDPR 同意を渡すをご覧ください。

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

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

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

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

Android

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

iOS

SKAdNetwork の統合

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

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

テスト広告を有効にする

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

テスト広告を確認する

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

エラーコード

アダプタが 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 広告フォーマットが PubMatic でサポートされていないか、RTB シグナルデータに含まれていません。
103 com.google.ads.mediation.pubmatic 広告の準備ができていなかったため、広告を表示できませんでした。
104 com.google.ads.mediation.pubmatic プロフィール ID がないか、無効です。
105 com.google.ads.mediation.pubmatic 広告ユニット ID がないか、空です。
106 com.google.ads.mediation.pubmatic 返されたリワード広告が null です。
107 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 ネイティブ広告の画像ソースの 1 つを読み込めませんでした。
107 com.google.ads.mediation.pubmatic 広告設定にパブリッシャー ID がありません。
108 com.google.ads.mediation.pubmatic 広告設定にプロファイル ID がありません。
109 com.google.ads.mediation.pubmatic 広告設定に、数値以外のプロファイル ID が含まれています。
110 com.google.ads.mediation.pubmatic 広告設定に広告ユニット ID がありません。
111 com.google.ads.mediation.pubmatic PubMatic OpenWrap SDK で広告サイズ インスタンスをインスタンス化できませんでした。
1001-5002 PubMatic SDK によって送信されたエラーコード PubMatic SDK がエラーを返しました。詳しくは、PubMatic のドキュメントをご覧ください。

バージョン 0.1.0

  • 初回リリース。