Mengintegrasikan nend dengan Mediasi

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK untuk memuat dan menampilkan iklan dari Nn menggunakan mediasi, yang mencakup integrasi waterfall. Artikel ini membahas cara menambahkan nend ke konfigurasi mediasi unit iklan, dan cara mengintegrasikan nend SDK dan adaptor ke aplikasiAndroid .

Antarmuka dasbor nend menggunakan teks bahasa Jepang untuk label, tombol, dan deskripsinya, serta screenshot yang ditampilkan di bawah belum diterjemahkan. Dalam panduan ini, label dan tombol dirujuk oleh padanannya dalam bahasa Inggris. Misalnya, "URL 多ปーム," adalah "Skema URL", dan seterusnya.

Integrasi dan format iklan yang didukung

Adaptor AdMob mediasi untuk nend memiliki kemampuan berikut:

Integrasi
Bidding
Air terjun
Format
Banner
Interstisial
Diberikan sebagai reward
Native

Persyaratan

  • Android API level 19 atau yang lebih tinggi
  • Google Mobile Ads SDK terbaru

Langkah 1: Siapkan Nend

Daftar atau login ke akun lain.

Untuk menambahkan aplikasi Anda ke dasbor nend, klik tab Deployment Management terlebih dahulu, lalu pilih Situs/Aplikasi. Klik tombol Tambahkan aplikasi untuk menambahkan aplikasi Anda ke nend.

Membuat aplikasi

Masukkan nama aplikasi, lalu pilih Android application sebagai application type. Masukkan URL dan periksa apakah aplikasi Anda ada di Google Play (lihat FAQ aplikasi yang belum dirilis Nend jika aplikasi Anda belum dirilis). Pilih kategori untuk aplikasi Anda, lalu klik Buat jika sudah selesai.

Aplikasi Anda akan ditampilkan di dasbor setelah aplikasi dibuat.

Membuat penempatan

Setelah aplikasi didaftarkan, Anda dapat melanjutkan untuk membuat penempatan. Untuk membuat penempatan untuk iklan banner, buka tab Pengelolaan Penempatan, lalu klik Penempatan. Kemudian, klik tombol Buat penempatan baru.

Pilih aplikasi Anda di menu drop-down. Kemudian, ikuti petunjuk di bawah ini yang sesuai dengan format iklan pilihan Anda.

Pilih Gambar diam untuk Jenis iklan, dan Banner untuk Jenis inventaris. Setelah selesai, masukkan Nama Penempatan, isi Pengantar inventaris, pilih Format inventaris, dan akhirnya pilih Ukuran inventaris yang diinginkan. Setelah selesai, klik tombol Buat untuk membuat penempatan Anda.

Interstisial

Pilih Gambar diam untuk Jenis iklan, dan Interstisial untuk Jenis inventaris. Setelah selesai, masukkan Nama Penempatan, isi Pengantar inventaris, lalu pilih Frekuensi tampilan iklan yang diinginkan dari menu drop-down. Setelah selesai, klik tombol Buat untuk membuat penempatan Anda.

Untuk iklan video Interstisial, pilih Video untuk Jenis iklan, dan Interstisial untuk Jenis inventaris. Setelah selesai, masukkan Nama Penempatan, isi Pengantar inventaris, lalu pilih Kategori yang sesuai dari menu drop-down. Setelah selesai, klik tombol Buat untuk membuat penempatan Anda.

Diberikan sebagai reward

Pilih Video untuk Jenis iklan, dan Reward untuk Jenis inventaris. Setelah selesai, masukkan Nama Penempatan, isi Pengantar inventaris, lalu pilih Kategori yang sesuai dari menu drop-down.

Pada bagian Setelan reward, pilih Konten reward yang diinginkan menggunakan menu drop-down, lalu masukkan Nama mata uang virtual pilihan Anda. Setelah selesai, klik tombol Buat untuk membuat penempatan Anda.

