يوضح هذا الدليل التغييرات اللازمة لإعداد تطبيقك لإصدار tvOS 14.
المتطلبات الأساسية
- حزمة تطوير البرامج لإعلانات الوسائط التفاعلية 4.3.2 أو إصدار أحدث
طلب الحصول على إذن App Tracking Transparency
لعرض طلب التفويض بموجب إطار عمل شفافية تتبُّع التطبيقات للوصول إلى
معرّف المعلِنين (IDFA)، عدِّل Info.plist
لإضافة مفتاح NSUserTrackingUsageDescription
مع رسالة مخصّصة تصف استخدامك. إليك مثال على نص الوصف:
<key>NSUserTrackingUsageDescription</key> <string>This identifier will be used to deliver personalized ads to you.</string>
يظهر وصف الاستخدام في مربع حوار "شفافية تتبع التطبيقات":
لتقديم طلب التفويض، يُرجى الاتصال بالرقم requestTrackingAuthorizationWithCompletionHandler:
.
ننصحك بالانتظار إلى أن يتم استدعاء الإجراء المكتمل قبل تحميل الإعلانات، وذلك لكي تتمكّن حزمة SDK لإعلانات الوسائط التفاعلية من استخدام معرّف IDFA في طلبات الإعلانات إذا منح المستخدم إذن شفافية تتبُّع التطبيقات.
Swift
import AppTrackingTransparency import AdSupport ... func requestIDFA() { ATTrackingManager.requestTrackingAuthorization(completionHandler: { status in // Tracking authorization completed. Start loading ads here. // loadAd() }) }
Objective-C
#import <AppTrackingTransparency/AppTrackingTransparency.h> #import <AdSupport/AdSupport.h> ... - (void)requestIDFA { [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) { // Tracking authorization completed. Start loading ads here. // [self loadAd]; }]; }
لمزيد من المعلومات عن قيم الحالة المحتمَلة، اطّلِع على
ATTrackingManager.AuthorizationStatus
.
معرّف الطرف الأول للناشر، والمعروف سابقًا باسم مفتاح التطبيق نفسه
المتطلّبات الأساسية: حزمة تطوير البرامج لإعلانات الوسائط التفاعلية لنظام التشغيل iOS 3.14.5 أو إصدار أحدث
قدّمت حزمة تطوير البرامج لإعلانات الوسائط التفاعلية لنظام التشغيل iOS معرّف الطرف الأول للناشر، والذي كان يُعرف سابقًا باسم مفتاح التطبيق نفسه لمساعدتك في عرض إعلانات أكثر صلةً وتخصيصًا باستخدام البيانات التي يتم جمعها من تطبيقاتك.
يتم تفعيل معرّف الطرف الأول للناشر تلقائيًا، ولكن يمكنك متى شئت اختيار
إيقافه في تطبيقك من خلال ضبط
IMASettings::SameAppKeyEnabled
على false
:
Swift
let settings = IMASettings() // Disables Publisher first-party ID, formerly known as same app key. settings.SameAppKeyEnabled = false adsLoader = IMAAdsLoader(settings: settings)
Objective-C
IMASettings *settings = [[IMASettings alloc] init]; // Disables Publisher first-party ID, formerly known as same app key. settings.SameAppKeyEnabled = false; IMAAdsLoader *adsLoader = [[IMAAdsLoader alloc] initWithSettings:settings];
الإفصاح عن استخدام البيانات في App Store
تتطلب Apple من مطوّري البرامج، الذين ينشرون التطبيقات على App Store، الإفصاح عن معلومات معيّنة تتعلق باستخدام بيانات تطبيقاتهم. وأعلنت Apple أنّه اعتبارًا من 8 كانون الأول (ديسمبر) 2020، سيكون مطلوبًا تضمين بيانات الإفصاح هذه في التطبيقات الجديدة وتحديثاتها.