استيراد المناطق الجغرافية من ملف CSV

عندما يكون لديك مئات المواقع، مثل كل متجر في سلسلة أو كل نقطة استلام، فإن وضعها على الخريطة واحدًا تلو الآخر ليس أمرًا واقعيًا. بدلاً من ذلك، قم باستيرادها من جدول بيانات.

تجهيز الملف

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

في الملف، يمكنك استخدام ترويسات قصيرة مثل range أو cooldown. في شاشة استيراد المناطق الجغرافية، تستخدم القائمة المنسدلة للربط التسميات أدناه (على سبيل المثال range → النطاق، م).

العمود في الملف	يربط بـ	مطلوب	ملاحظات
Name	الاسم	نعم	حتى 64 حرفًا.
Latitude	خط العرض	نعم	بين -90 و 90.
Longitude	خط الطول	نعم	بين -180 و 180.
Range	النطاق، م	لا	بالأمتار، بين 50 و 100,000. يعود إلى النطاق الافتراضي، م.
Cooldown	فترة التهدئة، ث	لا	بالثواني، بين 60 و 3,596,400 (41 يومًا). يعود إلى فترة التهدئة الافتراضية، ث.
Message	الرسالة	لا	نص الإشعار، حتى 1024 حرفًا.
Cluster code	رمز المجموعة	لا	رمز مجموعة موجود.
Preset code	رمز الإعداد المسبق	لا	رمز إعداد مسبق موجود.

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

مثال لملف CSV

هذا مثال لملف geozones.csv بموقعين. الصف الثاني يترك حقل range فارغًا لذا يتم تطبيق النطاق الافتراضي، م:

name	latitude	longitude	range	message
Store Downtown	40.7128	-74.0060	200	Welcome to our store!
Pickup Point	51.5074	-0.1278		Your order is ready

تمثيل ملف geozones.csv بصيغة نص عادي:

name,latitude,longitude,range,message
Store Downtown,40.7128,-74.0060,200,Welcome to our store!
Pickup Point,51.5074,-0.1278,,Your order is ready

ملفات التصدير من Excel تعمل كما هي

يتم اكتشاف الفاصل من الملف: فاصلة، فاصلة منقوطة أو علامة جدولة. تُقبل الفاصلة أيضًا كفاصل عشري في الإحداثيات، لذا تتم قراءة 55,7558 في ملف تصدير مفصول بفاصلة منقوطة بشكل صحيح. قد تحتوي الحقول المقتبسة على الفاصل وفواصل الأسطر.

احفظ الملف بترميز UTF-8. يقدم Excel هذا الخيار كـ CSV UTF-8 في مربع حوار حفظ باسم. الملف المحفوظ بترميز إقليمي بدلاً من ذلك يعرض الأسماء غير اللاتينية كأحرف مشوهة. علامة ترتيب البايتات (BOM) مقبولة. يتم إزالتها عند القراءة.

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

اتبع هذه الخطوات لرفع الملف وإنشاء المناطق الجغرافية.

1. في صفحة حملات Geo، انقر على استيراد CSV. تفتح شاشة استيراد المناطق الجغرافية.

2. حدد ملف CSV الخاص بك.

3. اربط الأعمدة وعيّن القيم الافتراضية في شاشة استيراد المناطق الجغرافية.

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

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

ملاحظة

يقوم Pushwoosh بمطابقة تهجئات الترويسات الشائعة تلقائيًا، مثل name، store، title، lat، latitude، lng، lon، longitude، radius، range، cooldown، message، cluster، و preset.

عيّن القيم الافتراضية للقيم التي لا يوفرها الملف:

• النطاق الافتراضي، م و فترة التهدئة الافتراضية، ث. تُستخدم عندما لا يحتوي الملف على عمود للنطاق أو فترة التهدئة، أو عندما تكون الخلية فارغة (كما في مثال “Pickup Point”).
• مجموعة لكل منطقة. اختر مجموعة، أو اترك لا توجد مجموعة.
• إعداد مسبق لكل منطقة. إعداد مسبق اختياري للإشعارات لكل صف يحتاجه.
• رسالة لكل منطقة. تُستخدم عندما لا يحتوي الملف على عمود للرسالة. الصفوف التي تحتوي بالفعل على رسالة تحتفظ بنصها الخاص.

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

5. عندما يبدو التحقق صحيحًا، انقر على استيراد. يتم إنشاء المناطق الجغرافية على دفعات. تبلغ شاشة النتائج عن عدد المناطق التي تم إنشاؤها والصفوف التي فشلت.

المناطق الجغرافية المستوردة تكون نشطة

يتم إنشاء المناطق الجغرافية المستوردة وهي نشطة وتبدأ في إطلاق الإشعارات على الفور. عيّن جدولًا زمنيًا لكل منطقة جغرافية بعد الاستيراد، أو أوقفها مؤقتًا في قائمة حملات Geo، إذا كان لا ينبغي أن تعمل بعد.

استيراد نفس الملف مرتين ينشئ نسخة ثانية من كل منطقة جغرافية: الأسماء ليست فريدة. لتصحيح خطأ، احذف المناطق الجغرافية التي استوردتها واستورد الملف المصحح.

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

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

• يكون الاسم فارغًا
• يكون خط العرض أو خط الطول ليس رقمًا، أو يقع خارج النطاق المحدد في الجدول أعلاه
• يكون النطاق ليس رقمًا، أو يقع خارج نطاق 50 إلى 100,000 متر
• تكون فترة التهدئة ليست رقمًا، أو تقع خارج نطاق 60 إلى 3,596,400 ثانية
• ينتهي الصف بدون رسالة أو إعداد مسبق

لإنشاء مناطق جغرافية من نظامك الخاص بدلاً من ملف، استخدم طريقة واجهة برمجة التطبيقات addGeoZone.