ironSource をメディエーションと統合する

このガイドでは、Google Mobile Ads SDK を使用して、ウォーターフォール統合をカバーするメディエーションを使用して、ironSource から広告を読み込んで表示する方法について説明します。ironSource を広告ユニットのメディエーション設定に追加する方法と、ironSource SDK とアダプタを Unity アプリに統合する方法について説明します。

サポートされている統合と広告フォーマット

AdMob ironSource 用メディエーション アダプタには次の機能があります。

統合
入札
ウォーターフォール
フォーマット
バナー
インタースティシャル
特典
リワード インタースティシャル

要件

  • 最新の Google Mobile Ads SDK
  • Unity 4 以降
  • Android にデプロイするには
    • Android API レベル 21 以降
  • iOS にデプロイする場合
    • iOS デプロイ ターゲットが 12.0 以降であること
  • Google Mobile Ads SDK で構成された Unity 作業中のプロジェクト詳しくは、使ってみるをご覧ください。
  • メディエーションのスタートガイドを完了する

ステップ 1: ironSource UI で構成をセットアップする

ironSource アカウントに登録してログインします。

アプリケーションを ironSource ダッシュボードに追加するには、[New App] ボタンをクリックします。

アプリの詳細を入力

[Live App] を選択し、アプリの URL を入力して [Import App Info] をクリックします。

アプリが利用できない場合は、[App Not Live in the Application Store] を選択し、アプリの仮名を指定します。プラットフォームを選択します。

フォームの残りの部分に記入し、[Add App] をクリックします。

アプリが追加された後に表示される新しいアプリキーをメモしておきます。この値は、AdMob 広告ユニット ID を設定する際に必要になります。アプリがサポートする広告フォーマットを選択します。その後、[続行] をクリックします。

Android

iOS

インスタンスを作成する

次に、追加したアプリのネットワーク インスタンスを構成します。ironSource は、リワード広告とインタースティシャル広告に対して複数のネットワーク インスタンスをサポートします。

[Ads] > [Setup] > [Instances] に移動します。アプリを選択して、[インスタンスを作成] をクリックします。

必要な詳細情報を入力し、[保存して閉じる] をクリックします。

インスタンスが作成されると、インスタンス ID が [インスタンス ID] フィールドに表示されます。

AdMob 広告ユニット ID を設定するには、アプリキーとインスタンス ID に加えて、ironSource の秘密鍵と更新トークンも必要です。

ironSource のパブリッシャー ダッシュボードで [My Account] に移動し、[API] タブをクリックします。秘密鍵と更新トークンをメモしておきます。

テストモードをオンにする

ironSource のテスト広告を有効にする方法については、ironSource の統合テストガイドをご覧ください。

ステップ 2: UI で AdMob ironSource のデマンドを設定する

広告ユニットのメディエーション設定を行う

Android

手順については、 Android 向けガイドのステップ 2 をご覧ください。

iOS

手順については、 iOS 向けガイドのステップ 2 をご覧ください。

GDPR と米国の州規制の広告パートナーのリストに ironSource Mobile 追加

GDPR 設定 米国の州規制の設定 の手順に沿って、 AdMob UI の GDPR および米国の州規制の広告パートナーのリストに ironSource Mobile を追加します。

ステップ 3: ironSource SDK とアダプターをインポートする

変更履歴のダウンロード リンクから ironSource 向け Google モバイル広告メディエーション プラグインの最新バージョンをダウンロードし、zip ファイルから GoogleMobileAdsIronSourceMediation.unitypackage を抽出します。

Unity プロジェクト エディタで、[Assets] > [Import Package] > [Custom Package] を選択し、ダウンロードした GoogleMobileAdsIronSourceMediation.unitypackage ファイルを見つけます。すべてのファイルが選択されていることを確認し、[Import] をクリックします。

次に、[Assets] > [Play Services Resolver] > [Android Resolver] > [Force Resolve] を選択します。Unity Play Services Resolver ライブラリは、依存関係の解決をゼロから行い、宣言された依存関係を Unity アプリの Assets/Plugins/Android ディレクトリにコピーします。

ステップ 4: ironSource SDK にプライバシー設定を実装する

Google の EU ユーザーの同意ポリシーに基づき、デベロッパーは、欧州経済領域（EEA）のユーザーに対して、デバイス識別子と個人データの使用に関して特定の開示を行い、同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則（GDPR）の要件が反映されています。同意を求める際は、個人データを収集、受信、または使用する可能性があるメディエーション チェーン内の各広告ネットワークを特定し、各ネットワークの使用に関する情報を提供する必要があります。現在のところ、同意に関するユーザーの選択をこのようなネットワークに自動的に渡すことはできません。

ironSource 向け Google モバイル広告メディエーション プラグイン バージョン 1.0.0 には、 IronSource.SetConsent() メソッドが含まれています。次のサンプルコードは、同意情報を ironSource SDK に渡す方法を示しています。このメソッドを呼び出す場合は、Google Mobile Ads SDK を使用して広告をリクエストする前に呼び出すことをおすすめします。

using GoogleMobileAds.Api.Mediation.IronSource;
// ...

