Menyiapkan mediasi

Pilih platform: Android iOS Unity Flutter Android (Lama)

Panduan ini menunjukkan cara mengintegrasikan adaptor mediasi dengan aplikasi Flutter Anda.

Prasyarat

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

Baru menggunakan mediasi? Baca Pengantar mediasi.

Melakukan inisialisasi Google Mobile Ads Flutter Plugin

Panduan memulai cepat menunjukkan cara melakukan inisialisasi Google Mobile Ads Flutter Plugin. Selama panggilan inisialisasi tersebut, adaptor mediasi juga diinisialisasi. Penting untuk menunggu hingga inisialisasi selesai sebelum Anda memuat iklan untuk memverifikasi partisipasi penuh dari setiap jaringan iklan pada panggilan iklan pertama.

Kode contoh berikut menunjukkan cara memeriksa status inisialisasi setiap adaptor sebelum membuat panggilan 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 flutterSdkPath = {
    def properties = new Properties()
    file("local.properties").withInputStream { properties.load(it) }
    def flutterSdkPath = properties.getProperty("flutter.sdk")
    assert flutterSdkPath != null, "flutter.sdk not set in local.properties"
    return flutterSdkPath
}()

includeBuild("$flutterSdkPath/packages/flutter_tools/gradle")

Menambahkan dependensi untuk jaringan partner

Adaptor mediasi dan dependensinya harus ditambahkan ke project Android dan iOS Anda. Dependensi ini dapat ditambahkan dengan mengupdate 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 class adaptor jaringan iklan yang memuat iklan

Kode contoh berikut menunjukkan cara mencatat nama class jaringan iklan ke dalam log 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(),
    );

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

Menggunakan iklan native dengan mediasi

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 Regulation (GDPR), ikuti langkah-langkah di Setelan peraturan negara bagian Amerika Serikat atau Setelan GDPR untuk menambahkan partner mediasi Anda di daftar partner iklan GDPR atau negara bagian Amerika Serikat di Privasi & pesan Ad Manager. Jika tidak, partner mungkin 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
Memilih sumber iklan