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. Bagian ini membahas cara menambahkan nend ke konfigurasi mediasi unit iklan, dan cara mengintegrasikan nend SDK dan adaptor ke iOS aplikasi.

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 oleh bahasa Inggris yang setara. Misalnya,"URL 🙌にーム", adalah "URL Scheme", 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

  • Target deployment iOS 11.0 atau yang lebih tinggi

Langkah 1: Siapkan nend

Daftar atau login ke akun telanjang Anda.

Untuk menambahkan aplikasi Anda ke dasbor nend, pertama klik tab Penempatan Penempatan, lalu pilih Situs/Aplikasi. Klik tombol Tambahkan aplikasi untuk menambahkan aplikasi Anda ke nend.

Membuat aplikasi

Masukkan nama aplikasi Anda, lalu pilih iOS aplikasi sebagai jenis aplikasi. Masukkan URL dan periksa apakah aplikasi Anda ada di App Store (lihat FAQ aplikasi yang belum dirilis 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 untuk membuat penempatan. Untuk membuat penempatan iklan banner, buka tab Penempatan Penempatan, lalu 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, dan akhirnya memilih Ukuran inventaris yang diinginkan. 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, dan pilih Frekuensi tampilan iklan yang diinginkan 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, dan pilih Kategori yang sesuai dari menu drop-down.

Pada Setelan reward, pilih Konten reward yang diinginkan menggunakan menu drop-down, masukkan Nama mata uang virtual yang Anda inginkan. 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, dan pilih Pemilihan gambar iklan yang Anda inginkan. 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 yang Anda inginkan dari daftar. Setelah selesai, klik tombol Buat untuk membuat penempatan.

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

Catat apiKey dan spotID.

Anda juga memerlukan Kunci API untuk API pelaporan nend, yang mereka sebut sebagai Kunci API untuk Melakukan scraping. Anda dapat menemukannya di tab Alat.

Langkah 2: Konfigurasikan setelan mediasi untuk AdMob unit iklan

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

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

Untuk membuat grup mediasi baru, pilih Buat Grup Mediasi.

Masukkan format dan platform iklan Anda, lalu klik Lanjutkan.

Beri nama grup mediasi Anda, lalu pilih lokasi yang akan ditargetkan. Selanjutnya, 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 Done.

Pilih unit iklan

Sekarang Anda akan melihat kartu unit iklan yang diisi dengan unit iklan yang dipilih, 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.

Jika sudah memiliki pemetaan untuk nend, Anda dapat memilihnya. Jika tidak, klik Tambahkan pemetaan.

Selanjutnya, masukkan Nama pemetaan, ID Spot, dan Kunci API yang diperoleh di bagian sebelumnya. Kemudian, klik Done.

Langkah 3: Impor SDK dan adaptor nend

  • Tambahkan baris berikut ke Podfile project Anda:

    pod 'GoogleMobileAdsMediationNend'

  • Dari command line, jalankan:

    pod install --repo-update

Integrasi manual

Download versi terbaru nend iOS SDK, dan tautkan nendSDK.framework di project Anda. Download adaptor nend terbaru dari link download di Changelog dan tautkan NendAdapter.framework di project Anda.

Tambahkan framework berikut ke project Anda:

  • AdSupport.framework
  • Security.framework
  • ImageIO.framework
  • AVFoundation.framework
  • CoreMedia.framework
  • SystemConfiguration.framework
  • WebKit.framework

Selain itu, dengan menambahkan framework berikut, informasi mendetail dapat digunakan melalui penayangan iklan.

  • CoreLocation.framework
  • CoreMotion.framework
  • CoreTelephony.framework

Langkah 4: Kode tambahan diperlukan

Tidak diperlukan kode tambahan untuk integrasi nend.

Integrasi SKAdNetwork

Ikuti dokumentasi nend untuk menambahkan ID SKAdNetwork ke file Info.plist project Anda.

Setelan project

Tambahkan flag -ObjC ke Other Linker Flags pada Application Target > Build Settings.

Langkah 5: Uji penerapan Anda

Untuk mendapatkan iklan uji coba untuk banner, interstisial, dan reward, sebaiknya gunakan kunci API dan ID Spot yang disediakan di halaman nend test unit iklan . 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, yang dapat diteruskan ke adaptor menggunakan class GADMAdapterNendExtras.

  • userId - Menetapkan UserID iklan interstisial nend spesifik.
  • interstitialType - Nend memberikan opsi untuk memilih TYPE_NORMAL bagi iklan insterstitial reguler atau TYPE_VIDEO untuk iklan video interstisial.

Berikut adalah contoh cara menetapkan parameter permintaan iklan ini:

Swift 

let request = GADRequest()
let extras = GADMAdapterNendExtras()
extras.userId = "12345"
extras.interstitialType = GADMNendInterstitialTypeNormal
request.registerAdNetworkExtras(extras)

Objective-C 

GADRequest *request = [GADRequest request];
GADMAdapterNendExtras *extras = [[GADMAdapterNendExtras alloc] init];
extras.userId = @"12345";
extras.interstitialType = GADMNendInterstitialTypeNormal;
[request registerAdNetworkExtras:extras];

Menggunakan iklan native

Rendering iklan

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

Kolom Diisi oleh adaptor Nend
Judul
Gambar 1
Isi
Ikon aplikasi 2
Pesan ajakan (CTA)
Nama Pengiklan
Rating bintang
Toko
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 mendasarinya dari respons iklan menggunakan GADResponseInfo.adNetworkInfoArray dalam class berikut:

Format Nama class
Banner GADMAdapterNend
Interstisial GADMAdapterNend
Diberikan sebagai reward GADMAdapterNendReward
Native GWSMediasiAdapterNend

Berikut adalah kode dan pesan yang menyertainya yang ditampilkan oleh adaptor nend saat iklan gagal dimuat:

Kode error Domain Alasan
101 com.google.ads.mediasi.nend nend memerlukan konteks aktivitas untuk memuat dan menampilkan iklan.
102 com.google.ads.mediasi.nend Parameter server nend yang dikonfigurasi di AdMob UI tidak ada/tidak valid.
103 com.google.ads.mediasi.nend nend iklan Anda belum siap untuk ditampilkan.
104 com.google.ads.mediasi.nend nend gagal memutar iklan.
105 com.google.ads.mediasi.nend Ukuran iklan yang diminta tidak cocok dengan ukuran banner yang didukung nend.
106 com.google.ads.mediasi.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 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 tampilkan tanpa informasi error tambahan.
103 com.google.mediasi.nend Parameter server nend yang dikonfigurasi di AdMob UI tidak ada/tidak valid.
104 com.google.mediasi.nend Gagal memuat aset gambar iklan native.
105 com.google.mediasi.nend Gagal menampilkan iklan nend karena iklan belum siap.
106 com.google.mediasi.nend Ukuran iklan banner yang diminta tidak cocok dengan ukuran banner yang didukung nend.
200-699 Dikirim oleh nend SDK. nend SDK menampilkan error. Lihat dokumen nend untuk mengetahui detail selengkapnya.

Log Perubahan Adaptor Mediasi nend iOS

Versi 8.1.0.0

  • Menghapus dukungan arsitektur armv7.
  • Versi iOS saat ini memerlukan iOS versi 11.0 minimum.
  • Google Mobile Ads SDK versi 10.4.0 atau yang lebih baru kini diwajibkan.

Dibuat dan diuji dengan:

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

Versi 8.0.1.0

  • Kompatibilitas terverifikasi dengan nend SDK 8.0.1.

Dibuat dan diuji dengan:

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

Versi 8.0.0.0

  • Kompatibilitas terverifikasi dengan nend SDK 8.0.0.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 10.2.0.
  • Nend SDK versi 8.0.0.

Versi 7.4.0.1

  • Kini membutuhkan Google Mobile Ads SDK versi 10.0.0 atau yang lebih tinggi.

Dibuat dan diuji dengan:

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

Versi 7.4.0.0

  • Kompatibilitas terverifikasi dengan nend SDK 7.4.0.
  • Memperbarui adaptor untuk menggunakan didRewardUser API.
  • Sekarang membutuhkan Google Mobile Ads SDK versi 9.8.0 atau yang lebih tinggi.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 9.10.0.
  • Nend SDK versi 7.4.0.

Versi 7.3.0.0

  • Kompatibilitas terverifikasi dengan nend SDK 7.3.0.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 9.3.0.
  • Nend SDK versi 7.3.0.

Versi 7.2.0.0

  • Kompatibilitas terverifikasi dengan nend SDK 7.2.0.
  • Menambahkan dukungan untuk arsitektur simulator arm64.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 9.1.0.
  • Nend SDK versi 7.2.0.

Versi 7.1.0.1

  • Kompatibilitas terverifikasi dengan Google Mobile Ads SDK versi 9.0.0.
  • Kini membutuhkan Google Mobile Ads SDK versi 9.0.0 atau yang lebih tinggi.

Dibuat dan diuji dengan:

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

Versi 7.1.0.0

  • Kompatibilitas terverifikasi dengan nend SDK 7.1.0.
  • Versi iOS saat ini memerlukan iOS versi 10.0 minimum.

Dibuat dan diuji dengan

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

Versi 7.0.6.1

  • Memperbaiki masalah saat callback adDidRecordClick tidak diteruskan untuk iklan interstisial.

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 8.9.0.
  • Nend SDK versi 7.0.6.

Versi 7.0.6.0

  • Kompatibilitas terverifikasi dengan nend SDK 7.0.6.
  • Menambahkan kode dan pesan error adaptor standar.

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 8.8.0.
  • Nend SDK versi 7.0.6.

Versi 7.0.5.0

  • Kompatibilitas terverifikasi dengan SDK nend 7.0.5.

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 8.5.0.
  • Nend SDK versi 7.0.5.

Versi 7.0.4.0

  • Kompatibilitas terverifikasi dengan nend SDK 7.0.4.
  • Dependensi santai ke Google Mobile Ads SDK versi 8.0.0 atau lebih tinggi.
  • Memperbarui adaptor untuk menggunakan format .xcframework.

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 8.5.0.
  • Nend SDK versi 7.0.4.

Versi 7.0.2.0

  • Kompatibilitas terverifikasi dengan nend SDK 7.0.2.
  • Memperbaiki masalah tampilan media yang terkadang ditampilkan di posisi yang salah.

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 7.69.0.
  • Nend SDK versi 7.0.2.

Versi 7.0.1.0

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

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 7.69.0.
  • Nend SDK versi 7.0.1.

Versi 7.0.0.0

  • Kompatibilitas terverifikasi dengan nend SDK 7.0.0.

Dibuat dan diuji dengan

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

Versi 6.0.3.0

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

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 7.65.0.
  • Nend SDK versi 6.0.3.

Versi 6.0.2.0

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

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 7.64.0.
  • Nend SDK versi 6.0.2.

Versi 6.0.1.0

  • Kompatibilitas terverifikasi dengan nend SDK 6.0.1.

Dibuat dan diuji dengan

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

Versi 6.0.0.0

  • Kompatibilitas terverifikasi dengan nend SDK 6.0.0.
  • Menghapus class GADNendRewardedNetworkExtras. Jika ingin meneruskan tambahan jaringan ke adaptor iOS nend, gunakan class GADMAdapterNendExtras.
  • Mengganti nama enum berikut dari class GADMAdapterNendExtras:
    • GADMNendInterstitialType menjadi GADMAdapterNendInterstitialType.
    • GADMNendNativeType menjadi GADMAdapterNendNativeType.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke versi 7.62.0.

Dibuat dan diuji dengan

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

Versi 5.4.1.0

  • Kompatibilitas terverifikasi dengan nend SDK 5.4.1.
  • Menambahkan dukungan untuk iklan native.
  • Menghapus dukungan untuk arsitektur i386.

Dibuat dan diuji dengan

  • Google Mobile Ads SDK versi 7.58.0.
  • Nend SDK versi 5.4.1.

Versi 5.3.1.0

  • Kompatibilitas terverifikasi dengan SDK nend 5.3.1.

Buat dan uji dengan

  • Google Mobile Ads SDK versi 7.52.0.
  • Nend SDK versi 5.3.1.

Versi 5.3.0.0

  • Kompatibilitas terverifikasi dengan SDK nend 5.3.0.

Dibuat dan diuji dengan:

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

Versi 5.1.1.0

  • Memperbarui adaptor untuk menggunakan API reward yang baru.
  • Sekarang membutuhkan Google Mobile Ads SDK versi 7.42.2 atau yang lebih tinggi.
  • Kompatibilitas terverifikasi dengan SDK nend 5.1.1.
  • Mengubah kondisi yang memeriksa ukuran banner. Ukuran yang sesuai untuk SmartBanner
    • kGWSAdSizeSmartBannerPortrait
      • iPhone: 320×50
      • iPad: 728×90 atau 320×50
    • kGWSAdSizeSmartBannerLandscape
      • iPad: 728×90 atau 320×50
  • Menambahkan dukungan untuk ukuran iklan banner fleksibel.

Versi 5.1.0.0

  • Kompatibilitas terverifikasi dengan SDK nend 5.1.0.

Versi 5.0.3.0

  • Kompatibilitas terverifikasi dengan SDK nend 5.0.3.

Versi 5.0.2.0

  • Kompatibilitas terverifikasi dengan SDK nend 5.0.2.

Versi 5.0.1.0

  • Kompatibilitas terverifikasi dengan SDK nend 5.0.1.

Versi 5.0.0.0

  • Kompatibilitas terverifikasi dengan nend SDK 5.0.0.

Versi 4.0.6.0

  • Kompatibilitas terverifikasi dengan nend SDK 4.0.6.
  • Hapus untuk menetapkan properti userFeature.

Versi 4.0.5.0

  • Kompatibilitas terverifikasi dengan SDK nend 4.0.5.

Versi 4.0.4.0

  • Kompatibilitas terverifikasi dengan nend SDK 4.0.4.

Versi 4.0.3.0

  • Kompatibilitas terverifikasi dengan nend SDK 4.0.3.

Versi 4.0.2.0

  • Rilis pertama dalam project open source mediasi Google Mobile Ads.
  • Menambahkan dukungan untuk iklan video berbasis reward.

Versi Sebelumnya

  • Mendukung iklan banner dan interstisial.