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

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

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

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

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

要件

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

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

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

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

アプリの詳細を入力

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

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

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

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

Android

iOS

インスタンスを作成

次に、追加したアプリのネットワーク インスタンスを構成します。

入札

[LevelPlay] > [設定] > [SDK ネットワーク] に移動して、アプリを選択します。[入札] で編集アイコンをクリックして、入札インスタンス ID を表示します。

Android

iOS

インスタンス ID をメモします。

Android

iOS

ウォーターフォール

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

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

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

Reporting API キーを確認する

入札

入札の統合では、この手順は必要ありません。

ウォーターフォール

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

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

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

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

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

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

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 開発者サービス リゾルバ ライブラリは、依存関係の解決をゼロから実行し、宣言された依存関係を Unity アプリの Assets/Plugins/Android ディレクトリにコピーします。

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

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

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

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

IronSource.SetConsent(true);

詳しくは、ironSource のドキュメントで規制の詳細設定をご覧ください。

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

米国のプライバシー関連州法 では、ユーザーに対して「個人情報」の「販売」をオプトアウトする権利（法律で定義される）を提供し、「販売」当事者のホームページに目立つ「個人情報を販売しない」リンクを通じてオプトアウトする権利を提供することが義務付けられています。米国のプライバシー関連州法の遵守ガイドでは、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 ユーザー ProGuard ファイル

プロジェクトで必要な ProGuard ルールの詳細について、IronSource の Android SDK 統合ガイドを参照し、そのルールを proguard-user.txt ファイルに追加します。

iOS

SKAdNetwork との統合

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

ステップ 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 ironSource では、SDK を初期化するために Activity コンテキストが必要です。
103 ironSource は、ironSource インスタンス ID ごとに 1 つの広告しかロードできません。
105 リクエストされたバナー広告のサイズは、ironSource でサポートされていません。
106 ironSource SDK が初期化されていません。
501-1056 ironSource SDK エラー。詳しくは、ドキュメントをご覧ください。

iOS

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

IronSource Unity メディエーション プラグインの変更履歴

バージョン 3.0.1

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