Native

Pilih Gambar diam untuk Jenis iklan, dan Native untuk Jenis inventaris. Setelah selesai, masukkan Nama Penempatan, isi Pengantar inventaris, lalu pilih Pemilihan gambar iklan yang diinginkan. Setelah selesai, klik tombol Buat untuk membuat penempatan Anda.

Untuk iklan video Native, pilih Video untuk Jenis iklan, dan Native (kustom) untuk Jenis inventaris. Setelah selesai, masukkan Nama Penempatan, isi Pengantar inventaris, lalu pilih Kategori yang sesuai dari menu drop-down.

Di bagian Setelan native, pilih Orientasi iklan video yang diinginkan dan Jenis iklan native dari daftar. Setelah selesai, klik tombol Buat untuk membuat penempatan Anda.

Untuk menyiapkan AdMob unit iklan di bagian berikutnya, Anda memerlukan apiKey dan spotID untuk setiap penempatan. Untuk menemukannya, buka tab Penempatan Pengelolaan dan pilih tombol SDK di bawah nama aplikasi Anda.

Catat apiKey dan spotID.

Anda juga memerlukan Kunci API untuk API pelaporan nend, yang disebut sebagai Kunci API untuk Scraping. Anda dapat menemukannya di tab Alat.

Langkah 2: Konfigurasikan setelan mediasi untuk AdMob unit iklan

Berikutnya, Anda perlu menambahkan nend ke konfigurasi mediasi untuk unit iklan Anda. Pertama, login ke akun AdMob.

Buka tab Mediasi. Jika Anda sudah memiliki grup mediasi yang ingin diubah, klik nama grup mediasi tersebut untuk mengeditnya, lalu lanjutkan ke Menambahkan nend sebagai sumber iklan.

Untuk membuat grup mediasi baru, pilih Buat Grup Mediasi.

Masukkan format dan platform iklan Anda, lalu klik Lanjutkan.

Berikan nama pada grup mediasi, lalu pilih lokasi yang akan ditargetkan. Berikutnya, tetapkan status grup mediasi ke Enabled. Lalu klik Tambahkan Unit Iklan.

Grup mediasi 2

Kaitkan grup mediasi ini dengan satu atau beberapa unit iklan AdMob yang ada. Kemudian, klik Selesai.

Pilih unit iklan

Sekarang Anda akan melihat kartu unit iklan yang terisi dengan unit iklan yang Anda pilih, seperti yang ditunjukkan di bawah:

Unit iklan grup

Tambahkan nend sebagai sumber iklan

Di kartu Sumber Iklan, pilih Tambahkan Jaringan Iklan.

Pilih nend dan aktifkan tombol Optimize. Masukkan Kunci API untuk Scraping yang diperoleh dari nend sebelumnya sebagai Reporting API Key guna menyiapkan pengoptimalan sumber iklan untuk nend. Kemudian, masukkan nilai eCPM untuk nend, lalu klik Continue.

Masukkan Spot ID dan Kunci API yang diperoleh di bagian sebelumnya, lalu klik Done.

Menggunakan iklan reward

Di setelan untuk unit iklan reward, berikan nilai untuk jumlah reward dan jenis reward. Kemudian, untuk memastikan Anda memberikan reward yang sama kepada pengguna, apa pun jaringan iklan yang ditayangkan, centang kotak Terapkan untuk semua jaringan di grup Mediasi.

Jika Anda tidak menerapkan setelan ini, adaptor nend akan meneruskan kembali reward yang ditentukan di dasbor nend.

Untuk informasi selengkapnya tentang cara menetapkan nilai reward untuk unit iklan AdMob, lihat Membuat unit iklan.

Langkah 3: Impor adaptor dan SDK nend

Tambahkan repositori Maven nend dan dependensi implementasi berikut dengan versi terbaru SDK dan adaptor nend pada file build.gradle level aplikasi:

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