IronSource.SetConsent(true);

詳しくは、ironSource の Regulation Advanced Settings に関するドキュメントをご覧ください。

米国のプライバシー関連州法

米国のプライバシー関連州法 「個人情報」の「販売」は、法律で定められているとおり、オプトアウトする権利をユーザーに提供することが義務付けられています。オプトアウトするには、「販売」当事者のホームページに目立つ [個人情報を第三者に売却しない] リンクがあります。米国のプライバシー関連州法の遵守ガイドでは、Google の広告配信について制限付きデータ処理を有効にすることができますが、Google がメディエーション チェーンの各広告ネットワークにこの設定を適用することはできません。したがって、個人情報の販売に参加する可能性のあるメディエーション チェーンの各広告ネットワークを特定し、各ネットワークのガイダンスに沿ってポリシーに準拠する必要があります。

ironSource 向け Google モバイル広告メディエーション プラグイン バージョン 2.2.4 には、 IronSource.SetMetaData() メソッドが含まれています。次のサンプルコードは、同意情報を ironSource SDK に渡す方法を示しています。これらのオプションは、ironSource SDK に正しく転送されるように、Google Mobile Ads SDK を初期化する前に設定する必要があります。

using GoogleMobileAds.Api.Mediation.IronSource;
// ...

IronSource.SetMetaData("do_not_sell", "true");

詳細とこのメソッドで指定できる値については、Android と iOS の規制の詳細設定に関する ironSource のドキュメントをご覧ください。

ステップ 5: 必要なコードを追加する

Android

ProGuard ルール

アプリの圧縮、難読化、最適化を行う場合、IronSource ではプロジェクトに追加 ProGuard ルールが必要になります。

プロジェクトをビルドするときに、[Platform] として [Android] を選択します。次に、[Player Settings] を開き、[Publishing Settings] タブの [User Proguard File] をオンにします。カスタム proguard-user.txt ファイルが作成された場所が Unity に表示されます。

Unity ユーザー ProGuard ファイル

プロジェクトに必要な ProGuard ルールについて詳しくは、IronSource の Android SDK 統合ガイドをご覧ください。これらのルールを proguard-user.txt ファイルに追加します。

iOS

SKAdNetwork との統合

IronSource のドキュメントに沿って、プロジェクトの Info.plist ファイルに SKAdNetwork 識別子を追加します。

ステップ 6: 実装をテストする

テスト広告を有効にする

AdMob にテストデバイスを登録し、 ironSource UI でテストモードを有効にします。

テスト広告を確認する

ironSourceからテスト広告を受信していることを確認するには、広告インスペクタで ironSource (Waterfall) 広告ソースを使用して単独の広告ソースのテストを有効にします。

エラーコード

アダプタが ironSource から広告を受信できない場合、パブリッシャーは、次のクラスの ResponseInfo を使用して、広告レスポンスの根本的なエラーを確認できます。

Android

com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter

iOS

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

広告の読み込みに失敗したときに ironSource アダプタによってスローされるコードと付随するメッセージは次のとおりです。

Android

エラーコード 理由
101 UI で設定された AdMob ironSource サーバー パラメータが見つからないか、無効です。
102 SDK を初期化するために、ironSource には Activity コンテキストが必要です。
103 ironSource は、ironSource インスタンス ID ごとに 1 つの広告しか読み込めません。
105 リクエストされたバナー広告のサイズは ironSource でサポートされていません。
106 ironSource SDK が初期化されていません。
501-1056 ironSource SDK エラー。詳しくは、ドキュメントをご覧ください。

iOS

エラーコード 理由
101 UI で設定された AdMob ironSource サーバー パラメータが見つからないか、無効です。
102 ironSource Adapter は、リクエストされた広告フォーマットをサポートしていません。
103 このネットワーク設定には ironSource 広告がすでに読み込まれています。
104 リクエストされたバナー広告のサイズは ironSource でサポートされていません。
508-1037 ironSource SDK エラー。詳しくは、ドキュメントをご覧ください。

IronSource Unity メディエーション プラグインに関する変更履歴

バージョン 3.0.0

バージョン 2.6.1

バージョン 2.6.0

バージョン 2.5.0

バージョン 2.4.0

バージョン 2.3.1

バージョン 2.3.0

バージョン 2.2.7

バージョン 2.2.6

バージョン 2.2.5

バージョン 2.2.4

バージョン 2.2.3

バージョン 2.2.2

バージョン 2.2.1

バージョン 2.2.0

バージョン 2.1.5

バージョン 2.1.4

バージョン 2.1.3

バージョン 2.1.2

バージョン 2.1.1

バージョン 2.1.0

バージョン 2.0.3

バージョン 2.0.2

バージョン 2.0.1

バージョン 2.0.0

バージョン 1.10.0

バージョン 1.9.1

バージョン 1.9.0

バージョン 1.8.2

バージョン 1.8.1

バージョン 1.8.0

バージョン 1.7.0

バージョン 1.6.0

バージョン 1.5.0

バージョン 1.4.0

バージョン 1.3.2

バージョン 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 をサポート。