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

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

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

nend のダッシュボードインターフェースでは、ラベル、ボタン、説明に日本語のテキストが使用されています。以下のスクリーンショットは翻訳されていません。このガイドでは、ラベルとボタンのことを英語の同等の表記で表記します。たとえば、「URL スキーム」は「URL スキーム」のように表されます。

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

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

統合
入札
ウォーターフォール
形式
バナー
インタースティシャル
特典
ネイティブ

要件

Android API レベル 19 以降

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

ステップ 1: nend UI で設定を行う

nend アカウントに登録またはログインします。

アプリを nend ダッシュボードに追加するには、まず [プレースメント管理] タブをクリックし、[サイト/アプリ] を選択します。[アプリを追加] ボタンをクリックして、nend にアプリを追加します。

アプリケーションを作成する

アプリの名前を入力し、アプリケーションタイプとしてアプリプラットフォームを選択します。URL を入力し、適切なアプリストアにアプリが掲載されているかどうかを確認します。

（アプリがまだリリースされていない場合は、nend の未リリースのアプリに関するよくある質問をご覧ください）。アプリのカテゴリを選択し、完了したら [作成] をクリックします。

アプリケーションが作成されると、ダッシュボードに表示されます。

プレースメントを作成する

アプリを登録したら、プレースメントの作成に進むことができます。バナー広告のプレースメントを作成するには、[プレースメント管理] タブで [プレースメント] をクリックします。次に、[新しいプレースメントを作成] ボタンをクリックします。

プルダウンメニューからアプリを選択します。次に、使用する広告フォーマットに対応する以下の手順を実施します。

[広告タイプ] で [静止画像] を選択し、[広告枠のタイプ] で [バナー] を選択します。完了したら、プレースメント名を入力し、広告枠の概要に記入し、広告枠のフォーマットを選択して、最後に広告枠のサイズを選択します。完了したら、[作成] ボタンをクリックしてプレースメントを作成します。

インタースティシャル

[広告タイプ] で [静止画像] を選択し、[広告枠のタイプ] で [インタースティシャル] を選択します。完了したら、プレースメント名を入力し、[広告枠の概要] に入力し、プルダウンリストから [広告の表示頻度] を選択します。完了したら、[作成] ボタンをクリックしてプレースメントを作成します。

インタースティシャル動画広告の場合は、[広告タイプ] に [動画] を選択し、[広告枠のタイプ] に [インタースティシャル] を選択します。完了したら、[プレースメント名] を入力し、[広告枠の概要] に入力し、プルダウンリストから適切な [カテゴリ] を選択します。完了したら、[作成] ボタンをクリックしてプレースメントを作成します。

特典

[広告タイプ] で [動画] を選択し、[広告枠のタイプ] で [リワード] を選択します。完了したら、プレースメント名を入力し、[広告枠の概要] に入力し、プルダウンリストから適切なカテゴリを選択します。

[報酬の設定] で、プルダウンリストを使用して [特典コンテンツ] を選択し、お好みの仮想通貨の名前を入力します。完了したら、[作成] ボタンをクリックしてプレースメントを作成します。

ネイティブ

[広告タイプ] で [静止画像] を選択し、[広告枠のタイプ] で [ネイティブ] を選択します。完了したら、プレースメント名を入力し、[広告枠の概要] に入力して、[広告画像の選択] を選択します。完了したら、[作成] ボタンをクリックしてプレースメントを作成します。

ネイティブ動画広告の場合は、[広告タイプ] で [動画] を選択し、[広告枠のタイプ] で [ネイティブ（カスタム）] を選択します。完了したら、プレースメント名を入力し、[広告枠の概要] に入力して、プルダウンリストから適切なカテゴリを選択します。

[ネイティブ設定] で、リストから [動画広告の向き] と [ネイティブ広告タイプ] を選択します。完了したら、[作成] ボタンをクリックしてプレースメントを作成します。

