Memulai

Panduan ini ditujukan untuk penayang yang ingin memonetisasi aplikasi Flutter.

Mengintegrasikan Google Mobile Ads SDK ke aplikasi Flutter, yang akan Anda lakukan di sini, adalah langkah pertama untuk menampilkan iklan Ad Manager dan memperoleh pendapatan. Setelah integrasi selesai, Anda dapat memilih format iklan untuk mendapatkan langkah-langkah penerapan yang mendetail.

Google Mobile Ads SDK untuk Flutter saat ini mendukung pemuatan dan tampilan iklan banner, interstisial (layar penuh), native, dan reward.

Prasyarat

  • Flutter 1.22.0 atau yang lebih baru
  • Android
    • Android Studio 3.2 atau yang lebih baru
    • Menargetkan Android API level 20 atau yang lebih tinggi
    • Tetapkan compileSdkVersion ke 28 atau lebih tinggi
  • iOS

Mengimpor Mobile Ads SDK

Penyiapan khusus platform

Android

Mengupdate AndroidManifest.xml

ID aplikasi Ad Manager harus disertakan di AndroidManifest.xml. Jika hal ini tidak dilakukan, akan terjadi error saat peluncuran aplikasi.

Tambahkan ID aplikasi Ad Manager (yang diidentifikasi di UI Ad Manager) ke file android/app/src/main/AndroidManifest.xml aplikasi dengan menambahkan tag <meta-data> dengan nama com.google.android.gms.ads.APPLICATION_ID. Anda dapat menemukan ID aplikasi di UI Ad Manager. Untuk android:value, masukkan ID aplikasi Ad Manager Anda sendiri dalam tanda kutip seperti yang ditunjukkan:

<manifest>
    <application>
        <!-- Sample app ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    <application>
<manifest>

Gunakan value yang sama saat Anda melakukan inisialisasi plugin dalam kode Dart.

Lihat panduan Android untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi AndroidManifest.xml dan menyiapkan ID aplikasi.

iOS

Mengupdate Info.plist Anda

Di file ios/Runner/Info.plist aplikasi Anda, tambahkan kunci GADApplicationIdentifier dengan nilai string ID aplikasi Ad Manager Anda (diidentifikasi di UI Ad Manager):

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-################~##########</string>

Anda harus meneruskan nilai yang sama saat melakukan inisialisasi plugin dalam kode Dart.

Lihat panduan iOS untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi Info.plist dan menyiapkan ID aplikasi Anda.

Menginisialisasi Mobile Ads SDK

Sebelum memuat iklan, aplikasi harus menginisialisasi Mobile Ads SDK dengan memanggil MobileAds.instance.initialize(), yang menginisialisasi SDK dan menampilkan Future yang selesai setelah inisialisasi selesai (atau setelah waktu tunggu 30 detik). Langkah ini hanya perlu dilakukan sekali, idealnya tepat sebelum menjalankan aplikasi.

import 'package:google_mobile_ads/google_mobile_ads.dart';
import 'package:flutter/material.dart';

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  MobileAds.instance.initialize();

  runApp(MyApp());
}

class MyApp extends StatefulWidget {
  @override
  MyAppState createState() => MyAppState();
}

class MyAppState extends State<MyApp> {
  @override
  void initState() {
    super.initState();
    // Load ads.
  }
}

Memilih format iklan

Mobile Ads SDK kini telah diimpor dan Anda siap menerapkan iklan. Pengelola Iklan menawarkan berbagai format iklan, sehingga Anda dapat memilih format yang paling sesuai dengan pengalaman pengguna aplikasi Anda.

Iklan persegi panjang yang muncul di bagian atas atau bawah layar perangkat. Iklan banner tetap muncul di layar saat pengguna berinteraksi dengan aplikasi, dan dapat dimuat ulang secara otomatis setelah jangka waktu tertentu. Jika periklanan seluler merupakan hal yang baru bagi Anda, iklan Banner adalah pilihan pertama yang baik.

Menerapkan Iklan banner

Interstisial

Iklan layar penuh yang menutupi antarmuka aplikasi hingga pengguna menutupnya. Iklan ini paling cocok digunakan saat jeda alami dalam alur eksekusi aplikasi, seperti di sela-sela level game atau tepat setelah menyelesaikan suatu tugas.

Menerapkan iklan Interstisial

Native

Iklan yang dapat disesuaikan, yang cocok dengan tampilan dan nuansa aplikasi Anda. Anda yang menentukan cara dan lokasi penempatannya, sehingga tata letaknya lebih konsisten dengan desain aplikasi Anda.

Menerapkan iklan Native

Reward

Iklan yang memberikan reward kepada pengguna karena telah menonton video singkat serta berinteraksi dengan survei dan iklan yang dapat dimainkan. Cocok untuk memonetisasi pengguna yang tidak dipungut biaya.

Menerapkan Iklan reward