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

تتيح لك حزمة تطوير البرامج (SDK) لمنصّة رسائل المستخدمين (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) لمعرّف المعلِنين (IDFA) عند عرض نموذج الموافقة:

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

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

الاختبار

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

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

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

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