次のセクションで AdMob 広告ユニットを設定するには、各プレースメントの apiKey と spotID が必要です。確認するには、[プレースメント管理] タブで、アプリ名の下にある [SDK] ボタンを選択します。

apiKey と spotID をメモしておきます。

また、nend の Reporting API で使用する API キーも必要です。この API は、スクレイピング用の API キーと呼んでいます。この機能は [Tools] タブから利用できます。

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

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

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

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

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

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

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

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

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

広告ソースとして nend を追加

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

[nend] を選択して、[最適化] スイッチを有効にします。前のセクションで取得した Reporting API Key from the API Key for Scrapingを入力して、nendの広告ソースの最適化を設定します。次に、nend の eCPM の値を入力し、[続行] をクリックします。

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

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

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

Android Studio との統合（推奨）

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

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://fan-adn.github.io/nendSDK-Android-lib/library")
    }
  }
}

次に、アプリレベルの build.gradle.kts ファイルで、次の実装依存関係と構成を追加します。最新バージョンの nend SDK とアダプターを使用してください。

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.0.0")
    implementation("com.google.ads.mediation:nend:10.0.0.0")
}

手動による統合

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

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

nend との統合にコードを追加する必要はありません。

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

テスト広告を有効にする

AdMob。バナー、インタースティシャル、リワードのテスト広告を取得するには、 nend テスト広告ユニットのページで提供される API キーとスポット ID を使用することをおすすめします。これらの ID は、テスト中は AdMob 広告ユニットの API キーと Spot ID として入力できます。アプリの本番環境の準備が整うと、実際の API キーと Spot ID に置き換えられます。

テスト広告を確認する

nendからテスト広告を受信していることを確認するには、広告インスペクタで nend (Waterfall) 広告ソースを使用して単独の広告ソースのテストを有効にします。

省略可能なステップ

ネットワーク固有のパラメータ

nend アダプターは、NendExtrasBundleBuilder クラスを使用してアダプターに渡すことができる追加のリクエストパラメータをサポートしています。このクラスには次のメソッドが含まれます。

setInterstitialType(InterstitialType): Nend には、通常のインタースティシャル広告の場合は TYPE_NORMAL を選択し、インタースティシャル動画広告の場合は TYPE_VIDEO を選択できます。このパラメータが追加されていない場合、nend はデフォルトでインタースティシャルタイプとして TYPE_NORMAL を使用します。
setNativeAdsType(nativeAdsType): nend には、通常のネイティブ広告の場合は TYPE_NORMAL を選択し、ネイティブ動画広告の場合は TYPE_VIDEO を選択できます。このパラメータが追加されていない場合、nend はデフォルトでネイティブ広告のタイプとして TYPE_NORMAL を使用します。

Java

Bundle bundle = new NendAdapter.NendExtrasBundleBuilder()
                        .setInterstitialType(InterstitialType.TYPE_NORMAL)
                        .setNativeAdsType(FormatType.TYPE_NORMAL)
                        .build();

AdRequest adRequest = new AdRequest.Builder()
    .addNetworkExtrasBundle(NendAdapter.class, bundle)
    .build();

adLoader.loadAd(adRequest);

Kotlin

val bundle = NendAdapter.NendExtrasBundleBuilder()
                     .setInterstitialType(InterstitialType.TYPE_NORMAL)
                     .setNativeAdsType(FormatType.TYPE_NORMAL)
                     .build()

val adRequest = AdRequest.Builder()
    .addNetworkExtrasBundle(NendAdapter.class, bundle)
    .build()

adLoader.loadAd(adRequest)

ネイティブ広告を使用する

広告レンダリング

Nend アダプタは、ネイティブ広告を NativeAd オブジェクトとして返します。以下の値が入力されます。 NativeAd のネイティブ広告フィールドの説明です。

項目	Nend アダプターによってデータが入力されます。
見出し
画像	1
本文
アプリアイコン	2
行動を促すフレーズ
広告主名
評価
格納
Price

¹ Nend では、広告画像の選択が横長（5: 3）の大きな広告画像に設定されているネイティブプレースメントのみ画像アセットが提供されます。

