このガイドでは、Google Mobile Ads SDK を使用して メディエーションで Moloco の広告を読み込んで表示する方法を説明します。入札統合についても説明します。このガイドでは、広告ユニットのメディエーション設定に Moloco を追加する方法と、Moloco SDK とアダプタを iOS アプリに統合する方法について説明します。
サポートされている統合と広告フォーマット
Moloco のメディエーション アダプタには、次の機能があります。
| 統合 | |
|---|---|
| 入札単価 | |
| 滝 | |
| フォーマット | |
| アプリの起動 | |
| バナー | |
| インタースティシャル | |
| 特典 | |
| リワード インタースティシャル | |
| ネイティブ | |
要件
iOS のデプロイ ターゲットが 12.0 以降
Moloco アダプタ 3.9.1.0 以降
最新の Google Mobile Ads SDK
メディエーションのスタートガイドの手順を完了していること。
ステップ 1: Moloco UI で設定を行う
Moloco パブリッシャー ポータルにログインします。
[概要] > [アプリ] タブに移動し、[アプリを追加] ボタンをクリックして新しいアプリを作成します。
アプリの [OS] と [プライバシー設定] を選択し、フォームの残りの部分を入力して、[作成] をクリックします。
アプリを作成したら、[アプリ] タブからアプリを選択して詳細を表示し、アプリキーをメモします。
[概要] > [広告ユニット] タブに移動し、プルダウン メニューからアプリを選択して、[新しい広告ユニット] をクリックします。
[オークション方法] で [アプリ内入札] を選択し、フォームの残りの部分を入力します。次に、[作成] をクリックします。
[広告ユニット] タブで、新しく作成した広告ユニットに移動して詳細を表示します。広告ユニット ID をメモします。
ステップ 2: アド マネージャーの UI で Moloco のデマンドを設定する
アド マネージャー アカウントにログインします。
セキュア シグナルの共有を有効にする
[管理者] > [全般設定] に移動します。[Ad Exchange アカウントの設定] タブに移動し、[セキュア シグナルの共有] を確認してオンに切り替えます。[保存] をクリックします。
入札リクエストでセキュア シグナルを共有する
[インベントリ] > [セキュア シグナル] に移動します。[セキュア シグナル] で、[Moloco Ads SDK] を検索し、[アプリ統合を有効にする] をオンにします。
[保存] をクリックします。
SDK 入札でセキュア シグナルの共有を許可する
[配信] > [デマンド チャネルの設定] に移動します。[デフォルト設定] タブで、[SDK ビッディング] の [セキュア シグナルの共有を許可する] をオンにします。
[保存] をクリックします。
Moloco の入札単価を設定する
[配信] > [入札者（ビッダー）] に移動し、[SDK 入札に移動] をクリックします。
[新しいビッダー] をクリックします。
入札者として [Moloco Ads] を選択します。
[続行] をクリックして、このビッダーの SDK 入札を有効にします。
[完了] をクリックします。
広告ユニットのマッピングを設定する
[配信] > [入札者（ビッダー）] に移動し、[SDK 入札に移動] をクリックします。
Moloco Ads SDK の会社を選択します。
[広告ユニットのマッピング] タブに移動し、[新しい広告ユニットのマッピング] をクリックします。
[特定の広告ユニット] を選択します。広告ユニットとフォーマット、[広告枠のタイプ] で [モバイルアプリ]、[モバイルアプリ] を選択します。次に、前のセクションで取得したアプリキーと広告ユニット ID を入力します。
最後に、[保存] をクリックします。
欧州および米国の州の規制に関する広告パートナーのリストに Moloco Ads を追加
欧州の規制に関する設定と米国の州の規制に関する設定の手順に沿って、アド マネージャーの管理画面で欧州と米国の州の規制に関する広告パートナーのリストに Moloco Ads を追加します。
ステップ 3: Moloco SDK とアダプタをインポートする
CocoaPods を使用する（推奨）
プロジェクトの Podfile に次の行を追加します。
pod 'GoogleMobileAdsMediationMoloco'コマンドラインから次のコマンドを実行します。
pod install --repo-update
ステップ 4: Moloco SDK でプライバシー設定を実装する
EU ユーザーの同意と GDPR
Google の EU ユーザーの同意ポリシーを遵守するため、欧州経済領域（EEA）、英国、スイスのユーザーに対して特定の情報を開示し、Cookie などのローカル ストレージの使用に対するユーザーの同意（法律で義務付けられている場合）、および広告のパーソナライズを目的とした個人データの収集、共有、使用に対するユーザーの同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則（GDPR）の要件が反映されています。同意がメディエーション チェーン内の各広告ソースに伝播されていることを確認する責任はお客様にあります。Google は、ユーザーの同意の選択をこのようなネットワークに自動的に渡すことはできません。
Moloco SDK には、同意情報を Moloco SDK に渡すための hasUserConsent フラグが含まれています。
次のサンプルコードは、同意情報を Moloco SDK に渡す方法を示しています。これらのフラグを設定する場合は、Google Mobile Ads SDK を通じて広告をリクエストする前に設定することをおすすめします。
Swift
import MolocoSDK
// ...
MolocoPrivacySettings.hasUserConsent = true;
Objective-C
#import <MolocoSDK/MolocoSDK-Swift.h>
// ...
[MolocoPrivacySettings setHasUserConsent:YES];
詳しくは、Moloco のプライバシーに関するドキュメントをご覧ください。
米国のプライバシー関連州法
米国の州のプライバシーに関する法律では、ユーザーが「個人情報」の「販売」を拒否する権利を付与することが義務付けられています（用語は法律の定義に基づく）。「販売者」のホームページには、「個人情報を第三者に売却しない」ことを明記したリンクを目立つように表示することによってオプトアウトの手段を提供する必要があります。米国の州のプライバシー関連州法遵守ガイドでは、Google 広告配信で制限付きデータ処理を有効にできますが、この設定をメディエーション チェーン内の各広告ネットワークに適用することはできません。そのため、メディエーション チェーンで個人情報の販売に関与する可能性のある各広告ネットワークを特定し、各ネットワークのガイダンスに沿ってコンプライアンスを確保する必要があります。
Moloco SDK には、同意情報を Moloco SDK に渡すための isDoNotSell フラグが含まれています。
次のサンプルコードは、同意情報を Moloco SDK に渡す方法を示しています。これらのフラグを設定する場合は、Google Mobile Ads SDK を通じて広告をリクエストする前に設定することをおすすめします。
Swift
import MolocoSDK
// ...
MolocoPrivacySettings.isDoNotSell = true;
Objective-C
#import <MolocoSDK/MolocoSDK-Swift.h>
// ...
[MolocoPrivacySettings setIsDoNotSell:YES];
詳しくは、Moloco のプライバシーに関するドキュメントをご覧ください。
ステップ 5: 実装をテストする
テスト広告を有効にする
アド マネージャーでテストデバイスを登録してください。
テスト広告を確認する
Moloco Ads SDK からテスト広告を受け取っていることを確認するには、Moloco（入札）の広告ソースを使用して、広告インスペクタで単一の広告ソースのテストを有効にします。
エラーコード
アダプタが Moloco から広告を受信できなかった場合は、次のクラスの GADResponseInfo.adNetworkInfoArray を使用して、広告レスポンスから根本原因のエラーを確認できます。
MolocoSDK.MolocoError
GADMediationAdapterMoloco
広告の読み込みに失敗した場合に Moloco アダプタがスローするコードとメッセージは次のとおりです。
| エラーコード | ドメイン | 理由 |
|---|---|---|
| 101 | com.google.ads.mediation.moloco | Moloco SDK は、iOS 12 以前での広告配信をサポートしていません。 |
| 102 | com.google.ads.mediation.moloco | Moloco アプリキーがないか、無効です。 |
| 103 | com.google.ads.mediation.moloco | Moloco 広告ユニット ID がないか、無効です。 |
| 104 | com.google.ads.mediation.moloco | 広告を表示する準備ができていません。 |
| 105 | com.google.ads.mediation.moloco | 広告が表示されませんでした。 |
| 106 | com.google.ads.mediation.moloco | 広告をレンダリングするためのレンダリング データがありません。 |
| -1 ～ 5000 | Moloco SDK によって送信 | Moloco SDK がエラーを返しました。詳しくは、Moloco のドキュメントをご覧ください。 |
リワードのサーバーサイド検証
サーバーサイド認証（SSV）コールバックを検証する場合、Moloco の広告ソース ID は 8267622065755668722 です。
Moloco iOS メディエーション アダプタの変更履歴
バージョン 3.12.0.0
- Moloco SDK バージョン 3.12.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 12.8.0。
- Moloco SDK バージョン 3.12.0。
バージョン 3.11.0.0
- Moloco SDK バージョン 3.11.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 12.6.0。
- Moloco SDK バージョン 3.11.0。
バージョン 3.10.1.0
- Moloco SDK バージョン 3.10.1 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 12.6.0。
- Moloco SDK バージョン 3.10.1。
バージョン 3.10.0.0
- Moloco SDK バージョン 3.10.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 12.5.0。
- Moloco SDK バージョン 3.10.0。
バージョン 3.9.1.0
- 入札広告フォーマットの透かしのサポートを追加しました。
- MREC バナー広告の読み込みに関する問題を修正しました。
- Moloco SDK バージョン 3.9.1 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 12.3.0。
- Moloco SDK バージョン 3.9.1。
バージョン 3.9.0.0
- Moloco SDK の初期化時にメディエーション プラットフォーム名が設定されるようになりました。
- Moloco SDK バージョン 3.9.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 12.3.0。
- Moloco SDK バージョン 3.9.0。
バージョン 3.8.0.0
-fobjc-arcフラグと-fstack-protector-allフラグを有効にしました。- ネイティブ広告の星評価の取得に関する問題を修正しました。
- Moloco SDK バージョン 3.8.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 12.2.0。
- Moloco SDK バージョン 3.8.0。
バージョン 3.7.2.0
- Moloco SDK バージョン 3.7.2 との互換性を確認しました。
- ネイティブ広告フォーマットの入札サポートを追加しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 12.1.0。
- Moloco SDK バージョン 3.7.2。
バージョン 3.7.1.0
- Moloco SDK バージョン 3.7.1 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 12.1.0。
- Moloco SDK バージョン 3.7.1。
バージョン 3.7.0.0
- Moloco SDK バージョン 3.7.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 12.0.0。
- Moloco SDK バージョン 3.7.0。
バージョン 3.6.0.1
- メインスレッドから Moloco SDK のバージョンを取得するようにアダプタを更新しました。
- Google Mobile Ads SDK バージョン 12.0.0 以降が必要になりました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 12.0.0。
- Moloco SDK バージョン 3.6.0。
バージョン 3.6.0.0
- Moloco SDK バージョン 3.6.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 11.13.0。
- Moloco SDK バージョン 3.6.0。
バージョン 3.5.0.0
- 初回リリース。
- バナー（MREC を含む）、インタースティシャル、リワードの広告フォーマットの入札サポートを追加しました。
- Moloco SDK バージョン 3.5.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 11.13.0。
- Moloco SDK バージョン 3.5.0。