このガイドでは、Google Mobile Ads SDK を使用して、ウォーターフォールの統合を含め、メディエーションによって Yahoo から広告を読み込んで表示する方法について説明します。広告ユニットのメディエーション設定に Yahoo を追加する方法と、Yahoo Mobile SDK とアダプタをAndroid アプリに統合する方法について説明します。
サポートされている統合と広告フォーマット
Yahoo 用 AdMob メディエーション アダプタには次の機能があります。
統合 | |
---|---|
入札 | |
ウォーターフォール | |
フォーマット | |
バナー | |
インタースティシャル | |
特典 | |
ネイティブ |
要件
- Android API レベル 19 以降
最新の Google Mobile Ads SDK
メディエーションのスタートガイドを完了する
ステップ 1: Yahoo の UI で設定を行う
Yahoo の SSP にログインします。[Applications and Sites] で [+] ボタンをクリックし、[Application] をクリックします。
フォームに入力し、[Save and Add Placement] をクリックしてアプリを作成します。
アプリを作成したら、Placement を作成する必要があります。[プレースメント タイプ] を選択してフォームに記入し、[保存して収益化] をクリックします。
プレースメント ID をメモしておきます。
プレースメントに広告ソースを追加する必要があります。次のフォームで、[広告ソース] として [Yahoo SSP] を選択し、フォームに入力します。フォームへの入力が完了したら、[保存] をクリックします。
最後に、作成した広告ソースを [ウォーターフォールの広告ソース] テーブルにドラッグして、プレースメントに追加します。
サイト ID をメモします。
テストモードをオンにする
Yahoo 広告をテストするには、テスト広告ソースを作成して、プレースメントのウォーターフォールの広告ソースに追加します。プレースメント ID の設定画面に移動し、[追加] ボタンをクリックして [広告ソースをテスト] を選択します。
広告ソースを作成したら、プレースメントのウォーターフォールの広告ソースにドラッグします。
これで、これで、メディエーションが Yahoo と正常に統合されました。
ステップ 2: 管理画面で Yahoo デマンドを設定する AdMob
広告ユニットのメディエーション設定を行う
広告ユニットのメディエーション設定に Yahoo を追加する必要があります。
AdMob アカウントにログインします。次に、[メディエーション] タブに移動します。既存のメディエーション グループを編集する場合は、そのメディエーション グループの名前をクリックして編集し、広告ソースとして Yahoo を追加するに進んでください。
新しいメディエーション グループを作成するには、[メディエーション グループを作成] を選択します。
広告フォーマットとプラットフォームを入力して、[続行] をクリックします。
メディエーション グループに名前を付けて、ターゲットとする地域を選択します。次に、メディエーション グループのステータスを [有効] に設定し、[広告ユニットを追加] をクリックします。
このメディエーション グループを、既存の 1 つ以上の広告ユニット(AdMob )に関連付けます。[完了] をクリックします。
選択した広告ユニットが入力された広告ユニットカードが表示されます。
広告ソースとして Yahoo を追加
[広告ソース] セクションの [ウォーターフォール] カードで、[広告のソースを追加] を選択します。 Yahoo を選択します。
[ Yahoo ] を選択します。 次に、 Yahoo の eCPM の値を入力し、[続行] をクリックします。Yahoo のマッピングがすでにある場合は、それを選択できます。それ以外の場合は、[マッピングを追加] をクリックします。
次に、前のセクションで取得した Placement ID and Site IDを入力します。[完了] をクリックします。
GDPR と米国の州規制の広告パートナーのリストに Yahoo 追加
GDPR 設定 米国の州規制の設定 の手順に沿って、 AdMob UI の GDPR および米国の州規制の広告パートナーのリストに Yahoo を追加します。
ステップ 3: Yahoo Mobile SDK とアダプタをインポートする
Android Studio との統合(推奨)
アプリレベルの build.gradle ファイルに、次に示す最新バージョンの Yahoo Ads SDK とアダプタの実装依存関係を追加します。
repositories { google() mavenCentral() maven { url 'https://artifactory.yahooinc.com/artifactory/maven/' } } ... dependencies { implementation 'androidx.appcompat:appcompat:1.2.0' implementation 'com.google.android.gms:play-services-ads:22.6.0' implementation 'com.google.ads.mediation:yahoo:1.4.1.1' } ...
手動統合
Yahoo Mobile SDK を組み込む場合は、Yahoo Android SDK のドキュメントをご覧ください。
Google の Maven リポジトリの Yahoo アダプタ アーティファクトに移動します。最新バージョンを選択し、Yahoo アダプタの
.aar
ファイルをダウンロードしてプロジェクトに追加します。
ステップ 4: Yahoo SDK にプライバシー設定を実装する
米国のプライバシー関連州法
米国のプライバシー関連州法 「個人情報」の「販売」は、法律で定められているとおり、オプトアウトする権利をユーザーに提供することが義務付けられています。オプトアウトするには、「販売」当事者のホームページに目立つ [個人情報を第三者に売却しない] リンクを使用します。米国のプライバシー関連州法の遵守ガイドでは、Google の広告配信について制限付きデータ処理を有効にすることができますが、Google がメディエーション チェーンの各広告ネットワークにこの設定を適用することはできません。したがって、個人情報の販売に参加する可能性のあるメディエーション チェーンの各広告ネットワークを特定し、各ネットワークのガイダンスに沿ってポリシーに準拠する必要があります。
次のサンプルコードは、同意情報を Yahoo Mobile SDK に渡す方法を示しています。このメソッドを呼び出す場合は、Google Mobile Ads SDK を使用して広告をリクエストする前に呼び出すことをおすすめします。
Java
import com.yahoo.ads.YASAds;
import com.yahoo.ads.CcpaConsent;
// ...
CcpaConsent ccpaConsent = new CcpaConsent("<CCPA CONSENT>");
YASAds.addConsent(ccpaConsent);
Kotlin
import com.yahoo.ads.YASAds
import com.yahoo.ads.CcpaConsent
// ...
val ccpaConsent = CcpaConsent("<CCPA CONSENT>")
YASAds.addConsent(ccpaConsent)
このメソッドで指定可能な値と詳細については、パブリッシャーのプライバシー設定をご覧ください。
ステップ 5: 必要なコードを追加する
Yahoo との統合にコードを追加する必要はありません。
ステップ 6: 実装をテストする
テスト広告を有効にする
AdMob にテストデバイスを登録し、 Yahoo UI でテストモードを有効にします。
テスト広告を確認する
Yahoo からテスト広告を受信していることを確認するには、広告インスペクタで Yahoo (Waterfall) 広告ソースを使用して単独の広告ソースのテストを有効にします。
省略可能なステップ
ネイティブ広告を使用する
広告レンダリング
Yahoo アダプタは、ネイティブ広告を
NativeAd
オブジェクトとして返します。以下の値が入力されます。
NativeAd
の
ネイティブ広告フィールドの説明
です。
項目 | Yahoo アダプタによってデータが入力されます |
---|---|
見出し | |
画像 | |
Body | |
アプリアイコン | |
行動を促すフレーズ | |
広告主名 | |
評価 | |
保存 | |
Price |
Yahoo Android メディエーション アダプタに関する変更履歴
次のバージョン
- 最低限必要な Google Mobile Ads SDK のバージョンを 22.4.0 に更新しました。
バージョン 1.4.1.1
- 新しい
VersionInfo
クラスを使用するようにアダプターを更新しました。 - 最低限必要な Google Mobile Ads SDK のバージョンを 22.0.0 に更新しました。
ビルドとテストに使用するプラットフォーム:
- Google Mobile Ads SDK バージョン 22.0.0 が必要です。
- Yahoo Mobile SDK 1.4.1
バージョン 1.4.1.0
- Verizon Media アダプターを「Yahoo」に名称変更しました。
- アダプタの読み込みとエラー表示について、わかりやすいエラーコードと理由を追加しました。
- Yahoo Mobile SDK バージョン 1.4.1 との互換性が確認されています。
- 最低限必要な Google Mobile Ads SDK のバージョンを 21.5.0 に更新しました。
ビルドとテストに使用するプラットフォーム:
- Google Mobile Ads SDK バージョン 21.5.0 が必要です。
- Yahoo Mobile SDK 1.4.1