Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK untuk memuat dan menampilkan iklan dari Tapjoy menggunakan mediasi, yang mencakup integrasi bidding dan waterfall. Video ini membahas cara menambahkan Tapjoy ke konfigurasi mediasi unit iklan, serta cara mengintegrasikan SDK dan adaptor Tapjoy ke dalam aplikasi Unity.
Integrasi dan format iklan yang didukung
Adaptor mediasi AdMob untuk Tapjoy memiliki kemampuan berikut:
Integrasi | |
---|---|
Bidding | |
Waterfall | |
Format | |
Banner | |
Interstisial | |
Diberikan sebagai reward |
Persyaratan
- Unity 4 atau yang lebih tinggi
- Google Mobile Ads SDK terbaru
- [Untuk bidding]: Plugin mediasi Google Mobile Ads untuk Tapjoy 2.3.0 atau yang lebih tinggi (versi terbaru direkomendasikan)
- 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: Siapkan konfigurasi di UI Tapjoy
Daftar atau login ke dasbor Tapjoy Anda.
Tambahkan aplikasi
Tambahkan aplikasi Anda ke dasbor Tapjoy dengan membuka daftar aplikasi di kanan atas, lalu klik tombol Add App. Kemudian, Anda akan diminta untuk memasukkan detail tentang aplikasi Anda.
Isi formulir dan klik tombol Create Now untuk menambahkan aplikasi Anda ke dasbor Tapjoy.
Anda dapat melewati langkah-langkah integrasi yang diberikan oleh Tapjoy dan beralih ke pembuatan penempatan yang akan digunakan dengan mediasi AdMob .
Jika aplikasi Anda mendukung kedua platform tersebut, pilih Keduanya sebagai platform.
Android
iOS
Penempatan, mata uang virtual, dan konten
Penempatan
Buka Monetisasi > Penempatan, lalu klik tombol Buat Penempatan di sudut kanan atas. Meskipun sudah memiliki penempatan, sebaiknya buat penempatan baru untuk AdMob agar dapat dilacak dan dilaporkan secara terpisah.
Masukkan Nama untuk penempatan Anda, centang kotak Mediasi, lalu pilih AdMob dari menu drop-down. Klik Buat setelah selesai.
Nama Penempatan yang dimasukkan di sini akan digunakan untuk menyiapkan AdMob Unit Iklan untuk mediasi di bagian berikutnya. "AdMob Mediasi" telah digunakan dalam contoh ini, tetapi Anda dapat memanggil penempatan sesuai keinginan.
Mata uang virtual
Buka Monetisasi > Mata Uang Virtual dan klik tombol Buat Mata Uang Virtual di pojok kanan atas.
Isi formulir dan klik Buat sekarang. Gunakan NO_CALLBACK sebagai Callback URL. Hal ini memastikan bahwa Tapjoy SDK menghindari panggilan yang tidak perlu ke server Anda.
Nilai dan nama mata uang tidak diteruskan oleh adaptor Tapjoy, sehingga nilai umum apa pun dapat dipilih untuk nama dan jumlah mata uang Anda.
Android
iOS
Konten
Buka Monetisasi > Buat Konten untuk membuat konten yang akan ditampilkan bersama penempatan.
Untuk petunjuk tambahan tentang cara membuat konten, pilih tab yang sesuai dengan format iklan pilihan Anda:
Bidding
Interstisial
Klik tombol Buat untuk konten Video Interstisial Terprogram. Berikan Nama untuk konten dan pilih Platform Anda. * {Android} * {iOS} Pilih mata uang virtual yang dibuat sebelumnya sebagai Mata Uang Virtual. Pilih penempatan Interstisial yang dibuat sebelumnya. Klik tombol Simpan di bagian bawah jika sudah selesai untuk membuat konten Anda.Diberikan sebagai reward
Klik tombol Buat untuk konten Video Reward Terprogram. * {Android} * {iOS} Pilih mata uang virtual yang dibuat sebelumnya sebagai Mata Uang Virtual. Pilih Penempatan reward yang dibuat sebelumnya. Klik tombol Save di bagian bawah jika sudah selesai untuk membuat konten Anda.Waterfall
Interstisial
Klik tombol Buat untuk konten Video Interstisial. Berikan Nama untuk konten dan pilih Platform Anda. * {Android} * {iOS} Pilih mata uang virtual yang dibuat sebelumnya sebagai Mata Uang Virtual. Pilih penempatan Interstisial yang dibuat sebelumnya. Klik tombol Simpan di bagian bawah jika sudah selesai untuk membuat konten Anda.Diberikan sebagai reward
Klik tombol Buat untuk konten Video Reward. Berikan Nama untuk konten dan pilih Platform Anda. * {Android} * {iOS} Pilih mata uang virtual yang dibuat sebelumnya sebagai Mata Uang Virtual. Pilih Penempatan reward yang dibuat sebelumnya. Klik tombol Save di bagian bawah jika sudah selesai untuk membuat konten Anda.Menemukan Kunci SDK
Selain Nama Penempatan, Anda juga memerlukan Kunci SDK untuk menyiapkan unit iklan AdMob Anda.
Buka Setelan > Setelan Aplikasi. Kunci SDK dapat diperoleh dari Info Aplikasi di bagian tab Platform Aplikasi.
Android
iOS
Menemukan kunci pelaporan
Bidding
Langkah ini tidak diperlukan untuk integrasi bidding.
Waterfall
Anda memerlukan Kunci OAuth Penayang dan Kunci Mediasi agar dapat melanjutkan. Kunci OAuth Penayang Anda dapat diperoleh di halaman yang sama pada tab Kunci API.
Kunci Mediasi dapat diperoleh di halaman yang sama pada tab Kunci Mediasi pada kolom Kunci API Pelaporan. Kuncinya diberi label "AdMob".
Aktifkan mode pengujian
Iklan percobaan dapat diaktifkan di dasbor Tapjoy di bagian Settings > App Settings > Test Devices. Buat perangkat pengujian baru menggunakan ID Iklan perangkat:
Android
ID Iklan perangkat Anda dapat ditemukan dengan membuka Google > Iklan di Setelan perangkat.
iOS
Untuk mendapatkan ID iklan perangkat, tambahkan kode berikut di aplikasi Anda. Pastikan untuk mengimpor framework AdSupport ke aplikasi Anda sebelum menggunakan kode di bawah.
Swift
let advertisingId: String = ASIdentifierManager.shared().advertisingIdentifier.uuidString
print("Advertising ID: \(advertisingId)")
Objective-C
NSString *advertisingId = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
NSLog(@"Advertising ID: %@", advertisingId);
Selanjutnya, ubah konten yang Anda buat sebelumnya.
Untuk mengubah konten, buka Monetisasi > Penempatan terlebih dahulu, lalu klik tab Dimulai oleh Pengguna. Selanjutnya, pilih menu drop-down untuk konten yang ingin Anda edit, lalu pilih Edit.
Di bagian Basic konten, centang kotak Only for Test Devices. Lalu klik Simpan di bagian bawah halaman. Selesai. Anda kini memiliki integrasi mediasi yang berfungsi dengan Tapjoy.
Android
iOS
Langkah 2: Siapkan permintaan Tapjoy di AdMob 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.
Tambahkan Tapjoy ke daftar partner iklan GDPR dan peraturan negara bagian AS
Ikuti langkah-langkah di Setelan GDPR dan Setelan peraturan negara bagian AS untuk menambahkan Tapjoy ke daftar partner iklan peraturan negara bagian AS dan GDPR di UI AdMob .
Langkah 3: Impor SDK dan adaptor Tapjoy
Download plugin mediasi Google Mobile Ads versi terbaru untuk Tapjoy
dari link download di
Changelog dan ekstrak
GoogleMobileAdsTapjoyMediation.unitypackage
dari file zip.
Di editor project Unity Anda, pilih Assets > Import Package > Custom
Package, lalu pilih file GoogleMobileAdsTapjoyMediation.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 resolusi
dependensi dari awal dan menyalin dependensi yang dideklarasikan ke
direktori Assets/Plugins/Android
aplikasi Unity Anda.
Langkah 4: Terapkan setelan privasi di Tapjoy SDK
Izin Uni Eropa dan GDPR
Berdasarkan Kebijakan Izin Pengguna Uni Eropa Google, Anda harus memastikan bahwa pengungkapan tertentu telah diberikan kepada, dan izin yang diperoleh dari, pengguna di Wilayah Ekonomi Eropa (EEA) terkait penggunaan ID perangkat dan data pribadi. Kebijakan ini mencerminkan persyaratan dalam ePrivacy Directive dan General Data Protection Regulation (GDPR) Uni Eropa. Saat meminta izin, Anda harus mengidentifikasi setiap jaringan iklan dalam rantai mediasi Anda yang dapat mengumpulkan, menerima, atau menggunakan data pribadi dan memberikan informasi tentang penggunaan setiap jaringan. Saat ini, Google tidak dapat secara otomatis meneruskan pilihan izin pengguna ke jaringan tersebut.
Plugin mediasi Google Mobile Ads untuk Tapjoy versi 1.1.1 menyertakan
metode SetUserConsent()
dan SubjectToGDPR()
. Kode contoh berikut menunjukkan cara meneruskan informasi izin ke Tapjoy SDK. Jika memilih untuk memanggil metode ini, sebaiknya Anda melakukannya sebelum meminta iklan melalui Google Mobile Ads SDK.
using GoogleMobileAds.Api.Mediation.Tapjoy;
// ...
Tapjoy.SetUserConsent("myUserConsent");
Selain itu, ada flag opsional yang dapat ditetapkan untuk menunjukkan apakah pengguna tunduk pada GDPR.
Tapjoy.SubjectToGDPR(true);
Lihat panduan Privasi Pengguna Tapjoy untuk detail selengkapnya dan nilai yang dapat diberikan dalam metode ini.
Hukum privasi negara bagian Amerika Serikat
Hukum privasi negara bagian Amerika Serikat mengharuskan pengguna untuk tidak ikut "penjualan" "informasi pribadi" mereka (sebagaimana istilah tersebut didefinisikan oleh hukum), dengan pilihan tidak ikut yang disediakan melalui link "Jangan Jual Informasi Pribadi Saya" yang terlihat jelas di halaman beranda pihak "penjual". Panduan kepatuhan hukum privasi negara bagian Amerika Serikat menawarkan kemampuan untuk mengaktifkan pemrosesan data yang dibatasi untuk penayangan iklan Google, tetapi Google tidak dapat menerapkan setelan ini ke setiap jaringan iklan dalam rantai mediasi Anda. Oleh karena itu, Anda harus mengidentifikasi setiap jaringan iklan dalam rantai mediasi Anda yang dapat berpartisipasi dalam penjualan informasi pribadi dan mengikuti panduan dari setiap jaringan tersebut untuk memastikan kepatuhannya.
Plugin mediasi Google Mobile Ads untuk Tapjoy versi 2.9.1 menyertakan
metode SetUSPrivacy()
. Kode contoh berikut menunjukkan cara meneruskan informasi izin ke Tapjoy SDK. Jika memilih untuk memanggil metode ini, sebaiknya Anda melakukannya sebelum meminta iklan melalui Google Mobile Ads SDK.
using GoogleMobileAds.Api.Mediation.Tapjoy;
// ...
Tapjoy.SetUSPrivacy("myUSPrivacyString");
Lihat panduan Privasi Pengguna Tapjoy untuk detail selengkapnya dan nilai yang dapat diberikan dalam metode ini.
Langkah 5: Tambahkan kode yang diperlukan:
Android
Tidak ada kode tambahan yang diperlukan untuk integrasi Tapjoy.
iOS
Integrasi SKAdNetwork
Ikuti dokumentasi Tapjoy untuk menambahkan ID SKAdNetwork ke file Info.plist
project Anda.
Langkah 6: Uji penerapan Anda
Aktifkan iklan percobaan
Pastikan Anda mendaftarkan perangkat pengujian Anda untuk AdMob dan mengaktifkan mode pengujian di Tapjoy UI.
Memverifikasi iklan percobaan
Untuk memverifikasi bahwa Anda menerima iklan pengujian dari Tapjoy, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan Tapjoy (Bidding) and Tapjoy (Waterfall) sumber iklan.
Langkah-langkah opsional
Android
Izin
Untuk performa yang optimal, Tapjoy merekomendasikan penambahan
izin opsional berikut
ke file AndroidManifest.xml
aplikasi Anda. Ubah file AndroidManifest.xml
yang berada di folder Assets/Plugins/Android/GoogleMobileAdsTapjoyMediation
dan sertakan izin opsional berikut:
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
iOS
Tidak ada langkah tambahan untuk integrasi iOS.
Kode error
Jika adaptor gagal menerima iklan dari Tapjoy, penayang dapat memeriksa
error yang mendasari dari respons iklan menggunakan
ResponseInfo
dalam
kelas berikut:
Android
Format | Nama kelas |
---|---|
Interstisial | TapjoyAdapter |
Diberikan sebagai reward | TapjoyMediationAdapter |
iOS
Format | Nama kelas |
---|---|
Interstisial | GADMAdapterTapjoy |
Diberikan sebagai reward | GADMAdapterTapjoy |
Berikut adalah kode dan pesan yang menyertainya yang ditampilkan oleh adaptor Tapjoy saat iklan gagal dimuat:
Android
Kode error | Alasan |
---|---|
101 | Parameter server Tapjoy yang dikonfigurasi di UI AdMob tidak ada/tidak valid. |
103 | Penayang harus meminta iklan dengan konteks Activity . |
104 | Tapjoy SDK gagal diinisialisasi. |
105 | Terjadi error pada presentasi Tapjoy saat pemutaran video berlangsung. |
106 | SDK Tapjoy tidak dapat memuat dua iklan untuk ID penempatan yang sama sekaligus. |
107 | Aplikasi tidak meminta iklan native. |
108 | Tapjoy SDK tidak memiliki konten iklan yang tersedia. |
iOS
Kode error | Alasan |
---|---|
101 | Parameter server Tapjoy yang dikonfigurasi di UI AdMob tidak ada/tidak valid. |
102 | Tapjoy SDK gagal diinisialisasi. |
103 | Adaptor Tapjoy tidak mendukung format iklan yang diminta. |
104 | Tapjoy mengirim callback pemuatan yang berhasil tetapi tidak ada konten yang tersedia. |
105 | Iklan sudah dimuat untuk konfigurasi jaringan ini. |
106 | Tapjoy SDK menampilkan callback error kegagalan video. |
Log Perubahan Plugin Mediasi Tapjoy Unity
Versi 3.2.0
- Mendukung Tapjoy Android adaptor versi 13.2.1.0.
- Mendukung Adaptor iOS Tapjoy versi 13.2.1.0.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 8.6.0.
Versi 3.1.1
- Mendukung Tapjoy Android adaptor versi 13.1.2.0.
- Mendukung Adaptor iOS Tapjoy versi 13.1.2.0.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 8.4.1.
Versi 3.1.0
- Mendukung Tapjoy Android adaptor versi 13.1.1.0.
- Mendukung Adaptor iOS Tapjoy versi 13.1.1.0.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 8.4.0.
Versi 3.0.0
- Memindahkan konten adaptor ke
GoogleMobileAds/Mediation/Tapjoy/
. - Namespace adaptor telah difaktorkan ulang untuk menggunakan
GoogleMobileAds.Mediation.Tapjoy
. - Mendukung Tapjoy Android adaptor versi 13.0.1.0.
- Mendukung Adaptor iOS Tapjoy versi 13.0.1.0.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 8.1.0.
Versi 2.10.1
- Mendukung Tapjoy Android adaptor versi 12.11.1.0.
- Mendukung Adaptor iOS Tapjoy versi 12.11.1.0.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 7.4.1.
Versi 2.10.0
- Mendukung Tapjoy Android adaptor versi 12.11.0.0.
- Mendukung Adaptor iOS Tapjoy versi 12.11.0.0.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 7.3.0.
Versi 2.9.1
- Menambahkan metode
Tapjoy.SetUSPrivacy(string)
. - Mendukung Tapjoy Android adaptor versi 12.10.0.1.
- Mendukung Adaptor iOS Tapjoy versi 12.10.0.0.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 7.2.0.
Versi 2.9.0
- Mendukung Tapjoy Android adaptor versi 12.10.0.1.
- Mendukung Adaptor iOS Tapjoy versi 12.10.0.0.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 7.0.2.
Versi 2.8.2
- Mendukung Tapjoy Android adaptor versi 12.9.1.0.
- Mendukung Adaptor iOS Tapjoy versi 12.9.1.0.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 7.0.0.
Versi 2.8.1
- Mendukung Tapjoy Android adaptor versi 12.9.0.0.
- Mendukung Adaptor iOS Tapjoy versi 12.9.0.1.
- Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 7.0.0.
Versi 2.8.0
- Mendukung Tapjoy Android adaptor versi 12.9.0.0.
- Mendukung Adaptor iOS Tapjoy versi 12.9.0.0.
Versi 2.7.1
- Mendukung Tapjoy Android adaptor versi 12.8.1.0.
- Mendukung Adaptor iOS Tapjoy versi 12.8.1.0.
Versi 2.7.0
- Mendukung Tapjoy Android adaptor versi 12.8.0.1.
- Mendukung Adaptor iOS Tapjoy versi 12.8.0.1.
Versi 2.6.1
- Mendukung Tapjoy Android adaptor versi 12.7.1.0.
- Mendukung Adaptor iOS Tapjoy versi 12.7.1.0.
Versi 2.6.0
- Mendukung Tapjoy Android adaptor versi 12.7.0.0.
- Mendukung Adaptor iOS Tapjoy versi 12.7.0.0.
Versi 2.5.1
- Mendukung Tapjoy Android adaptor versi 12.6.1.0.
- Mendukung Adaptor iOS Tapjoy versi 12.6.1.0.
Versi 2.5.0
- Mendukung Tapjoy Android adaptor versi 12.6.0.0.
- Mendukung Adaptor iOS Tapjoy versi 12.6.0.0.
Versi 2.4.2
- Mendukung Adaptor Android Tapjoy versi 12.4.2.1.
- Mendukung Adaptor iOS Tapjoy versi 12.4.2.1.
Versi 2.4.1
- Mendukung Tapjoy Android adaptor versi 12.4.2.0.
- Mendukung Adaptor iOS Tapjoy versi 12.4.2.0.
Versi 2.4.0
- Mendukung Tapjoy Android adaptor versi 12.4.1.0.
- Mendukung Adaptor iOS Tapjoy versi 12.4.1.0.
Versi 2.3.1
- Mendukung Tapjoy Android adaptor versi 12.3.3.0.
- Mendukung Adaptor iOS Tapjoy versi 12.3.3.0.
Versi 2.3.0
- Mendukung Tapjoy Android adaptor versi 12.3.1.0.
- Mendukung adaptor iOS Tapjoy versi 12.3.1.0.
Versi 2.2.0
- Mengupdate plugin untuk mendukung Reward API baru.
- Mendukung Tapjoy Android adaptor versi 12.2.1.0.
- Mendukung adaptor iOS Tapjoy versi 12.2.1.0.
Versi 2.1.0
- Mendukung Tapjoy Android adaptor versi 12.2.0.0.
- Mendukung adaptor iOS Tapjoy versi 12.1.0.0.
Versi 2.0.1
- Mendukung Tapjoy Android adaptor versi 12.0.0.1.
- Mendukung adaptor iOS Tapjoy versi 12.0.0.0.
Versi 2.0.0
- Mendukung Tapjoy Android adaptor versi 12.0.0.0.
- Mendukung adaptor iOS Tapjoy versi 12.0.0.0.
Versi 1.1.1
- Mendukung Tapjoy Android SDK versi 11.12.2.
- Mendukung Tapjoy iOS SDK versi 11.12.2.
- Menambahkan metode
Tapjoy.SetUserConsent()
untuk meneruskan status izin pengguna ke Tapjoy SDK dalam bentuk string izin. - Menambahkan metode
Tapjoy.SubjectToGDPR()
untuk menunjukkan apakah GDPR berlaku untuk pengguna atau tidak.
Versi 1.1.0
- Mendukung Tapjoy Android SDK versi 11.12.1.
- Mendukung Tapjoy iOS SDK versi 11.12.1.
Versi 1.0.0
- Rilis pertama!
- Mendukung Tapjoy Android SDK versi 11.11.1.
- Mendukung Tapjoy iOS SDK versi 11.11.1.