Thêm Audience Network SDK vào ứng dụng iOS

Có hiệu lực ngay đối với các thay đổi trên iOS 14.5

Tất cả nhà phát hành đều phải sử dụng Audience Network SDK 6.2.1 trở lên để kiếm tiền từ người dùng iOS 14.5. (Bạn cũng nên sử dụng Audience Network SDK 6.2.1 đối với người dùng iOS 14.) Phiên bản này có 2 yêu cầu:

Triển khai cờ setAdvertiserTrackingEnabled (bất kể có sử dụng nền tảng trung gian hay không) nhằm cho biết liệu có sử dụng dữ liệu này để phân phối quảng cáo được cá nhân hóa không.
Thêm ID SKAdNetwork gợi ý vào file Info.plist của dự án Xcode để nhà quảng cáo đo lường mức độ thành công của chiến dịch quảng cáo.

Hãy đọc thêm trong bài viết của chúng tôi trên Meta for Developers

Nâng cấp lên phiên bản SDK mới nhất trước khi tích hợp ứng dụng của bạn để kiếm tiền.

Hướng dẫn này giải thích cách thêm Audience Network SDK vào ứng dụng iOS của bạn để bạn có thể gọi API Audience Network. Phương thức ưu tiên là sử dụng CocoaPods để quản lý các phần phụ thuộc. Tuy nhiên, vị trí tải xuống khi tích hợp thủ công cũng được cung cấp.

CocoaPods (Phương thức tải xuống ưu tiên)

Thêm dòng sau vào file Podfile của dự án.

pod 'FBAudienceNetwork'

Chạy lệnh sau.

pod install

Tải xuống thủ công

Nếu không có tùy chọn sử dụng CocoaPods, bạn có thể tải Audience Network SDK xuống từ một trong các vị trí ở bảng sau.

Package	Date	Change Log
iOS Audience Network SDK 6.15.0	March 15, 2024	6.15.0 Change Log
iOS Audience Network SDK 6.14.0	August 3, 2023	6.14.0 Change Log

Sau khi bạn tải Audience Network SDK xuống, hãy hoàn tất quá trình tích hợp như sau:

Mở dự án của bạn trong XCode.
Kéo và thả FBAudienceNetwork.xcframework từ thư mục Động trong kho lưu trữ Audience Network SDK dành cho iOS đã tải xuống vào XCode.
Trong tab General (Chung) của phần cài đặt mục tiêu ứng dụng, chọn Embed & Sign (Nhúng và ký) cho FBAudienceNetwork.xcframework

Lưu ý

Bạn cũng có thể sử dụng phiên bản tĩnh của Audience Network SDK được cung cấp trong bản tải xuống. Để thực hiện việc này, hãy kéo và thả FBAudienceNetwork.xcframework từ thư mục Tĩnh
Nếu bạn muốn sử dụng phiên bản Tĩnh, hãy đảm bảo dự án của bạn đang dùng Swift. Nếu dự án đó không dùng Swift, hãy thêm một file swift trống (File -> New -> Swift (File -> Mới -> Swift) trong XCode) vào dự án của bạn
Nếu dự án của bạn nhắm mục tiêu đến phiên bản iOS cũ hơn 12.4, hãy nhớ đặt cài đặt Always embed Swift standard libraries (Luôn nhúng thư viện tiêu chuẩn Swift) thành YES (CÓ) trong phần Build settings (Cài đặt bản dựng) của mục tiêu ứng dụng trong XCode.
Để tránh thêm bất kỳ chỉnh sửa bổ sung nào sau khi cài đặt thủ công, hãy sử dụng CocoaPods.

Khắc phục sự cố cho SDK phiên bản 6.9.0 trở lên

Kể từ phiên bản 6.9.0, Audience Network SDK dành cho iOS đã bật Swift. Hãy tham khảo các điểm dưới đây để biết những vấn đề thường gặp nhất khi cài đặt SDK và khả năng tương tác của Swift:

XCode xuất hiện lỗi: "Biểu tượng không xác định: __swift_FORCE_LOAD_$_swiftDataDetection" và "Biểu tượng không xác định: __swift_FORCE_LOAD_$_swiftFileProvider. Những lỗi này xuất hiện do bạn không sử dụng phiên bản XCode mới nhất. Hãy cập nhật lên XCode 13 hoặc phiên bản mới hơn để khắc phục lỗi này.
XCode xuất hiện nhiều lỗi Undefined symbol__swift_FORCE_LOAD_$_. Những lỗi này xuất hiện do bạn chưa bật hỗ trợ Swift cho dự án của mình. Cách đơn giản nhất để khắc phục lỗi này là thêm một file Swift trống ("File" -> "New" -> "Swift file" (File > Mới > File Swift) trong XCode).
Khi chạy trên thiết bị, ứng dụng gặp sự cố ngay sau khi khởi động với lỗi: "dyld: Không tải được thư viện: @rpath/FBAudienceNetwork.framework". Lỗi này xuất hiện do bạn chưa nhúng Audience Network SDK vào ứng dụng của mình. Vui lòng chuyển đến phần cài đặt mục tiêu rồi chọn "Embed & Sign" (Nhúng và ký) cho "FBAudienceNetwork.xcframework" trên tab "General" (Chung).
Ứng dụng gặp sự cố ngay sau khi khởi động do lỗi: "dyld: Không tải được thư viện: @rpath/libswiftCore.dylib". Lỗi này xuất hiện do bạn đang chạy ứng dụng trên phiên bản iOS cũ hơn 12.4 và chưa đặt "YES" (CÓ) cho cài đặt "Always embed Swift standard libraries" (Luôn nhúng thư viện tiêu chuẩn Swift). Hãy nhớ đặt cài đặt "Always embed Swift standard libraries" (Luôn nhúng thư viện tiêu chuẩn Swift) thành "YES" (CÓ) trong phần "Build settings" (Cài đặt bản dựng) của mục tiêu ứng dụng trong XCode.