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

このガイドでは、Google Mobile Ads SDK を使用して、Google Mobile Ads SDK を読み込んで表示する方法を説明します。 メディエーションを使った Pangle の広告 ウォーターフォールと入札の両方に対応 の統合をご覧ください。このコースでは、 広告ユニットのメディエーション設定への Pangle の追加と、 SDK とアダプタをアプリに Flutter Pangle します。

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

Pangle 向け AdMob メディエーション アダプタには、 次のような機能があります。

統合
単価設定
フォーマット
バナー
インタースティシャル
特典
リワード インタースティシャル

要件

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

ステップ 1: Pangle UI で構成をセットアップする

Pangle アカウントに登録またはログインします。

新しいアプリケーションの追加

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

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

Android

iOS

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

Android

iOS

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

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

Android

iOS

入札

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

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

Android

iOS

ウォーターフォール

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

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

Android

iOS

Pangle Reporting API キーを見つける

入札

入札の統合では、この手順は必要ありません。

ウォーターフォール

ページの左下にあるユーザー ID をメモします。

[統合] > [SDK と API] > [Pangle Reporting API 2.0] をクリックします。[Role ID] と [Security Key] をメモします。

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

Pangle のテスト広告を有効にする方法については、Pangle のテスト広告を追加する方法ガイドをご覧ください。

ステップ 2: UI で AdMob Pangle デマンドを設定する

広告ユニットのメディエーション設定を行う

Android

手順については、 Android 向けガイドのステップ 2 をご覧ください。

iOS

手順については、 iOS 向けガイドのステップ 2 をご覧ください。

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

pub.dev による統合

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

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

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

dependencies:
  gma_mediation_pangle: ^1.0.0

手動統合

最新バージョンの Google モバイル広告メディエーション プラグイン Pangle ダウンロードしたファイルを解凍し、抽出したプラグイン フォルダを追加します。 (およびその内容)を Flutter プロジェクトに追加します。次に、Terraform でプラグインを pubspec.yaml ファイルに次の依存関係を追加します。

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

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

Android

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

iOS

SKAdNetwork との統合

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

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

テスト広告を有効にする

AdMob にテストデバイスを登録し、 Pangle UI でテストモードを有効にします。

テスト広告を確認する

Pangleからテスト広告を受信していることを確認するには、広告インスペクタで Pangle (Bidding) and Pangle (Waterfall) 広告ソースを使用して単独の広告ソースのテストを有効にします。

エラーコード

アダプタが 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 メディエーション アダプタの変更履歴

1.1.0

  • Pangle Android アダプター バージョン 5.9.0.4.0 との互換性を検証しました。
  • Pangle iOS アダプタ バージョン 5.9.0.7.0 との互換性を検証しました。
  • Google Mobile Ads Flutter プラグインのバージョン 5.1.0 を使って作成、テストしています。

1.0.0

  • 初回リリース。
  • Pangle Android アダプター バージョン 5.8.0.9.0 との互換性を検証しました
  • Pangle iOS アダプタ バージョン 5.8.0.8.0 との互換性を検証
  • Google Mobile Ads Flutter プラグインのバージョン 5.0.0 を使って作成、テストしています。