² Nend では、[広告画像の選択] が [画像なし（テキストのみ）] に設定されているネイティブプレースメント用のアイコンアセットは提供していません。

エラーコード

アダプタが nend から広告を受信できない場合、パブリッシャーは、次のクラスの ResponseInfo.getAdapterResponse() を使用して、広告レスポンスの根本的なエラーを確認できます。

形式	クラス名
バナー	com.google.ads.mediation.nend.NendAdapter
インタースティシャル	com.google.ads.mediation.nend.NendAdapter
特典	com.google.ads.mediation.nend.NendRewardedAdapter
ネイティブ	com.google.ads.mediation.nend.NendMediationAdapter

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

エラーコード	ドメイン	理由
101	com.google.ads.mediation.nend	nend では、広告を読み込んで表示するには、アクティビティのコンテキストが必要です。
102	com.google.ads.mediation.nend	UI で設定されている nend サーバーのパラメータが見つからないか、無効です。 AdMob
103	com.google.ads.mediation.nend	nend の広告はまだ表示できる準備が整っていません。
104	com.google.ads.mediation.nend	nend が広告を再生できませんでした。
105	com.google.ads.mediation.nend	リクエストされた広告サイズが、nend でサポートされているバナーサイズと一致しません。
106	com.google.ads.mediation.nend	Context オブジェクト参照が `null` であるか、メモリから最近解放されました。
200-299	net.nend.android	nend SDK からインタースティシャル広告の読み込みエラーが返されました。詳しくは、コードをご覧ください。
300-399	net.nend.android	nend SDK からインタースティシャル広告の表示エラーが返されました。詳しくは、コードをご覧ください。
400-499	net.nend.android	nend SDK から広告エラーが返されました。詳しくは、コードをご覧ください。
101	com.google.mediation.nend	nend SDK が、追加のエラー情報なしで読み込み失敗のコールバックを返しました。
102	com.google.mediation.nend	nend SDK が、追加のエラー情報なしで障害を示すコールバックを返しました。
103	com.google.mediation.nend	UI で設定されている nend サーバーのパラメータが見つからないか、無効です。 AdMob
104	com.google.mediation.nend	ネイティブ広告の画像アセットを読み込めませんでした。
105	com.google.mediation.nend	広告の準備ができていないため、nend の広告を表示できませんでした。
106	com.google.mediation.nend	リクエストされたバナー広告のサイズが、nend でサポートされているバナーサイズと一致しません。
200 ～ 699	nend SDK から送信されています。	nend SDK からエラーが返されました。詳しくは、nend のドキュメントをご覧ください。

nend Android メディエーションアダプタに関する変更履歴

バージョン 10.0.0.0

最低限必要な Google Mobile Ads SDK のバージョンを 22.3.0 に更新しました。
nend SDK 10.0.0 との互換性を検証しました。

Google Cloud の

Google Mobile Ads SDK バージョン 22.3.0 が必要です。
Nend SDK バージョン 10.0.0。

バージョン 9.0.1.0

新しい VersionInfo クラスを使用するようにアダプターを更新しました。
最低限必要な Google Mobile Ads SDK のバージョンを 22.0.0 に更新しました。
nend SDK 9.0.1 との互換性を確認。

Google Cloud の

Google Mobile Ads SDK バージョン 22.0.0 が必要です。
Nend SDK バージョン 9.0.1。

バージョン 9.0.0.0

nend SDK 9.0.0 との互換性を確認。
最低限必要な Google Mobile Ads SDK のバージョンを 21.2.0 に更新しました。

Google Cloud の

Google Mobile Ads SDK バージョン 21.2.0 が必要です。
Nend SDK バージョン 9.0.0。

バージョン 8.2.0.0

nend SDK 8.2.0 との互換性を検証済み。

Google Cloud の

Google Mobile Ads SDK バージョン 21.0.0 が必要です。
Nend SDK バージョン 8.2.0。

バージョン 8.1.0.1

