يوضِّح هذا الدليل الخطوات المطلوبة لإتاحة رسالة معرّف المعلِنين (IDFA) باعتبارها جزءًا من حزمة تطوير البرامج (SDK) لمنصّة UMP. ومن المفترض أن يتم إقران التطبيق بأداة البدء التي تقدّم نظرة عامة حول كيفية تشغيل تطبيقك باستخدام حزمة تطوير البرامج (SDK) لمنصّة UMP وأساسيات إعداد رسالتك. تتعلق الإرشادات الواردة أدناه برسالة معرّف المعلِنين (IDFA).
المتطلبات الأساسية
- أكمِل دليل البدء.
- أنشِئ رسالة معرّف المعلِنين (IDFA).
تعديل Info.plist
إذا كنت تخطّط لاستخدام حزمة تطوير البرامج (SDK) لمنصة UMP للتعامل مع متطلبات "شفافية تتبُّع التطبيقات" (ATT) من Apple، تأكَّد من إنشاء الرسالة التوضيحية بشأن معرّف المعلِنين (IDFA) في AdMob واجهة المستخدم.
لكي تعرض حزمة تطوير البرامج (SDK) لمنصّة UMP رسالة تنبيه مخصّصة في مربّع حوار نظام 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) يظهر مرة واحدة فقط،
لأنّ
requestTrackingAuthorization
هي طلب يُستخدَم لمرة واحدة. لا تتضمّن حزمة تطوير البرامج (SDK) لمنصّة UMP نموذجًا قابلاً للتحميل إلا إذا كانت حالة التفويض هي ATTrackingManagerAuthorizationStatusNotDetermined.
ولإظهار التنبيه للمرة الثانية، يجب إلغاء تثبيت تطبيقك وإعادة تثبيته على جهاز الاختبار.