在您的 iOS 應用程式中加入 Audience Network SDK
立即就 iOS 14.5 變更採取行動
所有發佈商必須使用 Audience Network SDK 6.2.1 或更新版本，方能透過 iOS 14.5 用戶營利。（我們也推薦您就 iOS 14 用戶使用 Audience Network SDK 6.2.1。）此版本有兩項要求：
- 無論有否使用中介服務，均須執行「setAdvertiserTrackingEnabled」標示，以通知我們是否要使用相關資料來刊登個人化廣告。
- 將建議的 SKAdNetwork 編號加入 Xcode 專案的 Info.plist 中，以方便廣告客戶衡量廣告宣傳活動的成效。
詳情請參閱我們的 Meta for Developers 帖子
在為應用程式註冊營利功能之前，請先將 SDK 升級到最新版本。
本指南講解如何將 Audience Network SDK 加入您的 iOS 應用程式，以便您呼叫 Audience Network API。執行這一操作的首選方法是使用 CocoaPods 來管理相依項目，但我們也為手動整合方式提供了下載位置。
CocoaPods（首選下載方式）
將以下程式碼行加入您專案的 Podfile。
pod 'FBAudienceNetwork'
運行以下指令。
pod install
手動下載
如果無法使用 CocoaPods，您可以從下表中的任何一個位置下載 Audience Network SDK。
| Package | Date | Change Log |
|---|---|---|
Oct 15, 2024 | ||
Aug 15, 2024 |
下載 Audience Network SDK 後，請按照以下步驟完成整合程序：
- 在 XCode 中開啟您的專案。
-
將 FBAudienceNetwork.xcframework 拖放到 XCode，您可在下載的 iOS Audience Network SDK 封存中的 Dynamic 資料夾中找到此檔案。
-
在應用程式目標設定中的 General 分頁下，為 FBAudienceNetwork.xcframework 選擇 Embed & Sign。
備註
- 您也可使用下載檔案中提供的 Audience Network SDK 靜態變數。如要使用，請拖放 Static 資料夾中的 FBAudienceNetwork.xcframework。
- 如要使用靜態變數，請確保您的專案是使用 Swift 程式語言。如果專案不是使用 Swift，請將一個空白的 Swift 檔案加入專案，方法為在 XCode 中依次選擇 File -> New -> Swift。
- 如果您的專案是為 12.4 版之前的 iOS 版本而設，請確保在 XCode 中執行以下操作：在應用程式目標的 Build settings 下，將 Always embed Swift standard libraries 設定設為 YES。
- 如要避免在手動安裝後還需再作任何額外微調，請使用 CocoaPods。
為 SDK 6.9.0 版及更高版本解決疑難
iOS Audience Network SDK 由 6.9.0 版起支援 Swift。如要解決最常見的 SDK 安裝和 Swift 互通性問題，請參考以下幾點：
- XCode 發出以下錯誤：「Undefined symbol:
__swift_FORCE_LOAD_$_swiftDataDetection」與「Undefined symbol:__swift_FORCE_LOAD_$_swiftFileProvider」。這些錯誤代表您使用的不是最新版 XCode。如要修復這些錯誤，請更新至 XCode 13 或更新版本。 - XCode 發出多個
Undefined symbol__swift_FORCE_LOAD_$_錯誤。這些錯誤代表您未為專案啟用 Swift 支援。如要修復此錯誤，最簡單的方法是加入一個空白的 Swift 檔案，步驟為在 XCode 中依次選擇「File」->「New」->「Swift file」。 - 在裝置上運行時，應用程式在啟動後立即當機並發出以下錯誤：「dyld: Library not loaded: @rpath/FBAudienceNetwork.framework」。此錯誤代表您並未在應用程式內嵌 Audience Network SDK。請前往目標設定，並在「General」分頁中為「FBAudienceNetwork.xcframework」選擇「Embed & Sign」。
- 應用程式在啟動後立即當機並發出以下錯誤：「dyld: Library not loaded: @rpath/libswiftCore.dylib」。此錯誤代表您在 12.4 版之前的 iOS 版本上運行應用程式，而且未將「Always embed Swift standard libraries」設定設為「YES」。請確保在 XCode 中執行以下操作：在應用程式目標的「Build settings」下，將「Always embed Swift standard libraries」設定設為「YES」。