إدارة قاعدة مشتركي الإشعارات الفورية

في Pushwoosh، يتم تحديد كل مشترك بواسطة رمز إشعار فوري (push token)، وهو معرف فريد يتيح توصيل الرسائل إلى جهاز معين. يغطي هذا المقال كيفية عمل رموز الإشعارات الفورية وكيفية الاحتفاظ بالرموز الصالحة فقط في قاعدة المشتركين لديك.

فهم رموز الإشعارات الفورية وكيفية عملها

رمز الإشعار الفوري هو معرف فريد ومجهول يتم تعيينه لمثيل تطبيق معين على جهاز بواسطة مزود خدمة الإشعارات الفورية الخاص به:

• Apple Push Notification Service (APNs) لأجهزة iOS
• Firebase Cloud Messaging (FCM) لأجهزة Android

يضمن هذا الرمز تسليم الإشعارات الفورية إلى التطبيق الصحيح على جهاز المستخدم.

في Pushwoosh، تتضمن دورة حياة رمز الإشعار الفوري هذه المراحل الرئيسية:

1. عند تشغيل التطبيق لأول مرة، يطلب من نظام تشغيل الجهاز (OS) الإذن لتلقي الإشعارات الفورية.

2. تقوم خدمة الإشعارات الفورية للتطبيق (مثل APNs لنظام iOS، و FCM لنظام Android) بإنشاء رمز إشعار فوري فريد لمثيل التطبيق هذا. بشكل افتراضي، يقوم Pushwoosh SDK بجمع وتخزين هذا الرمز حتى لو لم يمنح المستخدم أذونات عرض الإشعارات. لن يتم عرض رسائل الإشعارات الفورية لهؤلاء المستخدمين، ولكن لا يزال من الممكن استخدام الرمز لإرسال رسائل إلى صندوق الوارد الخاص بتطبيقهم، وهو قناة مراسلة أخرى في Pushwoosh.

   ومع ذلك، يمكنك تكوين SDK لجمع الرموز فقط من المستخدمين الذين منحوا الإذن.

3. يستخدم التطبيق Pushwoosh SDK لإرسال هذا الرمز إلى قاعدة بيانات Pushwoosh مع بيانات الجهاز (بما في ذلك معرف الجهاز أو HWID) إلى Pushwoosh عبر نقطة نهاية واجهة برمجة التطبيقات /registerDevice.

4. يقوم Pushwoosh بتخزين الرمز بشكل آمن للمراسلة المستقبلية.

5. عند تشغيل إشعار، يستخدم Pushwoosh الرمز المخزن لتوجيه الرسالة عبر بوابة التسليم المناسبة.

6. تقوم البوابة المختارة بتسليم الرسالة إلى الجهاز، ويعرضها نظام التشغيل بناءً على إعدادات إشعارات النظام والتطبيق.

7. إذا أصبح رمز الإشعار الفوري غير صالح (على سبيل المثال، بسبب إلغاء تثبيت التطبيق)، يكتشف Pushwoosh فشل التسليم بعد إرسال إشعار آخر، عندما تعيد البوابة قائمة أخطاء الإرسال، بما في ذلك الرموز منتهية الصلاحية/غير الصالحة/إلخ. ثم يقوم Pushwoosh بوضع علامة على الرمز بأنه غير نشط ويحذفه من قاعدة البيانات. إذا تم إعادة تثبيت التطبيق على نفس الجهاز، فسيتم إصدار رمز جديد.

الأسباب الشائعة التي تجعل رموز الإشعارات الفورية غير صالحة

بينما لا توفر Apple Push Notification Service (APNs) و Firebase Cloud Messaging (FCM) شفافية كاملة في سياسات دورة حياة الرموز أو تسمح بالتحقق الاستباقي من صحة الرمز، هناك سيناريوهات معروفة يمكن أن تصبح فيها رموز الإشعارات الفورية غير صالحة أو تنتهي صلاحيتها.

