הכנה ל-tvOS 14 ואילך

במדריך הזה מפורטים השינויים הנדרשים כדי להכין את האפליקציה ל-tvOS 14.

דרישות מוקדמות

• Interactive Media Ads SDK מגרסה 4.3.2 ואילך.

שליחת בקשה להרשאה של App Tracking Transparency

כדי להציג את בקשת ההרשאה ל-App Tracking Transparency לצורך גישה ל-IDFA, צריך לעדכן את Info.plist ולהוסיף את המפתח NSUserTrackingUsageDescription עם הודעה מותאמת אישית שמתארת את השימוש שלכם. דוגמה לטקסט של תיאור:

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

תיאור השימוש מופיע בתיבת הדו-שיח של App Tracking Transparency:

כדי להציג את בקשת ההרשאה, קוראים את הפונקציה requestTrackingAuthorizationWithCompletionHandler:. מומלץ להמתין לקריאה החוזרת על השלמת ההשלמה לפני טעינת המודעות, כך שאם המשתמש ייתן לו את ההרשאה App Tracking Transparency, ה-SDK של Interactive Media Ads 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.

נקודת מפתח: כדי לשפר את חוויית המשתמש, מומלץ להוסיף הסבר לפני הקריאה ל-requestTrackingAuthorizationWithCompletionHandler: כדי להבהיר למשתמשים את ההרשאה ואת השימוש בנתונים.

מזהה מאינטראקציה ישירה של בעל האפליקציה, שנקרא בעבר מפתח אפליקציה זהה (SameAppKey)

הערה: השם של 'מפתח אפליקציה זהה' השתנה למזהה מאינטראקציה ישירה של בעל האפליקציה. יכול להיות ש-SameAppKey API ישתנה כדי לשקף את המזהה מאינטראקציה ישירה של בעל האפליקציה בגרסה עתידית של SDK. השינוי הזה לא ישפיע על ההפעלה הקיימת של מפתח אפליקציה זהה בערכות IMA SDK מגרסה 3.14.5 ואילך. כל גרסאות ה-SDK הרלוונטיות יעבדו את המזהה בצורה חלקה.

דרישות מוקדמות: IMA SDK ל-iOS מגרסה 3.14.5 ואילך

ב-Interactive Media Ads SDK ל-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.

מידע נוסף על הדרישות לגבי גילוי נאות בנתונים