Mengintegrasikan Tapjoy dengan mediasi

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

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

Versi 3.1.1

Versi 3.1.0

Versi 3.0.0

Versi 2.10.1

Versi 2.10.0

Versi 2.9.1

Versi 2.9.0

Versi 2.8.2

Versi 2.8.1

Versi 2.8.0

Versi 2.7.1

Versi 2.7.0

Versi 2.6.1

Versi 2.6.0

Versi 2.5.1

Versi 2.5.0

Versi 2.4.2

Versi 2.4.1

Versi 2.4.0

Versi 2.3.1

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.