Mengintegrasikan Iklan Unity dengan mediasi

Pilih platform: Android iOS Unity Flutter Android (Legacy)

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

Integrasi dan format iklan yang didukung

Adaptor mediasi Ad Manager untuk Unity Ads memiliki kemampuan berikut:

Integrasi
Bidding
Air Terjun  1
Format
Banner
Interstisial
Reward

Prasyarat

Sebelum Anda melanjutkan, verifikasi hal berikut:

  • Versi Google Mobile Ads Flutter Plugin terbaru.
  • Framework Flutter versi 3.7.0 atau yang lebih baru.
  • [Untuk bidding]: Untuk mengintegrasikan semua format iklan yang didukung dalam bidding, gunakan plugin mediasi Google Mobile Ads untuk Unity Ads 1.1.0 atau yang lebih baru (direkomendasikan versi terbaru).
  • Untuk men-deploy di Android
    • Android API level 24 atau yang lebih baru.
  • Untuk men-deploy di iOS
    • Target deployment iOS 13.0 atau yang lebih baru.
  • Project Flutter yang berfungsi dan dikonfigurasi dengan Google Mobile Ads Flutter Plugin. Lihat Menyiapkan Google Mobile Ads Flutter Plugin untuk mengetahui detailnya.
  • Menyiapkan mediasi.

    • Langkah 1: Siapkan konfigurasi di UI Unity Ads

    Daftar atau login ke Unity Ads.

    Membuat project

    Di dasbor Unity Ads, buka Projects lalu klik New.

    Isi formulir dan klik Create untuk menambahkan project Anda.

    Buka Unity Ads Monetization, lalu klik Get started.

    Di modal New Project, pilih I will use Mediation dan Google Admob untuk Mediation Partner, lalu klik Next.

    Pilih opsi untuk setelan iklan, lalu klik Berikutnya.

    Pilih penyiapan penempatan Anda, lalu klik Berikutnya.

    Bidding

    Air Terjun

    Isi formulir, lalu klik Add project.

    Catat ID Game.

    Membuat unit iklan dan penempatan

    Buka Unity Ads Monetization > Placements, lalu pilih project Anda dan klik Tambahkan unit iklan.

    Masukkan Nama unit iklan, lalu pilih Platform dan Format iklan.

    Android

    iOS

    Buka Monetisasi > Penempatan, lalu klik Tambahkan Unit Iklan.

    Masukkan Nama Unit Iklan, lalu pilih Platform dan Format Iklan Anda.

    Android

    iOS

    Pilih Waterfall untuk Penyiapan. Di bagian Placement, masukkan Placement name, GEO Tagging, dan Target.

    Catat ID Penempatan.

    Terakhir, klik Tambahkan unit iklan untuk menyimpan unit iklan dan penempatan Anda.

    Menemukan kunci Unity Ads Reporting API

    Bidding

    Langkah ini tidak diperlukan untuk integrasi bidding.

    Air Terjun

    Buka Unity Ads Monetization > API management, lalu catat API Key di Monetization Stats API Access.

    Kemudian, buka Unity Ads Monetization > Organization Settings dan catat Organization core ID.

    Memperbarui app-ads.txt

    Authorized Sellers for Apps app-ads.txt adalah inisiatif IAB Tech Lab yang membantu memastikan inventaris iklan aplikasi Anda hanya dijual melalui saluran yang telah Anda identifikasi sebagai resmi. Untuk mencegah kerugian pendapatan iklan yang signifikan, Anda harus menerapkan file app-ads.txt. Jika Anda belum melakukannya, buat file app-ads.txt untuk Ad Manager.

    Untuk menerapkan app-ads.txt untuk Unity Ads, lihat menyiapkan app-ads.txt untuk pertama kalinya.

    Mengaktifkan mode pengujian

    Mode pengujian dapat diaktifkan dari dasbor Unity Ads. Buka Unity Ads Monetization > Testing.

    Anda dapat menerapkan mode pengujian untuk aplikasi dengan mengklik tombol edit setiap platform, mengaktifkan Ganti mode pengujian klien, dan memilih Aktifkan mode pengujian (yaitu, gunakan iklan percobaan) untuk semua perangkat.

    Android

    iOS

    Atau, Anda dapat mengaktifkan mode pengujian untuk perangkat tertentu dengan mengklik Tambahkan Perangkat Pengujian.

    Masukkan detail perangkat pengujian, lalu klik Simpan.

    Langkah 2: Siapkan permintaan Unity Ads di UI Ad Manager

    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 Unity Ads ke daftar partner iklan GDPR dan peraturan negara bagian AS

    Ikuti langkah-langkah di Setelan peraturan Eropa dan Setelan peraturan negara bagian AS untuk menambahkan Unity Ads ke daftar partner iklan peraturan Eropa dan negara bagian AS di UI Ad Manager.

    Langkah 3: Impor Unity Ads SDK dan adapter

    Integrasi melalui pub.dev

    Tambahkan dependensi berikut dengan Unity Ads SDK dan adaptor versi terbaru di file pubspec.yaml paket Anda:

    dependencies:
  gma_mediation_unity: ^1.11.1

    Integrasi Manual

    Download plugin mediasi Google Mobile Ads versi terbaru untuk Unity Ads, ekstrak file yang didownload, dan tambahkan folder plugin yang diekstrak (beserta isinya) ke project Flutter Anda. Kemudian, referensikan plugin di file pubspec.yaml dengan menambahkan dependensi berikut:

    dependencies:
  gma_mediation_unity:
    path: path/to/local/package

    Langkah 4: Terapkan setelan privasi di Unity Ads SDK

    Untuk mematuhi Kebijakan Izin Pengguna Uni Eropa Google, Anda harus membuat pengungkapan tertentu kepada pengguna di Wilayah Ekonomi Eropa (EEA), Inggris Raya, dan Swiss, serta mendapatkan izin mereka untuk penggunaan cookie atau penyimpanan lokal lainnya jika diwajibkan secara hukum, dan untuk pengumpulan, pembagian, serta penggunaan data pribadi untuk personalisasi iklan. Kebijakan ini mencerminkan persyaratan dalam ePrivacy Directive dan General Data Protection Regulation (GDPR) Uni Eropa. Anda bertanggung jawab untuk memverifikasi bahwa izin diteruskan ke setiap sumber iklan dalam rantai mediasi Anda.

    Adaptor Unity Ads Flutter versi 1.10.0 dan yang lebih baru mendukung penerusan sinyal izin GDPR dari Platform Pengelolaan Izin yang terintegrasi dengan Transparency and Consent Framework (TCF) IAB ke SDK iklan Unity Ads. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan konfigurasi izin TCF atau non-TCF.

    Hukum privasi negara bagian Amerika Serikat

    Hukum privasi negara bagian Amerika Serikat mewajibkan perusahaan tersebut untuk memberikan hak kepada pengguna guna menolak "penjualan" "informasi pribadi" mereka (sebagaimana kedua istilah tersebut didefinisikan dalam hukum), dengan pilihan tidak ikut yang disediakan melalui link "Jangan Jual Informasi Pribadi Saya" yang terlihat jelas di halaman beranda pihak "penjual". Panduan kepatuhan terhadap 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 mungkin berpartisipasi dalam penjualan informasi pribadi dan mengikuti panduan dari setiap jaringan tersebut untuk memastikan kepatuhan.

    Plugin mediasi Google Mobile Ads untuk Unity Ads menyertakan metode GmaMediationUnity.setCCPAConsent(). Kode contoh berikut menunjukkan cara meneruskan informasi izin ke Unity Ads SDK iklan. Jika Anda memilih untuk memanggil metode ini, sebaiknya lakukan sebelum meminta iklan melalui Google Mobile Ads Flutter Plugin.

    import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...

