Meta Audience Network

Menambahkan Audience Network SDK ke Aplikasi iOS Anda

Bertindaklah sekarang untuk perubahan iOS 14.5

Semua penerbit harus menggunakan Audience Network SDK 6.2.1 atau yang lebih baru untuk monetisasi dengan pengguna iOS 14.5. (Kami juga merekomendasikan Audience Network SDK 6.2.1 untuk pengguna iOS 14.) Dalam versi ini ada dua persyaratan:

  • Terapkan bendera setAdvertiserTrackingEnabled, terlepas dari penggunaan mediasi, untuk menginformasikan apakah perlu menggunakan data untuk menayangkan iklan yang dipersonalisasi.
  • Tambahkan ID SKAdNetwork yang disarankan ke Info.plist proyek Xcode agar pengiklan dapat mengukur keberhasilan kampanye iklan.

Baca selengkapnya di postingan Meta untuk Developer kami

Tingkatkan ke versi terbaru SDK sebelum mengaktifkan aplikasi Anda untuk monetisasi.

Panduan ini menjelaskan cara menyertakan Audience Network SDK dalam aplikasi Anda sehingga Anda dapat memanggil Audience Network API. Dianjurkan menggunakan CocoaPods untuk mengelola dependensi; tetapi juga tersedia lokasi unduhan untuk integrasi manual.

CocoaPods (Metode Unduh yang Lebih Disukai)

Tambahkan baris berikut ke Podfile proyek Anda.

pod 'FBAudienceNetwork'

Jalankan perintah berikut.

pod install

Unduh Manual

Jika menggunakan CocoaPods bukan merupakan pilihan, Anda dapat mengunduh Audience Network SDK dari salah satu lokasi di tabel berikut.

Setelah Anda mengunduh Audience Network SDK, selesaikan integrasi sebagai berikut:

  1. Buka proyek Anda di XCode.
  2. Seret dan letakkan FBAudienceNetwork.xcframework dari folder Dynamic di unduhan arsip iOS Audience Network SDK ke XCode.
  3. Di tab Umum di pengaturan target aplikasi, pilih Sematkan & Tanda Tangan untuk FBAudienceNetwork.xcframework

Catatan

  • Anda juga dapat menggunakan varian statis Audience Network SDK yang disediakan dalam unduhan. Untuk melakukannya, seret dan letakkan FBAudienceNetwork.xcframework dari folder Statis
  • Jika ingin menggunakan varian Statis, pastikan proyek Anda menggunakan Swift. Jika proyek Anda tidak menggunakan Swift, tambahkan file swift kosong (File -> New -> Swift di XCode) ke proyek Anda
  • Jika proyek Anda menargetkan versi iOS lebih awal dari 12.4, pastikan agar pengaturan Always embed Swift standard libraries [Selalu sematkan perpustakaan standar Swift] diatur ke YA, di bawah Build settings [Pengaturan build] dari target aplikasi Anda di XCode.
  • Agar tidak perlu tweak tambahan setelah instalasi manual, gunakan CocoaPods.

Pemecahan masalah untuk SDK versi 6.9.0 ke atas

Mulai versi 6.9.0, iOS Audience Network SDK telah mengaktifkan Swift. Lihat poin di bawah ini untuk mengatasi masalah paling umum dari instalasi SDK & interoperabilitas Swift:

  • XCode mengeluarkan kesalahan: __swift_FORCE_LOAD_$_swiftDataDetection' dan 'Simbol tidak terdefinisi: __swift_FORCE_LOAD_$_swiftFileProvider. Kesalahan ini berarti Anda tidak menggunakan XCode versi terbaru. Perbarui ke XCode 13 atau lebih baru untuk memperbaiki kesalahan ini.
  • XCode mengeluarkan banyak kesalahan Undefined symbol__swift_FORCE_LOAD_$_. Kesalahan ini berarti Anda tidak mengaktifkan dukungan Swift untuk proyek Anda. Cara paling sederhana untuk mengatasi hal ini adalah dengan menambahkan file Swift kosong ('File' -> 'New' -> 'Swift file' di XCode).
  • Saat berjalan di perangkat, aplikasi macet begitu dimulai dengan kesalahan: 'dyld: Library not loaded: @rpath/FBAudienceNetwork.framework'. Kesalahan ini berarti Anda tidak menyematkan Audience Network SDK di aplikasi Anda. Silakan buka pengaturan target Anda dan pilih 'Sematkan & Tanda Tangan' untuk 'FBAudienceNetwork.xcframework' pada tab 'Umum'.
  • Aplikasi mengalami crash tepat setelah dimulai dengan kesalahan: 'dyld: Library not loaded: @rpath/libswiftCore.dylib'. Kesalahan ini berarti Anda menjalankan aplikasi di iOS dengan versi lebih lama dari 12.4 dan tidak diatur ke 'YA' untuk pengaturan "Always embed Swift standard libraries [Selalu sematkan perpustakaan standar Swift]". Pastikan agar pengaturan "Always embed Swift standard libraries [Selalu sematkan perpustakaan standar Swift]" selalu diatur ke YA di bawah "Build settings [Pengaturan build]" target aplikasi Anda di XCode.