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

このガイドでは、Google Mobile Ads SDK を使用して メディエーションで Pangle の広告を読み込んで表示する方法を説明します。ウォーターフォール統合と入札統合の両方について説明します。このガイドでは、広告ユニットのメディエーション構成に Pangle を追加する方法と、Pangle SDK とアダプタを Flutter アプリに統合する方法について説明します。

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

Pangle 用のアド マネージャー メディエーション アダプタには、次の機能があります。

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

要件

  • 最新の Google Mobile Ads SDK
  • Flutter 3.7.0 以降
  • [入札の場合]: 入札でサポートされているすべての広告フォーマットを統合するには、Pangle 向けの Google Mobile Ads メディエーション プラグイン 2.4.0 以降（最新バージョンを推奨）を使用します。
  • Android にデプロイするには
    • Android API レベル 23 以降
  • iOS にデプロイするには
    • iOS のデプロイ ターゲットが 12.0 以降
  • Google Mobile Ads SDK を使用して構成された、動作する Flutter プロジェクト。詳しくは、スタートガイドをご覧ください。
  • メディエーションのスタートガイドの手順を完了していること

ステップ 1: Pangle UI で設定を行う

Pangle アカウントに登録するか、ログインします。

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

[アプリケーション] タブに移動し、[アプリを追加] ボタンをクリックします。

アプリケーションを作成するオペレーティング システムを選択し、フォームの残りの部分を入力します。[送信] をクリックします。

Android

iOS

アプリケーションのアプリ ID をメモします。

Android

iOS

広告プレースメントを作成する

アプリケーションを作成したら、[追加] ボタンをクリックして広告プレースメントを作成します。

Android

iOS

入札単価

[広告フォーマット] と [広告プレースメント名] を選択し、[料金タイプ] として [アプリ内入札] を選択します。フォームの残りの部分に記入し、[送信] をクリックします。

広告プレースメントを作成したら、広告プレースメント ID をメモします。

Android

iOS

滝

[広告フォーマット]、[広告プレースメント名]、[料金タイプ] として [グローバル CPM] を選択します。フォームの残りの部分に記入し、[送信] をクリックします。

広告プレースメントを作成したら、広告プレースメント ID をメモします。

Android

iOS

app-ads.txt を更新する

Authorized Sellers for Apps app-ads.txt は、承認されたチャネルでのみアプリ広告枠を販売できるようにする IAB Tech Lab が推進しているイニシアチブです。広告収益の大幅な減少を防ぐためには、app-ads.txt ファイルを実装する必要があります。まだ作成していない場合は、アド マネージャー用の app-ads.txt ファイルを作成します。

Pangle に app-ads.txt を実装するには、アプリの app-ads.txt ファイルに Pangle を追加する方法をご覧ください。

テストモードをオンにする

Pangle のテスト広告を追加する方法ガイドの手順に沿って、Pangle のテスト広告を有効にします。

ステップ 2: アド マネージャーの UI で Pangle のデマンドを設定する

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

Android

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

iOS

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

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

欧州の規制に関する設定と米国の州の規制に関する設定の手順に沿って、アド マネージャーの管理画面で、欧州と米国の州の規制に関する広告パートナーのリストに Pangle DSP を追加します。

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

pub.dev を介した統合

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

  repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://artifact.bytedance.com/repository/pangle/")
      }
  }

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

dependencies:
  gma_mediation_pangle: ^

手動による統合

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

dependencies:
  gma_mediation_pangle:
    path: path/to/local/package

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

Google の EU ユーザーの同意ポリシーに基づき、デバイス ID と個人データの使用に関して、欧州経済領域（EEA）のユーザーに特定の情報を開示し、同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則（GDPR）の要件が反映されています。同意を求める際は、メディエーション チェーン内の個人データを収集、受信、使用する可能性がある各広告ネットワークを特定し、各ネットワークの利用に関する情報を提供する必要があります。現在、Google はユーザーの同意の選択をこのようなネットワークに自動的に渡すことができません。

Pangle 向けの Google Mobile Ads メディエーション プラグインには、Pangle.SetGDPRConsent() メソッドが含まれています。次のサンプルコードは、同意情報を Pangle SDK に渡す方法を示しています。Google Mobile Ads SDK を初期化する前に同意情報を設定して、Pangle SDK に正しく転送されるようにします。

using GoogleMobileAds.Api.Mediation.Pangle;
// ...

Pangle.SetGDPRConsent(0);

各メソッドで指定できる値の詳細については、Pangle の統合ガイドをご覧ください。

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

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

Pangle 向けの Google Mobile Ads メディエーション プラグインには、Pangle.SetPAConsent() メソッドが含まれています。次のサンプルコードは、同意情報を Pangle SDK に渡す方法を示しています。Google Mobile Ads SDK を初期化する前に同意情報を設定して、Pangle SDK に正しく転送されるようにします。

using GoogleMobileAds.Api.Mediation.Pangle;
// ...

Pangle.SetPAConsent(0);

各メソッドで指定できる値の詳細については、Pangle の統合ガイドをご覧ください。

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

Android

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

iOS

SKAdNetwork の統合

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

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

テスト広告を有効にする

アド マネージャーでテストデバイスを登録し、Pangle の管理画面でテストモードを有効にしてください。

テスト広告を確認する

Pangle からテスト広告が配信されていることを確認するには、Pangle（入札）と Pangle（ウォーターフォール）の広告ソースを使用して、広告インスペクタで単一の広告ソースのテストを有効にします。

エラーコード

アダプタが Pangle から広告を受け取れなかった場合、パブリッシャーは次のクラスの ResponseInfo を使用して、広告レスポンスから根本原因のエラーを確認できます。

Android

com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter

iOS

GADMediationAdapterPangle

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

Android

エラーコード ドメイン 理由
101 com.google.ads.mediation.pangle サーバー パラメータが無効です（アプリ ID またはプレースメント ID が指定されていませんなど）。
102 com.google.ads.mediation.pangle リクエストされた広告サイズが、Pangle でサポートされているバナーサイズと一致していません。
103 com.google.ads.mediation.pangle 入札レスポンスがないか、無効です。
-1-60000 com.pangle.ads Pangle SDK がエラーを返しました。詳しくは、Pangle のドキュメントをご覧ください。

iOS

エラーコード ドメイン 理由
101 com.google.ads.mediation.pangle サーバー パラメータが無効です（アプリ ID またはプレースメント ID が指定されていませんなど）。
102 com.google.ads.mediation.pangle リクエストされた広告サイズが、Pangle でサポートされているバナーサイズと一致していません。
-1-60000 Pangle SDK によって送信されました Pangle SDK がエラーを返しました。詳しくは、Pangle のドキュメントをご覧ください。

Pangle Flutter メディエーション アダプタの変更履歴

バージョン 3.1.1

バージョン 3.1.0

バージョン 3.0.0

バージョン 2.2.0

バージョン 2.1.0

バージョン 2.0.0

バージョン 1.1.0

バージョン 1.0.0