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

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

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

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

הערה: השם של 'מפתח אפליקציה זהה' השתנה למזהה מאינטראקציה ישירה של בעל האפליקציה. אותו API של מפתח אפליקציה זהה עשוי להשתנות כדי לשקף מזהה מאינטראקציה ישירה של בעל האפליקציה בגרסת ה-SDK הבאה. השינוי הזה לא ישפיע על ההפעלה הקיימת של מפתח אפליקציה זהה ב-IMA SDKs בגרסה 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 הודעות הגילוי הנאות האלה יידרשו באפליקציות חדשות ובעדכוני אפליקציות.

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