تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يوضّح هذا الدليل الخطوات المطلوبة لتفعيل رسالة معرّف المعلِنين (IDFA) كجزء من
حزمة تطوير البرامج (SDK) لمنصّة UMP. ومن المفترض أن يكون هذا القسم مصحوبًا بقسم البدء الذي يقدّم نظرة عامة حول كيفية تشغيل تطبيقك باستخدام حزمة تطوير البرامج (SDK) لمنصّة UMP والأساسيات المتعلّقة بإعداد رسالتك. تنطبق هذه
الإرشادات على رسالة معرّف المعلِنين (IDFA).
إذا كنت تخطّط لاستخدام حزمة تطوير البرامج (SDK) لمنصّة UMP للتعامل مع متطلبات "إطار عمل شفافية تتبُّع التطبيقات" (ATT) من Apple، تأكَّد من إنشاء
الرسالة التوضيحية لمعرّف المعلِنين (IDFA)
وإعدادها ونشرها في واجهة مستخدِم "مدير إعلانات Google".
لكي تعرض حزمة تطوير البرامج (SDK) لمنصة UMP رسالة تنبيه مخصّصة في مربع diálogo نظام iOS، عليك تعديل Info.plist لإضافة مفتاح NSUserTrackingUsageDescription
مع سلسلة رسالة مخصّصة تصف استخدامك.
<key>NSUserTrackingUsageDescription</key>
<string>This identifier will be used to deliver personalized ads to you.</string>
يظهر وصف الاستخدام كجزء من مربّع حوار ATT عند عرض
نموذج الموافقة:
بعد ذلك، اربط إطار عمل AppTrackingTransparency:
يعرض تطبيقك الآن رسالة توضيحية بشأن معرّف المعلِنين (IDFA) قبل مربّع حوار ATT لمعرّف المعلِنين (IDFA).
الاختبار
أثناء الاختبار، تذكَّر أنّ مربّع حوار موافقة المستخدِم على تتبُّع الإعلانات باستخدام معرّف المعلِنين (IDFA) لا يظهر إلّا مرّة واحدة
لأنّه
requestTrackingAuthorization
هو طلب لمرة واحدة. لا تتوفّر حزمة تطوير البرامج (SDK) لمنصّة UMP إلا بنموذج يمكن تحميله إذا كانت
حالة التفويض هي
ATTrackingManagerAuthorizationStatusNotDetermined.
لظهور التنبيه مرة أخرى، عليك إزالة تثبيت
التطبيق وإعادة تثبيته على جهاز الاختبار.
تاريخ التعديل الأخير: 2025-04-22 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-04-22 (حسب التوقيت العالمي المتفَّق عليه)"],[[["This 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."],["Before starting, ensure you have completed the UMP SDK setup and created an IDFA message in Google Ad Manager."],["Update your app's `Info.plist` file to include the `NSUserTrackingUsageDescription` key with a custom message explaining your data usage for personalized ads, which will be displayed in the ATT dialog."],["Link the `AppTrackingTransparency` framework to enable the display of an IDFA explainer message before the ATT dialog appears."],["For testing, remember the ATT dialog appears only once; reinstall the app to see it again after the initial authorization."]]],["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"]]
