Mengintegrasikan AdColony dengan mediasi

Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK untuk memuat dan menampilkan iklan dari AdColony menggunakan mediasi, yang mencakup integrasi bidding dan waterfall. Video ini membahas cara menambahkan AdColony ke konfigurasi mediasi unit iklan, serta cara mengintegrasikan AdColony SDK dan adaptor ke dalam aplikasi Unity.

Integrasi dan format iklan yang didukung

Adaptor mediasi AdMob untuk AdColony memiliki kemampuan berikut:

Integrasi
Bidding
Waterfall
Format
Banner
Interstisial
Diberikan sebagai reward

Persyaratan

  • Unity 5.6 atau yang lebih tinggi
  • Google Mobile Ads SDK terbaru
  • [Untuk bidding]: Plugin mediasi Google Mobile Ads untuk AdColony 1.0.5 atau yang lebih tinggi (direkomendasikan versi 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: Siapkan konfigurasi di UI AdColony

Daftar dan login ke akun AdColony Anda. Tambahkan aplikasi Anda ke dasbor penayang AdColony dengan mengklik tombol Siapkan Aplikasi Baru.

Aplikasi baru penyiapan AdColony

Isi formulir, lalu klik Create di bagian bawah halaman untuk menambahkan aplikasi Anda ke AdColony.

Android

Aplikasi pembuatan AdColony

iOS

Aplikasi pembuatan AdColony

Setelah aplikasi dibuat, Anda bisa mendapatkan ID Aplikasi dengan membuka Monetisasi > Aplikasi di bagian Informasi Aplikasi Dasar.

Android

ID aplikasi AdColony

iOS

ID aplikasi AdColony

Selanjutnya, buat Zona Iklan baru dengan mengklik tombol Siapkan Zona Iklan Baru di bagian Zona Iklan di halaman Aplikasi Anda. Sebaiknya buat Zona Iklan baru untuk mediasi dengan AdMob meskipun Anda sudah memilikinya.

Android

Zona penyiapan AdColony

iOS

Zona penyiapan AdColony

Untuk petunjuk tambahan tentang cara membuat penempatan iklan, pilih tab yang sesuai dengan format iklan pilihan Anda.

  1. Tetapkan Zona Aktif? ke Ya.

  2. Masukkan Nama untuk Zona Iklan Anda.

  3. Pilih Banner sebagai Ad Zone Size.

  4. Masukkan nilai untuk Batas permainan harian.

Interstisial

  1. Tetapkan Zona Aktif? ke Ya.

  2. Masukkan Nama untuk Zona Iklan Anda.

  3. Pilih Preroll/Interstisial sebagai Jenis Zona.

  4. Masukkan nilai untuk Batas permainan harian.

Diberikan sebagai reward

  1. Tetapkan Zona Aktif? ke Ya.

  2. Masukkan Nama untuk Zona Iklan Anda.

  3. Pilih Value Exchange/V4VC sebagai Zone Type.

  4. Tetapkan Client Side Only? ke Yes dan masukkan Nama Mata Uang Virtual, Video Maks Harian per Pengguna, dan Jumlah Reward.

  5. Masukkan nilai untuk Batas permainan harian.

Klik tombol Buat jika sudah selesai untuk membuat Zona Iklan.

Setelah Zona Iklan dibuat, Anda dapat menemukan ID Zona di bagian Integration pada Zona Iklan. ID Zona akan digunakan di langkah berikutnya.

ID zona AdColony

Menemukan Kunci AdColony API

Bidding

Langkah ini tidak diperlukan untuk integrasi bidding.

Waterfall

Anda memerlukan Kunci API AdColony untuk menyiapkan AdMob ID unit iklan. Buka Setelan Akun di dasbor penayang AdColony untuk menemukan Kunci API Anda.

Setelan AdColony

Aktifkan mode pengujian

Untuk mengaktifkan iklan percobaan di AdColony, buka dasbor AdColony dan buka Monetisasi > Apps. Pilih Zona tempat Anda ingin mengaktifkan iklan percobaan di bagian Zona Iklan pada aplikasi Anda. Iklan percobaan dapat diaktifkan dengan mencentang Yes hingga Tampilkan iklan pengujian saja? di bagian Pengembangan.

Pengujian AdColony

Langkah 2: Siapkan permintaan AdColony 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.

Menambahkan AdColony ke daftar partner iklan peraturan negara bagian Amerika Serikat dan GDPR

Ikuti langkah-langkah di Setelan GDPR dan Setelan peraturan negara bagian AS untuk menambahkan AdColony ke daftar partner iklan peraturan negara bagian AS dan GDPR di UI AdMob .

Langkah 3: Impor SDK dan adaptor AdColony

Download versi terbaru plugin mediasi Google Mobile Ads untuk AdColony dari link download di Changelog dan ekstrak GoogleMobileAdsAdColonyMediation.unitypackage dari file zip.

Di editor project Unity, pilih Assets > Import Package > Custom Package, lalu temukan file GoogleMobileAdsAdColonyMediation.unitypackage yang telah Anda download. Pastikan semua file dipilih, lalu klik Impor.

Lalu, pilih Assets > Play Services Resolver > Android Resolver > Force Resolve. Library External Dependency Manager akan menjalankan resolusi dependensi dari awal dan menyalin dependensi yang dideklarasikan ke direktori Assets/Plugins/Android aplikasi Unity Anda.

Langkah 4: Terapkan setelan privasi di AdColony 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 AdColony versi 2.6.1 menambahkan class AdColonyAppOptions dengan metode SetPrivacyFrameworkRequired() dan SetPrivacyConsentString(), agar Anda dapat meneruskan izin ke AdColony SDK. Kode contoh berikut menunjukkan cara meneruskan informasi izin ke adaptor AdColony, yang kemudian digunakan dalam metode inisialisasi AdColony. Opsi ini harus ditetapkan sebelum Anda menginisialisasi Google Mobile Ads SDK untuk memastikannya diteruskan dengan benar ke SDK AdColony.

using GoogleMobileAds.Api.Mediation.AdColony;
// ...

AdColonyAppOptions.SetPrivacyFrameworkRequired(AdColonyPrivacyFramework.GDPR, true);
AdColonyAppOptions.SetPrivacyConsentString(AdColonyPrivacyFramework.GDPR, "myPrivacyConsentString");

Lihat artikel Privasi Konsumen dan panduan penerapan Hukum Privasi AdColony untuk mengetahui detail selengkapnya dan nilai yang dapat diberikan dalam metode.

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 AdColony versi 2.6.1 menambahkan class AdColonyAppOptions dengan metode SetPrivacyFrameworkRequired() dan SetPrivacyConsentString(), agar Anda dapat meneruskan izin ke AdColony SDK. Kode contoh berikut menunjukkan cara meneruskan informasi izin ke adaptor AdColony, yang kemudian digunakan dalam metode inisialisasi AdColony. Opsi ini harus ditetapkan sebelum Anda menginisialisasi Google Mobile Ads SDK agar dapat diteruskan dengan benar ke SDK AdColony.

using GoogleMobileAds.Api.Mediation.AdColony;
// ...

AdColonyAppOptions.SetPrivacyFrameworkRequired(AdColonyPrivacyFramework.CCPA, true);
AdColonyAppOptions.SetPrivacyConsentString(AdColonyPrivacyFramework.CCPA, "myPrivacyConsentString");

Lihat artikel Privasi Konsumen dan panduan penerapan Hukum Privasi AdColony untuk mengetahui detail selengkapnya dan nilai yang dapat diberikan dalam metode.

Langkah 5: Tambahkan kode yang diperlukan

Android

Tidak ada kode tambahan yang diperlukan untuk integrasi AdColony.

iOS

Integrasi SKAdNetwork

Ikuti dokumentasi AdColony 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 AdColony UI.

Memverifikasi iklan percobaan

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

Langkah-langkah opsional

Android

Izin

Untuk performa yang optimal, AdColony merekomendasikan penambahan izin opsional berikut ke dalam file AndroidManifest.xml yang berada di direktori Assets/Plugins/Android/GoogleMobileAdsPlugin project Unity Anda.

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.VIBRATE" />

iOS

Tidak ada langkah tambahan yang diperlukan untuk integrasi iOS.

Parameter khusus jaringan

Paket mediasi AdColony mendukung konfigurasi dan parameter permintaan tambahan, yang dapat diteruskan ke adaptor menggunakan class AdColonyMediationExtras dan AdColonyAppOptions.

Class AdColonyMediationExtras menyertakan metode berikut:

SetShowPrePopup(bool)
Menetapkan apakah akan menampilkan pop-up sebelum menampilkan iklan atau tidak. Tetapkan ke false jika Anda tidak ingin menampilkan pop-up sebelum iklan ditampilkan.
SetShowPostPopup(bool)
Menetapkan apakah akan menampilkan pop-up setelah menampilkan iklan atau tidak. Tetapkan ke false jika Anda tidak ingin menampilkan pop-up setelah iklan ditampilkan.

Class AdColonyAppOptions menyertakan metode berikut:

SetUserId(string)
Menetapkan User ID untuk AdColony SDK yang menyediakan analisis lebih lanjut untuk AdColony Ad Server.
SetTestMode(bool)
Menetapkan apakah mode pengujian AdColony SDK diaktifkan atau tidak.

Berikut adalah contoh kode tentang cara menetapkan konfigurasi dan parameter permintaan iklan ini:

// Set app-level configurations
AdColonyAppOptions.SetUserId("myUser");
AdColonyAppOptions.SetTestMode(true);

// Set ad request parameters
AdColonyMediationExtras extras = new AdColonyMediationExtras();
extras.SetShowPrePopup(true);
extras.SetShowPostPopup(true);

AdRequest request = new AdRequest.Builder()
        .AddMediationExtras(extras)
        .Build();

Kode error

Jika adaptor gagal menerima iklan dari AdColony, penayang dapat memeriksa error yang mendasari dari respons iklan menggunakan ResponseInfo di kelas berikut:

Android

com.jirbo.adcolony.AdColonyAdapter
com.google.ads.mediation.adcolony.AdColonyMediationAdapter

iOS

GADMAdapterAdColony
GADMediationAdapterAdColony

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

Android

Kode error Alasan
100 AdColony SDK menampilkan error.
101 Parameter server tidak valid (misalnya, ID Zona tidak ada).
102 Iklan sudah diminta untuk ID Zona yang sama.
103 AdColony SDK menampilkan error inisialisasi.
104 Ukuran banner yang diminta tidak memetakan ke ukuran iklan AdColony yang valid.
105 Kesalahan presentasi karena iklan tidak dimuat.
106 Konteks yang digunakan untuk melakukan inisialisasi AdColony SDK bukan merupakan instance Activity.

iOS

Kode error Alasan
0 - 3 AdColony SDK menampilkan error. Lihat dokumentasi untuk mengetahui detail selengkapnya.
101 Parameter server tidak valid (misalnya, ID Zona tidak ada).
102 Pengontrol tampilan root yang menampilkan iklan adalah nil.
103 AdColony SDK menampilkan error inisialisasi.
104 AdColony SDK tidak mendukung konfigurasi dua kali dalam periode lima detik.
105 Gagal menampilkan iklan.
106 Zona yang digunakan untuk reward bukan zona reward di portal AdColony.

Log Perubahan Plugin Mediasi AdColony Unity

Versi 2.6.3 (Dalam Proses)

  • Memperbaiki peringatan definisi duplikat untuk MediationExtras.

Versi 2.6.2

Versi 2.6.1

  • Memperbarui API privasi dari class AdColonyAppOptions menjadi metode berikut untuk mendukung GDPR dan CCPA:
    • SetGDPRRequired(bool) -> SetPrivacyFrameworkRequired(AdColonyPrivacyFramework, bool)
    • IsGDPRRequired() -> GetPrivacyFrameworkRequired(AdColonyPrivacyFramework)
    • SetGDPRConsentString(string)-> SetPrivacyConsentString(AdColonyPrivacyFramework, string)
    • GetGDPRConsentString() -> GetPrivacyConsentString(AdColonyPrivacyFramework)
  • Mendukung AdColony Android adaptor versi 4.8.0.1.
  • Mendukung adaptor AdColony versi 4.9.0.2.
  • Dibuat dan diuji dengan Plugin Google Mobile Ads Unity versi 7.4.1.

Versi 2.6.0

Versi 2.5.0

Versi 2.4.1

Versi 2.4.0

Versi 2.3.0

Versi 2.2.0

Versi 2.1.0

Versi 2.0.3

Versi 2.0.2

Versi 2.0.1

Versi 2.0.0

Versi 1.0.6

Versi 1.0.5

  • Memindahkan metode berikut dari class Builder AdColonyMediationExtras ke class AdColonyAppOptions:
    • SetGDPRRequired()
    • SetGDPRConsentString()
    • SetUserId()
    • SetTestMode()
  • Menambahkan metode berikut ke class AdColonyAppOptions:
    • IsGDPRRequired()
    • GetGDPRConsentString()
    • GetUserId()
    • IsTestMode()
  • Menghapus metode SetZoneId() dari class Builder AdColonyMediationExtras.
  • Mendukung AdColony Android adaptor versi 3.3.10.1.
  • Mendukung AdColony iOS adaptor versi 3.3.7.2.

Versi 1.0.4

  • Mengupdate plugin untuk mendukung Reward API beta terbuka baru.
  • Mendukung AdColony Android adaptor versi 3.3.8.1.
  • Mendukung AdColony iOS adaptor versi 3.3.6.1.

Versi 1.0.3

  • Mendukung AdColony Android adaptor versi 3.3.5.1.
  • Mendukung AdColony iOS adaptor versi 3.3.5.0.

Versi 1.0.2

  • Mendukung AdColony Android SDK versi 3.3.4.
  • Mendukung AdColony iOS SDK versi 3.3.4.
  • SetTestMode() dari class Builder AdColonyMediationExtras kini diabaikan untuk Android. Penayang kini dapat meminta iklan percobaan dari AdColony untuk Android dengan menentukan perangkat pengujian melalui AddTestDevice() dari class Builder AdRequest.
  • Menambahkan metode berikut ke class Builder AdColonyMediationExtras:
    • SetGDPRRequired()
    • SetGDPRConsentString()

Versi 1.0.1

  • Mendukung AdColony Android SDK versi 3.3.0-unity.
  • Mendukung AdColony iOS SDK versi 3.3.0.

Versi 1.0.0

  • Rilis pertama!
  • Mendukung AdColony Android SDK versi 3.3.0.
  • Mendukung AdColony iOS SDK versi 3.3.0.