このガイドでは、Google Mobile Ads SDK を使用して、Google Mobile Ads SDK を読み込んで表示する方法を説明します。 メディエーションを使った Pangle の広告 ウォーターフォールと入札の両方に対応 の統合をご覧ください。このコースでは、 広告ユニットのメディエーション設定への Pangle の追加と、 SDK とアダプタをアプリに Flutter Pangle します。
サポートされている統合と広告フォーマット
Pangle 向け AdMob メディエーション アダプタには、 次のような機能があります。
統合 | |
---|---|
単価設定 | |
滝 | |
フォーマット | |
バナー | |
インタースティシャル | |
特典 | |
リワード インタースティシャル |
要件
- 最新の Google Mobile Ads SDK
- Flutter 3.7.0 以降
- Android にデプロイする
<ph type="x-smartling-placeholder">
- </ph>
- Android API レベル 21 以降
- iOS にデプロイする場合
<ph type="x-smartling-placeholder">
- </ph>
- iOS デプロイ ターゲットが 12.0 以降であること
- 以下で構成された Flutter 作業プロジェクト Google Mobile Ads SDK詳しくは、 スタートガイドをご覧ください。
- メディエーションを完了する スタートガイド
ステップ 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 のみ)次のリポジトリを内部の 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 を使って作成、テストしています。