このページは Cloud Translation API によって翻訳されました。

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

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

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

ironSource Ads 用のアドマネージャーメディエーションアダプターには、次の機能があります。

統合
単価設定	¹
滝
フォーマット
バナー	²
インタースティシャル
特典
リワードインタースティシャル	²

¹ 入札の統合はクローズドベータ版です。アクセス権をリクエストするには、アカウントマネージャーにお問い合わせください。

² この形式はウォーターフォール統合でのみサポートされます。

要件

最新の Google Mobile Ads SDK
Unity 4 以降
[入札の場合]: サポートされているすべての広告フォーマットを入札に統合するには、IronSource 用 Google Mobile Ads メディエーションプラグイン 3.0.0 以降（最新バージョンを推奨）を使用します。
Android にデプロイするには
- Android API レベル 21 以降
iOS にデプロイするには
- iOS デプロイターゲットが 12.0 以降
Google Mobile Ads SDK で構成された、動作する Unity プロジェクト。詳細については、スタートガイドをご覧ください。
メディエーションのスタートガイドを完了していること

ステップ 1: ironSource 広告の管理画面で設定を行う

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

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

アプリの詳細を入力

[ライブアプリ] を選択し、アプリの名前を入力して、[アプリ情報をインポート] をクリックします。

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

フォームの残りの部分に記入し、[アプリを追加] をクリックします。

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

Android

iOS

インスタンスを作成

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

[広告] > [設定] > [インスタンス] に移動します。アプリを選択し、[インスタンスを作成] をクリックします。

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

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

Reporting API キーを確認する

アドマネージャーの広告ユニット ID を設定するには、アプリキーとインスタンス ID に加えて、ironSource Ads のシークレットキーと更新トークンも必要です。

ironSource 広告パブリッシャーダッシュボードの [マイアカウント] に移動し、[API] タブをクリックします。シークレットキーと更新トークンをメモします。

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

ironSource 広告のテスト広告を有効にする方法については、ironSource 広告の統合テストガイドの手順に沿って操作してください。

ステップ 2: アドマネージャーの UI で ironSource 広告のデマンドを設定する

広告ユニットのメディエーション設定を構成する

Android

手順については、Android のガイドの手順 2 をご覧ください。

iOS

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

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

GDPR 設定と米国の州の規制の設定の手順に沿って、アドマネージャーの管理画面で、GDPR と米国の州の規制の広告パートナーリストに ironSource Mobile を追加します。

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

OpenUPM-CLI

OpenUPM-CLI がインストールされている場合は、プロジェクトのルートディレクトリから次のコマンドを実行して、Unity 用の Google モバイル広告 ironSource 広告メディエーションプラグインをプロジェクトにインストールできます。

openupm add com.google.ads.mobile.mediation.ironsource

OpenUPM

Unity プロジェクトエディタで、[Edit] > [Project Settings] > [Package Manager] を選択して、Unity Package Manager の設定を開きます。

[スコープ付きレジストリ] タブで、OpenUPM をスコープ付きレジストリとして追加し、次の詳細情報を指定します。

名前: OpenUPM
URL: https://package.openupm.com
スコープ: com.google

OpenUPM の詳細

次に、[Window] > [Package Manager] に移動して Unity Package Manager を開き、プルダウンメニューから [My Registries] を選択します。

Unity レジストリ

[Google Mobile Ads ironSource Ads Mediation] パッケージを選択し、[Install] をクリックします。

OpenUPM からインストールする

Unity パッケージ

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

Unity プロジェクトエディタで、[Assets] > [Import Package] > [Custom Package] を選択し、ダウンロードした GoogleMobileAdsIronSourceMediation.unitypackage ファイルを探します。すべてのファイルのチェックボックスがオンになっていることを確認して、[インポート] をクリックします。

Unity からインポートする

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

強制解決

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

EU の同意と GDPR

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

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

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

IronSource.SetConsent(true);

詳しくは、ironSource 広告の規制に関する詳細設定に関するドキュメントをご覧ください。

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

米国の州のプライバシー法では、ユーザーに「個人情報」の「販売」を拒否する権利を付与することが義務付けられています（用語は法律の定義に基づく）。「販売」を行う事業者はホームページに「個人情報を販売しない」リンクをわかりやすく表示することが求められます。米国の州のプライバシー関連法の遵守ガイドでは、Google 広告配信で制限付きデータ処理を有効にできますが、Google はメディエーションチェーン内の各広告ネットワークにこの設定を適用することはできません。そのため、個人情報の販売に関与する可能性があるメディエーションチェーンの各広告ネットワークを特定し、各ネットワークのガイダンスに沿ってコンプライアンスを確保する必要があります。

ironSource Ads 向け Google Mobile Ads メディエーションプラグインバージョン 2.2.4 には、IronSource.SetMetaData() メソッドが含まれています。次のサンプルコードは、同意情報を ironSource Ads SDK に渡す方法を示しています。これらのオプションは、Google Mobile Ads SDK を初期化する前に設定する必要があります。これにより、ironSource 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] をオンにします。Unity に、変更が必要なカスタム proguard-user.txt ファイルが作成された場所が表示されます。

Unity ユーザー ProGuard ファイル

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

iOS

SKAdNetwork の統合

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

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

テスト広告を有効にする

アドマネージャーにテストデバイスを登録し、ironSource 広告の管理画面でテストモードを有効にしてください。

テスト広告を確認する

ironSource 広告からテスト広告が配信されていることを確認するには、広告インスペクタで ironSource 広告（入札）と ironSource 広告（ウォーターフォール）の広告ソースを使用して、単一の広告ソースのテストを有効にします。

エラーコード

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

Android

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

iOS

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

Android

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

iOS

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