الاستعداد لنظام التشغيل tvOS 14+

يوضّح هذا الدليل التغييرات اللازمة لإعداد تطبيقك ليعمل على 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، سيكون مطلوبًا تضمين بيانات الإفصاح هذه في التطبيقات الجديدة وتحديثاتها.

مزيد من المعلومات حول متطلّبات الإفصاح عن البيانات