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

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

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

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

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

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

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

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

要件

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] を選択し、アプリの一時的な名前を入力します。プラットフォームを選択します。

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

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

インスタンスを作成

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

単価設定

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

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

滝

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

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

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

Reporting API キーを確認する

単価設定

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

滝

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

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

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

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

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

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

広告ユニットのメディエーション構成に ironSource 広告を追加する必要があります。

まず、AdMob アカウントにログインします。次に、[メディエーション] タブに移動します。既存のメディエーショングループを変更する場合は、そのメディエーショングループの名前をクリックして編集し、ironSource 広告を広告ソースとして追加するに進みます。

新しいメディエーショングループを作成するには、[メディエーショングループを作成] を選択します。

広告フォーマットとプラットフォームを入力し、[続行] をクリックします。

メディエーショングループに名前を付け、ターゲットとする地域を選択します。次に、メディエーショングループのステータスを [有効] に設定し、[広告ユニットを追加] をクリックします。

このメディエーショングループを、既存の AdMob 広告ユニットに関連付けます。次に [完了] をクリックします。

選択した広告ユニットが広告ユニットカードに表示されます。

ironSource Ads を広告ソースとして追加する

単価設定

[広告ソース] セクションの [入札] カードで、[広告ソースを追加] を選択します。次に、[ironSource 広告] を選択します。
[パートナー契約への署名手順] をクリックし、ironSource 広告で入札パートナーシップを設定します。

[確認して同意する]、[続行] の順にクリックします。

ironSource 広告のマッピングがすでにある場合は、そのマッピングを選択できます。それ以外の場合は、[マッピングを追加] をクリックします。

次に、前のセクションで取得したアプリキーとインスタンス ID を入力します。[完了] をクリックします。

滝

[広告ソース] セクションの [ウォーターフォール] カードで、[広告ソースを追加] を選択します。次に、[ironSource 広告] を選択します。

[ironSource 広告] を選択し、[最適化] スイッチをオンにします。前のセクションで取得したシークレットキーと更新トークンを入力して、ironSource 広告の広告ソースの最適化を設定します。次に、ironSource 広告の eCPM 値を入力し、[続行] をクリックします。

ironSource 広告のマッピングがすでにある場合は、そのマッピングを選択できます。それ以外の場合は、[マッピングを追加] をクリックします。

次に、前のセクションで取得したアプリキーとインスタンス ID を入力します。[完了] をクリックします。

注: 広告ソースの最適化では、メディエーションネットワークの eCPM を正確に計算するのに十分なデータが収集されるまでに数日かかります。最適化が完了するまでの間、広告ソースの最適化ステータスは PENDING になります。このため、ネットワークの eCPM 値を手動で設定する必要があります。eCPM を計算できるようになると、広告ソースが自動的に eCPM の更新を開始します。

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 に渡す方法を示しています。これらのオプションは、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: 実装をテストする

テスト広告を有効にする

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

テスト広告を確認する

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

エラーコード

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

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

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

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