السبب	APNs (iOS)	FCM (Android)
إلغاء تثبيت التطبيق	يصبح الرمز غير صالح بعد إلغاء تثبيت التطبيق. يعيد APNs في النهاية خطأ 410 Unregistered. لا تحدد Apple متى يحدث الإبطال؛ يمكن أن يستغرق ذلك من بضع دقائق إلى عدة أيام. اعرف المزيد	يتم إبطال الرمز فورًا عند إلغاء التثبيت. تعيد عمليات الإرسال اللاحقة خطأ Unregistered. اعرف المزيد
تحديث الرمز	يصدر APNs رمزًا جديدًا بعد ترقيات نظام التشغيل، أو استعادة نسخة احتياطية للجهاز، أو إعادة تثبيت التطبيق، أو تحديثات نظام التشغيل. اعرف المزيد	نفس سلوك APNs. يتم تشغيله أيضًا عن طريق مسح بيانات التطبيق أو استعادة الجهاز. اعرف المزيد
عدم نشاط الرمز	لا يوجد انتهاء صلاحية موثق بسبب عدم النشاط. اعرف المزيد	تعتبر الرموز غير النشطة لأكثر من 270 يومًا قديمة/منتهية الصلاحية. يقوم FCM بوضع علامة عليها كغير صالحة. اعرف المزيد

هام

يحدد Pushwoosh صلاحية الرمز فقط عند فشل تسليم إشعار فوري. لا يقوم بالتحقق من حالة الرمز بشكل استباقي.

كيفية الحفاظ على نظافة قائمة المشتركين عن طريق إزالة رموز الإشعارات الفورية غير الصالحة

للحفاظ على نظافة قائمة مشتركي الإشعارات الفورية، تحقق بانتظام من إحصائيات التسليم، وأزل الرموز غير الصالحة، وتأكد من أن تطبيقك والواجهة الخلفية لديك دائمًا على أحدث بيانات الرمز.

يقدم Pushwoosh عدة طرق لمساعدتك في القيام بذلك:

إرسال إشعارات فورية إلى قاعدة المشتركين بأكملها بانتظام

أرسل رسائل إشعارات فورية إلى قاعدة المشتركين بأكملها بانتظام. يساعد هذا Pushwoosh في تحديد الرموز غير الصالحة. عندما تفشل رسالة في التسليم، عادةً بسبب رمز غير صالح، تعيد بوابة الإشعارات الفورية خطأ. يلتقط SDK هذه الاستجابة ويزيل الرمز غير الصالح تلقائيًا، مما يضمن استبعاده من عمليات الإرسال المستقبلية.

هام: يتم التحقق من صلاحية الرمز فقط عند إرسال إشعار فوري. لا يقوم Pushwoosh بإجراء فحوصات في الخلفية على صلاحية الرمز.

إلغاء تسجيل الأجهزة باستخدام واجهة برمجة التطبيقات (API)

مطلوب مساعدة من فريق التطوير

يتطلب إلغاء تسجيل الأجهزة عبر واجهة برمجة التطبيقات (API) مساعدة من فريق التطوير لديك. يرجى مشاركة هذا الدليل معهم لتنفيذ العملية.

يمكنك استخدام طريقة /bulkUnregisterDevice من Device API لإزالة رموز الإشعارات الفورية من قاعدة المشتركين لديك، على سبيل المثال، عندما يختار المستخدمون إلغاء الاشتراك أو لم يعودوا نشطين.

للقيام بذلك:

1. أنشئ شريحة من المستخدمين تطابق معاييرك (على سبيل المثال، المستخدمون الذين ألغوا الاشتراك، أو مستخدمو الفئة المجانية، أو أولئك غير النشطين لمدة X يومًا).
2. صدّر الشريحة باستخدام لوحة التحكم (Control Panel) أو طريقة exportSegment من واجهة برمجة التطبيقات (API).
3. استدعِ /bulkUnregisterDevice لحذف رموز الإشعارات الفورية للأجهزة في تلك الشريحة.

إزالة الرموز غير النشطة تلقائيًا بعد 90 يومًا باستخدام التحقق التلقائي

