Menyiapkan Google Mobile Ads SDK

Untuk menayangkan iklan dan memperoleh pendapatan, integrasikan Google Mobile Ads SDK ke dalam aplikasi iOS Anda. Untuk menyiapkan project, Anda harus mengimpor dan melakukan inisialisasi Google Mobile Ads SDK sebelum meminta iklan.

Jika Anda menyertakan Firebase di aplikasi iOS, lihat Memulai AdMob di project iOS Anda.

Panduan ini membahas cara mengimpor dan melakukan inisialisasi Google Mobile Ads SDK, serta memilih format iklan.

Prasyarat

Sebelum melanjutkan, pastikan Anda memiliki hal berikut:

  • Menggunakan Xcode 16.0 atau yang lebih baru.
  • Menargetkan iOS 13.0 atau yang lebih baru.

Mengimpor Google Mobile Ads SDK

Untuk mengimpor Google Mobile Ads SDK, selesaikan salah satu bagian berikut:

Swift Package Manager

Untuk menambahkan dependensi paket ke project Anda, ikuti langkah-langkah berikut:

  1. Buka Xcode.
  2. Buka File > Add Package Dependencies....
  3. Instal Paket Swift Google Mobile Ads SDK.

  4. Pada perintah yang muncul, telusuri repositori GitHub Paket Swift Google Mobile Ads:

    https://github.com/googleads/swift-package-manager-google-mobile-ads.git
    
  5. Pilih versi Paket Swift Google Mobile Ads SDK yang ingin Anda gunakan. Untuk project baru, sebaiknya gunakan Up to Next Major Version.

CocoaPods

Untuk menggunakan CocoaPods, ikuti langkah-langkah berikut:

  1. Buka Podfile project Anda dan tambahkan baris ini ke konfigurasi build target aplikasi Anda:

    pod 'Google-Mobile-Ads-SDK'
  2. Di terminal, jalankan:

    pod install --repo-update

Download manual

Untuk mendownload Google Mobile Ads SDK secara manual, lakukan hal berikut:

  1. Download Google Mobile Ads SDK.
  2. Ekstrak paket googlemobileadssdkios.zip.
  3. Di project Xcode Anda, tambahkan framework berikut:

    • GoogleMobileAds.xcframework
    • UserMessagingPlatform.xcframework
  4. Di setelan General target Anda, buka Frameworks, Libraries, and Embedded Content.

  5. Pastikan Anda telah menetapkan GoogleMobileAds.xcframework dan UserMessagingPlatform.xcframework ke Embed & Sign.

  6. Di setelan build project Anda, lakukan hal berikut:

    • Tambahkan jalur /usr/lib/swift ke Runpath Search Paths.
    • Tambahkan flag linker -ObjC ke Other Linker Flags.

Memperbarui file Info.plist

Di file Info.plist aplikasi Anda, tambahkan kunci berikut:

Contoh lengkap

<key>GADApplicationIdentifier</key>
<!-- Sample AdMob app ID: ca-app-pub-3940256099942544~1458002511 -->
<string>SAMPLE_APP_ID</string>
<key>SKAdNetworkItems</key>
<array>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>cstr6suwn9.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4fzdc2evr5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>2fnua5tdw4.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ydx93a7ass.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>p78axxw29g.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v72qych5uu.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ludvb6z3bs.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>cp8zw746q7.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3sh42y64q3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>c6k4g5qg8m.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>s39g8k73mm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>wg4vff78zm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qy4746246.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>f38h382jlk.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>hs6bdukanm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>mlmmfzh3r3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v4nxqhlyqp.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>wzmmz9fp6w.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>su67r6k2v3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>yclnxrl5pm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>t38b2kh725.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>7ug5zh24hu.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>gta9lk7p23.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>vutu7akeur.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>y5ghdn5j9k.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v9wttpbfk9.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>n38lu8286q.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>47vhws6wlr.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>kbd757ywx3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>9t245vhmpl.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>a2p9lx4jpn.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>22mmun2rn5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>44jx6755aq.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>k674qkevps.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4468km3ulz.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>2u9pt9hc89.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>8s468mfl3y.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>klf5c3l5u5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ppxm28t8ap.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>kbmxgpxpgc.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>uw77j35x4d.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>578prtvx9j.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4dzt52r2t5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>tl55sbb4fm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>c3frkrj4fj.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>e5fvkxwrpn.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>8c4e2ghe7u.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3rd42ekr43.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>97r2b46745.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qcr597p9d.skadnetwork</string>
  </dict>
