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

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

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

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

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

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

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

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

要件

iOS デプロイターゲットが 12.0 以降であること

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

ステップ 1: ironSource Ads UI で設定をセットアップする

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

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

アプリの詳細を入力

[ライブアプリ] を選択し、アプリの 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 UI で ironSource 広告のデマンドを設定する

広告ユニットのメディエーション設定を行う

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

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

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

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

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

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

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

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

入札

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

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

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

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

次に、 App Key and Instance IDを入力します。必要があります。[完了] をクリックします。

ウォーターフォール

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

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

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

次に、前のセクションで取得した App Key and Instance IDを入力します。[完了] をクリックします。

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 Ads からテスト広告を受信していることを確認するには、ironSource Ads（単価設定）と ironSource Ads（Waterfall）広告ソースを使用して、広告インスペクタで単一の広告ソースのテストを有効にします。

エラーコード

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

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

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

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