با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
این راهنما تغییرات مورد نیاز برای آماده سازی برنامه شما برای tvOS 14 را تشریح می کند.
پیش نیازها
SDK تبلیغات رسانه تعاملی 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 در درخواستهای تبلیغاتی استفاده کند.
شناسه شخص اول ناشر، که قبلاً به عنوان کلید برنامه مشابه شناخته می شد
پیش نیازها: IMA SDK برای iOS 3.14.5 یا بالاتر
SDK تبلیغات رسانه تعاملی برای iOS شناسه شخص اول ناشر را معرفی کرد، که قبلاً به عنوان کلید برنامه شناخته میشد تا به شما کمک کند با استفاده از دادههای جمعآوریشده از برنامههایتان، تبلیغات مرتبطتر و شخصیشدهتری ارائه دهید.
شناسه شخص اول ناشر به طور پیش فرض فعال است، اما همیشه می توانید با تنظیم IMASettings::SameAppKeyEnabled روی false ، آن را در برنامه خود غیرفعال کنید:
اپل از توسعه دهندگانی که برنامه ها را در اپ استور منتشر می کنند می خواهد اطلاعات خاصی را در مورد استفاده از داده های برنامه های خود فاش کنند. اپل اعلام کرده است که از 8 دسامبر 2020 برای برنامهها و بهروزرسانیهای برنامههای جدید این افشاگریها ضروری است.
تاریخ آخرین بهروزرسانی 2025-09-04 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-09-04 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003ePrepare your tvOS app for upcoming changes by updating to Interactive Media Ads SDK 4.3.2 or higher and requesting App Tracking Transparency authorization for IDFA access.\u003c/p\u003e\n"],["\u003cp\u003eImplement the App Tracking Transparency authorization request in your app's \u003ccode\u003eInfo.plist\u003c/code\u003e and code, potentially including an explainer for a better user experience.\u003c/p\u003e\n"],["\u003cp\u003eConsider leveraging Publisher first-party ID (formerly known as same app key) to enhance ad relevance and personalization, and it's enabled by default in IMA SDK for iOS 3.14.5 or higher.\u003c/p\u003e\n"],["\u003cp\u003eEnsure your app complies with Apple's data usage disclosure requirements for the App Store by December 8, 2020, for new apps and app updates.\u003c/p\u003e\n"]]],[],null,["This guide outlines the changes needed to prepare your app for\ntvOS 14.\n\nPrerequisites\n\n- Interactive Media Ads SDK 4.3.2 or higher.\n\nRequest App Tracking Transparency authorization\n\nTo display the App Tracking Transparency authorization request for accessing the\nIDFA, update your `Info.plist` to add the `NSUserTrackingUsageDescription` key\nwith a custom message describing your usage. Here is an example description\ntext: \n\n```text\n\u003ckey\u003eNSUserTrackingUsageDescription\u003c/key\u003e\n\u003cstring\u003eThis identifier will be used to deliver personalized ads to you.\u003c/string\u003e\n```\n\nThe usage description appears in the App Tracking Transparency dialog box:\n\nTo present the authorization request, call\n[`requestTrackingAuthorizationWithCompletionHandler:`](//developer.apple.com/documentation/apptrackingtransparency/attrackingmanager/3547037-requesttrackingauthorization).\nWe recommend waiting for the completion callback prior to loading ads so that if\nthe user grants the App Tracking Transparency permission, the Interactive Media\nAds SDK can use the IDFA in ad requests. \n\nSwift \n\n```swift\nimport AppTrackingTransparency\nimport AdSupport\n...\nfunc requestIDFA() {\n ATTrackingManager.requestTrackingAuthorization(completionHandler: { status in\n // Tracking authorization completed. Start loading ads here.\n // loadAd()\n })\n}\n```\n\nObjective-C \n\n```objective-c\n#import \u003cAppTrackingTransparency/AppTrackingTransparency.h\u003e\n#import \u003cAdSupport/AdSupport.h\u003e\n...\n- (void)requestIDFA {\n [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {\n // Tracking authorization completed. Start loading ads here.\n // [self loadAd];\n }];\n}\n```\n\nFor more information about the possible status values, see\n[`ATTrackingManager.AuthorizationStatus`](//developer.apple.com/documentation/apptrackingtransparency/attrackingmanager/authorizationstatus).\n| **Key Point:** For a better user experience, we recommend adding an explainer preceding the call to `requestTrackingAuthorizationWithCompletionHandler:` to clarify the permission and data usage to users.\n\nPublisher first-party ID, formerly known as same app key **Note:** Same app key has been renamed to [Publisher first-party\n| ID](//support.google.com/admob/answer/9997589). The same app key API may change to reflect publisher first-party ID in an upcoming SDK release. This change will not impact existing activation of same app key on IMA SDKs 3.14.5+. All applicable SDK versions will process the identifier seamlessly.\n\n**Prerequisites: IMA SDK for iOS 3.14.5 or higher**\n\nThe Interactive Media Ads SDK for iOS introduced Publisher first-party\nID, formerly known as [same app\nkey](//support.google.com/admanager/answer/9997589) to help you deliver more\nrelevant and personalized ads by using data collected from your apps.\n\nPublisher first-party ID is enabled by default, but you can always choose to\ndisable it in your app by setting\n[`IMASettings::SameAppKeyEnabled`](/interactive-media-ads/docs/sdks/ios/client-side/reference/Classes/IMASettings#sameappkeyenabled) to `false`: \n\nSwift \n\n```swift\nlet settings = IMASettings()\n// Disables Publisher first-party ID, formerly known as same app key.\nsettings.SameAppKeyEnabled = false\nadsLoader = IMAAdsLoader(settings: settings)\n```\n\nObjective-C \n\n```objective-c\nIMASettings *settings = [[IMASettings alloc] init];\n// Disables Publisher first-party ID, formerly known as same app key.\nsettings.SameAppKeyEnabled = false;\nIMAAdsLoader *adsLoader = [[IMAAdsLoader alloc] initWithSettings:settings];\n```\n\nDisclose data usage in the App Store\n\nApple requires that developers publishing apps on the App Store disclose\n[certain information](//developer.apple.com/app-store/app-privacy-details/)\nregarding their apps' data use. Apple has\n[announced](//developer.apple.com/news/?id=vlj9jty9) that these disclosures will\nbe required for new apps and app updates starting December 8, 2020.\n\n[Learn more about the data disclosure\nrequirements](/interactive-media-ads/docs/sdks/tvos/client-side/data-disclosure)."]]