Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Menyiapkan Google Mobile Ads SDK

Pilih platform: Android iOS Unity Flutter Android (Lama)

Untuk menayangkan iklan dan memperoleh pendapatan, integrasikan Google Mobile Ads SDK ke aplikasi iOS Anda. Untuk menyiapkan project, impor dan lakukan inisialisasi Google Mobile Ads SDK sebelum meminta iklan.

Panduan ini membahas cara mengimpor dan melakukan inisialisasi 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 (Direkomendasikan)

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

Buka Xcode.
Buka File > Add Package Dependencies....
Instal Paket Swift Google Mobile Ads SDK.
Pada perintah yang muncul, telusuri repositori GitHub Paket Swift Google Mobile Ads:
```
https://github.com/googleads/swift-package-manager-google-mobile-ads.git
```
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:

Buka Podfile project Anda dan tambahkan baris ini ke konfigurasi build target aplikasi Anda:
```
pod 'Google-Mobile-Ads-SDK'
```
Di terminal, jalankan perintah berikut:
```
pod install --repo-update
```

Mengonfigurasi target deployment untuk Xcode 27

Xcode 27 memerlukan target deployment minimum iOS 15.0 untuk semua target. Karena Google Mobile Ads SDK mendukung iOS 13.0, build Xcode 27 akan gagal saat menggunakan CocoaPods.

Untuk menyelesaikan masalah ini, ikuti langkah berikut:

Buka Podfile project Anda dan tambahkan hook post_install yang menetapkan target deployment ke 15.0. Jika Anda memiliki blok post_install, tambahkan loop dalam ke blok yang ada.

Contoh berikut menetapkan kunci IPHONEOS_DEPLOYMENT_TARGET ke 15.0 untuk semua target pod:
```
post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '15.0'
    end
  end
end
```
Untuk menginstal ulang pod, jalankan perintah berikut:
```
pod install --repo-update
```

Download manual

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

Download Google Mobile Ads SDK.
Ekstrak paket googlemobileadssdkios.zip.
Di project Xcode Anda, tambahkan framework berikut:
- GoogleMobileAds.xcframework
- UserMessagingPlatform.xcframework
Di setelan General target Anda, buka Frameworks, Libraries, and Embedded Content.
Pastikan Anda telah menetapkan GoogleMobileAds.xcframework dan UserMessagingPlatform.xcframework ke Embed & Sign.
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.

Mengupdate file Info.plist

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-################~##########.
Kunci 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 di contoh sebelumnya.

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

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 adaptor mediasi selesai memproses, atau setelah 30 detik.

Contoh berikut melakukan inisialisasi Google Mobile Ads SDK:

Swift

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

SwiftUI

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

Objective-C

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

Saat melakukan inisialisasi, Google Mobile Ads SDK mungkin akan memuat iklan terlebih dahulu 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 tanda 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.

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 dimuat ulang secara otomatis pada interval yang ditetapkan. Pengguna akan 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, misalnya setelah menyelesaikan level dalam aplikasi game.	Iklan interstisial
Native	Memungkinkan Anda menyesuaikan aset, seperti judul dan pesan ajakan (CTA), di aplikasi Anda. 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 item dan nilai 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. Overlay iklan akan ditempatkan di layar pemuatan.	Iklan di layar pembuka aplikasi

Menyiapkan Google Mobile Ads SDK Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.