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

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

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

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

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

لعرض طلب الإذن من إطار عمل "شفافية تتبُّع التطبيقات" للوصول إلى معرّف المعلِنين (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.

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

المتطلبات الأساسية: الإصدار 3.14.5 أو إصدار أحدث من حزمة تطوير البرامج لإعلانات الوسائط التفاعلية (IMA SDK) لنظام التشغيل 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.

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