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

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

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