إعداد إصدارات tvOS

يوضّح هذا الدليل التغييرات اللازمة لإعداد تطبيقك لنظام التشغيل tvOS 14.

المتطلبات الأساسية

  • الإصدار 4.3.2 أو إصدار أحدث من حزمة تطوير البرامج لإعلانات الوسائط التفاعلية

طلب الحصول على إذن استخدام ميزة "شفافية تتبُّع التطبيقات"

لعرض طلب الإذن من إطار عمل "شفافية تتبُّع التطبيقات" للوصول إلى معرّف المعلِنين (IDFA)، عدِّل ملف Info.plist لإضافة المفتاح NSUserTrackingUsageDescription مع رسالة مخصّصة تصف استخدامك له. في ما يلي مثال على نص الوصف:

<key>NSUserTrackingUsageDescription</key>
<string>This identifier will be used to deliver personalized ads to you.</string>

يظهر وصف الاستخدام في مربّع حوار "شفافية تتبُّع التطبيقات" على النحو التالي:

لعرض طلب التفويض، استدعِ الدالة requestTrackingAuthorizationWithCompletionHandler:. ننصحك بالانتظار إلى أن يتم استدعاء دالة معاودة الاتصال عند اكتمال العملية قبل تحميل الإعلانات، وذلك حتى يتمكّن المستخدم من منح إذن &quot;شفافية تتبُّع التطبيقات&quot;، وبالتالي تتمكّن حزمة تطوير البرامج (SDK) الخاصة بـ &quot;إعلانات الوسائط التفاعلية&quot; من استخدام معرّف المعلِنين (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.

معرّف الطرف الأول للناشر، والمعروف سابقًا باسم مفتاح التطبيق نفسه

المتطلبات الأساسية: الإصدار 3.14.5 أو إصدار أحدث من حزمة تطوير البرامج لإعلانات الوسائط التفاعلية (IMA) لأجهزة iOS

قدّمت حزمة تطوير البرامج لإعلانات الوسائط التفاعلية على 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.

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