عرض رسالة معرّف المعلِنين (IDFA)

تتيح لك حزمة تطوير البرامج لمنصّة User Messaging Platform (UMP) عرض رسالة معرّف المعلِنين (IDFA) للمستخدمين قبل طلب موافقتهم على إطار عمل شفافية تتبُّع التطبيقات (ATT). توضّح رسالة معرّف المعلِنين (IDFA) للمستخدمين كيفية استخدام تطبيقك لهذا المعرّف.

يغطّي هذا الدليل استخدام حزمة تطوير البرامج لمنصة UMP لعرض رسالة معرّف المعلِنين (IDFA).

المتطلبات الأساسية

قبل البدء، تأكَّد من تنفيذ ما يلي:

• إعداد Google Mobile Ads SDK
• أنشئ رسالة معرّف المعلِنين (IDFA) في واجهة مستخدم AdMob.

تعديل ملف Info.plist

لعرض رسالة تنبيه مخصّصة، اتّبِع الخطوات التالية:

1. افتح ملف Info.plist.
2. أضِف المفتاح NSUserTrackingUsageDescription مع رسالة مخصّصة تصف الاستخدام:

<key>NSUserTrackingUsageDescription</key>
<string>This identifier will be used to deliver personalized ads to you.</string>

يظهر وصف الاستخدام كجزء من تنبيه ATT الخاص بمعرّف المعلِنين عند عرض نموذج الموافقة:

بعد ذلك، اربط إطار عمل AppTrackingTransparency:

بعد ذلك، يعرض تطبيقك رسالة معرّف المعلِنين (IDFA) قبل تنبيه ATT.

الاختبار

أثناء الاختبار، تذكَّر أنّ تنبيه ATT يظهر مرة واحدة فقط لأنّ requestTrackingAuthorization هو طلب لمرة واحدة. لا تتضمّن حزمة تطوير البرامج لمنصة UMP نموذجًا متاحًا للتحميل إلا إذا كانت حالة التفويض هي ATTrackingManagerAuthorizationStatusNotDetermined.

لإظهار التنبيه مرة ثانية، عليك إلغاء تثبيت تطبيقك وإعادة تثبيته على جهاز الاختبار.

طلب الإعلانات باستخدام معرّف المعلِنين أو بدونه

إذا رفض المستخدم إذن ATT، واصِل طلب الإعلانات باستخدام واجهات برمجة التطبيقات الخاصة بشكل الإعلان. لا يرسل Google Mobile Ads SDK معرّف المعلِنين (IDFA) في طلب عرض الإعلان. لمزيد من التفاصيل، اطّلِع على اختيار شكل إعلان.