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, dan cara mengintegrasikan nend SDK dan adaptor ke dalam aplikasi Unity.
Antarmuka dasbor untuk nend menggunakan teks bahasa Jepang untuk label, tombol, serta deskripsinya, dan screenshot yang ditampilkan di bawah belum diterjemahkan. Namun, dalam teks panduan ini, label dan tombol dirujuk oleh nama bahasa Inggrisnya. Misalnya, "URL Downloadnyataム" adalah "Skema URL", dan sebagainya.
Integrasi dan format iklan yang didukung
Integrasi | |
---|---|
Bidding | |
Waterfall | |
Format | |
Banner | |
Interstisial | |
Diberikan sebagai reward |
Persyaratan
- Unity 4 atau yang lebih tinggi
- Google Mobile Ads SDK terbaru
- Untuk men-deploy di Android
- Android API level 19 atau yang lebih tinggi
- Untuk men-deploy di iOS
- Target deployment iOS 12.0 atau yang lebih tinggi
- Project Unity berfungsi yang dikonfigurasi dengan Google Mobile Ads SDK. Lihat Memulai untuk mengetahui detailnya.
- Selesaikan mediasi Panduan memulai
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.
Android
iOS
Aplikasi Anda akan ditampilkan di dasbor setelah dibuat.
Android
iOS
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.
Banner
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
Android
Untuk mengetahui petunjuknya, lihat langkah 2 dalam panduan untuk Android.
iOS
Untuk mengetahui petunjuknya, lihat langkah 2 dalam panduan untuk iOS.
Langkah 3: Impor nend SDK dan adaptor
Download versi terbaru plugin mediasi Google Mobile Ads untuk nend
dari link download di Changelog
dan ekstrak paket GoogleMobileAdsNendMediation.unitypackage
dari
file zip
.
Di editor project Unity, pilih Assets > Import Package > Custom
Package, lalu temukan file GoogleMobileAdsNendMediation.unitypackage
yang telah
Anda download. Pastikan semua file dipilih, lalu klik Impor.
Lalu, pilih Assets > Play Services Resolver > Android Resolver >
Force Resolve. Library Resolver Layanan Unity Play akan melakukan
penyelesaian dependensi dari awal dan menyalin dependensi yang dideklarasikan ke
direktori Assets/Plugins/Android
aplikasi Unity Anda.
Langkah 4: Tambahkan kode yang diperlukan
Android
Tidak diperlukan kode tambahan untuk integrasi nend.
iOS
Integrasi SKAdNetwork
Ikuti dokumentasi
nend
untuk menambahkan ID SKAdNetwork ke file Info.plist
project Anda.
Langkah 5: 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 nend test unit iklan . 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.
Kode error
Jika adaptor gagal menerima iklan dari nend, penayang dapat memeriksa
error yang mendasari dari respons iklan menggunakan
ResponseInfo
dalam
kelas berikut:
Android
com.google.ads.mediation.nend.NendAdapter
com.google.ads.mediation.nend.NendRewardedAdapter
com.google.ads.mediation.nend.NendMediationAdapter
iOS
GADMAdapterNend
GADMAdapterNend
GADMAdapterNendRewarded
GADMediationAdapterNend
Berikut adalah kode dan pesan yang menyertainya yang ditampilkan oleh adaptor nend saat iklan gagal dimuat:
Android
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. |
iOS
Kode error | Domain | Alasan |
---|---|---|
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. |
nend Log Perubahan Plugin Mediasi Unity
Versi 8.0.0
- Mendukung nend adaptor Android versi 10.0.0.0.
- Mendukung nend adaptor iOS versi 8.2.0.0.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 8.6.0.
Versi 7.0.0
- Memindahkan konten adaptor ke
GoogleMobileAds/Mediation/Nend/
. - Namespace adaptor telah difaktorkan ulang untuk menggunakan
GoogleMobileAds.Mediation.Nend
. - Mendukung nend adaptor Android versi 9.0.1.0.
- Mendukung nend adaptor iOS versi 8.0.1.0.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 8.1.0.
Versi 6.0.1
- Mendukung nend adaptor Android versi 9.0.0.0.
- Mendukung adaptor iOS versi 7.4.0.1.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 7.4.1.
Versi 6.0.0
- Mendukung nend adaptor Android versi 9.0.0.0.
- Mendukung nend adaptor iOS versi 7.4.0.0.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 7.2.0.
Versi 5.2.0
- Mendukung nend adaptor Android versi 8.1.0.1.
- Mendukung nend adaptor iOS versi 7.3.0.0.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 7.0.2.
Versi 5.1.0
- Mendukung nend adaptor Android versi 8.1.0.0.
- Mendukung adaptor iOS versi 7.2.0.0.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 7.0.0.
Versi 5.0.0
- Mendukung nend adaptor Android versi 8.0.1.0.
- Mendukung adaptor iOS versi 7.1.0.0.
Versi 4.0.1
- Mendukung nend adaptor Android versi 7.0.3.0.
- Mendukung nend adaptor iOS versi 7.0.5.0.
Versi 4.0.0
- Mendukung nend adaptor Android versi 7.0.0.0.
- Mendukung nend adaptor iOS versi 7.0.0.0.
Versi 3.0.0
- Mendukung nend adaptor Android versi 6.0.1.0.
- Mendukung adaptor iOS versi 6.0.1.0.
Versi 2.3.0
- Mendukung nend adaptor Android versi 5.4.2.0.
- Mendukung nend adaptor iOS versi 5.4.1.0.
Versi 2.2.0
- Mendukung nend adaptor Android versi 5.3.0.0.
- Mendukung nend adaptor iOS versi 5.3.0.0.
Versi 2.1.0
- Mengupdate plugin untuk mendukung Reward API baru.
- Mendukung nend adaptor Android versi 5.1.0.2.
- Mendukung nend adaptor iOS versi 5.1.1.0.
Versi 2.0.3
- Mendukung nend adaptor Android versi 5.0.2.1.
- Mendukung nend adaptor iOS versi 5.0.2.0.
Versi 2.0.2
- Mendukung nend adaptor Android versi 5.0.2.0.
- Mendukung nend adaptor iOS versi 5.0.2.0.
Versi 2.0.1
- Mendukung nend adaptor Android versi 5.0.2.0.
- Mendukung nend adaptor iOS versi 5.0.1.0.
Versi 2.0.0
- Mendukung nend adaptor Android versi 5.0.0.0.
- Mendukung nend adaptor iOS versi 5.0.0.0.
Versi 1.0.2
- Mendukung nend adaptor Android versi 4.0.5.0.
- Mendukung nend adaptor iOS versi 4.0.6.0.
Versi 1.0.1
- Mendukung nend Android SDK versi 4.0.4.
- Mendukung iOS SDK versi 4.0.4.
Versi 1.0.0
- Rilis pertama!
- Mendukung nend Android SDK versi 4.0.2.
- Mendukung iOS SDK versi 4.0.2.