compileSdkVersion と targetSdkVersion を API 31 に更新しました。
最低限必要な Google Mobile Ads SDK のバージョンを 21.0.0 に更新しました。

Google Cloud の

Google Mobile Ads SDK バージョン 21.0.0 が必要です。
Nend SDK バージョン 8.1.0。

バージョン 8.1.0.0

nend SDK 8.1.0 との互換性を検証しました。
nend が null の広告画像またはロゴの URL を返したときに NullPointerException がクラッシュする問題を修正しました。
最低限必要な Google Mobile Ads SDK のバージョンを 20.5.0 に更新しました。

Google Cloud の

Google Mobile Ads SDK バージョン 20.5.0 が必要です。
Nend SDK バージョン 8.1.0。

バージョン 8.0.1.0

nend SDK 8.0.1 との互換性を確認。
誤ったドメインを使用して一部の AdError オブジェクトが返されるバグを修正しました。
最低限必要な Google Mobile Ads SDK のバージョンを 20.4.0 に更新しました。

Google Cloud の

Google Mobile Ads SDK バージョン 20.4.0 が必要です。
Nend SDK バージョン 8.0.1。

バージョン 7.1.0.0

nend SDK 7.1.0 との互換性を確認。
nend の UNSUPPORTED_DEVICE エラーを取得するようにエラーコードを更新しました。
最低限必要な Google Mobile Ads SDK のバージョンを 20.2.0 に更新しました。

Google Cloud の

Google Mobile Ads SDK バージョン 20.2.0 が必要です。
Nend SDK バージョン 7.1.0。

バージョン 7.0.3.0

nend SDK 7.0.3 との互換性を検証しました。
アダプタの読み込み/表示失敗について、わかりやすいエラーコードと理由を追加しました。
最低限必要な Google Mobile Ads SDK のバージョンを 20.0.0 に更新しました。

Google Cloud の

Google Mobile Ads SDK バージョン 20.0.0 が必要です。
Nend SDK バージョン 7.0.3。

バージョン 7.0.0.0

nend SDK 7.0.0 との互換性を確認。
最低限必要な Google Mobile Ads SDK のバージョンを 19.4.0 に更新しました。

Google Cloud の

Google Mobile Ads SDK バージョン 19.4.0 が必要です。
Nend SDK バージョン 7.0.0。

バージョン 6.0.1.0

nend SDK 6.0.1 との互換性を確認。
最低限必要な Google Mobile Ads SDK のバージョンを 19.3.0 に更新しました。

Google Cloud の

Google Mobile Ads SDK バージョン 19.3.0 が必要です。
Nend SDK バージョン 6.0.1。

バージョン 6.0.0.0

nend SDK 6.0.0 との互換性を確認。
最小 Android SDK バージョンを API 19 に更新しました。

Google Cloud の

Google Mobile Ads SDK バージョン 19.2.0 が必要です。
Nend SDK バージョン 6.0.0。

バージョン 5.4.2.1

インラインアダプティブバナーリクエストをサポートするようにアダプターを更新しました。
スマートバナー広告が破棄されたときに発生する可能性がある、まれな競合状態によるクラッシュを修正しました。
最低限必要な Google Mobile Ads SDK のバージョンを 19.2.0 に更新しました。

Google Cloud の

Google Mobile Ads SDK バージョン 19.2.0 が必要です。
Nend SDK バージョン 5.4.2。

バージョン 5.4.2.0

ネイティブ広告がサポートされるようになりました。
nend SDK 5.4.2 との互換性を検証しました。
最低限必要な Google Mobile Ads SDK のバージョンを 19.0.0 に更新しました。

Google Cloud の

Google Mobile Ads SDK バージョン 19.0.0 が必要です。
Nend SDK バージョン 5.4.2。

バージョン 5.3.0.0

nend SDK 5.3.0 との互換性を検証しました。
最低限必要な Google Mobile Ads SDK のバージョンを 18.2.0 に更新しました。

Google Cloud の