</array>

Ganti SAMPLE_APP_ID dengan ID aplikasi AdMob Anda. Saat melakukan pengujian, gunakan ID aplikasi contoh yang ditampilkan dalam contoh sebelumnya.

Jika Anda belum membuat akun AdMob dan mendaftarkan aplikasi, sekarang adalah saat yang tepat untuk melakukannya.

Melakukan inisialisasi Google Mobile Ads SDK

Sebelum memuat iklan, lakukan inisialisasi Google Mobile Ads SDK dengan memanggil metode start() dari properti GADMobileAds.sharedInstance. Metode ini memanggil pengendali penyelesaian setelah Google Mobile Ads SDK dan adapter mediasi selesai diproses, atau setelah 30 detik.

Contoh berikut melakukan inisialisasi Google Mobile Ads SDK:

Swift

// Initialize the Google Mobile Ads SDK.
MobileAds.shared.start()

SwiftUI

// Initialize the Google Mobile Ads SDK.
MobileAds.shared.start()

Objective-C

// Initialize the Google Mobile Ads SDK.
[GADMobileAds.sharedInstance startWithCompletionHandler:nil];

Saat melakukan inisialisasi, Google Mobile Ads SDK mungkin melakukan pramuat iklan atau melakukan inisialisasi SDK pihak ketiga saat memanggil metode startWithCompletionHandler:. Jika Anda perlu mendapatkan izin dari pengguna di Wilayah Ekonomi Eropa (EEA), Inggris Raya (UK), atau Swiss, tetapkan flag khusus permintaan. Jika Anda perlu menetapkan flag khusus permintaan, pastikan Anda menetapkan flag sebelum melakukan inisialisasi Google Mobile Ads SDK. Untuk mengetahui detailnya, lihat Penargetan.

Memilih format iklan

Setelah mengimpor Google Mobile Ads SDK, Anda dapat memilih format iklan untuk diterapkan.

AdMob menawarkan format iklan berikut:

Format Iklan Deskripsi Dokumentasi
Banner Menampilkan iklan persegi panjang di bagian tata letak aplikasi Anda. Iklan ini otomatis diperbarui pada interval yang ditetapkan. Pengguna melihat iklan ini secara berkala saat tetap berada di layar yang sama. Menyiapkan iklan banner
Interstisial Menampilkan iklan satu halaman penuh di aplikasi Anda. Tempatkan iklan ini pada jeda dan transisi alami di antarmuka aplikasi Anda, seperti setelah penyelesaian level di aplikasi game. Iklan interstisial
Native Memungkinkan Anda menyesuaikan aset, seperti judul dan pesan ajakan, di aplikasi Anda. Saat menyesuaikan iklan, Anda membuat iklan yang sesuai dengan desain visual aplikasi Anda. Memuat iklan native
Reward Pengguna mendapatkan reward dalam aplikasi, seperti koin atau poin, dengan bermain game, mengikuti survei, atau menonton video. Anda dapat menetapkan reward untuk unit iklan, dan menentukan nilai reward serta item yang diterima pengguna. Iklan reward
Interstisial reward Memungkinkan Anda menawarkan reward, seperti koin atau nyawa tambahan, untuk iklan yang muncul selama transisi aplikasi. Iklan interstisial reward
Layar pembuka aplikasi Muncul saat pengguna membuka atau kembali ke aplikasi Anda. Iklan ini menutupi layar pemuatan. Iklan di layar pembuka aplikasi