Mulai menggunakan AdMob di project iOS Anda

Panduan memulai ini ditujukan untuk penayang dan developer yang ingin menggunakan AdMob untuk memonetisasi aplikasi yang di-build dengan Firebase. Jika Anda tidak berencana untuk menyertakan Firebase dalam aplikasi, buka panduan AdMob mandiri.

Pelajari semua manfaat penggunaan AdMob, Firebase, dan Google Analytics secara bersamaan, jika belum melakukannya.

Sebelum memulai

• Jika Anda belum memiliki project Firebase dan aplikasi Firebase, ikuti panduan memulai Firebase: Menambahkan Firebase ke project iOS Anda.

• Pastikan bahwa Google Analytics diaktifkan di project Firebase Anda:

  • Jika Anda membuat project Firebase baru, aktifkan Google Analytics selama alur kerja pembuatan project.

  • Jika sudah memiliki project Firebase yang belum mengaktifkan Google Analytics, Anda dapat mengaktifkan Google Analytics dari tab Integrations di bagian > Project settings.

  Catatan: Menambahkan Firebase SDK untuk Google Analytics ke aplikasi Anda bersifat opsional tetapi sangat direkomendasikan. Pelajari lebih lanjut manfaat menambahkan Firebase SDK untuk Google Analytics.

Langkah 1: Siapkan aplikasi di akun AdMob

1. Daftarkan aplikasi sebagai aplikasi AdMob.

   1. Login atau daftar untuk membuka akun AdMob.

   2. Daftarkan aplikasi ke AdMob. Langkah ini akan membuat aplikasi AdMob dengan ID Aplikasi AdMob unik yang nantinya akan Anda butuhkan dalam panduan ini.

   Anda akan diminta untuk menambahkan Mobile Ads SDK ke aplikasi Anda. Temukan petunjuk detail terkait tugas ini nanti dalam panduan ini.

2. Tautkan aplikasi AdMob ke aplikasi Firebase Anda.

   Langkah ini bersifat opsional, tetapi sangat direkomendasikan. Pelajari lebih lanjut manfaat mengaktifkan metrik pengguna dan menautkan aplikasi AdMob ke Firebase.

   Selesaikan dua langkah berikut di dasbor Apps pada akun AdMob Anda:

   1. Aktifkan User Metrics agar AdMob dapat memproses dan menampilkan data analisis pilihan di akun AdMob Anda. Ini juga merupakan setelan wajib agar dapat menautkan aplikasi AdMob ke Firebase.

   2. Tautkan aplikasi AdMob Anda ke project Firebase dan aplikasi Firebase yang ada.

      Pastikan Anda memasukkan ID paket yang sama dengan yang Anda masukkan untuk aplikasi Firebase. Temukan ID paket aplikasi Firebase Anda di kartu Your apps pada > Project settings.

Langkah 2: Tambahkan ID Aplikasi AdMob ke file Info.plist Anda

Di file Info.plist aplikasi Anda, tambahkan kunci GADApplicationIdentifier dengan nilai string ID Aplikasi AdMob.

Penting: Langkah ini diperlukan mulai Google Mobile Ads SDK v7.42.0. Jika Anda tidak menambahkan entri Info.plist ini, aplikasi akan error dan menampilkan pesan: "The Google Mobile Ads SDK was initialized incorrectly."

Anda dapat melakukan perubahan ini secara terprogram:

<!-- Sample AdMob App ID: ca-app-pub-3940256099942544~1458002511 -->
<key>GADApplicationIdentifier</key>
<string>ADMOB_APP_ID</string>

Atau, edit di editor daftar properti:

Langkah 3: Tambahkan dan inisialisasi Mobile Ads SDK

1. Tambahkan dependensi untuk Google Mobile Ads SDK ke Podfile project Anda:

   pod 'Google-Mobile-Ads-SDK'
   

2. Sebelum memuat iklan, panggil metode startWithCompletionHandler: pada GADMobileAds.sharedInstance.

   Panggilan ini akan menginisialisasi SDK dan memanggil kembali pengendali penyelesaian setelah proses inisialisasi selesai (atau setelah waktu tunggu 30 detik). Panggil metode ini sekali saja dan sedini mungkin, idealnya pada peluncuran aplikasi, tetapi setelah inisialisasi Firebase.

   Peringatan: Iklan dapat dipramuat oleh Mobile Ads SDK atau SDK partner mediasi setelah memanggil startWithCompletionHandler:. Jika perlu melakukan tindakan apa pun sebelum memuat iklan, pastikan Anda melakukannya sebelum menginisialisasi Mobile Ads SDK. Berikut beberapa contoh tindakan yang mungkin diperlukan sebelum inisialisasi:

   • Mendapatkan izin dari pengguna di Wilayah Ekonomi Eropa (EEA)
   • Menetapkan flag khusus permintaan (seperti tagForChildDirectedTreatment atau tag_for_under_age_of_consent)

   Pelajari lebih lanjut di dokumentasi AdMob.

   Berikut adalah contoh cara memanggil metode startWithCompletionHandler: di AppDelegate Anda:

   Swift

   import Firebase
   import GoogleMobileAds
   ...
   
   @UIApplicationMain
   class AppDelegate: UIResponder, UIApplicationDelegate {
   
     var window: UIWindow?
   
     func application(_ application: UIApplication,
         didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
   
       // Use Firebase library to configure APIs.
       FirebaseApp.configure()
   
       // Initialize the Google Mobile Ads SDK.
       GADMobileAds.sharedInstance().start(completionHandler: nil)
   
       return true
     }
   
   }
   

   Objective-C

   @import Firebase;
   @import GoogleMobileAds;
   ...
   
   @implementation AppDelegate
   
   - (BOOL)application:(UIApplication *)application
       didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
     // Use Firebase library to configure APIs.
     [FIRApp configure];
     // Initialize the Google Mobile Ads SDK.
     [[GADMobileAds sharedInstance] startWithCompletionHandler:nil];
     return YES;
   }
   
   @end
   