Google Mobile Ads SDK バージョン 18.2.0 が必要です。
Nend SDK バージョン 5.3.0。

バージョン 5.2.0.0

nend SDK 5.2.0 との互換性を検証しました。
最低限必要な Google Mobile Ads SDK のバージョンを 18.1.1 に更新しました。

バージョン 5.1.0.4

バナー広告とインタースティシャル広告が onAdClicked() イベントを転送しない問題を修正しました。
nend のバナー広告が破棄されたときに NullPointerException がスローされる問題を修正しました。
アダプターを AndroidX に移行しました。
最低限必要な Google Mobile Ads SDK のバージョンを 18.0.0 に更新しました。

バージョン 5.1.0.3

スマートバナーに nend バナーの一部を表示するための実装を追加しました。スマートバナーに適したサイズ
- 縦向きと横向き
  - スマートフォン: 320×50
  - タブレット: 728×90 または 320×50

バージョン 5.1.0.2

柔軟なバナー広告サイズのサポートを追加しました。

バージョン 5.1.0.1

新しいオープンベータ版リワード API をサポートするようにアダプタを更新しました。
最低限必要な Google Mobile Ads SDK のバージョンを 17.2.0 に更新しました。

バージョン 5.1.0.0

nend SDK 5.1.0 との互換性を検証しました。

バージョン 5.0.2.1

次のメソッドが AdRequest.Builder で非推奨となったため、ユーザー機能を転送する関数を削除しました。
- setGender()
- setBirthday()
- setIsDesignedForFamiles()

バージョン 5.0.2.0

nend SDK 5.0.2 との互換性を検証しました。

バージョン 5.0.1.0

nend SDK 5.0.1 との互換性を確認。

バージョン 5.0.0.0

nend SDK 5.0.0 との互換性を検証しました。

バージョン 4.0.5.0

nend SDK 4.0.5 との互換性を確認。

バージョン 4.0.4.1

RewardedVideoAdListener の onRewardedVideoCompleted() メソッドがサポートされています。

バージョン 4.0.4.0

nend SDK 4.0.4 との互換性を確認。

バージョン 4.0.2.1

NendExtrasBundleBuilder クラスを使用してメディエーションエクストラの Bundle を作成する機能を追加しました。

バージョン 4.0.2.0

Google モバイル広告メディエーションのオープンソースプロジェクトで初リリース。
バナー広告、インタースティシャル広告、動画リワード広告のサポートを追加しました。

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

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

要件

ステップ 1: nend UI で設定を行う

アプリケーションを作成する

プレースメントを作成する

バナー

インタースティシャル

特典

ネイティブ

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

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

広告ソースとして nend を追加

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

Android Studio との統合（推奨）

手動による統合

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

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

テスト広告を有効にする

テスト広告を確認する

省略可能なステップ

ネットワーク固有のパラメータ

Java

Kotlin

ネイティブ広告を使用する

広告レンダリング

エラーコード

nend Android メディエーション アダプタに関する変更履歴

バージョン 10.0.0.0

バージョン 9.0.1.0

バージョン 9.0.0.0

バージョン 8.2.0.0

バージョン 8.1.0.1

バージョン 8.1.0.0

バージョン 8.0.1.0

バージョン 7.1.0.0

バージョン 7.0.3.0

バージョン 7.0.0.0

バージョン 6.0.1.0

バージョン 6.0.0.0

バージョン 5.4.2.1

バージョン 5.4.2.0

バージョン 5.3.0.0

バージョン 5.2.0.0

バージョン 5.1.0.4

バージョン 5.1.0.3

バージョン 5.1.0.2

バージョン 5.1.0.1

バージョン 5.1.0.0

バージョン 5.0.2.1

バージョン 5.0.2.0

バージョン 5.0.1.0

バージョン 5.0.0.0

バージョン 4.0.5.0

バージョン 4.0.4.1

バージョン 4.0.4.0

バージョン 4.0.2.1

バージョン 4.0.2.0

nend Android メディエーションアダプタに関する変更履歴