تساعد خوارزمية التنظيف التلقائي لعدم النشاط في Pushwoosh في الحفاظ على نظافة قائمة المشتركين عن طريق إزالة رموز الإشعارات الفورية من المستخدمين الذين لم يكونوا نشطين لمدة 90 يومًا.

تعمل عن طريق تتبع آخر مرة فتح فيها المستخدمون تطبيقك باستخدام وسم Last Application Open الافتراضي. إذا لم يفتح المستخدم التطبيق لمدة 90 يومًا أو أكثر، يتم وضع علامة على رمز الإشعار الفوري الخاص به كغير نشط وإزالته من قاعدة المشتركين لديك.

هام

يتم تمكين هذه الميزة بشكل افتراضي لجميع الحسابات التي تم إنشاؤها في 1 يناير 2024 أو بعده. للتحقق مما إذا كانت نشطة لحسابك أو لطلب التفعيل، يرجى الاتصال بدعم Pushwoosh.

استخدام تتبع إلغاء التثبيت (Uninstall Tracking)

يحافظ تتبع إلغاء التثبيت (Uninstall Tracking) على دقة قائمة مشتركي الإشعارات الفورية عن طريق اكتشاف متى يقوم المستخدمون بإلغاء تثبيت تطبيقك. هذا يسمح لـ Pushwoosh بإزالة الرموز غير الصالحة تلقائيًا.

ملاحظة: يتم دعم تتبع إلغاء التثبيت (Uninstall Tracking) فقط على iOS و Android.

إليك كيفية عمله:

1. يرسل Pushwoosh إشعارًا فوريًا صامتًا مرة واحدة يوميًا إلى جميع الأجهزة المشتركة. هذه الإشعارات الصامتة غير مرئية للمستخدمين، بدون تنبيهات أو أصوات أو شارات.
2. كل جهاز لديه رمز إشعار فوري فريد مقدم من بوابة الإشعارات. إذا تم إلغاء تثبيت التطبيق، يصبح الرمز غير صالح. عندما يفشل الإشعار الصامت، تعيد البوابة خطأ.
3. يكتشف Pushwoosh الخطأ ويزيل الرمز غير الصالح من قائمة المشتركين لديك.

هام

يرسل تتبع إلغاء التثبيت (Uninstall Tracking) إشعارات فورية صامتة إلى جميع المشتركين يوميًا، مما قد يزيد من حِمل النظام. تأكد من أن بنيتك التحتية يمكنها دعم هذا الحجم. يتم تمكين الميزة بشكل افتراضي على المنصات المدعومة. لتعطيلها، اتصل بدعم Pushwoosh أو مدير نجاح العملاء الخاص بك.

قيود تتبع إلغاء التثبيت

لا تضمن بوابات الإشعارات تسليم الإشعارات الصامتة. قد يتم تخفيض أولوية هذه الرسائل أو إسقاطها بواسطة البوابة، مما قد يؤخر أو يحد من دقة اكتشاف إلغاء التثبيت. اعرف المزيد

عرض بيانات إلغاء التثبيت

لمراقبة نشاط إلغاء التثبيت، انتقل إلى الإحصائيات > لوحات المعلومات > لوحة معلومات التطبيق في لوحة تحكم Pushwoosh الخاصة بك. يوفر الرسم البياني لعمليات إلغاء تثبيت التطبيق عرضًا زمنيًا لاتجاهات إلغاء التثبيت لتطبيقك.

هل يمكنك استعادة المستخدمين بعد حذف رمز الإشعار الفوري؟

حذف رمز إشعار فوري باستخدام أي طريقة مدعومة يمكن عكسه بسهولة.

عندما يعيد المستخدم فتح تطبيقك:

1. يطلب Pushwoosh SDK تلقائيًا رمز إشعار فوري جديد.
2. ثم يعيد تسجيل الجهاز (عبر registerDevice).
3. يصبح المستخدم مشتركًا نشطًا مرة أخرى وسيتلقى إشعارات فورية من الآن فصاعدًا.