إضافة مجموعة Audience Network SDK إلى تطبيقك على نظام iOS

الاستجابة وفقًا لتغييرات نظام iOS 14.5

يجب على كل الناشرين استخدام الإصدار 6.2.1 أو الإصدارات الأحدث من مجموعة Audience Network SDK لتحقيق أرباح من خلال مستخدمي نظام iOS 14.5. (كما نوصي بالإصدار 6.2.1 من مجموعة Audience Network SDK لمستخدمي نظام iOS 14.) يوجد متطلبان ضمن هذا الإصدار:

تنفيذ العلامة setAdvertiserTrackingEnabled، بغض النظر عن استخدام خدمة وسيطة، لإخبارنا بما إذا كان سيتم استخدام البيانات لعرض إعلانات ذات طابع شخصي.
إضافة معرفات SKAdNetwork المقترحة إلى ملف Info.plist في مشروع Xcode؛ حتى يتمكن المعلنون من قياس مدى نجاح الحملات الإعلانية.

يمكنك قراءة المزيد في منشور Meta للمطوّرين

قم بالترقية إلى أحدث إصدار من مجموعة SDK قبل تأهيل تطبيقك لتحقيق الأرباح.

يوضح هذا الدليل كيفية تضمين مجموعة Audience Network SDK في تطبيق iOS لديك بحيث يمكنك استدعاء واجهات Audience Network API. يتمثل الأسلوب المفضل في استخدام CocoaPods لإدارة التبعيات؛ ومع ذلك، يتم توفير مواقع التنزيل للدمج اليدوي أيضًا.

CocoaPods (أسلوب التنزيل المفضل)

أضف السطر التالي في ملف Podfile ضمن المشروع.

pod 'FBAudienceNetwork'

قم بتشغيل الأمر التالي.

pod install

التنزيل اليدوي

إذا لم يكن استخدام CocoaPods خيارًا متوفرًا، فيمكنك تنزيل مجموعة Audience Network SDK من أحد المواقع المتوفرة في الجدول التالي.

Package	Date	Change Log
iOS Audience Network SDK 6.16.0	Oct 15, 2024	6.16.0 Change Log
iOS Audience Network SDK 6.15.2	Aug 15, 2024	6.15.2 Change Log

بعد تنزيل مجموعة Audience Network SDK، يمكنك إكمال عملية الدمج كما يلي:

افتح المشروع في XCode.
اسحب FBAudienceNetwork.xcframework من المجلد Dynamic وأفلته في أرشيف مجموعة Audience Network SDK لنظام iOS الذي تم تنزيله في XCode.
في علامة التبويب عام ضمن إعدادات الاستهداف في التطبيق، حدد التضمين والتوقيع في FBAudienceNetwork.xcframework

ملاحظات

يمكنك أيضًا استخدام شكل متنوع ثابت لمجموعة Audience Network SDK متوفر في التنزيل. للقيام بذلك، اسحب FBAudienceNetwork.xcframework من المجلد Static وأفلته
إذا أردت استخدام الشكل المتنوع من مجلد Static، فتأكد من أن مشروعك يستخدم Swift. إذا كان مشروعك لا يستخدم Swift، فأضف ملف swift فارغ (ملف -> جديد -> Swift في XCode) إلى مشروعك
إذا كان مشروعك يستهدف إصدار iOS أقدم من 12.4، فتأكد من تعيين الإعداد تضمين مكتبات Swift القياسية دائمًا على نعم، ضمن إعدادات الإصدار لهدف تطبيقك في XCode.
لتجنب إضافة أي تعديلات إضافية بعد التثبيت اليدوي، استخدم CocoaPods.

استكشاف الأخطاء وإصلاحها للإصدار 6.9.0 والإصدارات الأحدث من مجموعة SDK

بدايةً من الإصدار 6.9.0، سيتم تمكين Swift في مجموعة Audience Network SDK لنظام iOS. ارجع إلى النقاط أدناه لحل المشكلات الأكثر شيوعًا المرتبطة بتثبيت مجموعة 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 فارغ ("ملف" -> "جديد" -> "ملف Swift" في XCode).
عند التشغيل على الجهاز، يتعطل التطبيق مباشرةً بعد البدء ويعرض الخطأ: 'dyld: Library not loaded: @rpath/FBAudienceNetwork.framework'. هذا الخطأ يعني أنه لم يتم تضمين مجموعة Audience Network SDK في تطبيقك. يُرجى الانتقال إلى إعدادات الاستهداف واختيار "التضمين والتوقيع" لـ "FBAudienceNetwork.xcframework" في علامة التبويب "عام".
يتعطل التطبيق مباشرةً بعد البدء ويعرض الخطأ: 'dyld: Library not loaded: @rpath/libswiftCore.dylib'. هذا الخطأ يعني أنه تم تشغيل تطبيق على إصدار iOS أقدم من 12.4 ولم يتم تعيين الإعداد "تضمين مكتبات Swift القياسية دائمًا" على "نعم". يُرجى التأكد من تعيين الإعداد "تضمين مكتبات Swift القياسية دائمًا" على "نعم" ضمن "إعدادات الإصدار" لهدف التطبيق في XCode.