دعم معرّف المعلِنين (IDFA)

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

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

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

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

• أكمِل دليل البدء.
• أنشئ رسالة معرّف المعلِنين (IDFA) في واجهة مستخدم "مدير إعلانات Google".

تعديل ملف 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) لمنصّة إدارة المستخدمين نموذجًا متاحًا للتحميل إلا إذا كانت حالة التفويض هي ATTrackingManagerAuthorizationStatusNotDetermined.

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

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

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