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

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

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

ironSource Ads 用の Ad Manager メディエーション アダプタは次のとおりです。 次のような機能があります。

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

要件

  • 最新の Google Mobile Ads SDK
  • Unity 4 以降
  • Android にデプロイする <ph type="x-smartling-placeholder">
      </ph>
    • Android API レベル 21 以降
  • iOS にデプロイする場合 <ph type="x-smartling-placeholder">
      </ph>
    • iOS デプロイ ターゲットが 12.0 以降であること
  • Google で構成された Unity 作業プロジェクト Mobile Ads SDK があります。詳しくは、 スタートガイドをご覧ください。
  • メディエーションを完了する スタートガイド

ステップ 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

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

Android

手順については、 Android

iOS

手順については、 iOS

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

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

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

ironSource 用の Google モバイル広告メディエーション プラグインの最新バージョンをダウンロード [変更履歴] をクリックして、 ZIP ファイル内の GoogleMobileAdsIronSourceMediation.unitypackage

Unity プロジェクト エディタで、[Assets] >パッケージをインポート >カスタム パッケージ化し、GoogleMobileAdsIronSourceMediation.unitypackage ファイルを見つけます。 表示されます。すべてのファイルのチェックボックスがオンになっていることを確認して、[Import](インポート)をクリックします。

次に、[アセット >Play 開発者サービス リゾルバ >Android リゾルバ >力 解決する。Unity Play Services Resolver ライブラリが依存関係を実行 宣言し、宣言された依存関係を Unity アプリの Assets/Plugins/Android ディレクトリ。

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

Google の EU ユーザーの同意 ポリシーに基づき、特定の情報開示が必ず行われるようにし、 欧州経済領域(EEA)のユーザーから、 デバイス ID と個人データの使用。このポリシーは、 EU の e プライバシー指令と一般データ保護規則の要件 規則(GDPR)。同意を求める場合は、各広告ネットワークを特定する必要がある 個人データを収集、受信、または使用する可能性がある 各ネットワークの使用状況に関する情報が表示されます。現在のところ、Google は ユーザーの同意に関する選択をこうしたネットワークに自動的に渡す。

ironSource Ads 用の Google モバイル広告メディエーション プラグイン バージョン 1.0.0 含まれる IronSource.SetConsent() メソッドを呼び出します。次のサンプルコードは、Python コードを ironSource Ads SDK に送信されます。このように メソッドを使って広告をリクエストする前に、 Google Mobile Ads SDK

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

IronSource.SetConsent(true);

詳しくは、ironSource Ads のドキュメントを参照してください。 規則の詳細設定 をご覧ください。

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

米国プライバシー関連州法 は、ユーザーに対して適切な権限を 「セール」からオプトアウトする「個人情報」を(法律で定められているとおり、 これらの規約を参照)の「Do Not Sell My Personal」という目立つ位置で 情報」[販売]ページのリンクに表示されます。「 米国州のプライバシー 法令遵守ガイドに用意されている 制限付きデータ処理 設定されているが、この設定を各広告に適用することはできない 関連付けられますそのため各広告ネットワークを 個人の商品販売に参加するメディエーション チェーン 各ネットワークのガイダンスに従って 遵守する必要があります

ironSource Ads 用の Google モバイル広告メディエーション プラグイン バージョン 2.2.4 含まれる IronSource.SetMetaData() メソッドを呼び出します。次のサンプルコードは、Python コードを ironSource Ads SDK に送信されます。これらのオプションは Google モバイル広告を SDK ironSource Ads SDK に適切に転送されるようにしてください。

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

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

両方に関する規制の詳細設定については、ironSource Ads のドキュメントを参照してください。 Android および iOS を参照してください。

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

Android

ProGuard ルール

アプリの圧縮、難読化、最適化を行う際は、 IronSource Ads を使用するには、プロジェクトに追加の ProGuard ルールが必要です。

プロジェクトをビルドするときに、[Platform] で [Android] を選択します。次に、 [Player Settings] を開き、 [Publishing Settings] タブ。カスタム コンテナ イメージが 変更可能な proguard-user.txt ファイルが作成されました。

Unity ユーザー ProGuard ファイル

コンサルト IronSource Ads の Android SDK 統合ガイド プロジェクトで必要な ProGuard ルールについて詳しくは、 それらのルールを 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 広告からスローされたコードとそのメッセージは次のとおりです。 広告の読み込みに失敗した場合に表示されます。

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.1

バージョン 3.1.0

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