Menyiapkan Google Mobile Ads SDK

Pilih platform: Android iOS Unity Flutter Android (Legacy)

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

Panduan ini mencakup cara mengimpor dan menginisialisasi Google Mobile Ads SDK, serta memilih format iklan.

Prasyarat

Sebelum melanjutkan, pastikan Anda memiliki hal berikut:

  • Gunakan Xcode 16.0 atau yang lebih baru.
  • Targetkan iOS 13.0 atau yang lebih tinggi.

Impor 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 Google Mobile Ads Swift Package:

    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. Konfirmasi bahwa Anda telah menetapkan GoogleMobileAds.xcframework dan UserMessagingPlatform.xcframework ke Sematkan & Tandatangani.

  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 Anda

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

  • Kunci GADApplicationIdentifier dengan nilai string ID aplikasi Ad Manager Anda yang ditemukan di UI Ad Manager dan dalam bentuk ca-app-pub-################~##########.

  • Tombol SKAdNetworkItems. Kunci ini mencakup nilai SKAdNetworkIdentifier untuk cstr6suwn9.skadnetwork Google dan pembeli pihak ketiga tertentu.

Contoh lengkap

<key>GADApplicationIdentifier</key>
<!-- Sample Ad Manager 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 Ad Manager Anda. Saat menguji, gunakan ID aplikasi contoh yang ditampilkan dalam contoh sebelumnya.

Untuk membantu aplikasi Anda diinisialisasi lebih cepat, tautkan grup hasil ke aplikasi tertentu. Jika grup hasil menargetkan iOS, tetapi tidak ditautkan ke aplikasi, Google akan mengirimkan grup tersebut ke semua aplikasi iOS di akun Anda. Pendekatan ini dapat memperlambat performa.

Lakukan 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 menginisialisasi 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 dapat memuat iklan terlebih dahulu atau menginisialisasi 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 menyetel flag khusus permintaan, pastikan Anda menyetel flag sebelum menginisialisasi Google Mobile Ads SDK. Untuk mengetahui detailnya, lihat Penargetan.

Pilih format iklan

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

Ad Manager menawarkan format iklan berikut:

Format Iklan Deskripsi Dokumentasi
Banner Menampilkan iklan persegi panjang di bagian tata letak aplikasi Anda. Iklan ini diperbarui secara otomatis 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 yang alami di antarmuka aplikasi Anda, seperti setelah penyelesaian level dalam aplikasi game. Iklan interstisial
Native Memungkinkan Anda menyesuaikan aset, seperti judul dan pesan ajakan, di aplikasi. Saat menyesuaikan iklan, Anda membuat iklan yang cocok 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, serta menentukan nilai dan item reward 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 akan ditempatkan di layar pemuatan. Iklan di layar pembuka aplikasi