このガイドでは、Google Mobile Ads SDK を使用して、 メディエーション、 ウォーターフォールと入札の両方の統合をカバーする、Pangle からの広告を読み込んで表示する方法について説明します。広告ユニットのメディエーション設定に Pangle を追加する方法と、 iOS Pangle SDK とアダプタをアプリに統合する方法について説明します。
サポートされている統合と広告フォーマット
Pangle のメディエーション アダプタには次の機能があります。
統合 | |
---|---|
単価設定 | |
滝 | 1 |
フォーマット | |
アプリの起動 | 2 |
バナー | |
インタースティシャル | |
特典 | |
リワード インタースティシャル | |
ネイティブ |
2 このフォーマットの入札統合はクローズド ベータ版です。
要件
- iOS デプロイ ターゲットが 10.0 以降であること
最新の Google Mobile Ads SDK
メディエーションのスタートガイドを完了していること
ステップ 1: Pangle UI で設定を行う
新しいアプリを追加する
[Applications] タブに移動し、[Add App] ボタンをクリックします。
アプリケーションを作成するオペレーティング システムを選択し、フォームの残りの部分に入力します。[送信] をクリックします。
アプリケーションの アプリ ID をメモします。
広告プレースメントを作成する
アプリを作成したら、[追加] ボタンをクリックして広告プレースメントを作成します。
単価設定
[広告フォーマット] と [広告プレースメント名] を選択し、[料金タイプ] として [アプリ内入札] を選択します。フォームの残りの部分に記入し、[送信] をクリックします。
広告プレースメントを作成したら、広告プレースメント ID をメモします。
滝
[広告フォーマット] と [広告プレースメント名] を選択し、[料金タイプ] として [グローバル CPM] を選択します。フォームの残りの部分に記入し、[送信] をクリックします。
広告プレースメントを作成したら、広告プレースメント ID をメモします。
Pangle Reporting API キーを確認する
単価設定
入札の統合では不要です。
滝
ページの左下にあるユーザー ID をメモします。
[統合] > [SDK と API] > [Pangle Reporting API 2.0] をクリックします。ロール ID とセキュリティ キーをメモします。
テストモードをオンにする
Pangle のテスト広告を追加する方法ガイドの手順に沿って、Pangle のテスト広告を有効にします。
ステップ 2: Ad Manager UI で Pangle デマンドを設定する
ステップ 3: Pangle SDK とアダプターをインポートする
CocoaPods を使用する(推奨)
プロジェクトの Podfile に次の行を追加します。
pod 'GoogleMobileAdsMediationPangle'
コマンドラインから次のコマンドを実行します。
pod install --repo-update
手動による統合
- 最新バージョンの Pangle SDK for iOS をダウンロードし、プロジェクト内のすべての
.framework
ファイルとバンドルをリンクします。 - 変更ログのダウンロード リンクから Pangle アダプターの最新バージョンをダウンロードし、プロジェクトの
PangleAdapter.xcframework
にリンクします。
ステップ 4: 必要なコードを追加する
SKAdNetwork との統合
Pangle のドキュメントに沿って、SKAdNetwork 識別子をプロジェクトの Info.plist
ファイルに追加します。
ステップ 5: 実装をテストする
テスト広告を有効にする
Ad Manager にテストデバイスを登録し、 Pangle UI でテストモードを有効にします。
テスト広告を確認する
Pangleからテスト広告を受信していることを確認するには、広告インスペクタで Pangle (Bidding) and Pangle (Waterfall) 広告ソースを使用して単独の広告ソースのテストを有効にします。
省略可能な手順
ネイティブ広告
広告のレンダリング
Pangle アダプタは、ネイティブ広告を
GADNativeAd
オブジェクトとして返します。
GADNativeAd
。
フィールド | Pangle アダプターに常に含まれるアセット |
---|---|
広告見出し | |
画像 | 1 |
本文 | |
アイコン | |
行動を促すフレーズ | |
評価 | |
ストア | |
価格 | |
広告主様 |
1 Pangle アダプタは、ネイティブ広告のメイン画像アセットに直接アクセスできません。代わりに、アダプターは
GADMediaView
に動画または画像を入力します。
エラーコード
アダプターが Pangle から広告を受信できない場合は、
GADResponseInfo.adNetworkInfoArray
次のクラスに追加します。
GADMediationAdapterPangle
広告の読み込みに失敗したときに Pangle アダプタによってスローされるコードとそれに付随するメッセージは次のとおりです。
エラーコード | ドメイン | 理由 |
---|---|---|
101 | com.google.ads.mediation.pangle | 無効なサーバー パラメータ(アプリ ID またはプレースメント ID がないなど)。 |
102 | com.google.ads.mediation.pangle | リクエストされた広告サイズが、Pangle でサポートされているバナーサイズと一致しません。 |
-1-60000 | Pangle SDK によって送信されました | Pangle SDK がエラーを返しました。詳しくは、Pangle のドキュメントをご覧ください。 |
Pangle iOS メディエーション アダプタの変更履歴
バージョン 6.3.0.8.0
- Pangle SDK バージョン 6.3.0.8 との互換性を検証しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 11.11.0。
- Pangle SDK バージョン 6.3.0.8.
バージョン 6.3.0.6.0
- Pangle SDK バージョン 6.3.0.6 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 11.11.0。
- Pangle SDK バージョン 6.3.0.6。
バージョン 6.2.0.9.0
- Pangle SDK バージョン 6.2.0.9 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 11.10.0。
- Pangle SDK バージョン 6.2.0.9。
バージョン 6.2.0.8.0
- Pangle SDK バージョン 6.2.0.8 との互換性を検証しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 11.10.0.
- Pangle SDK バージョン 6.2.0.8.
バージョン 6.2.0.7.0
- Pangle SDK バージョン 6.2.0.7 との互換性を検証しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 11.8.0。
- Pangle SDK バージョン 6.2.0.7。
バージョン 6.2.0.6.0
- Pangle SDK バージョン 6.2.0.6 との互換性を検証しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 11.8.0。
- Pangle SDK バージョン 6.2.0.6。
バージョン 6.2.0.5.0
- Pangle SDK バージョン 6.2.0.5 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 11.8.0.
- Pangle SDK バージョン 6.2.0.5。
バージョン 6.1.0.6.0
- Pangle SDK バージョン 6.1.0.6 との互換性が確認されました。
以下を使用してビルドとテストを行う:
- Google Mobile Ads SDK バージョン 11.7.0。
- Pangle SDK バージョン 6.1.0.6。
バージョン 6.1.0.5.0
- Pangle SDK バージョン 6.1.0.5 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 11.6.0。
- Pangle SDK バージョン 6.1.0.5。
バージョン 6.1.0.4.0
- Pangle SDK バージョン 6.1.0.4 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 11.6.0。
- Pangle SDK バージョン 6.1.0.4。
バージョン 6.0.0.6.0
- Pangle SDK バージョン 6.0.0.6 との互換性を検証しました。
以下を使用してビルドとテストを行う:
- Google Mobile Ads SDK バージョン 11.6.0.
- Pangle SDK バージョン 6.0.0.6。
バージョン 6.0.0.5.0
- Pangle SDK バージョン 6.0.0.5 との互換性が確認されました。
以下を使用してビルドとテストを行う:
- Google Mobile Ads SDK バージョン 11.5.0。
- Pangle SDK バージョン 6.0.0.5。
バージョン 6.0.0.4.0
- Pangle SDK バージョン 6.0.0.4 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 11.5.0。
- Pangle SDK バージョン 6.0.0.4。
バージョン 5.9.0.9.0
- Pangle SDK バージョン 5.9.0.9 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 11.5.0。
- Pangle SDK バージョン 5.9.0.9。
バージョン 5.9.0.8.0
- Pangle SDK バージョン 5.9.0.8 との互換性を確認しました。
以下を使用してビルドとテストを行う:
- Google Mobile Ads SDK バージョン 11.4.0。
- Pangle SDK バージョン 5.9.0.8。
バージョン 5.9.0.7.0
- Pangle SDK バージョン 5.9.0.7 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 11.3.0。
- Pangle SDK バージョン 5.9.0.7。
バージョン 5.8.0.8.0
- Pangle SDK バージョン 5.8.0.8 との互換性を確認しました。
- 新しい Pangle SDK シグナル収集 API を使用するようにアダプターを更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 11.2.0。
- Pangle SDK バージョン 5.8.0.8。
バージョン 5.8.0.7.0
- Pangle SDK バージョン 5.8.0.7 との互換性を検証しました。
- 現在は iOS バージョン 12.0 以降が必要です。
- Google Mobile Ads SDK バージョン 11.0 以降が必要になりました。
PangleAdapter.xcframework
内のフレームワークにInfo.plist
を含めました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 11.0.1。
- Pangle SDK バージョン 5.8.0.7。
バージョン 5.7.0.7.0
- Pangle SDK バージョン 5.7.0.7 との互換性が確認されました。
以下を使用してビルドとテストを行う:
- Google Mobile Ads SDK バージョン 10.14.0。
- Pangle SDK バージョン 5.7.0.7。
バージョン 5.7.0.6.0
- Pangle SDK バージョン 5.7.0.6 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 10.14.0。
- Pangle SDK バージョン 5.7.0.6。
バージョン 5.6.0.8.0
- Pangle SDK バージョン 5.6.0.8 との互換性を確認しました。
- 非推奨の
adConfiguration.childDirectedTreatment
プロパティを新しいGADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment
プロパティに置き換えて、+setCOPPA
メソッドをリファクタリングしました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 10.14.0.
- Pangle SDK バージョン 5.6.0.8。
バージョン 5.5.0.9.0
- Pangle SDK バージョン 5.5.0.9 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 10.13.0.
- Pangle SDK バージョン 5.5.0.9。
バージョン 5.5.0.7.0
- Pangle SDK バージョン 5.5.0.7 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 10.12.0。
- Pangle SDK バージョン 5.5.0.7。
バージョン 5.5.0.5.0
- Pangle SDK バージョン 5.5.0.5 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 10.11.0。
- Pangle SDK バージョン 5.5.0.5。
バージョン 5.4.1.1.0
- アプリ起動時広告フォーマットの入札サポートを追加しました。
- Pangle SDK バージョン 5.4.1.1 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 10.10.0.
- Pangle SDK バージョン 5.4.1.1。
バージョン 5.4.0.9.0
- Pangle SDK バージョン 5.4.0.9 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 10.9.0。
- Pangle SDK バージョン 5.4.0.9。
バージョン 5.4.0.8.0
GADPangleNetworkExtras
がGADAdNetworkExtras
プロトコルに準拠していない問題を修正しました。- インタースティシャル広告、リワード広告、アプリ起動時広告に
adDidShowFail
プロトコル メソッドを実装しました。 - Pangle SDK バージョン 5.4.0.8 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 10.9.0。
- Pangle SDK バージョン 5.4.0.8。
バージョン 5.3.1.2.0
- Pangle SDK バージョン 5.3.1.2 との互換性を検証しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 10.8.0。
- Pangle SDK バージョン 5.3.1.2。
バージョン 5.3.1.0.0
- Pangle SDK バージョン 5.3.1.0 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 10.8.0。
- Pangle SDK バージョン 5.3.1.0。
バージョン 5.2.1.1.0
- Pangle SDK バージョン 5.2.1.1 との互換性を検証しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 10.7.0。
- Pangle SDK バージョン 5.2.1.1。
バージョン 5.2.0.9.0
- Pangle SDK バージョン 5.2.0.9 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 10.5.0.
- Pangle SDK バージョン 5.2.0.9。
バージョン 5.2.0.8.0
- Pangle SDK バージョン 5.2.0.8 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 10.5.0。
- Pangle SDK バージョン 5.2.0.8。
バージョン 5.2.0.7.0
- アプリ起動時、バナー(MREC を含む)、インタースティシャル広告、リワード広告、ネイティブ広告フォーマットで、ウォーターフォールがサポートされるようになりました。
- Pangle SDK バージョン 5.2.0.7 との互換性が確認されました。
以下を使用してビルドとテストを行う:
- Google Mobile Ads SDK バージョン 10.5.0。
- Pangle SDK バージョン 5.2.0.7。
バージョン 5.2.0.6.0
- Pangle SDK バージョン 5.2.0.6 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 10.5.0。
- Pangle SDK バージョン 5.2.0.6。
バージョン 5.1.1.0.0
- Pangle SDK バージョン 5.1.1.0 との互換性を検証しました。
arm64
シミュレータ アーキテクチャのサポートを追加しました。- Google Mobile Ads SDK バージョン 10.4.0 以降が必要になりました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 10.4.0.
- Pangle SDK バージョン 5.1.1.0。
バージョン 5.1.0.6.0
- Pangle SDK バージョン 5.1.0.6 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 10.3.0.
- Pangle SDK バージョン 5.1.0.6。
バージョン 5.0.1.0.0
- Pangle SDK バージョン 5.0.1.0 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 10.2.0.
- Pangle SDK バージョン 5.0.1.0。
バージョン 5.0.0.8.0
- Pangle SDK バージョン 5.0.0.8 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 10.2.0。
- Pangle SDK バージョン 5.0.0.8。
バージョン 5.0.0.7.0
- Pangle SDK バージョン 5.0.0.7 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 10.1.0。
- Pangle SDK バージョン 5.0.0.7。
バージョン 5.0.0.6.0
- Pangle SDK バージョン 5.0.0.6 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 10.1.0。
- Pangle SDK バージョン 5.0.0.6。
バージョン 4.9.1.0.0
armv7
アーキテクチャのサポートを削除しました。- Pangle SDK バージョン 4.9.1.0 との互換性を検証しました。
- iOS の最小バージョンが 12.0 に引き上げられました。
- Google Mobile Ads SDK バージョン 10.0.0 以降が必要になりました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 10.0.0.
- Pangle SDK バージョン 4.9.1.0。
バージョン 4.9.0.8.0
- Pangle SDK バージョン 4.9.0.8 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 9.14.0。
- Pangle SDK バージョン 4.9.0.8。
バージョン 4.9.0.7.0
- Pangle SDK バージョン 4.9.0.7 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 9.14.0。
- Pangle SDK バージョン 4.9.0.7。
バージョン 4.9.0.6.0
- Pangle SDK バージョン 4.9.0.6 との互換性を確認しました。
以下を使用してビルドとテストを行う:
- Google Mobile Ads SDK バージョン 9.14.0。
- Pangle SDK バージョン 4.9.0.6。
バージョン 4.8.1.0.0
- Pangle SDK バージョン 4.8.1.0 との互換性を検証しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 9.14.0。
- Pangle SDK バージョン 4.8.1.0。
バージョン 4.8.0.9.0
- Pangle SDK バージョン 4.8.0.9 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 9.13.0。
- Pangle SDK バージョン 4.8.0.9。
バージョン 4.8.0.7.0
- Pangle SDK バージョン 4.8.0.7 との互換性を確認しました。
以下を使用してビルドとテストを行う:
- Google Mobile Ads SDK バージョン 9.13.0。
- Pangle SDK バージョン 4.8.0.7。
バージョン 4.8.0.6.0
- Pangle SDK バージョン 4.8.0.6 との互換性が確認されました。
- ネイティブ広告アイコン画像の読み込み時にメインスレッドがブロックされる問題を修正しました。
以下を使用してビルドとテストを行う:
- Google Mobile Ads SDK バージョン 9.13.0。
- Pangle SDK バージョン 4.8.0.6。
バージョン 4.7.0.7.0
- Pangle SDK バージョン 4.7.0.7 との互換性が確認されました。
以下を使用してビルドとテストを行う:
- Google Mobile Ads SDK バージョン 9.11.0。
- Pangle SDK バージョン 4.7.0.7。
バージョン 4.7.0.6.0
- Pangle SDK バージョン 4.7.0.6 との互換性を検証しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 9.11.0。
- Pangle SDK バージョン 4.7.0.6。
バージョン 4.7.0.5.0
- Pangle SDK バージョン 4.7.0.5 との互換性が確認されました。
以下を使用してビルドとテストを行う:
- Google Mobile Ads SDK バージョン 9.11.0。
- Pangle SDK バージョン 4.7.0.5。
バージョン 4.7.0.4.0
- Pangle SDK バージョン 4.7.0.4 との互換性が確認されました。
以下を使用してビルドとテストを行う:
- Google Mobile Ads SDK バージョン 9.10.0.
- Pangle SDK バージョン 4.7.0.4。
バージョン 4.6.2.2.0
GADMediationAdapterPangle
クラスのsetGDPR()
メソッドとsetCCPA()
メソッドの名前を、それぞれsetGDPRConsent()
とsetDoNotSell
に変更しました。- Pangle SDK バージョン 4.6.2.2 との互換性を確認しました。
以下を使用してビルドとテストを行う:
- Google Mobile Ads SDK バージョン 9.10.0。
- Pangle SDK バージョン 4.6.2.2。
バージョン 4.6.1.8.0
- Pangle SDK バージョン 4.6.1.8 との互換性を確認しました。
- ネイティブ広告フォーマットの入札サポートを追加しました。
didRewardUser
API を使用するようにアダプターを更新しました。- Google Mobile Ads SDK バージョン 9.8.0 以降が必要になりました。
以下を使用してビルドとテストを行う:
- Google Mobile Ads SDK バージョン 9.9.0。
- Pangle SDK バージョン 4.6.1.8.
バージョン 4.5.2.8.0
- Pangle SDK バージョン 4.5.2.8 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 9.7.0。
- Pangle SDK バージョン 4.5.2.8。
バージョン 4.5.2.7.0
- Pangle SDK バージョン 4.5.2.7 との互換性を検証しました。
以下を使用してビルドとテストを行う:
- Google Mobile Ads SDK バージョン 9.7.0。
- Pangle SDK バージョン 4.5.2.7。
バージョン 4.5.2.5.0
- Pangle SDK バージョン 4.5.2.5 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 9.6.0.
- Pangle SDK バージョン 4.5.2.5。
バージョン 4.5.2.4.0
- Pangle SDK バージョン 4.5.2.4 との互換性を確認しました。
以下を使用してビルドとテストを行う:
- Google Mobile Ads SDK バージョン 9.6.0。
- Pangle SDK バージョン 4.5.2.4。
バージョン 4.5.2.3.0
- Pangle SDK バージョン 4.5.2.3 との互換性が確認されました。
以下を使用してビルドとテストを行う:
- Google Mobile Ads SDK バージョン 9.6.0.
- Pangle SDK バージョン 4.5.2.3。
バージョン 4.5.1.3.0
- Pangle SDK バージョン 4.5.1.3 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 9.5.0。
- Pangle SDK バージョン 4.5.1.3。
バージョン 4.3.1.9.0
- Pangle SDK バージョン 4.3.1.9 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 9.3.0。
- Pangle SDK バージョン 4.3.1.9。
バージョン 4.3.0.5.0
- Pangle SDK バージョン 4.3.0.5 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 9.2.0。
- Pangle SDK バージョン 4.3.0.5。
バージョン 4.3.0.4.0
- 初回リリース
- バナー(MREC を含む)、インタースティシャル広告、リワード広告フォーマットの入札サポートが追加されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 9.1.0。
- Pangle SDK バージョン 4.3.0.4。