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

[プラットフォームを選択]: Android（ベータ版） Android iOS Unity Flutter

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

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

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

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

要件

• Android API レベル 24 以降

• [入札]: 入札でサポートされているすべての広告フォーマットを統合するには、 IronSource アダプタ 8.5.0.1 以降を使用します（最新バージョンを推奨）

• 最新の GMA Next-Gen SDK

• メディエーションの スタートガイドを完了していること

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

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

新しいアプリを追加する

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

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

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

インスタンスの作成

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

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

Reporting API キーを確認する

app-ads.txt を更新する

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

ironSource の app-ads.txt を実装するには、 ironSource の認定リセラーをご覧ください。

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

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

ステップ 2: AdMob の管理画面で 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 を入力します。[完了] をクリックします。

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

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

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

Android Studio 統合（推奨）

プロジェクト レベルの settings.gradle.kts ファイルに、次のリポジトリを追加します。

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://android-sdk.is.com/")
    }
  }
}

アプリレベルの Gradle ファイルに、次の実装の依存関係と構成を追加します。

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:ironsource:9.3.0.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:ironsource:9.3.0.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

手動統合

1. ironSource Ads Android SDK の最新バージョンをダウンロードし、プロジェクトに追加します。

2. Google の Maven リポジトリで ironSource Ads アダプタ アーティファクト に移動します。最新バージョンを選択し、IronSource アダプタの .aar ファイルをダウンロードして、プロジェクトに追加します。

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

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

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

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

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

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

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

LevelPlay.setMetaData("do_not_sell", "true");
IronSourceMediationSnippets.java

LevelPlay.setMetaData("do_not_sell", "true")
IronSourceMediationSnippets.kt

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

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

アクティビティ コンテキストで広告を読み込む

バナー、インタースティシャル、リワード広告の広告フォーマットを読み込むときに Activity コンテキストを渡します。アクティビティ コンテキストがないと、広告掲載に失敗します。

Proguard ルール

アプリを 圧縮、難読化、最適化 する場合は、ironSource Ads でプロジェクトに追加の ProGuard ルールが必要になります。詳しくは、 ironSource Ads の Android SDK 統合ガイド をご覧ください。

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

テスト広告を有効にする

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

テスト広告を確認する

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

エラーコード

アダプタが ironSource Ads から広告を受け取れない場合は、 次のクラスの ResponseInfo.getAdSourceResponses() を使用して、広告レスポンスからエラーの詳細を確認できます。

com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter

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