תמיכה במזהה עבור מפרסמים (IDFA) (ב-iOS בלבד)
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בחירת פלטפורמה:
iOS
Flutter
ה-User Messaging Platform (UMP) SDK מאפשר להציג למשתמשים הודעה בנושא IDFA לפני שמבקשים מהם להביע הסכמה לשקיפות במעקב באפליקציות (ATT). בהודעה בנושא מזהה עבור מפרסמים (IDFA) מוצג למשתמשים הסבר על אופן השימוש של האפליקציה במזהה.
במדריך הזה מוסבר איך להשתמש ב-UMP SDK כדי להציג הודעה בנושא IDFA.
דרישות מוקדמות
לפני שמתחילים, חשוב לוודא שביצעתם את הפעולות הבאות:
עדכון הקובץ Info.plist
כדי להציג הודעת התראה מותאמת אישית:
- פותחים את הקובץ
Info.plist.
- מוסיפים את המפתח
NSUserTrackingUsageDescription עם הודעה מותאמת אישית שמתארת את השימוש:
<key>NSUserTrackingUsageDescription</key>
<string>This identifier will be used to deliver personalized ads to you.</string>
תיאור השימוש מופיע כחלק מהתראת ה-ATT של IDFA כשמציגים את טופס ההסכמה:
לאחר מכן, מקשרים את מסגרת AppTrackingTransparency:
לאחר מכן, האפליקציה מציגה הודעת IDFA לפני התראת ה-ATT.
בדיקה
במהלך הבדיקה, חשוב לזכור שההתראה על ATT מופיעה רק פעם אחת כי requestTrackingAuthorization היא בקשה חד-פעמית. ערכת UMP SDK כוללת טופס שזמין לטעינה רק אם סטטוס ההרשאה הוא ATTrackingManagerAuthorizationStatusNotDetermined.
כדי שההתראה תופיע בפעם השנייה, צריך להסיר את האפליקציה במכשיר הבדיקה ולהתקין אותה מחדש.
בקשות להצגת מודעות עם או בלי IDFA
אם משתמש דוחה את בקשת ה-ATT, ממשיכים לבקש מודעות באמצעות ממשקי ה-API של פורמט המודעה. Google Mobile Ads SDK לא שולח את IDFA בבקשה להצגת מודעה. פרטים נוספים זמינים במאמר בנושא בחירת פורמט מודעה.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-31 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-31 (שעון UTC)."],[[["\u003cp\u003eThis guide explains how to implement the IDFA message within the User Messaging Platform (UMP) SDK for Flutter apps, specifically for handling Apple's App Tracking Transparency (ATT) requirements.\u003c/p\u003e\n"],["\u003cp\u003eBefore starting, ensure you have completed the UMP SDK setup and created an IDFA message in Google Ad Manager.\u003c/p\u003e\n"],["\u003cp\u003eUpdate your app's \u003ccode\u003eInfo.plist\u003c/code\u003e file to include the \u003ccode\u003eNSUserTrackingUsageDescription\u003c/code\u003e key with a custom message explaining your data usage for personalized ads, which will be displayed in the ATT dialog.\u003c/p\u003e\n"],["\u003cp\u003eLink the \u003ccode\u003eAppTrackingTransparency\u003c/code\u003e framework to enable the display of an IDFA explainer message before the ATT dialog appears.\u003c/p\u003e\n"],["\u003cp\u003eFor testing, remember the ATT dialog appears only once; reinstall the app to see it again after the initial authorization.\u003c/p\u003e\n"]]],["To support the IDFA message using the UMP SDK, first complete the \"Get started\" guide and create an IDFA message in Ad Manager. Update the `Info.plist` file by adding the `NSUserTrackingUsageDescription` key with a custom message explaining IDFA usage. Link the `AppTrackingTransparency` framework. During testing, remember the IDFA ATT dialog appears only once unless the app is uninstalled and reinstalled due to the one-time authorization request. The form is available if the authorization status is `ATTrackingManagerAuthorizationStatusNotDetermined`.\n"],null,["# IDFA support (iOS only)\n\nSelect platform: [iOS](/ad-manager/mobile-ads-sdk/ios/privacy/idfa \"View this page for the iOS platform docs.\") [Flutter](/ad-manager/mobile-ads-sdk/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/admanager/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/admanager/answer/10075998#which-message-your-users-will-see) for the possible outcomes.\n\nPrerequisites\n-------------\n\nBefore you begin, make sure you've done the following:\n\n- Complete the [Get started guide](/ad-manager/mobile-ads-sdk/flutter/privacy).\n- [Create an IDFA message](//support.google.com/admanager/answer/10116236) in the Ad Manager UI.\n\nUpdate Info.plist\n-----------------\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-------\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--------------------------------\n\nIf a user denies ATT, continue to request ads using your ad format's APIs. The\n\n\nGoogle Mobile Ads SDK\n\ndoesn't send IDFA in the ad request. For more details see,\n[Select an ad format](/ad-manager/mobile-ads-sdk/flutter/quick-start#select_an_ad_format)."]]
