تنبيه: لا تتوفر وثائق قديمة لهذا العنصر، لذا فإنك ترى الوثائق الحالية.
يمكنك نقل مشتركي دفع التطبيق لنظامي iOS و Android من OneSignal إلى PushEngage عن طريق إعادة استخدام نفس بيانات اعتماد Apple و Firebase التي يستخدمها تطبيقك بالفعل. نظرًا لأن رموز الأجهزة تصدرها Apple و Google بدلاً من OneSignal، فإن الاحتفاظ ببيانات الاعتماد هذه يسمح لرموزك بالاستمرار في العمل بعد التبديل. يشرح هذا الدليل كيفية عمل الترحيل والخطوات اللازمة لإعداده. الترحيل هو عملية خلفية تتم بالتعاون مع فريقنا.
قبل البدء
- إنشاء حساب مع PushEngage.
- جهز بيانات اعتماد دفع Apple الخاصة بك، وتحديداً معرف دفع التطبيق الخاص بك وشهادة p12 من حساب مطور Apple الخاص بك، وهي نفس البيانات المستخدمة في OneSignal.
- جهز معرف مرسل Firebase لنظام Android، وهو نفس المعرف المستخدم في OneSignal.
- احصل على وصول إلى حساب OneSignal الخاص بك لتصدير بيانات المشتركين.
كيف يعمل ترحيل التطبيق
تأتي رموز الأجهزة لدفع التطبيق من خدمة Apple Push Notification service (APNs) و Firebase Cloud Messaging (FCM)، وليس من OneSignal. إذا قمت بتكوين PushEngage بنفس بيانات اعتماد APNs و FCM، فستظل رموزك صالحة وسيتم الترحيل على الواجهة الخلفية. تنتقل أذونات الإشعارات أيضًا، لذلك لا يحتاج المستخدم الذي منح الإذن بالفعل إلى منحه مرة أخرى.
خطوات الترحيل
الخطوة 1: تصدير المشتركين من OneSignal
قم بتصدير بيانات المشتركين الخاصة بك باستخدام أي من الطريقتين:
- تصدير عبر واجهة برمجة التطبيقات (API)، باستخدام معرف تطبيق OneSignal ومفتاح واجهة برمجة التطبيقات للتطبيق الخاص بك.
- تصدير CSV، مع ملف يتضمن
identifierوdevice_typeوlanguageوأي حقول أخرى ذات صلة.
الخطوة 2: تكوين Android FCM في PushEngage
- قم بتسجيل الدخول إلى لوحة تحكم PushEngage.
- انتقل إلى الإعدادات » التثبيت » Android SDK.
- قم بتكوين إعدادات Google Android FCM باستخدام نفس معرف مرسل Firebase الذي استخدمته في OneSignal.
الخطوة 3: تكوين iOS APNs في PushEngage
- انتقل إلى الإعدادات » التثبيت » iOS SDK.
- قم بتكوين إعدادات Apple iOS APNs باستخدام نفس معرف دفع التطبيق من إعداد OneSignal الخاص بك.
- قم بتحميل شهادة p12 من حساب مطور Apple الخاص بك، وهي نفس الشهادة التي استخدمتها في OneSignal.
[لقطة شاشة: تكوين Android SDK و iOS SDK ضمن الإعدادات » التثبيت.]
ملاحظات هامة حول الانتقال بين إصدارات التطبيق
يعتمد ترحيل إشعارات التطبيق على إصدار تطبيق المشترك الذي يقوم بتشغيله، لذا خطط لانتقال الإصدار الخاص بك بعناية.
- إصدارات التطبيق الأقدم مع OneSignal SDK. بعد الترحيل، لن يتلقى المشتركون الذين لا يزالون على إصدارات التطبيق الأقدم إشعارات مرسلة من PushEngage، لأن حمولة PushEngage لا يمكن فك تشفيرها بواسطة OneSignal SDK.
- إصدارات التطبيق الجديدة مع PushEngage SDK. إذا قمت بالإرسال من لوحة تحكم OneSignal بعد الترحيل، فلن تظهر هذه الإشعارات على إصدارات التطبيق الجديدة، لأن حمولة OneSignal لا يمكن فك تشفيرها بواسطة PushEngage SDK.
أرسل من PushEngage للمستخدمين على إصدار التطبيق الجديد، وتوقع أن ينتقل المستخدمون الذين لم يقوموا بالتحديث مع ترقية التطبيق.
أسئلة متكررة
هل يجب على مستخدمي تطبيقي منح إذن الإشعارات مرة أخرى؟
لا. إذا تم منح الإذن بالفعل في تطبيقك، فسيتم نقله ولا يلزم منحه مرة أخرى بعد الترحيل.
هل سيتلقى كل مشترك الإشعارات فورًا بعد الترحيل؟
لن يتلقى المستخدمون على إصدار التطبيق الجديد باستخدام SDK الخاص بـ PushEngage. لن يتلقى المستخدمون الذين ما زالوا على إصدار تطبيق أقدم باستخدام SDK الخاص بـ OneSignal إشعارات PushEngage حتى يقوموا بتحديث التطبيق.
لماذا أعيد استخدام نفس بيانات اعتماد APNs و Firebase؟
لأن رموز الأجهزة مرتبطة ببيانات الاعتماد هذه. إن إعادة استخدام نفس معرف التطبيق، وشهادة p12، ومعرف مرسل Firebase تجعل الرموز الموجودة لديك صالحة، وهذا ما يجعل الترحيل ممكنًا دون مطالبة المستخدمين بإعادة التسجيل.
ما هي البيانات التي أحتاج إلى تصديرها من OneSignal؟
إما تصدير API باستخدام معرف تطبيق OneSignal ومفتاح API للتطبيق الخاص بك، أو ملف CSV يتضمن على الأقل identifier و device_type و language، بالإضافة إلى أي حقول أخرى ذات صلة.
إذا واجهت أي مشاكل، فلا تتردد في الاتصال بنا بالنقر هنا. سيكون فريق الدعم لدينا قادرًا على مساعدتك.
