新增 Audience Network SDK 至 iOS 應用程式
立即針對 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，再設置應用程式進行營利。
本指南說明如何在 iOS 應用程式中加入 Audience Network SDK，以便您可呼叫 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 中開啟專案。
-
從已下載 iOS Audience Network SDK 封存檔案中的 Dynamic 資料夾，將 FBAudienceNetwork.xcframework 拖放至 XCode 中。
-
在應用程式目標設定的「General」（一般）頁籤中，為 FBAudienceNetwork.xcframework 選擇「Embed & Sign」（內嵌並簽署）
備註
- 您也可以使用下載項目中提供的 Audience Network SDK 靜態變數資料型態。若要這麼做，請從 Static 資料夾拖放 FBAudienceNetwork.xcframework
- 如果您想要使用靜態變數資料型態，請確認您的專案是使用 Swift。如果您的專案不是使用 Swift，請新增空白的 Swift 檔案至專案（XCode 中的 File -> New -> Swift（檔案 -> 新增 -> Swift））
- 如果專案的目標設定是 iOS 12.4 以下版本，請務必在 XCode 中，於應用程式目標的「Build Settings」（建置版本設定）下，將「Always embed Swift standard libraries」（一律內嵌 Swift 標準程式庫）設定設為「YES」（是）。
- 為避免在手動安裝後加入任何多餘的改動，請使用 CocoaPods。
SDK 6.9.0 和以上版本的疑難排解
從 6.9.0 版開始，iOS Audience Network SDK 已啟用 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」（Swift 檔案））。 - 在裝置上執行時，應用程式一啟動就當機，並出現錯誤：「dyld: Library not loaded: @rpath/FBAudienceNetwork.framework」。此錯誤表示您未在應用程式中內嵌 Audience Network SDK。請前往目標設定，並在「General」（一般）頁籤上，為「FBAudienceNetwork.xcframework」選擇「Embed & Sign」（內嵌並簽署）。
- 應用程式一啟動就當機，並出現錯誤：「dyld: Library not loaded: @rpath/libswiftCore.dylib」。此錯誤表示您用來執行應用程式的 iOS 版本低於 12.4，而且未將「Always embed Swift standard libraries」（一律內嵌 Swift 標準程式庫）設定設為「YES」（是）。請務必在 XCode 中，於應用程式目標的「Build Settings」（建置版本設定）下，將「Always embed Swift standard libraries」（一律內嵌 Swift 標準程式庫）設定設為「YES」（是）。