...
dependencies {
    implementation 'com.google.android.gms:play-services-ads:21.3.0'
    implementation 'com.google.ads.mediation:nend:9.0.0.0'
}
...

Integrasi manual

  1. Download versi terbaru nend Android SDK dan tambahkan ke project Anda.

  2. Buka artefak adaptor Nend di Repositori Maven Google. Pilih versi terbaru, download file .aar adaptor nend, dan tambahkan ke project Anda.

Langkah 4: Diperlukan kode tambahan

Kode tambahan tidak diperlukan untuk integrasi online.

Langkah 5: Uji penerapan Anda

Untuk mendapatkan iklan uji coba untuk banner, interstisial, dan reward, nend merekomendasikan penggunaan kunci API dan ID Spot yang disediakan di halaman nend test ad unit halaman. ID ini dapat dimasukkan sebagai Kunci API dan ID Spot untuk unit iklan AdMob Anda saat pengujian, lalu diganti dengan Kunci API dan ID Spot yang sebenarnya saat aplikasi Anda siap untuk produksi.

Langkah opsional

Parameter khusus jaringan

Adaptor nend mendukung parameter permintaan tambahan untuk iklan interstisial yang dapat diteruskan ke adaptor menggunakan class NendExtrasBundleBuilder. Class ini mencakup metode berikut:

  • setUserId(String) - Menetapkan UserID iklan interstisial nend tertentu.
  • setInterstitialType(InterstitialType) - Nend memberikan opsi memilih TYPE_NORMAL untuk iklan insterstisial reguler atau TYPE_VIDEO untuk iklan video interstisial.
  • setNativeAdsType(nativeAdsType) - Nend memberikan opsi memilih TYPE_NORMAL untuk iklan native reguler atau TYPE_VIDEO untuk iklan video native.

Java

Bundle bundle = new NendAdapter.NendExtrasBundleBuilder()
                        .setUserId("userId")
                        .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()
                     .setUserId("userId")
                     .setInterstitialType(InterstitialType.TYPE_NORMAL)
                     .setNativeAdsType(FormatType.TYPE_NORMAL)
                     .build()

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

adLoader.loadAd(adRequest)

Menggunakan iklan native

Rendering iklan

Adaptor Nend menampilkan iklan native-nya sebagai objek NativeAd . Kolom ini mengisi Deskripsi kolom iklan native berikut untuk NativeAd.

Kolom Diisi oleh adaptor Nend
Judul
Image 1
Isi
Ikon aplikasi 2
Call to action
Nama Pengiklan
Rating bintang
App Store
Harga

1 Nend hanya menyediakan aset Gambar untuk penempatan native yang dikonfigurasi dengan Pemilihan gambar iklan yang disetel ke Horizontal (5: 3) gambar iklan besar.

2 Nend tidak menyediakan aset Ikon untuk penempatan native yang dikonfigurasi dengan Pemilihan gambar iklan yang disetel ke Tanpa gambar (khusus teks).

Kode error

Jika adaptor gagal menerima iklan dari nend, penayang dapat memeriksa error yang mendasari dari respons iklan menggunakan ResponseInfo.getAdapterResponse() pada class berikut:

Format Nama kelas
Banner com.google.ads.mediation.nend.NendAdapter
Interstisial com.google.ads.mediation.nend.NendAdapter
Diberikan sebagai reward com.google.ads.mediation.nend.NendRewardedAdapter
Native com.google.ads.mediation.nend.NendMediationAdapter

Berikut adalah kode dan pesan pendamping yang dilemparkan oleh adaptor nend saat iklan gagal dimuat:

Kode error Domain Alasan
101 com.google.ads.mediation.nend nend memerlukan konteks aktivitas untuk memuat dan menampilkan iklan.
102 com.google.ads.mediation.nend Parameter server Nend yang dikonfigurasi di UI AdMob tidak ada/tidak valid.
103 com.google.ads.mediation.nend nend iklan belum siap ditampilkan.
104 com.google.ads.mediation.nend nend gagal memutar iklan.
105 com.google.ads.mediation.nend Ukuran iklan yang diminta tidak cocok dengan ukuran banner yang didukung Nn.
106 com.google.ads.mediation.nend Referensi objek Context adalah null dan/atau baru-baru ini dilepaskan dari memori.
200-299 net.nend.android nend SDK menampilkan error pemuatan iklan interstisial. Lihat kode untuk detail selengkapnya.
300-399 net.nend.android nend SDK menampilkan error iklan interstisial. Lihat kode untuk detail selengkapnya.
400-499 net.nend.android nend SDK menampilkan error iklan. Lihat kode untuk detail selengkapnya.
101 com.google.mediasi.nend nend SDK menampilkan callback kegagalan pemuatan tanpa informasi error tambahan.
102 com.google.mediasi.nend nend SDK menampilkan callback kegagalan acara tanpa informasi error tambahan.
103 com.google.mediasi.nend Parameter server Nend yang dikonfigurasi di UI AdMob tidak ada/tidak valid.
104 com.google.mediasi.nend Gagal memuat aset gambar iklan native.
105 com.google.mediasi.nend Gagal menampilkan iklan biasa karena iklan belum siap.
106 com.google.mediasi.nend Ukuran iklan banner yang diminta tidak cocok dengan ukuran banner yang didukung Nn.
200-699 Dikirim oleh nend SDK. nend SDK menampilkan error. Lihat dokumen nend untuk detail selengkapnya.

Log Perubahan Adaptor Mediasi Android nend

Versi 9.0.0.0

  • Kompatibilitas terverifikasi dengan nend SDK 9.0.0.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 21.2.0.

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 21.2.0.
  • Nend SDK versi 9.0.0.

Versi 8.2.0.0

  • Kompatibilitas terverifikasi dengan nend SDK 8.2.0.

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 21.0.0.
  • Nend SDK versi 8.2.0.

Versi 8.1.0.1

  • Mengupdate compileSdkVersion dan targetSdkVersion ke API 31.
  • Mengupdate versi minimum Google Mobile Ads SDK minimum ke 21.0.0.

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 21.0.0.
  • Nend SDK versi 8.1.0.

Versi 8.1.0.0

  • Kompatibilitas terverifikasi dengan nend SDK 8.1.0.
  • Memperbaiki error NullPointerException saat nend menampilkan URL gambar atau URL iklan null.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 20.5.0.

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 20.5.0.
  • Nend SDK versi 8.1.0.

Versi 8.0.1.0

  • Kompatibilitas terverifikasi dengan nend SDK 8.0.1.
  • Memperbaiki bug saat beberapa objek AdError ditampilkan menggunakan domain yang salah.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke versi 20.4.0.

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 20.4.0.
  • Nend SDK versi 8.0.1.

Versi 7.1.0.0

  • Kompatibilitas terverifikasi dengan nend SDK 7.1.0.
  • Memperbarui kode error untuk menangkap error UNSUPPORTED_DEVICE nend.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 20.2.0.

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 20.2.0.
  • Nend SDK versi 7.1.0.

Versi 7.0.3.0

  • Kompatibilitas terverifikasi dengan nend SDK 7.0.3.
  • Menambahkan kode error deskriptif dan alasan kegagalan pemuatan/tampilan adaptor.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke versi 20.0.0.

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 20.0.0.
  • Nend SDK versi 7.0.3.

Versi 7.0.0.0

  • Kompatibilitas terverifikasi dengan nend SDK 7.0.0.
  • Versi minimum Google Mobile Ads SDK minimum telah diupdate ke 19.4.0.

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 19.4.0.
  • Nend SDK versi 7.0.0.

Versi 6.0.1.0

  • Kompatibilitas terverifikasi dengan nend SDK 6.0.1.
  • Versi minimum Google Mobile Ads SDK minimum telah diupdate ke 19.3.0.

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 19.3.0.
  • Nend SDK versi 6.0.1.

Versi 6.0.0.0

  • Kompatibilitas terverifikasi dengan nend SDK 6.0.0.
  • Mengupdate versi SDK Android minimum ke API 19.

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 19.2.0.
  • Nend SDK versi 6.0.0.

Versi 5.4.2.1

  • Memperbarui adaptor untuk mendukung permintaan banner adaptif inline.
  • Memperbaiki error kondisi race yang jarang terjadi yang mungkin terjadi saat iklan banner cerdas dihancurkan.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 19.2.0.

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 19.2.0.
  • Nend SDK versi 5.4.2.

Versi 5.4.2.0

  • Menambahkan dukungan untuk iklan native.
  • Kompatibilitas terverifikasi dengan nend SDK 5.4.2.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 19.0.0.

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 19.0.0.
  • Nend SDK versi 5.4.2.

Versi 5.3.0.0

  • Kompatibilitas terverifikasi dengan nend SDK 5.3.0.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 18.2.0.

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 18.2.0.
  • Nend SDK versi 5.3.0.

Versi 5.2.0.0

  • Kompatibilitas terverifikasi dengan nend SDK 5.2.0.
  • Versi minimum Google Mobile Ads SDK minimum telah diupdate ke 18.1.1.

Versi 5.1.0.4

  • Memperbaiki masalah saat iklan Banner dan Interstisial tidak meneruskan peristiwa onAdClicked().
  • Memperbaiki masalah ketika NullPointerException ditampilkan saat iklan Banner Nendak dihancurkan.
  • Memigrasikan adaptor ke AndroidX.
  • Versi minimum Google Mobile Ads SDK minimum telah diupdate ke 18.0.0.

Versi 5.1.0.3

  • Menambahkan implementasi untuk menampilkan bagian dari banner nend di SmartBanner. Ukuran yang sesuai untuk SmartBanner
    • Potret dan Lanskap
      • Ponsel: 320×50
      • Tablet: 728×90 atau 320×50

Versi 5.1.0.2

  • Menambahkan dukungan untuk ukuran iklan banner fleksibel.

Versi 5.1.0.1

  • Memperbarui adaptor untuk mendukung Rewarded API beta terbuka yang baru.
  • Versi minimum Google Mobile Ads SDK minimum telah diupdate ke 17.2.0.

Versi 5.1.0.0

  • Kompatibilitas terverifikasi dengan nend SDK 5.1.0.

Versi 5.0.2.1

  • Menghapus fungsi yang meneruskan fitur pengguna karena metode berikut tidak digunakan lagi pada AdRequest.Builder.
    • setGender()
    • setBirthday()
    • setIsDesignedForFamiles()

Versi 5.0.2.0

  • Kompatibilitas terverifikasi dengan nend SDK 5.0.2.

Versi 5.0.1.0

  • Kompatibilitas terverifikasi dengan nend SDK 5.0.1.

Versi 5.0.0.0

  • Kompatibilitas terverifikasi dengan nend SDK 5.0.0.

Versi 4.0.5.0

  • Kompatibilitas terverifikasi dengan nend SDK 4.0.5.

Versi 4.0.4.1

  • Mendukung metode onRewardedVideoCompleted() dari RewardedVideoAdListener.

Versi 4.0.4.0

  • Kompatibilitas terverifikasi dengan nend SDK 4.0.4.

Versi 4.0.2.1

  • Menambahkan kemampuan untuk membuat Bundle tambahan mediasi menggunakan class NendExtrasBundleBuilder.

Versi 4.0.2.0

  • Rilis pertama di project open source Mediasi Google Mobile Ads.
  • Menambahkan dukungan untuk banner, interstisial, dan iklan video reward.