Langkah 4: Lihat metrik pengguna dan data analisis

Setelah diinisialisasi, Mobile Ads SDK secara otomatis mulai mencatat peristiwa dan properti pengguna analisis ke dalam log dari aplikasi Anda. Data ini dapat Anda lihat tanpa harus menambahkan kode tambahan ke aplikasi atau menerapkan iklan apa pun. Berikut adalah tempat Anda dapat melihat data analisis ini:

• Di kartu User metrics akun AdMob Anda (dasbor Home atau Apps), Anda dapat melihat metrik pengguna pilihan yang berasal dari data analisis yang dikumpulkan, seperti durasi sesi rata-rata, ARPU, dan retensi.

• Di dasbor Analytics Firebase console, Anda dapat melihat statistik gabungan dan ringkasan metrik kunci. Jika menambahkan Firebase SDK untuk Google Analytics, Anda juga dapat menandai konversi untuk kampanye iklan dan membuat audiens kustom di Firebase console.

Perhatikan bahwa untuk mewakili metrik ARPU dan ARPPU dengan lebih baik, sebaiknya sertakan data dari peristiwa kustom analisis yang bernama ecommerce_purchase dalam penghitungan pendapatan untuk metrik ini (pelajari caranya).

Data biasanya ditampilkan dalam satu jam, tetapi terkadang dapat memerlukan hingga 48 jam.

Langkah 5: (Opsional) Gunakan fitur Google Analytics dan Firebase lainnya

Manfaatkan kesempatan dan fitur lainnya untuk meningkatkan monetisasi aplikasi dan interaksi pengguna:

• Menambahkan dan menggunakan Firebase SDK untuk Google Analytics

  • Terapkan pencatatan peristiwa kustom ke dalam log di aplikasi Anda.

  • Tandai konversi untuk kampanye iklan kustom.

  • Sertakan data peristiwa ecommerce_purchase dalam penghitungan pendapatan untuk metrik ARPU dan ARPPU.

  Untuk mempelajari lebih lanjut, baca panduan untuk menggunakan Google Analytics dan Firebase dengan aplikasi AdMob.

• Menggunakan produk Firebase lainnya di aplikasi

  Setelah menambahkan Firebase SDK untuk Google Analytics, gunakan produk Firebase lainnya untuk mengoptimalkan iklan di aplikasi Anda.

  • Dengan Remote Config, Anda dapat mengubah perilaku dan tampilan aplikasi tanpa memublikasikan update aplikasi, tanpa biaya apa pun dan tanpa batasan jumlah pengguna aktif harian.

  • Dengan A/B Testing, Anda dapat menguji perubahan pada UI, fitur, atau kampanye interaksi aplikasi untuk mempelajari apakah perubahan tersebut memengaruhi metrik kunci Anda (seperti pendapatan dan retensi) sebelum menerapkannya secara luas.

• Mengoptimalkan monetisasi iklan untuk aplikasi Anda

  Coba berbagai format atau konfigurasi iklan berbeda dengan sekelompok kecil pengguna, lalu buat keputusan berdasarkan data mengenai penerapan iklan untuk semua pengguna. Untuk mempelajari lebih lanjut, lihat tutorial berikut:

  • Menguji adopsi format iklan baru (ringkasan | penerapan).

  • Mengoptimalkan frekuensi iklan (ringkasan | penerapan).

Langkah 6: Pilih format iklan yang akan diterapkan di aplikasi

AdMob menawarkan berbagai format iklan yang berbeda, sehingga Anda dapat memilih format yang paling sesuai dengan pengalaman pengguna aplikasi Anda. Klik tombol format iklan berikut untuk melihat petunjuk implementasi mendetail dalam dokumentasi AdMob.

Banner

Iklan kotak yang muncul di bagian atas atau bawah layar perangkat

Iklan Banner tetap ditampilkan di layar saat pengguna berinteraksi dengan aplikasi, dan dapat diperbarui 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 Interstisial paling cocok digunakan saat jeda alami dalam alur eksekusi aplikasi, misalnya 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

Iklan Native adalah format iklan berbasis komponen. Cara dan lokasi penayangan iklan Native sepenuhnya ada di tangan Anda. Dengan begitu, tata letaknya dapat lebih konsisten dengan desain aplikasi Anda. Dengan memilih sendiri font, warna, dan detail lainnya, Anda dapat membuat tampilan iklan yang tampak alami dan tidak mengganggu untuk memperkaya pengalaman pengguna.

Menerapkan Iklan Native Advanced

Reward

Iklan yang memberikan reward kepada pengguna karena telah menonton video singkat serta berinteraksi dengan survei dan iklan yang dapat dimainkan

Iklan Reward (atau "berbasis reward") dapat membantu memonetisasi pengguna yang tidak dipungut biaya.

Menerapkan Iklan Reward

Menerapkan Iklan Reward (API Baru)