Mediasi

Panduan ini menunjukkan cara mengintegrasikan adaptor mediasi dengan aplikasi Flutter.

Prasyarat

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

Baru mengenal mediasi? Baca Pengantar Mediasi.

Menginisialisasi Mobile Ads SDK

Panduan memulai cepat menunjukkan cara melakukan inisialisasi Mobile Ads SDK. Selama panggilan inisialisasi tersebut, mediasi dan adaptor bidding juga diinisialisasi. Anda harus menunggu hingga inisialisasi selesai sebelum memuat iklan. Tindakan ini diperlukan untuk memastikan partisipasi penuh dari setiap jaringan iklan pada permintaan iklan pertama.

Kode contoh berikut menunjukkan cara memeriksa status inisialisasi setiap 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 sehingga Anda dapat menggunakan API Android 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 project Android dan iOS Anda. Elemen tersebut dapat ditambahkan dengan memperbarui file build.gradle tingkat aplikasi di Android dan Podfile di iOS. Google memiliki adaptor open source di GitHub untuk Android dan iOS.

Lihat dokumentasi Android dan iOS untuk setiap jaringan partner guna mendapatkan panduan mendetail tentang cara menambahkan adaptornya 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 ke dalam log:

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

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

Mediasi iklan native

Berikut adalah beberapa praktik terbaik yang perlu dipertimbangkan saat menerapkan mediasi native.

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

Hukum privasi negara bagian Amerika Serikat dan GDPR

Jika Anda harus mematuhi hukum privasi negara bagian Amerika Serikat atau General Data Protection Peraturan (GDPR), ikuti langkah-langkah di setelan peraturan negara bagian Amerika Serikat atau setelan GDPR untuk menambahkan partner mediasi Anda di negara bagian AS atau daftar partner iklan GDPR Ad Manager. Jika hal ini tidak dilakukan, partner dapat gagal menayangkan iklan di aplikasi Anda.

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