このガイドでは、Google Mobile Ads SDK で、メディエーションを使用して ironSource の広告から広告を読み込んで表示し、ウォーターフォールの統合を行う方法について説明します。ironSource Ads を広告ユニットのメディエーション設定に追加する方法と、ironSource Ads SDK とアダプタをアプリに統合する方法について説明します。 Unity
サポートされている統合と広告フォーマット
ironSource Ads 用の Ad Manager メディエーション アダプタには、次のような機能があります。
インテグレーション | ||
---|---|---|
入札 | 1 | |
ウォーターフォール | ||
フォーマット | ||
バナー | 2 | |
インタースティシャル | ||
特典 | ||
リワード インタースティシャル | 2 |
要件
- 最新の Google Mobile Ads SDK
- Unity 4 以降
- Android にデプロイするには
- Android API レベル 21 以降
- iOS にデプロイするには
- iOS デプロイ ターゲットが 12.0 以降であること
- Google Mobile Ads SDK で構成された Unity 作業中のプロジェクト。詳しくは、使ってみるをご覧ください。
- メディエーションのスタートガイドを完了している。
ステップ 1: ironSource Ads UI で設定をセットアップする
ironSource の広告アカウントに登録してログインします。
アプリケーションを ironSource Ads ダッシュボードに追加するには、[New App] ボタンをクリックします。
アプリの詳細を入力
[Live App] を選択し、アプリの URL を入力して [Import App Info] をクリックします。
アプリが利用できない場合は、[App Not Live in the Application Store] を選択し、アプリの仮名を指定します。プラットフォームを選択します。
フォームの残りの部分に記入し、[Add App] をクリックします。
アプリを追加した後に表示される新しいアプリキーをメモしておきます。この値は、Ad Manager 広告ユニット ID を設定する際に必要になります。アプリがサポートする広告フォーマットを選択します。その後、[続行] をクリックします。
Android
iOS
インスタンスを作成
次に、追加したアプリのネットワーク インスタンスを構成します。
[Ads] > [Setup] > [Instances] に移動します。アプリを選択して、[インスタンスを作成] をクリックします。
必要な詳細情報を入力し、[保存して閉じる] をクリックします。
インスタンスが作成されると、インスタンス ID が [インスタンス ID] フィールドに表示されます。
Reporting API キーを確認する
Ad Manager 広告ユニット ID を設定するには、アプリキーとインスタンス ID に加えて、ironSource 広告の秘密鍵と更新トークンも必要です。
ironSource 広告パブリッシャー ダッシュボードの [My Account] に移動し、[API] タブをクリックします。秘密鍵と更新トークンをメモしておきます。
テストモードをオンにする
ironSource Ads のテスト広告を有効にする方法については、ironSource Ads の統合テスト ガイドをご覧ください。
ステップ 2: 管理画面で ironSource の広告デマンドを設定する Ad Manager
広告ユニットのメディエーション設定を行う
GDPR と米国の州規制の広告パートナー リストに ironSource Mobile 追加
GDPR 設定 米国の州規制の設定 の手順に沿って、 Ad Manager UI の GDPR および米国の州規制の広告パートナーのリストに ironSource Mobile を追加します。
ステップ 3: ironSource Ads SDK とアダプタをインポートする
変更履歴のダウンロード リンクから、ironSource Ads 用の Google モバイル広告メディエーション プラグインの最新バージョンをダウンロードし、zip ファイルから GoogleMobileAdsIronSourceMediation.unitypackage
を抽出します。
Unity プロジェクト エディタで、[Assets] > [Import Package] > [Custom Package] を選択し、ダウンロードした GoogleMobileAdsIronSourceMediation.unitypackage
ファイルを見つけます。すべてのファイルのチェックボックスがオンになっていることを確認して、[Import](インポート)をクリックします。
次に、[Assets] > [Play Services Resolver] > [Android Resolver] > [Force Resolve] を選択します。Unity Play 開発者サービス リゾルバ ライブラリは、依存関係の解決をゼロから実行し、宣言された依存関係を Unity アプリの Assets/Plugins/Android
ディレクトリにコピーします。
ステップ 4: ironSource Ads SDK にプライバシー設定を実装する
EU の同意と GDPR
Google の EU ユーザーの同意ポリシーに基づき、デベロッパーは、デバイス ID および個人データの使用に関して欧州経済領域(EEA)のユーザーに対し特定の開示を行い、ユーザーから同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則(GDPR)の要件が反映されています。同意を求める際は、個人データを収集、受信、または使用する可能性があるメディエーション チェーンの各広告ネットワークを特定し、各ネットワークの使用に関する情報を提供する必要があります。Google は現在、同意に関するユーザーの選択をそのようなネットワークに自動的に渡すことはできません。
ironSource Ads 用の Google モバイル広告メディエーション プラグイン
バージョン 1.0.0
には、
IronSource.SetConsent()
メソッドが含まれています。次のサンプルコードは、同意情報を ironSource Ads SDK に渡す方法を示しています。このメソッドを呼び出す場合は、Google Mobile Ads SDK を使用して広告をリクエストする前に、呼び出すことをおすすめします。
using GoogleMobileAds.Api.Mediation.IronSource;
// ...
IronSource.SetConsent(true);
詳しくは、ironSource Ads のドキュメントで規制の詳細設定をご覧ください。
米国のプライバシー関連州法
米国のプライバシー関連州法 では、ユーザーに対して「個人情報」の「販売」をオプトアウトする権利(法律で定義される)を提供し、「販売」当事者のホームページに目立つ「個人情報を販売しない」リンクを通じてオプトアウトする権利を提供することが義務付けられています。米国のプライバシー関連州法の遵守ガイドでは、Google 広告配信で制限付きデータ処理を有効にすることができますが、メディエーション チェーン内の各広告ネットワークにこの設定を適用することはできません。そのため、個人情報の販売に参加する可能性があるメディエーション チェーンの各広告ネットワークを特定し、各ネットワークのガイダンスに従ってコンプライアンスを確保する必要があります。
ironSource Ads 用の Google モバイル広告メディエーション プラグイン
バージョン 2.2.4
には、
IronSource.SetMetaData()
メソッドが含まれています。次のサンプルコードは、同意情報を ironSource Ads SDK に渡す方法を示しています。ironSource Ads SDK に適切に転送されるように、Google Mobile Ads SDK を初期化する前に、これらのオプションを設定する必要があります。
using GoogleMobileAds.Api.Mediation.IronSource;
// ...
IronSource.SetMetaData("do_not_sell", "true");
詳細およびメソッドで指定できる値については、Android と iOS の規則の詳細設定に関する ironSource Ads のドキュメントをご覧ください。
ステップ 5: 必要なコードを追加する
Android
ProGuard ルール
アプリの圧縮、難読化、最適化を行う場合、IronSource Ads では、プロジェクトに追加の ProGuard ルールが必要です。
プロジェクトをビルドする際に、[Platform] として [Android] を選択します。次に、[Player Settings] を開き、[Publishing Settings] タブの [User Proguard File] を確認します。変更用のカスタム proguard-user.txt
ファイルが作成された場所が表示されます。
プロジェクトで必要な ProGuard ルールの詳細について、IronSource Ads の Android SDK 統合ガイドを参照し、そのルールを proguard-user.txt
ファイルに追加します。
iOS
SKAdNetwork との統合
ironSource Ads のドキュメントに沿って、SKAdNetwork 識別子をプロジェクトの Info.plist
ファイルに追加します。
ステップ 6: 実装をテストする
テスト広告を有効にする
Ad Manager にテストデバイスを登録し、 ironSource UI でテストモードを有効にします。
テスト広告を確認する
ironSourceからテスト広告を受信していることを確認するには、広告インスペクタで ironSource (Waterfall) 広告ソースを使用して単独の広告ソースのテストを有効にします。
エラーコード
アダプタが ironSource Ads から広告を受信できない場合、パブリッシャーは、次のクラスの ResponseInfo
を使用して、広告レスポンスから根本的なエラーを確認できます。
Android
com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter
iOS
GADMAdapterIronSource
GADMAdapterIronSourceRewarded
広告の読み込みに失敗したときに ironSource Ads アダプタがスローするコードとそのメッセージは次のとおりです。
Android
エラーコード | 理由 |
---|---|
101 | UI に設定されている Ad Manager ironSource 広告サーバーのパラメータがないか、無効です。 |
102 | ironSource Ads では、SDK を初期化するために Activity コンテキストが必要です。 |
103 | ironSource 広告は、ironSource インスタンス ID ごとに 1 つの広告しかロードできません。 |
105 | リクエストされたバナー広告のサイズは、ironSource 広告でサポートされていません。 |
106 | ironSource Ads SDK が初期化されていません。 |
501-1056 | ironSource Ads SDK エラー。詳しくは、ドキュメントをご覧ください。 |
iOS
エラーコード | 理由 |
---|---|
101 | UI に設定されている Ad Manager ironSource 広告サーバーのパラメータがないか、無効です。 |
102 | ironSource の広告アダプタは、リクエストされた広告フォーマットをサポートしていません。 |
103 | ironSource 広告はこのネットワーク設定用にすでに読み込まれています。 |
104 | リクエストされたバナー広告のサイズは、ironSource 広告でサポートされていません。 |
508-1037 | ironSource Ads SDK エラー。詳しくは、ドキュメントをご覧ください。 |
IronSource Unity メディエーション プラグインの変更履歴
バージョン 3.1.0
- IronSource Android アダプター バージョン 8.1.0.0 をサポートします。
- IronSource iOS アダプター バージョン 8.1.0.0.1 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 9.1.0 でビルド、テストされています。
バージョン 3.0.1
- IronSource Android アダプター バージョン 8.0.0.1 をサポートします。
- IronSource iOS アダプター バージョン 8.0.0.0.1 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 9.1.0 でビルド、テストされています。
バージョン 3.0.0
- IronSource Android アダプター バージョン 8.0.0.0 をサポートします。
- IronSource iOS アダプター バージョン 8.0.0.0.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 9.0.0 でビルド、テストされています。
バージョン 2.6.1
- IronSource Android アダプター バージョン 7.9.0.0 をサポートします。
- IronSource iOS アダプター バージョン 7.9.1.0.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 9.0.0 でビルド、テストされています。
バージョン 2.6.0
- IronSource Android アダプター バージョン 7.9.0.0 をサポートします。
- IronSource iOS アダプター バージョン 7.9.0.0.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 9.0.0 でビルド、テストされています。
バージョン 2.5.0
- IronSource Android アダプター バージョン 7.6.0.0 をサポートします。
- IronSource iOS アダプター バージョン 7.6.0.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 8.6.0 でビルド、テストされています。
バージョン 2.4.0
- IronSource Android アダプター バージョン 7.5.2.0 をサポートします。
- IronSource iOS アダプター バージョン 7.5.1.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 8.6.0 でビルド、テストされています。
バージョン 2.3.1
- IronSource Android アダプター バージョン 7.3.1.0 をサポートします。
- IronSource iOS アダプター バージョン 7.3.1.0.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 8.3.0 でビルド、テストされています。
バージョン 2.3.0
- アダプターのコンテンツを
GoogleMobileAds/Mediation/IronSource/
に移動しました。 GoogleMobileAds.Mediation.IronSource
を使用するようにアダプターの名前空間をリファクタリングしました。- IronSource Android アダプター バージョン 7.3.0.1.0 をサポートします。
- IronSource iOS アダプター バージョン 7.3.0.0.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 8.1.0 でビルド、テストされています。
バージョン 2.2.7
- IronSource Android アダプター バージョン 7.2.7.0 をサポートします。
- IronSource iOS アダプター バージョン 7.2.7.0.1 をサポートします。
- Google Mobile Ads Unity Plugin バージョン 7.4.1 でビルド、テストされていること。
バージョン 2.2.6
- IronSource Android アダプター バージョン 7.2.6.0 をサポートします。
- IronSource iOS アダプター バージョン 7.2.6.0.0 をサポートします。
- Google Mobile Ads Unity Plugin バージョン 7.3.1 でビルド、テストされていること。
バージョン 2.2.5
- IronSource Android アダプター バージョン 7.2.5.0 をサポートします。
- IronSource iOS アダプター バージョン 7.2.5.1.0 をサポートします。
- Google Mobile Ads Unity Plugin バージョン 7.3.0 でビルド、テストされていること。
バージョン 2.2.4
IronSource.SetMetaData(string, string)
メソッドを追加しました。- IronSource Android アダプター バージョン 7.2.3.1.0 をサポートします。
- IronSource iOS アダプター バージョン 7.2.4.0 をサポートします。
- Google Mobile Ads Unity Plugin バージョン 7.2.0 でビルド、テストされていること。
バージョン 2.2.3
- IronSource Android アダプター バージョン 7.2.3.1.0 をサポートします。
- IronSource iOS アダプター バージョン 7.2.3.1.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 7.1.0 でビルド、テストされています。
バージョン 2.2.2
- IronSource Android アダプター バージョン 7.2.2.1.0 をサポートします。
- IronSource iOS アダプター バージョン 7.2.2.1.0 をサポートします。
- Google Mobile Ads Unity Plugin バージョン 7.0.2 でビルド、テストされていること。
バージョン 2.2.1
- IronSource Android アダプター バージョン 7.2.1.1.0 をサポートします。
- IronSource iOS アダプター バージョン 7.2.1.2.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 7.0.0 でビルド、テストされています。
バージョン 2.2.0
- IronSource Android アダプター バージョン 7.2.1.0 をサポートします。
- IronSource iOS アダプター バージョン 7.2.1.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 7.0.0 でビルド、テストされています。
バージョン 2.1.5
- IronSource Android アダプター バージョン 7.1.14.0 をサポートします。
- IronSource iOS アダプター バージョン 7.1.14.0 をサポートします。
バージョン 2.1.4
- IronSource Android アダプター バージョン 7.1.13.0 をサポートします。
- IronSource iOS アダプター バージョン 7.1.13.0 をサポートします。
バージョン 2.1.3
- IronSource Android アダプター バージョン 7.1.12.0 をサポートします。
- IronSource iOS アダプター バージョン 7.1.12.0 をサポートします。
バージョン 2.1.2
- IronSource Android アダプター バージョン 7.1.11.1.0 をサポートします。
- IronSource iOS アダプター バージョン 7.1.11.1.0 をサポートします。
バージョン 2.1.1
- IronSource Android アダプター バージョン 7.1.8.0 をサポートします。
- IronSource iOS アダプター バージョン 7.1.8.0 をサポートします。
バージョン 2.1.0
- IronSource Android アダプター バージョン 7.1.6.0 をサポートします。
- IronSource iOS アダプター バージョン 7.1.6.1.0 をサポートします。
バージョン 2.0.3
- IronSource Android アダプター バージョン 7.0.3.1.0 をサポートします。
- IronSource iOS アダプター バージョン 7.0.3.0 をサポートします。
バージョン 2.0.2
- IronSource Android アダプター バージョン 7.0.2.0 をサポートします。
- IronSource iOS アダプター バージョン 7.0.2.0 をサポートします。
バージョン 2.0.1
- IronSource Android アダプター バージョン 7.0.1.1.0 をサポートします。
- IronSource iOS アダプター バージョン 7.0.1.0 をサポートします。
バージョン 2.0.0
- IronSource Android アダプター バージョン 7.0.0.0 をサポートします。
- IronSource iOS アダプター バージョン 7.0.0.0 をサポートします。
バージョン 1.10.0
- IronSource Android アダプター バージョン 6.18.0.0 をサポートします。
- IronSource iOS アダプター バージョン 6.18.0.0 をサポートします。
バージョン 1.9.1
- IronSource Android アダプター バージョン 6.17.0.1 をサポートします。
- IronSource iOS アダプター バージョン 6.17.0.1.0 をサポートします。
バージョン 1.9.0
- IronSource Android アダプター バージョン 6.17.0.0 をサポートします。
- IronSource iOS アダプター バージョン 6.16.3.0 をサポートします。
バージョン 1.8.2
- IronSource Android アダプター バージョン 6.16.2.0 をサポートします。
- IronSource iOS アダプター バージョン 6.16.2.0 をサポートします。
バージョン 1.8.1
- IronSource Android アダプター バージョン 6.16.1.0 をサポートします。
- IronSource iOS アダプター バージョン 6.16.1.0 をサポートします。
バージョン 1.8.0
- IronSource Android アダプター バージョン 6.16.0.0 をサポートします。
- IronSource iOS アダプター バージョン 6.16.0.0 をサポートします。
バージョン 1.7.0
- IronSource Android アダプター バージョン 6.15.0.1.0 をサポートします。
- IronSource iOS アダプター バージョン 6.15.0.1.0 をサポートします。
バージョン 1.6.0
- IronSource Android アダプター バージョン 6.14.0.1.0 をサポートします。
- IronSource iOS アダプター バージョン 6.14.0.0 をサポートします。
バージョン 1.5.0
- IronSource Android アダプター バージョン 6.13.0.1.0 をサポートします。
- IronSource iOS アダプター バージョン 6.13.1.0.0 をサポートします。
バージョン 1.4.0
- IronSource Android アダプター バージョン 6.12.0.0 をサポートします。
- IronSource iOS アダプター バージョン 6.12.0.0 をサポートします。
バージョン 1.3.2
- IronSource Android アダプター バージョン 6.10.0.0 をサポートします。
- IronSource iOS アダプター バージョン 6.8.7.0 をサポートします。
バージョン 1.3.1
- IronSource Android アダプター バージョン 6.10.0.0 をサポート
- IronSource iOS アダプター バージョン 6.8.6.0 をサポート
バージョン 1.3.0
- IronSource Android アダプター バージョン 6.10.0.0 をサポート
- IronSource iOS アダプター バージョン 6.8.4.1.0 をサポート
バージョン 1.2.0
- IronSource Android アダプター バージョン 6.9.0.1 をサポート
- IronSource iOS アダプター バージョン 6.8.4.1.0 をサポート
バージョン 1.1.2
- IronSource Android アダプター バージョン 6.8.4.1 をサポート
- IronSource iOS アダプター バージョン 6.8.4.1 をサポート
バージョン 1.1.1
- IronSource Android アダプター バージョン 6.8.4.1 をサポート
- IronSource iOS アダプター バージョン 6.8.3.0 をサポート
バージョン 1.1.0
- 新しいオープンベータ版の リワード API をサポートするようプラグインを更新しました。
- IronSource Android アダプター バージョン 6.8.1.2 をサポート
- IronSource iOS アダプター バージョン 6.8.0.1 をサポート
バージョン 1.0.4
- IronSource Android アダプター バージョン 6.7.11.0 をサポート
- IronSource iOS アダプター バージョン 6.7.11.0 をサポート
バージョン 1.0.3
- IronSource Android アダプター バージョン 6.7.10.0 をサポート
- IronSource iOS アダプター バージョン 6.7.10.0 をサポート
バージョン 1.0.2
- IronSource Android アダプター バージョン 6.7.9.1.1 をサポート
- IronSource iOS アダプター バージョン 6.7.10.0 をサポート
- Chartboost Unity メディエーション プラグインとの競合を修正しました。
バージョン 1.0.1
- IronSource Android アダプター バージョン 6.7.9.0 をサポートします。
- IronSource iOS アダプター バージョン 6.7.9.2.0 をサポートします。
バージョン 1.0.0
- 初リリース
- IronSource Android アダプター バージョン 6.7.9.0 をサポートします。
- IronSource iOS アダプター バージョン 6.7.9.1.0 をサポートします。