GmaMediationUnity.setCCPAConsent(true);

    Menetapkan perlakuan berdasarkan usia

    Plugin mediasi Unity Ads versi 1.6.5 dan yang lebih baru meneruskan setelan yang ditujukan untuk anak-anak dan setelan pengguna di bawah usia dewasa ke Unity Ads.

    Untuk memproses sinyal ini per pengguna, Unity Ads mengharuskan Anda mengaktifkan penetapan Mixed Audience di dasbor Unity Monetization. Untuk mengetahui informasi selengkapnya tentang cara mengaktifkan penetapan audiens campuran di project Anda, lihat Menetapkan penetapan usia tingkat game.

    Langkah 5: Tambahkan kode yang diperlukan

    Android

    Tidak diperlukan kode tambahan untuk integrasi Unity Ads Android.

    iOS

    Integrasi SKAdNetwork

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

    Langkah 6: Uji penerapan Anda

    Mengaktifkan iklan pengujian

    Pastikan Anda mendaftarkan perangkat pengujian untuk Ad Manager dan mengaktifkan mode pengujian di UI Unity Ads.

    Memverifikasi iklan percobaan

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

    Kode error

    Jika adaptor gagal menerima iklan dari Unity Ads, penayang dapat memeriksa error yang mendasarinya dari respons iklan menggunakan ResponseInfo di bawah class berikut:

    Android

    com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter

    iOS

    GADMAdapterUnity
