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

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

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

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

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

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

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

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

要件

iOS デプロイターゲットが 12.0 以降
[入札の場合]: サポートされているすべての広告フォーマットを入札に統合するには、IronSource アダプター 7.9.1.0.0 以降を使用します（最新バージョンを推奨）。

最新の Google Mobile Ads SDK
メディエーションのスタートガイドを完了していること

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

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

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

アプリの詳細を入力

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

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

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

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

インスタンスを作成

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

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

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

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

Reporting API キーを確認する

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

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

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

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

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

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

アドマネージャーアカウントにログインします。

[配信] > [収益グループ] に移動し、[新しい収益グループ] ボタンをクリックします。

収益グループの一意の名前を入力し、ステータスを [有効] に設定し、広告フォーマットを選択し、広告枠タイプを [モバイルアプリ] に設定します。[ターゲティング > 広告枠] セクションで、メディエーションを追加する広告ユニットを [広告枠] と [モバイルアプリ] で選択します。

次に、[収益パートナーを追加] ボタンをクリックします。

ironSource 広告の収益パートナーをすでにご利用の場合は、そのパートナーを選択できます。そうでない場合は、[新しい収益パートナーを作成] を選択します。

[広告ネットワーク] として [ironSource Ads] を選択し、一意の名前を入力して [メディエーション] を有効にします。

[自動データ収集] をオンにして、前のセクションで取得したシークレットキーと更新トークンを入力します。

[収益パートナー] を選択したら、[統合タイプ] として [モバイル SDK メディエーション]、[プラットフォーム] として [iOS]、[ステータス] として [有効] を選択します。前のセクションで取得したアプリキーとインスタンス ID を入力します。次に、[デフォルト CPM] の値を入力します。

完了したら、ページの下部にある [保存] をクリックします。

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

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

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

CocoaPods を使用する（推奨）

プロジェクトの Podfile に次の行を追加します。
```
pod 'GoogleMobileAdsMediationIronSource'
```
コマンドラインから次のコマンドを実行します。
```
pod install --repo-update
```

手動による統合

ironSource Ads iOS SDK の最新バージョンをダウンロードし、プロジェクトで IronSource.framework をリンクします。
変更ログのダウンロードリンクから ironSource 広告アダプターの最新バージョンをダウンロードし、プロジェクトで IronSourceAdapter.framework をリンクします。

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

EU ユーザーの同意と GDPR

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

SDK バージョン 6.7.9 で、ironSource Ads に同意 API が追加されました。次のサンプルコードは、この同意情報を ironSource Ads SDK に渡す方法を示しています。このメソッドを呼び出す場合は、Google Mobile Ads SDK で広告をリクエストする前に呼び出すことをおすすめします。

Swift

// For Swift integration, you need to import the ironSource Ads SDK in your Bridging Header.
// For more details, see https://developers.is.com/ironsource-mobile/ios/ironsource-ios-sdk-integration-swift/
// ...

IronSource.setConsent(true)

Objective-C

#import <IronSource/IronSource.h>
// ...

[IronSource setConsent:YES];

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

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

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

SDK バージョン 6.14.0 で、ironSource Ads に CCPA 規制をサポートする API が追加されました。次のサンプルコードは、この同意情報を ironSource Ads SDK に渡す方法を示しています。これらのオプションは、Google Mobile Ads SDK を初期化する前に設定する必要があります。そうすることで、ironSource Ads SDK に適切に転送されます。

Swift

// For Swift integration, you need to import the ironSource SDK in your Bridging Header.
// For more details, see https://developers.is.com/ironsource-mobile/ios/ironsource-ios-sdk-integration-swift/
// ...

IronSource.setMetaDataWithKey("do_not_sell", value: "YES")

Objective-C

#import <IronSource/IronSource.h>
// ...

[IronSource setMetaDataWithKey:@"do_not_sell" value:@"YES"];

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

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

SKAdNetwork の統合

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

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

テスト広告を有効にする

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

テスト広告を確認する

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

エラーコード

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

次のクラスの GADResponseInfo.adNetworkInfoArray に追加します。

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

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