دعم معرّف المعلِنين (IDFA) (نظام التشغيل iOS فقط)

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

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

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

قبل البدء، تأكَّد من إجراء ما يلي:

تعديل ملف 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 هو طلب لمرة واحدة. لا تتوفّر حزمة تطوير البرامج (SDK) لمنصّة UMP إلا بنموذج يمكن تحميله إذا كانت حالة التفويض هي ATTrackingManagerAuthorizationStatusNotDetermined.

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

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

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