AdMob のプロダクトに関して意見交換やフィードバックを行うには、広告と測定に関する Google コミュニティサーバーの公式 AdMob Discord チャネルにご参加ください。

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

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

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

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

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

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

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

要件

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

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

ステップ 1: ironSource Ads の管理画面で構成を設定する

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

新しいアプリを追加する

新しいアプリを追加するには、[広告] > [アプリ] に移動し、[アプリを追加] をクリックします。

フォームに必要事項を記入し、[アプリを追加] をクリックします。

アプリキーをメモし、アプリでサポートする広告フォーマットを選択して [続行] をクリックします。

インスタンスの作成

次に、追加したアプリのインスタンスを構成します。

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

入札単価

フォームに記入し、[料金] で [入札] を選択します。[保存して閉じる] をクリックします。

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

ウォーターフォール

フォームに記入して [保存して閉じる] をクリックします。

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

Reporting API キーを確認する

入札単価

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

ウォーターフォール

[マイアカウント] ページで [API] タブをクリックし、シークレットキーと更新トークンをメモします。

app-ads.txt を更新する

Authorized Sellers for Apps app-ads.txt は、承認されたチャネルでのみアプリ広告枠を販売できるようにする IAB Tech Lab が推進しているイニシアチブです。広告収益の大幅な減少を防ぐためには、app-ads.txt ファイルを実装する必要があります。まだ設定していない場合は、アプリの app-ads.txt ファイルを設定します。

ironSource 向けに app-ads.txt を実装するには、ironSource の正規販売店をご覧ください。

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

ironSource Ads の統合テストガイドの手順に沿って、ironSource Ads のテスト広告を有効にします。

ステップ 2: AdMob の UI で ironSource Ads のデマンドを設定する

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

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

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

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

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

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

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

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

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

入札単価

[広告のソース] セクションの [入札] カードで、[広告ソースを追加] を選択します。[ironSource Ads] を選択します。

[パートナー契約への署名手順] をクリックし、ironSource Ads との入札のパートナーシップを設定します。

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

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

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

ウォーターフォール

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

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

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

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

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

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

欧州の規制に関する設定と米国の州の規制に関する設定の手順に沿って、AdMob 管理画面の欧州および米国の州の規制に関する広告パートナーのリストに ironSource Mobile を追加します。

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

CocoaPods の使用（推奨）

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

手動による統合

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

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

EU ユーザーからの同意と GDPR

Google の EU ユーザーの同意ポリシーに準拠するには、欧州経済領域（EEA）、英国、スイスのユーザーに対して特定の情報を開示し、法律で義務付けられている場合は、Cookie やその他のローカルストレージの使用、広告のパーソナライズを目的とした個人データの収集、共有、使用についてユーザーの同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則（GDPR）の要件が反映されています。パブリッシャー様には、同意がメディエーションチェーン内の各広告ソースに反映されていることを確認する責任があります。 Google は、同意に関するユーザーの選択をそのようなネットワークに自動的に渡すことはできません。

ironSource SDK バージョン 7.7.0 以降では、UMP SDK など、Google の追加の同意に関する仕様をサポートする同意管理プラットフォームで設定された GDPR の同意が自動的に読み取られます。詳細については、Google の追加の同意をサポートする Google UMP と CMP のサポートをご覧ください。

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

米国の州のプライバシー法では、ユーザーが「個人情報」の「販売」を拒否する権利を保障することが求められています（用語は法律の定義に基づく）。「販売者」のホームページにある「個人情報を販売しない」リンクから販売を拒否することができます。米国のプライバシー関連州法遵守ガイドでは、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 のドキュメントに沿って、プロジェクトの Info.plist ファイルに SKAdNetwork 識別子を追加します。

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

テスト広告を有効にする

AdMob 用のテストデバイスを登録し、ironSource Ads UI でテストモードを有効にしてください。

テスト広告を確認する

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

エラーコード

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

次のクラスの GADResponseInfo.adNetworkInfoArray:

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

広告の読み込みに失敗した場合に ironSource Ads アダプタがスローするコードとメッセージは次のとおりです。

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

IronSource iOS メディエーションアダプタの変更履歴

バージョン 8.11.0.0.0

IronSource SDK バージョン 8.11.0.0 との互換性を確認しました。

構築およびテストに使用したバージョン:

Google Mobile Ads SDK バージョン 12.9.0。
IronSource SDK バージョン 8.11.0.0。

バージョン 8.10.0.0.0

IronSource SDK バージョン 8.10.0.0 との互換性を確認しました。

構築およびテストに使用したバージョン:

Google Mobile Ads SDK バージョン 12.6.0。
IronSource SDK バージョン 8.10.0.0。

バージョン 8.9.1.0.1

最小 iOS バージョンが 12.0 になりました。

構築およびテストに使用したバージョン:

Google Mobile Ads SDK バージョン 12.6.0。
IronSource SDK バージョン 8.9.1.0。

バージョン 8.9.1.0.0

IronSource SDK バージョン 8.9.1.0 との互換性を確認しました。

構築およびテストに使用したバージョン:

Google Mobile Ads SDK バージョン 12.6.0。
IronSource SDK バージョン 8.9.1.0。

バージョン 8.9.0.0.0

IronSource SDK バージョン 8.9.0.0 との互換性を確認しました。

構築およびテストに使用したバージョン:

Google Mobile Ads SDK バージョン 12.5.0。
IronSource SDK バージョン 8.9.0.0。

バージョン 8.8.0.0.0

-fobjc-arc フラグと -fstack-protector-all フラグを有効にしました。
アダプタを更新し、広告ユニットに関連付けられた以前に読み込まれた広告が使用または割り当て解除されない限り、後続のウォーターフォール広告が読み込まれないようにしました。
IronSource SDK バージョン 8.8.0.0 との互換性を確認しました。

構築およびテストに使用したバージョン: