Mengintegrasikan nend dengan Mediasi

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

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

Integrasi dan format iklan yang didukung

Adaptor mediasi Ad Manager untuk nend memiliki kemampuan berikut:

Integrasi
Bidding
Waterfall
Format
Banner
Interstisial
Diberikan sebagai reward
Native

Persyaratan

  • Android API level 19 atau yang lebih tinggi

Langkah 1: Menyiapkan konfigurasi di nend UI

Daftar atau login ke akun nend Anda.

Untuk menambahkan aplikasi ke dasbor nend, klik tab Placement Management terlebih dahulu, lalu pilih Site/App. Klik tombol Add an app untuk menambahkan aplikasi Anda ke nend.

Membuat aplikasi

Masukkan nama aplikasi Anda dan pilih platform aplikasi sebagai jenis aplikasi. Masukkan URL dan periksa apakah aplikasi Anda tersedia di app store yang sesuai

(lihat FAQ tentang aplikasi yang belum dirilis dari nend jika aplikasi Anda belum dirilis). Pilih kategori untuk aplikasi Anda, lalu klik Create jika sudah selesai.

Aplikasi Anda akan ditampilkan di dasbor setelah dibuat.

Membuat penempatan

Setelah aplikasi terdaftar, Anda dapat melanjutkan ke tahap pembuatan penempatan. Untuk membuat penempatan iklan banner, buka tab Pengelolaan Penempatan dan klik Penempatan. Lalu klik tombol Buat penempatan baru.

Pilih aplikasi Anda di menu drop-down. Kemudian, ikuti petunjuk di bawah 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, lalu pilih Ukuran inventaris. Setelah selesai, klik tombol Buat untuk membuat penempatan.

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 dari menu drop-down. Setelah selesai, klik tombol Buat untuk membuat penempatan.

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.

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 menggunakan menu drop-down, masukkan Nama mata uang virtual pilihan Anda. Setelah selesai, klik tombol Buat untuk membuat penempatan.

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. Setelah selesai, klik tombol Buat untuk membuat penempatan.

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 dan Jenis iklan native dari daftar. Setelah selesai, klik tombol Buat untuk membuat penempatan.

Untuk menyiapkan Ad Manager unit iklan di bagian berikutnya, Anda memerlukan apiKey dan spotID untuk setiap penempatan. Untuk menemukannya, buka tab Placement Management dan pilih tombol SDK di bagian nama aplikasi Anda.

Catat apiKey dan spotID.

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

Langkah 2: Siapkan nend demand di Ad Manager UI

Mengonfigurasi setelan mediasi untuk unit iklan

Login ke akun Ad Manager.

Buka Penayangan > Grup hasil, lalu klik tombol Grup hasil baru.

Masukkan Nama unik untuk grup hasil Anda, tetapkan Status menjadi Aktif, pilih Format Iklan, dan tetapkan Jenis inventaris ke Aplikasi Seluler. Di bagian Penargetan > Inventaris, pilih unit iklan di bagian Inventaris dan Aplikasi seluler yang ingin Anda tambahi mediasi.

Selanjutnya, klik tombol Tambahkan partner hasil.

Jika sudah memiliki Partner hasil untuk nend, Anda dapat memilihnya. Jika tidak, pilih Buat partner hasil baru.

Pilih nend sebagai Jaringan iklan, masukkan Nama unik dan aktifkan Mediasi.

Aktifkan Pengumpulan data otomatis, lalu masukkan Reporting API Key from the API Key for Scraping yang diperoleh di bagian sebelumnya.

Setelah Partner hasil dipilih, pilih Mediasi SDK Seluler sebagai Jenis integrasi, Android sebagai Platform, dan Aktif sebagai Status. Masukkan Slot ID and API Key yang diperoleh di bagian sebelumnya. Lalu, masukkan nilai CPM Default.

Klik Save di bagian bawah halaman jika sudah selesai.

Langkah 3: Impor nend SDK dan adaptor

Di file settings.gradle.kts level project, tambahkan repositori berikut:

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

Kemudian, di file build.gradle.kts tingkat aplikasi, tambahkan dependensi dan konfigurasi implementasi berikut. Gunakan adaptor dan SDK nend versi terbaru:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.0.0")
    implementation("com.google.ads.mediation:nend:10.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, lalu tambahkan ke project Anda.

Langkah 5: Tambahkan kode yang diperlukan

Tidak diperlukan kode tambahan untuk integrasi nend.

Langkah 6: Uji penerapan Anda

Aktifkan iklan percobaan

Pastikan Anda mendaftarkan perangkat pengujian Anda untuk Ad Manager Guna mendapatkan iklan percobaan untuk banner, interstisial, dan reward, nend merekomendasikan penggunaan kunci API dan ID Spot yang diberikan di unit iklan pengujian tambahan . Ini dapat dimasukkan sebagai Kunci API dan ID Spot untuk unit iklan AdMob Anda saat melakukan pengujian, lalu diganti dengan Kunci API dan ID Spot yang sebenarnya saat aplikasi Anda siap produksi.

Memverifikasi iklan percobaan

Untuk memverifikasi bahwa Anda menerima iklan pengujian dari nend, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan nend (Waterfall) sumber iklan.

Langkah-langkah opsional

Parameter khusus jaringan

Adaptor nend mendukung parameter permintaan tambahan, yang dapat diteruskan ke adaptor menggunakan class NendExtrasBundleBuilder. Class ini menyertakan metode berikut:

  • setInterstitialType(InterstitialType): Nend memberikan opsi untuk memilih TYPE_NORMAL untuk iklan interstisial reguler atau TYPE_VIDEO untuk iklan video interstisial. Secara default, Nend akan menggunakan TYPE_NORMAL sebagai jenis interstisial jika parameter tambahan ini tidak ditambahkan.

  • setNativeAdsType(nativeAdsType): Nend memberikan opsi untuk memilih TYPE_NORMAL untuk iklan native reguler atau TYPE_VIDEO untuk iklan video native. Secara default, Nend akan menggunakan TYPE_NORMAL sebagai jenis iklan native jika parameter tambahan ini tidak ditambahkan.

Java 

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

AdManagerAdRequest adRequest = new AdManagerAdRequest.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 = AdManagerAdRequest.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 kolom berikut untuk NativeAd.

Kolom Diisi oleh adaptor Nend
Judul
Gambar 1
Body
Ikon aplikasi 2
Pesan ajakan (CTA)
Nama Pengiklan
Rating bintang
Simpan
Harga

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

2 Nend tidak menyediakan aset ikon untuk penempatan native yang dikonfigurasi dengan Pemilihan gambar iklan yang ditetapkan ke Tidak ada gambar (hanya teks).

Kode error

Jika adaptor gagal menerima iklan dari nend, penayang dapat memeriksa error yang mendasar dari respons iklan menggunakan ResponseInfo.getAdapterResponse() dalam kelas 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 yang menyertainya yang ditampilkan oleh adaptor nend saat iklan gagal dimuat:

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

Ubah Log Perubahan Adaptor Mediasi Android

Versi 10.0.0.0

  • Update versi minimum Google Mobile Ads SDK yang diperlukan ke 22.3.0.
  • Kompatibilitas yang diverifikasi dengan nend SDK 10.0.0.

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 22.3.0.
  • Nend SDK versi 10.0.0.

Versi 9.0.1.0

  • Mengupdate adaptor untuk menggunakan class VersionInfo baru.
  • Update versi minimum Google Mobile Ads SDK yang diperlukan ke 22.0.0.
  • Kompatibilitas terverifikasi dengan nend SDK 9.0.1.

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 22.0.0.
  • Nend SDK versi 9.0.1.

Versi 9.0.0.0

  • Kompatibilitas yang diverifikasi dengan nend SDK 9.0.0.
  • Update 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 yang diperlukan 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 logo iklan null.
  • Update 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.
  • Update versi minimum Google Mobile Ads SDK yang diperlukan ke 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.
  • Update 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 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.
  • Update versi minimum Google Mobile Ads SDK yang diperlukan 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.
  • Update versi minimum Google Mobile Ads SDK yang diperlukan 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 Android SDK 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

  • Mengupdate adaptor untuk mendukung permintaan banner adaptif inline.
  • Memperbaiki error kondisi race yang jarang terjadi yang mungkin terjadi saat iklan banner cerdas dihancurkan.
  • Mengupdate Google Mobile Ads SDK versi minimum 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

  • Penambahan dukungan untuk iklan native.
  • Kompatibilitas terverifikasi dengan nend SDK 5.4.2.
  • Mengupdate Google Mobile Ads SDK versi minimum 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.
  • Update 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 yang diverifikasi dengan nend SDK 5.2.0.
  • Update versi minimum Google Mobile Ads SDK yang diperlukan ke 18.1.1.

Versi 5.1.0.4

  • Memperbaiki masalah iklan Banner dan Interstisial yang tidak meneruskan peristiwa onAdClicked().
  • Memperbaiki masalah yang menyebabkan NullPointerException ditampilkan saat iklan Banner baru dihancurkan.
  • Memigrasikan adaptor ke AndroidX.
  • Update versi minimum Google Mobile Ads SDK yang diperlukan ke 18.0.0.

Versi 5.1.0.3

  • Menambahkan implementasi untuk menampilkan bagian banner nend di SmartBanner. Ukuran yang sesuai untuk SmartBanner
    • Potret dan Lanskap
      • Telepon: 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

  • Mengupdate adaptor untuk mendukung Reward API beta terbuka baru.
  • Update versi minimum Google Mobile Ads SDK yang diperlukan 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 di AdRequest.Builder.
    • setGender()
    • setBirthday()
    • setIsDesignedForFamiles()

Versi 5.0.2.0

  • Kompatibilitas yang diverifikasi 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

  • Metode onRewardedVideoCompleted() yang didukung pada RewardedVideoAdListener.

Versi 4.0.4.0

  • Kompatibilitas yang diverifikasi 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 iklan banner, interstisial, dan video reward.