このガイドでは、Google Mobile Ads SDK を使用して、Google Mobile Ads SDK を読み込んで表示する方法を説明します。 ironSource の広告経由の メディエーション(ウォーターフォールをカバー) 統合できますironSource 広告を広告ユニットの メディエーションの設定と、ironSource Ads SDK とアダプタを統合する方法について 組み込むことが重要です。 Unity
サポートされている統合と広告フォーマット
ironSource Ads 用の Ad Manager メディエーション アダプタは次のとおりです。 次のような機能があります。
統合 | |
---|---|
単価設定 | |
滝 | |
フォーマット | |
バナー | |
インタースティシャル | |
特典 | |
リワード インタースティシャル |
要件
- 最新の 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
広告ユニットのメディエーション設定を行う
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 にプライバシー設定を実装する
EU の同意と GDPR
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] を選択します。その後、
プレーヤー設定を開き、ユーザー ProGuard ファイルを
[Publishing Settings] タブ。カスタム コンテナ イメージが
変更可能な proguard-user.txt
ファイルが作成されました。
コンサルト
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 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.2.1
DummyClient
の名前をPlaceholderClient
に変更しました。- IronSource Android アダプター バージョン 8.2.1.0 をサポートします。
- IronSource iOS アダプター バージョン 8.2.0.0.0 をサポートします。
- Google Mobile Ads Unity Plugin バージョン 9.2.0 でビルド、テストされています。
バージョン 3.2.0
- IronSource Android アダプター バージョン 8.2.0.0 をサポートします。
- IronSource iOS アダプター バージョン 8.2.0.0.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 9.1.1 でビルド、テストされています。
バージョン 3.1.1
- IronSource Android アダプター バージョン 8.1.0.0 をサポートします。
- IronSource iOS アダプター バージョン 8.1.1.0.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 9.1.1 でビルド、テストされています。
バージョン 3.1.0
- IronSource Android アダプター バージョン 8.1.0.0 をサポートします。
- IronSource iOS アダプター バージョン 8.1.0.0.1 をサポートします。
- Google Mobile Ads Unity Plugin バージョン 9.1.0 でビルド、テストされています。
バージョン 3.0.1
- IronSource Android アダプター バージョン 8.0.0.1 をサポートします。
- IronSource iOS アダプター バージョン 8.0.0.0.1 をサポートします。
- Google Mobile Ads Unity Plugin バージョン 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 をサポートします。