Để thảo luận và đưa ra ý kiến phản hồi về các sản phẩm của chúng tôi, hãy tham gia kênh Discord chính thức của Ad Manager trong máy chủ Cộng đồng quảng cáo và đo lường của Google.
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Hướng dẫn này đề cập đến những thay đổi mà bạn cần thực hiện để chuẩn bị ứng dụng của bạn cho tvOS 14.
Điều kiện tiên quyết
SDK Quảng cáo tương tác trên phương tiện truyền thông phiên bản 4.3.2 trở lên.
Xin cấp quyền theo chính sách Minh bạch về việc theo dõi ứng dụng
Để hiển thị yêu cầu uỷ quyền theo chính sách Minh bạch về việc theo dõi ứng dụng nhằm truy cập IDFA, hãy cập nhật Info.plist để thêm khoá NSUserTrackingUsageDescription bằng một thông báo tuỳ chỉnh mô tả việc sử dụng của bạn. Dưới đây là nội dung mô tả mẫu:
<key>NSUserTrackingUsageDescription</key>
<string>This identifier will be used to deliver personalized ads to you.</string>
Nội dung mô tả về việc sử dụng xuất hiện trong hộp thoại App Tracking Transparency:
Để trình bày yêu cầu cấp quyền, hãy gọi requestTrackingAuthorizationWithCompletionHandler:.
Bạn nên đợi lệnh gọi lại hoàn tất trước khi tải quảng cáo để nếu người dùng cấp quyền theo thông báo Minh bạch về việc theo dõi ứng dụng, thì SDK Quảng cáo đa phương tiện tương tác có thể sử dụng IDFA trong các yêu cầu quảng cáo.
Mã nhận dạng bên thứ nhất của nhà xuất bản (trước đây gọi là khoá cho cùng ứng dụng)
Điều kiện tiên quyết: IMA SDK cho iOS 3.14.5 trở lên
Interactive Media Ads SDK cho iOS ra mắt Mã nhận dạng bên thứ nhất của nhà xuất bản (trước đây được gọi là khoá cho cùng ứng dụng) để giúp bạn phân phối các quảng cáo được cá nhân hoá và phù hợp hơn bằng cách sử dụng dữ liệu thu thập được từ các ứng dụng của bạn.
Mã nhận dạng bên thứ nhất của nhà xuất bản được bật theo mặc định, nhưng bạn luôn có thể chọn tắt mã nhận dạng này trong ứng dụng của mình bằng cách đặt IMASettings::SameAppKeyEnabled thành false:
Apple yêu cầu các nhà phát triển xuất bản ứng dụng trên App Store tiết lộ một số thông tin nhất định về việc sử dụng dữ liệu trong ứng dụng của họ. Kể từ ngày 8 tháng 12 năm 2020, Apple đã thông báo rằng các nhà phát triển bắt buộc phải tiết lộ những thông tin này cho các ứng dụng mới và bản cập nhật ứng dụng.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-09-05 UTC."],[[["\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)."]]