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

إذا كنت تنتقل من مزود إشعارات فورية آخر، يمكنك استيراد قاعدة مشتركي الإشعارات الفورية الحالية إلى Pushwoosh من ملف CSV. تستمر الرموز في العمل طالما أن التطبيق لا يزال يستخدم نفس مفتاح APNs أو مشروع Firebase أو بيانات اعتماد HMS. لا يحتاج المستخدمون إلى إعادة تثبيت التطبيق أو منح الإذن مرة أخرى.

يقوم هذا الاستيراد بتسجيل الأجهزة برموز الإشعارات الفورية. لا ينشئ شريحة. تحصل الأجهزة المستوردة على وسم CSV import الذي يمكنك استخدامه لإنشاء شريحة لاحقًا. لاستيراد قائمة من معرفات المستخدم (User IDs) أو معرفات الأجهزة (Hardware IDs) المسجلة بالفعل إلى شريحة بدلاً من ذلك، راجع استيراد شريحة.

المنصات المدعومة

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

يقبل عمود device_type تنسيقين مختلفين، اعتمادًا على مصدر ملفك:

• رقم، إذا كان التصدير الخاص بك يستخدم رموز المنصات الخاصة بـ OneSignal.
• كلمة، إذا كان تصديرًا من Amazon Pinpoint أو ملفًا أنشأته يدويًا.

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

المنصة	رقم device_type في OneSignal	أسماء المنصات المقبولة
iOS	0	ios, apns, apns_sandbox, apns_voip
Android	1	android, gcm, fcm
Amazon	2	amazon, adm, fireos
Windows	6	windows, wns
macOS	9	macos, osx
Huawei (HMS)	13	huawei, hms

يتم تخطي الصفوف التي تحتوي على أي قيمة أخرى، بما في ذلك:

• أنواع أجهزة إشعارات الويب والبريد الإلكتروني والرسائل القصيرة الخاصة بـ OneSignal.
• المنصات التي لا يدعمها Pushwoosh، مثل Windows Phone المتوقف أو إشعارات Baidu.

لا يمكن نقل اشتراكات إشعارات الويب من أي مزود. يحتاج هؤلاء المستخدمون إلى إعادة الاشتراك من خلال Pushwoosh SDK على موقع الويب الخاص بك.

إعداد ملف CSV

يجب أن يكون حجم ملف CSV الخاص بك أقل من 100 ميغابايت. قم بتسمية الأعمدة تمامًا كما هو موضح أدناه. حالة الأحرف لا تهم. لا يمكنك ربط الأعمدة في واجهة المستخدم، لذا أعد تسمية أي رؤوس لا تتطابق:

العنوان	يقابل
identifier	رمز الإشعار الفوري (مطلوب)
device_type	المنصة (مطلوب)
external_id أو external_user_id	معرف المستخدم (User ID)
language	لغة الجهاز
tags	كائن JSON لقيم الوسوم المخصصة
invalid_identifier	علامة “غير مشترك” في OneSignal. يتم تخطي الصفوف التي تحمل هذه العلامة

لا يتم استيراد عمود المنطقة الزمنية، إن وجد، لأن تنسيقه يختلف بين إصدارات التصدير.

مثال على ملف CSV

إليك ملف subscribers.csv يحتوي على جهازين، أحدهما يستخدم اسم منصة والآخر يستخدم رمزًا رقميًا من OneSignal:

identifier	device_type	external_id	language	tags
ios-token-0001	ios	user-1001	en	{"plan":"pro"}
android-token-0002	1	user-1002	en	{"plan":"free"}

تمثيل subscribers.csv بتنسيق نص عادي:

identifier,device_type,external_id,language,tags
ios-token-0001,ios,user-1001,en,"{""plan"":""pro""}"
android-token-0002,1,user-1002,en,"{""plan"":""free""}"

ملاحظة

قيمة tags هي كائن JSON، وتحتوي على علامات اقتباس. عند إنشاء هذا الملف في Excel أو Google Sheets، لا تحتاج إلى فعل أي شيء، لأن هذه التطبيقات تضع الخلية بين علامتي اقتباس تلقائيًا. عند تحرير الملف مباشرة في محرر نصوص عادي، قم بلف القيمة بأكملها بعلامات اقتباس واكتب كل علامة اقتباس بداخلها كعلامتي اقتباس (" تصبح "")، بنفس الطريقة الموضحة في المثال أعلاه.

كيفية الاستيراد

اتبع هذه الخطوات لتحميل ملف CSV الخاص بك وتسجيل الأجهزة في Pushwoosh.

1. اذهب إلى Audience ← Import CSV وحدد بطاقة Import push subscribers.

2. حدد ملف CSV الخاص بك.
3. راجع الملخص:
   • إجمالي الصفوف في الملف، وعدد الصفوف القابلة للاستيراد، مقسمة حسب المنصة.
   • الصفوف التي تم تخطيها، مقسمة حسب السبب، مع رابط لتنزيل الصفوف التي تم تخطيها كملف CSV (الأعمدة الأصلية بالإضافة إلى عمود skip_reason).
   • الوسوم المخصصة التي تم اكتشافها في عمود tags، مع النوع الذي استنتجه Pushwoosh لكل منها (string، integer، boolean، أو date). إذا كان اسم الوسم موجودًا بالفعل في حسابك بنوع مختلف، فسيتم تمييزه على أنه تعارض. يمكنك تغيير النوع أو تخطي هذا الوسم لهذا الاستيراد.

4. انقر على Start import بمجرد أن تكون راضيًا.

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

لماذا يتم تخطي الصف

هذه هي أسباب التخطي الموضحة في ملخص الربط وفي ملف CSV للصفوف التي تم تخطيها.

السبب	التفسير
اشتراكات الويب	مرتبطة بمفاتيح مزود آخر. لا يمكن نقلها
رموز غير صالحة	مرفوضة بالفعل من قبل APNs / FCM (علامة invalid_identifier في OneSignal)
عناوين البريد الإلكتروني	استخدم استيراد جهات اتصال البريد الإلكتروني بدلاً من ذلك
أرقام الهواتف	استخدم استيراد جهات اتصال الرسائل القصيرة بدلاً من ذلك
رموز مكررة	يظهر نفس رمز الإشعار الفوري أكثر من مرة في الملف. يتم اعتماد الصف الأول وتخطي الصفوف اللاحقة
منصة غير مدعومة	المنصة ليست من المنصات التي يدعمها Pushwoosh (مثل Windows Phone, Baidu)
منصة غير معروفة	قيمة المنصة غير معروفة على الإطلاق
رمز إشعار فوري فارغ	لا توجد قيمة في عمود رمز الإشعار الفوري

إعادة استيراد نفس الملف

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

بعد الاستيراد

يتم وسم الأجهزة المستوردة بـ CSV import، مع قيمة تاريخ ووقت الاستيراد. يتم استخدام نفس الوسم بواسطة استيراد الشريحة. استخدمه لإنشاء شريحة من الأجهزة المستوردة، أو للعثور عليها بشكل فردي في مستكشف المستخدم.

لا يتم إنشاء أي شريحة تلقائيًا.