Menyiapkan mediasi

Pilih platform: Android Baru Android iOS Unity Flutter

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.

Menginisialisasi Google Mobile Ads Flutter Plugin

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

Contoh kode 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());
}

Mengupdate setelan gradle (khusus Android)

Tambahkan baris berikut ke file settings.gradle, sehingga Anda dapat menggunakan Android API 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. Adaptor dan dependensi 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 Android dan iOS dokumentasi untuk setiap jaringan partner guna mendapatkan panduan mendetail tentang cara menambahkan adaptornya di aplikasi Anda.

Memeriksa class adaptor jaringan iklan yang memuat iklan

Contoh kode berikut menunjukkan cara mencatat nama class 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(),
    );

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 frekuensi refresh unit iklan banner Anda.

Menggunakan iklan native dengan mediasi

Berikut 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 tetap harus mematuhi kebijakan jaringan mediasi yang menyediakan iklan.

Hukum privasi negara bagian Amerika Serikat dan GDPR

Jika Anda harus mematuhi hukum privasi negara bagian Amerika Serikat atau Peraturan Perlindungan Data Umum (GDPR), ikuti langkah-langkah di setelan peraturan negara bagian Amerika Serikat atau setelan GDPR untuk menambahkan partner mediasi Anda di daftar partner iklan negara bagian Amerika Serikat atau GDPR di Privasi & pesan Ad Manager. Jika tidak melakukannya, 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 sumber iklan