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

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

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

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

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

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

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

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

要件

iOS デプロイターゲットが 12.0 以降

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

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

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

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

アプリの詳細を入力

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

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

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

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

インスタンスを作成

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

単価設定

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

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

滝

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

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

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

Reporting API キーを確認する

単価設定

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

滝

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

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

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

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

ステップ 2: 管理画面で ironSource の広告デマンドを設定する Ad Manager

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

GDPR の設定と米国の州規制の設定の手順に沿って、AdMob 管理画面の 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 に渡す方法を示しています。これらのオプションは、ironSource Ads SDK に正しく転送されるように、Google Mobile 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 識別子をプロジェクトの Info.plist ファイルに追加します。

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

テスト広告を有効にする

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

テスト広告を確認する

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

エラーコード

アダプタが ironSource Ads から広告を受信できない場合は、次のクラスの

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

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

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