このガイドでは、Google Mobile Ads SDK を使用して、メディエーションによって Pangle から広告を読み込み、表示する方法について説明します。 ウォーターフォールと入札の両方の 統合に対応しています。広告ユニットのメディエーション構成に Pangle を追加する方法と、Pangle SDK とアダプタを Flutter アプリに統合する方法が記載されています。
サポートされている統合と広告フォーマット
AdMob Pangle 用メディエーション アダプタには次の機能があります。
統合 | |
---|---|
入札 | |
ウォーターフォール | |
フォーマット | |
バナー | |
インタースティシャル | |
特典 | |
リワード インタースティシャル |
要件
- 最新の Google Mobile Ads SDK
- Flutter 3.7.0 以降
- Android にデプロイするには
- Android API レベル 21 以降
- iOS にデプロイする場合
- iOS デプロイ ターゲットが 12.0 以降であること
- Google Mobile Ads SDK で構成された Flutter 作業中のプロジェクト詳しくは、使ってみるをご覧ください。
- メディエーションのスタートガイドを完了します。
ステップ 1: Pangle UI で構成をセットアップする
新しいアプリケーションの追加
[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 デマンドを設定する
広告ユニットのメディエーション設定を行う
ステップ 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: ^1.0.0
手動統合
Pangle の Google モバイル広告メディエーション プラグインの最新バージョンをダウンロードし、ダウンロードしたファイルを抽出し、抽出したプラグイン フォルダ(とその内容)を Flutter プロジェクトに追加します。次に、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 のドキュメントをご覧ください。 |
1.0.0
- 初回リリース。
- Pangle Android アダプター バージョン 5.8.0.9.0 と互換性を検証済み
- Pangle iOS アダプター バージョン 5.8.0.8.0 との互換性を確認