Mengintegrasikan maio dengan mediasi

Pilih platform: Android iOS Unity Flutter Android (Lama)

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

Antarmuka dasbor untuk maio menggunakan teks bahasa Jepang untuk label, tombol, dan deskripsinya, dan screenshot dalam panduan ini belum diterjemahkan. Namun, dalam deskripsi dan petunjuk di sini, label dan tombol disebut dengan padanan bahasa Inggrisnya. Misalnya, "URL スキーム" adalah "URL Scheme".

Integrasi dan format iklan yang didukung

Adaptor mediasi untuk MAIO memiliki kemampuan berikut:

Integrasi
Bidding
Air Terjun
Format
Membuka Aplikasi
Banner
Interstisial
Reward
Interstisial Reward
Native

Prasyarat

Sebelum melanjutkan, verifikasi hal berikut:

  • Versi Google Mobile Ads Unity Plugin terbaru.
  • Unity Editor versi 4 atau yang lebih baru.
  • Untuk men-deploy di Android
    • Android API level 24 atau yang lebih baru.
  • Untuk men-deploy di iOS
    • Target deployment iOS 15.0 atau yang lebih baru.
  • Project Unity yang berfungsi dan dikonfigurasi dengan Google Mobile Ads Unity Plugin. Lihat Menyiapkan Google Mobile Ads Unity Plugin untuk mengetahui detailnya.
  • Menyiapkan mediasi.

    • Langkah 1: Siapkan konfigurasi di UI maio

    Pertama, daftar atau login ke akun maio Anda. Klik tombol Pengelolaan aplikasi di sidebar kiri, lalu klik Aplikasi baru.

    Pilih tab yang sesuai dengan Jenis Iklan yang Anda inginkan.

    Interstisial

    Masukkan Nama aplikasi Anda, pilih platform, dan berikan URL Aplikasi Anda. Pilih Video interstisial sebagai Jenis Iklan, lalu klik Perbarui.

    Android

    iOS

    Reward

    Masukkan Nama aplikasi Anda, pilih platform, dan berikan URL Aplikasi Anda. Pilih Video Reward sebagai Jenis Iklan, lalu klik Perbarui.

    Android

    iOS

    Di halaman Application Management, catat ID media. Diperlukan untuk menyiapkan unit iklan Ad Manager Anda di bagian berikutnya.

    Android

    iOS

    Di halaman Zone Management, catat Zone ID. Kode ini juga akan diperlukan untuk menyiapkan unit iklan Ad Manager di bagian berikutnya.

    Android

    iOS

    (Khusus waterfall) Selain ID media dan Zone ID, Anda memerlukan API ID dan API KEY untuk menyiapkan ID unit iklan untuk mediasi. Di halaman Reporting API, catat ID API dan KUNCI API.

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

    Langkah 3: Impor SDK dan adaptor maio

    OpenUPM-CLI

    Jika telah menginstal OpenUPM-CLI, Anda dapat menginstal Plugin Mediasi maio Google Mobile Ads untuk Unity ke project dengan menjalankan perintah berikut dari direktori root project:

    openupm add com.google.ads.mobile.mediation.maio

    OpenUPM

    Di editor project Unity, pilih Edit > Setelan Project > Package Manager untuk membuka Unity Package Manager Settings.

    Di tab Scoped Registries, tambahkan OpenUPM sebagai scoped registry dengan detail berikut:

    • Nama: OpenUPM
    • URL: https://package.openupm.com
    • Cakupan: com.google

    Detail OpenUPM

    Kemudian, buka Window > Package Manager untuk membuka Unity Package Manager dan pilih My Registries dari menu drop-down.

    Registry Unity

    Pilih paket Google Mobile Ads Maio Mediation lalu klik Install.

    Menginstal dari OpenUPM

    Paket Unity

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

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

    Mengimpor dari Unity

    Kemudian, pilih Assets > External Dependency Manager > Android Resolver > Force Resolve. Library External Dependency Manager akan melakukan penyelesaian dependensi dari awal dan menyalin dependensi yang dideklarasikan ke direktori Assets/Plugins/Android aplikasi Unity Anda.

    Paksa Penyelesaian

    Langkah 4: Tambahkan kode yang diperlukan

    Android

    Tidak diperlukan kode tambahan untuk integrasi maio.

    iOS

    Integrasi SKAdNetwork

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

    Langkah 5: Uji penerapan Anda

    Mengaktifkan iklan pengujian

    Pastikan Anda mendaftarkan perangkat pengujian untuk Ad Manager.

    Penayang yang menggunakan Google Mobile Ads Unity Plugin versi 7.26.0 atau yang lebih tinggi akan otomatis menerima iklan percobaan dari maio di ponsel dan tablet yang terdaftar sebagai perangkat pengujian saat membuat permintaan.

    Memverifikasi iklan pengujian

    Untuk memverifikasi bahwa Anda menerima iklan percobaan dari maio, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan sumber iklan maio (Waterfall).

    Kode error

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

    Android

    Format Nama kelas
    Interstisial jp.maio.sdk.android.mediation.admob.adapter.Interstitial
    Reward jp.maio.sdk.android.mediation.admob.adapter.Rewarded

    iOS

    Format Nama kelas
    Interstisial GADMMaioInterstitialAdapter
    Reward GADMMaioRewardedAdapter

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

    Android

    Kode error Alasan
    0-10 maio menampilkan error khusus SDK. Lihat kode dan dokumentasi maio untuk mengetahui detail selengkapnya.
    101 Maio tidak memiliki iklan yang tersedia.
    102 Parameter server tidak valid (misalnya, ID Penempatan tidak ada).
    103 Konteks yang digunakan untuk memuat iklan bukan instance `Activity`.

    iOS

    Kode error Alasan
    0-10 maio menampilkan error khusus SDK. Lihat kode maio untuk mengetahui detail selengkapnya.
    101 maio belum memiliki iklan yang tersedia.
    102 Parameter server tidak valid (misalnya, ID Penempatan tidak ada).
    103 Adaptor maio tidak mendukung format iklan yang diminta.
    104 Iklan sudah dimuat untuk konfigurasi jaringan ini.

    Log Perubahan Plugin Mediasi Unity maio

    Versi 3.1.11

    Versi 3.1.10

    Versi 3.1.9

    Versi 3.1.8

    Versi 3.1.7

    Versi 3.1.6

    Versi 3.1.5

    Versi 3.1.4

    Versi 3.1.3

    Versi 3.1.2

    Versi 3.1.1

    Versi 3.1.0

    Versi 3.0.2

    Versi 3.0.1

    Versi 3.0.0

    Versi 2.0.4

    Versi 2.0.3

    Versi 2.0.2

    Versi 2.0.1

    Versi 2.0.0

    Versi 1.4.3

    Versi 1.4.2

    Versi 1.4.1

    Versi 1.4.0

    Versi 1.3.6

    Versi 1.3.5

    Versi 1.3.4

    Versi 1.3.3

    Versi 1.3.2

    Versi 1.3.1

    Versi 1.3.0

    Versi 1.2.3

    • Mengupdate plugin untuk mendukung Reward API baru.
    • Mendukung adaptor Android maio versi 1.1.7.0.
    • Mendukung adaptor maio iOS versi 1.4.6.0.

    Versi 1.2.2

    • Mendukung adaptor Android maio versi 1.1.6.0.
    • Mendukung adaptor maio iOS versi 1.4.2.0.

    Versi 1.2.1

    • Mendukung adaptor maio Android versi 1.1.6.0.
    • Mendukung adaptor maio iOS versi 1.4.1.0.

    Versi 1.2.0

    • Mendukung adaptor Android maio versi 1.1.4.1.
    • Mendukung adaptor maio iOS versi 1.4.0.0.

    Versi 1.1.3

    • Mendukung adaptor Android maio versi 1.1.3.1.
    • Mendukung adaptor maio iOS versi 1.3.2.0.

    Versi 1.1.2

    • Mendukung adaptor Android maio versi 1.1.3.0.
    • Mendukung adaptor iOS maio versi 1.3.2.0.

    Versi 1.1.1

    • Mendukung adaptor Android maio versi 1.1.1.0.
    • Mendukung adaptor maio iOS versi 1.3.1.1.

    Versi 1.1.0

    • Mendukung adaptor Android maio versi 1.1.0.0.
    • Mendukung adaptor iOS maio versi 1.3.0.0.

    Versi 1.0.2

    • Mendukung maio Android SDK versi 1.0.8.
    • Mendukung maio iOS SDK versi 1.2.19.

    Versi 1.0.1

    • Mendukung maio Android SDK versi 1.0.7.
    • Mendukung maio iOS SDK versi 1.2.19.

    Versi 1.0.0

    • Rilis pertama!
    • Mendukung maio Android SDK versi 1.0.6.
    • Mendukung maio iOS SDK versi 1.2.18.