Mediasi

Panduan ini menunjukkan cara mengintegrasikan adaptor mediasi dengan Aplikasi Flutter.

Prasyarat

Sebelum dapat mengintegrasikan mediasi untuk format iklan, Anda perlu mengintegrasikan format iklan ke aplikasi Anda:

Baru mengenal mediasi? {i>Read<i} Pengantar mediasi.

Menginisialisasi Mobile Ads SDK

Panduan memulai cepat menunjukkan cara melakukan inisialisasi Iklan Seluler SDK. Selama panggilan inisialisasi itu, adaptor mediasi juga melakukan inisialisasi. Sebaiknya tunggu hingga inisialisasi selesai sebelum Anda memuat iklan untuk memastikan partisipasi penuh dari setiap jaringan iklan di permintaan iklan pertama.

Kode contoh berikut menunjukkan cara memeriksa setiap inisialisasi adaptor sebelum membuat permintaan iklan.

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  
  MobileAds.instance.initialize()
    .then((initializationStatus) {
      initializationStatus.adapterStatuses.forEach((key, value) {
        debugPrint('Adapter status for $key: ${value.description}');
      });
  });
  
  runApp(MyApp());
}

Memperbarui setelan Gradle (khusus Android)

Tambahkan baris berikut ke file settings.gradle Anda agar Anda dapat menggunakan Android API plugin:

def flutterProjectRoot = rootProject.projectDir.parentFile.toPath()
def plugins = new Properties()
def pluginsFile = new File(flutterProjectRoot.toFile(), '.flutter-plugins')
if (pluginsFile.exists()) {
    pluginsFile.withInputStream { stream -> plugins.load(stream) }
}

plugins.each { name, path ->
    def pluginDirectory = flutterProjectRoot.resolve(path).resolve('android').toFile()
    include ":$name"
    project(":$name").projectDir = pluginDirectory
}

Menambahkan dependensi untuk jaringan partner

Adaptor mediasi dan dependensinya perlu ditambahkan ke Android Anda dan project iOS. Fitur ini dapat ditambahkan dengan mengupdate level aplikasi build.gradle file di Android dan Podfile di iOS. Google memiliki adaptor open source di GitHub untuk keduanya Android dan iOS.

Lihat Android dan iOS untuk setiap jaringan partner guna mendapatkan panduan mendetail tentang cara adaptor daya di aplikasi Anda.

Memeriksa kelas adaptor jaringan iklan mana yang memuat iklan

Kode contoh berikut menunjukkan cara mencatat nama kelas jaringan iklan untuk iklan banner:

final bannerAd = AdManagerBannerAd(
      size: [AdSize.banner],
      adUnitId: '<your-ad-unit>',
      listener: AdManagerBannerAdListener(
        onAdLoaded: (ad) {
          debugPrint('$ad loaded: ${ad.responseInfo?.mediationAdapterClassName}');
        },
      ),
      request: AdManagerAdRequest(),
    );

Menggunakan iklan banner dengan mediasi

Pastikan untuk menonaktifkan muat ulang di semua UI sumber iklan pihak ketiga untuk iklan banner unit yang digunakan dalam mediasi. Hal ini mencegah muat ulang dua kali karena Ad Manager juga memicu muat ulang berdasarkan kecepatan refresh unit iklan banner Anda.

Menggunakan iklan native dengan mediasi

Berikut adalah beberapa praktik terbaik yang perlu dipertimbangkan saat mengimplementasikan iklan mediasi.

Kebijakan presentasi iklan Native
Setiap jaringan iklan memiliki kebijakannya sendiri. Saat menggunakan mediasi, penting untuk ingat bahwa aplikasi Anda masih harus mematuhi kebijakan jaringan yang menyediakan iklan.

Hukum privasi negara bagian Amerika Serikat dan GDPR

Jika Anda harus mematuhi privasi status hukum atau Perlindungan Data Umum Peraturan (GDPR), ikuti langkah-langkah dalam Peraturan negara bagian AS setelan atau GDPR setelan untuk menambahkan partner mediasi di Privasi & Ad Manager pesan Daftar partner iklan GDPR atau negara bagian Amerika Serikat. Kegagalan dalam melakukannya dapat menyebabkan partner gagal menayangkan iklan di aplikasi Anda.

Pelajari lebih lanjut cara mengaktifkan pemrosesan data yang dibatasi (RDP) dan mendapatkan GDPR memberikan izin kepada Google User Messaging Platform (UMP) SDK.
Berikutnya
Pilih jaringan