تتيح لك حزمة تطوير البرامج (SDK) الخاصة بمنصّة رسائل المستخدمين (UMP) عرض رسالة معرّف المعلِنين (IDFA) للمستخدمين قبل طلب موافقتهم على إطار عمل شفافية تتبُّع التطبيقات (ATT). توضّح رسالة معرّف المعلِنين (IDFA) للمستخدمين كيفية استخدام تطبيقك لهذا المعرّف.
يغطّي هذا الدليل استخدام حزمة تطوير البرامج (SDK) لمنصّة UMP لعرض رسالة بشأن معرّف المعلِنين.
لإظهار التنبيه مرة ثانية، عليك إلغاء تثبيت تطبيقك وإعادة تثبيته على جهازك التجريبي.
طلب الإعلانات باستخدام معرّف المعلِنين أو بدونه
إذا رفض المستخدم إذن ATT، واصِل طلب الإعلانات باستخدام واجهات برمجة التطبيقات الخاصة بشكل الإعلان. لا ترسِل حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة معرّف المعلِنات (IDFA) في طلب الإعلان. لمزيد من التفاصيل، اطّلِع على اختيار شكل إعلان.
تاريخ التعديل الأخير: 2025-09-02 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-09-02 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis guide provides steps to integrate the IDFA message within the User Messaging Platform (UMP) SDK for iOS apps, specifically focusing on Apple's App Tracking Transparency (ATT) framework.\u003c/p\u003e\n"],["\u003cp\u003eBefore proceeding, ensure you have completed the UMP SDK setup and created an IDFA message in AdMob.\u003c/p\u003e\n"],["\u003cp\u003eUpdate your app's \u003ccode\u003eInfo.plist\u003c/code\u003e file by adding the \u003ccode\u003eNSUserTrackingUsageDescription\u003c/code\u003e key with a clear explanation of how you will use the IDFA, and link the \u003ccode\u003eAppTrackingTransparency\u003c/code\u003e framework for the UMP SDK to manage the ATT dialog.\u003c/p\u003e\n"],["\u003cp\u003eDuring testing, note that the IDFA ATT dialog appears only once per app installation; to retest, uninstall and reinstall the app on your device.\u003c/p\u003e\n"]]],["To support the IDFA message with the UMP SDK, create and publish an IDFA explainer message in the AdMob UI. Update the `Info.plist` file by adding the `NSUserTrackingUsageDescription` key with a custom message. Link the `AppTrackingTransparency` framework. Remember, the IDFA ATT dialog appears only once unless the app is reinstalled. The UMP SDK can load a form only if the authorization status is `ATTrackingManagerAuthorizationStatusNotDetermined`.\n"],null,["Select platform: [iOS](/admob/ios/privacy/idfa \"View this page for the iOS platform docs.\") [Flutter](/admob/flutter/privacy/idfa \"View this page for the Flutter platform docs.\")\n\n\u003cbr /\u003e\n\nThe User Messaging Platform (UMP) SDK lets you present an\n\n[IDFA message](//support.google.com/admob/answer/10115027)\n\nto your users before requesting their consent for\n[App Tracking Transparency](//developer.apple.com/documentation/apptrackingtransparency)\n(ATT). The IDFA message shows your users how your app uses the identifier.\n\nThis guide covers using the UMP SDK to present an IDFA message.\n| **Note:** If you enable both GDPR and IDFA messages, refer to [Which message your users will\n| see](//support.google.com/admob/answer/10114020#which-message-your-users-will-see) for the possible outcomes.\n\nPrerequisites\n\nBefore you begin, make sure you've done the following:\n\n- Complete the [Get started guide](/admob/flutter/privacy).\n- [Create an IDFA message](//support.google.com/admob/answer/10115331) in the AdMob UI.\n\nUpdate Info.plist\n\nTo show a custom alert message, do the following:\n\n1. Open the `Info.plist` file.\n2. Add the `NSUserTrackingUsageDescription` key with a custom message that describes the usage:\n\n \u003ckey\u003eNSUserTrackingUsageDescription\u003c/key\u003e\n \u003cstring\u003eThis identifier will be used to deliver personalized ads to you.\u003c/string\u003e\n\nThe usage description appears as part of the IDFA ATT alert when you present the\nconsent form:\n\nThen, link the `AppTrackingTransparency` framework:\n\nYour app then shows an IDFA message before the ATT alert.\n\nTesting\n\nWhile testing, remember that the ATT alert only appears a single time since\n[`requestTrackingAuthorization`](//developer.apple.com/documentation/apptrackingtransparency/attrackingmanager/3547037-requesttrackingauthorization)\nis a one-time request. The UMP SDK only has a form available to load if the\nauthorization status is\n[`ATTrackingManagerAuthorizationStatusNotDetermined`](//developer.apple.com/documentation/apptrackingtransparency/attrackingmanagerauthorizationstatus/attrackingmanagerauthorizationstatusnotdetermined?language=objc).\n\nTo make the alert appear a second time, you must uninstall and reinstall your\napp on your test device.\n\nRequest ads with or without IDFA\n\nIf a user denies ATT, continue to request ads using your ad format's APIs. The\nGoogle Mobile Ads SDK doesn't send IDFA in the ad request. For more details see,\n[Select an ad format](/admob/flutter/quick-start#select_an_ad_format)."]]