GADMediationAdapterUnity

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

    Android

    Kode error Alasan
    0-10 UnityAds SDK menampilkan error. Lihat kode untuk mengetahui detail selengkapnya.
    101 Parameter server UnityAds yang dikonfigurasi di UI AdMob tidak ada/tidak valid.
    102 UnityAds menampilkan penempatan dengan status NO_FILL.
    103 UnityAds menampilkan penempatan dengan status NONAKTIF.
    104 UnityAds mencoba menampilkan iklan dengan konteks null.
    105 Konteks yang digunakan untuk melakukan inisialisasi, memuat, dan/atau menampilkan iklan dari Unity Ads bukan merupakan instance Aktivitas.
    106 UnityAds mencoba menampilkan iklan yang belum siap ditampilkan.
    107 UnityAds tidak didukung di perangkat.
    108 UnityAds hanya dapat memuat 1 iklan per penempatan dalam satu waktu.
    109 UnityAds selesai dengan status ERROR.
    110 Ukuran iklan yang diminta tidak sesuai dengan ukuran banner yang didukung UnityAds.
    111 UnityAds menampilkan error inisialisasi.
    112 Unity Ads menampilkan token bidding null atau kosong.
    200-204 Banner UnityAds menampilkan error tertentu. Lihat kode untuk mengetahui detail selengkapnya.

    iOS

    0-9 UnityAds SDK menampilkan error. Lihat dokumentasi Unity untuk mengetahui detail selengkapnya.
    101 Parameter server UnityAds yang dikonfigurasi di UI Ad Manager tidak ada/tidak valid.
    102 Perangkat tidak didukung oleh UnityAds.
    103 UnityAds selesai menampilkan dengan status error kUnityAdsFinishStateError.
    104 Objek iklan Unity bernilai nihil setelah memanggil penginisialisasinya.
    105 Gagal menampilkan Unity Ads karena iklan belum siap.
    107 UnityAds memanggil callback perubahan penempatan dengan status penempatan kUnityAdsPlacementStateDisabled.
    108 Iklan telah dimuat untuk penempatan ini. UnityAds SDK tidak mendukung pemuatan beberapa iklan untuk penempatan yang sama.
    109 Iklan banner yang ditampilkan oleh UnityAds tidak sesuai dengan ukuran yang diminta.
    110 UnityAds menampilkan error inisialisasi.
    111 Format iklan tidak didukung.
    112 UnityAds menampilkan token bidding null atau kosong.

    Log Perubahan Adaptor Mediasi Flutter Unity Ads

    Versi 1.11.1

    Versi 1.11.0

    Versi 1.10.0

    Versi 1.9.0

    Versi 1.8.1

    Versi 1.8.0

    Versi 1.7.0

    Versi 1.6.5

    • Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.

    Versi 1.6.4

    Versi 1.6.3

    • Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.

    Versi 1.6.2

    • Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.

    Versi 1.6.1

    • Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.

    Versi 1.6.0

    • Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.

    Versi 1.5.1

    • Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.

    Versi 1.5.0

    • Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.

    Versi 1.4.1

    • Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.

    Versi 1.4.0

    • Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.

    Versi 1.3.0

    • Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.3.1.

    Versi 1.2.0

    • Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.3.1.

    Versi 1.1.0

    • Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.2.0.

    Versi 1.0.0

    • Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.0.0.