تسجيل الدخول ابدأ خطة →
الرئيسيةالمزاياالأسعارالأسئلة الشائعةالوثائقالمدوّنةتواصل معنا
تسجيل الدخول ابدأ خطة →
D01 · DOCUMENTATIONSCANFENCE / DOCUMENTATIONQUICKSTART · API · RECIPES

كيف يعمل.

أدلة الإعداد، مراجع API، وصفات التكامل. ابدأ بالبدء السريع، ثم توسّع إلى المرجع التقني عندما تكون جاهزًا.

جدول المحتويات

1. البدء

1.1 إنشاء حسابك
  1. انتقل إلى صفحة التسجيل في GeoTrack على /signup
  2. اختر خطة اشتراكك (Basic أو Starter أو Professional)
  3. أدخل عنوان بريدك الإلكتروني وأنشئ كلمة مرور آمنة
  4. انقر على “إنشاء حساب”
  5. سيتم تسجيل دخولك تلقائيًا وإعادة توجيهك إلى لوحة التحكم

ملاحظة: تشمل جميع الخطط فترة تجريبية مجانية مدتها 7 أيام. لن يتم خصم أي مبلغ من بطاقتك حتى انتهاء الفترة التجريبية.

عند تسجيل دخولك لأول مرة، سترى:

  • لوحة التحكم مع إحصائيات سريعة (عند الصفر حاليًا)
  • قائمة التنقّل على اليسار مع الميزات المتاحة
  • رسالة ترحيب تدعوك لإنشاء أول رمز QR خاص بك

خطة Basic ($4.99/شهريًا)

  • 20 رمز QR
  • 5,000 عملية مسح شهريًا
  • عضو فريق واحد
  • الاحتفاظ بالبيانات لمدة 7 أيام
  • دعم عبر البريد الإلكتروني (استجابة خلال 48 ساعة)

خطة Starter ($14.99/شهريًا)

  • 100 رمز QR
  • 25,000 عملية مسح شهريًا
  • عضوا فريق
  • الاحتفاظ بالبيانات لمدة 30 يومًا
  • دعم بريد إلكتروني ذو أولوية (24 ساعة)

خطة Professional ($44.99/شهريًا)

  • 500 رمز QR
  • 250,000 عملية مسح شهريًا
  • 10 أعضاء فريق
  • الاحتفاظ بالبيانات لمدة 90 يومًا
  • دعم ذو أولوية + وصول إلى API

2. نظرة عامة على لوحة التحكم

2.1 مكوّنات لوحة التحكم
تعرض لوحة التحكم ما يلي: المقاييس الرئيسية: • إجمالي رموز QR: عدد رموز QR التي أنشأتها • إجمالي عمليات المسح: إجمالي عمليات المسح عبر جميع رموز QR • السياجات الجغرافية النشطة: عدد السياجات الجغرافية النشطة حاليًا • عمليات المسح هذا الشهر: عمليات المسح المسجّلة في الشهر التقويمي الحالي

3. إنشاء رموز QR

3.1 رمز QR القياسي

الغرض: رمز QR بسيط يعيد التوجيه إلى عنوان URL واحد.

الخطوات:

  1. انتقل إلى “QR Codes” في قائمة التنقّل
  2. انقر على “Create New QR Code”
  3. اختر “Standard” كنوع
  4. أدخل اسمًا لرمز QR الخاص بك (مثل “كتيّب المنتج”)
  5. أدخل عنوان URL الوجهة
  6. انقر على “Create QR Code”

حالات الاستخدام:

  • صفحات معلومات المنتج
  • التسجيل في الفعاليات
  • معلومات الاتصال
  • ملفات وسائل التواصل الاجتماعي

الغرض: إعادة توجيه المستخدمين إلى عناوين URL مختلفة بناءً على موقعهم الفعلي.

الخطوات:

  1. انتقل إلى “QR Codes” → “Create New QR Code”
  2. اختر “Geofence” كنوع
  3. أدخل اسمًا لرمز QR الخاص بك
  4. أدخل عنوان URL الافتراضي (يُستخدم عندما يكون المستخدم خارج جميع السياجات الجغرافية)
  5. انقر على “Create QR Code”
  6. انتقل إلى قائمة “Geofences” وانقر على “Create Geofence”
  7. اختر رمز QR الخاص بك، وحدّد الموقع ونصف القطر
  8. أدخل عنوان URL لإعادة التوجيه لهذا الموقع

حالات الاستخدام:

  • متاجر التجزئة متعددة المواقع
  • تسليم المحتوى الإقليمي
  • عروض خاصة بموقع معيّن
  • التنقّل داخل مكان الفعالية

الغرض: إعادة توجيه المستخدمين تلقائيًا إلى أقرب موقع من قائمة محدّدة مسبقًا.

كيف يعمل:

  1. يمسح المستخدم رمز QR
  2. يكتشف النظام إحداثيات GPS للمستخدم
  3. يحسب المسافة إلى جميع المواقع
  4. يعيد التوجيه إلى الأقرب

حالات الاستخدام:

  • أعمال الامتياز التجاري
  • سلاسل المطاعم
  • مزوّدو الخدمات ذوو المكاتب المتعددة
  • محدّدات مواقع المتاجر

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

التهيئة:

  • أيام الأسبوع: اختر الأيام التي تنطبق فيها هذه القاعدة
  • النطاق الزمني: حدّد أوقات البدء والانتهاء (بتنسيق 24 ساعة)
  • نطاق التاريخ: نطاق تاريخ محدّد اختياري
  • الأولوية: الأرقام الأعلى لها الأسبقية
  • عنوان URL الوجهة: إلى أين تتم إعادة التوجيه خلال هذا الوقت

أمثلة:

  • قوائم المطاعم (فطور، غداء، عشاء)
  • معلومات ساعات العمل مقابل ما بعد الدوام
  • محتوى موسمي
  • إعادات توجيه خاصة بالفعاليات

اصنع شعورًا بالندرة والإلحاح عبر حدود المسح.

حالات الاستخدام:

  • عروض لفترة محدودة (“أول 100 عميل يحصلون على خصم 20%”)
  • رموز وصول حصرية
  • إدارة سعة الفعاليات
  • الحملات الترويجية

4. إدارة السياجات الجغرافية

4.1 إنشاء سياج جغرافي
  1. انتقل إلى “Geofences” في التنقّل
  2. انقر على “Create Geofence”
  3. اختر رمز QR الذي تريد إحاطته بسياج جغرافي
  4. أدخل معلومات الموقع (العنوان أو الإحداثيات)
  5. حدّد نصف القطر بالأمتار (الافتراضي: 100m)
  6. أدخل عنوان URL لإعادة التوجيه لهذا السياج الجغرافي
  7. انقر على “Create Geofence”

اختيار نصف القطر:

  • المناطق الحضرية: 50-100 متر (دقة GPS عالية)
  • المناطق شبه الحضرية: 100-300 متر (دقة معتدلة)
  • المناطق الريفية: 300-1000 متر (دقة GPS أقل)

السياجات الجغرافية المتداخلة:

  • عند تداخل السياجات الجغرافية، يستخدم النظام أقرب نقطة مركز
  • استخدم إعدادات الأولوية للتحكم في السلوك
  • اختبر بدقة في المناطق التي تتداخل فيها السياجات الجغرافية

5. التحليلات وإعداد التقارير

5.1 لوحة تحكم التحليلات

مقاييس النظرة العامة:

  • إجمالي عمليات المسح (طوال الوقت)
  • عمليات المسح الفريدة
  • عمليات المسح هذا الشهر
  • نسبة نمو المسح

المخططات والرسوم البيانية:

  • الجدول الزمني للمسح (يومي/أسبوعي/شهري)
  • التوزيع الجغرافي
  • تفصيل الأجهزة (الجوال مقابل سطح المكتب)
  • إحصائيات المتصفح

تعرض الخريطة التفاعلية ما يلي:

  • علامات دبوس لكل موقع مسح
  • علامات تجميع عند وجود عمليات مسح متعددة قريبة
  • انقر على الدبابيس لعرض تفاصيل المسح
  • كبّر وحرّك لاستكشاف المناطق

الخطوات:

  1. انتقل إلى صفحة التحليلات
  2. حدّد عوامل التصفية المطلوبة
  3. انقر على “Export Data”
  4. اختر التنسيق (CSV)
  5. نزّل الملف

تتضمّن البيانات المصدَّرة:

  • الطابع الزمني، اسم رمز QR، الموقع
  • نوع الجهاز، المتصفح، نظام التشغيل
  • سلسلة وكيل المستخدم (user agent)

6. إدارة الفريق

6.1 أدوار الفريق

Admin

• وصول كامل إلى جميع الميزات

• دعوة/إزالة أعضاء الفريق

• إدارة الفوترة

• عرض جميع التحليلات

• الوصول إلى الإعدادات

Manager

• إنشاء/إدارة رموز QR

• إنشاء/إدارة السياجات الجغرافية

• عرض جميع التحليلات

• لا يمكنه إدارة الفريق

• لا يمكنه الوصول إلى الفوترة

Field User

• إنشاء رموز QR

• عرض رموز QR الخاصة به فقط

• وصول محدود إلى التحليلات

• لا يمكنه إدارة السياجات الجغرافية

• لا يمكنه الوصول إلى الفوترة

  1. انتقل إلى “Team” في التنقّل (يجب أن تكون Admin)
  2. انقر على “Invite Team Member”
  3. أدخل عنوان بريدهم الإلكتروني
  4. اختر دورهم (Admin أو Manager أو Field User)
  5. انقر على “Send Invitation”
  6. يتلقّى المدعوّ بريدًا إلكترونيًا يحتوي على رابط القبول

ملاحظة: يمكنك دعوة عدد من الأعضاء بقدر ما تسمح به خطتك فقط (Basic: 1، Starter: 2، Professional: 10)

7. الاشتراك والفوترة

7.1 عرض حالة الاشتراك

مؤشرات الحالة:

  • نشط: الاشتراك ساري ونشط
  • تجريبي: ضمن الفترة التجريبية البالغة 7 أيام
  • متأخر السداد: فشل الدفع، جارٍ إعادة المحاولة
  • ملغى: ملغى لكنه لا يزال نشطًا حتى نهاية الفترة
  • منتهٍ: انتهى الاشتراك
  1. انتقل إلى صفحة “Pricing” أو لوحة التحكم
  2. انقر على “Upgrade” للخطة المطلوبة
  3. راجع ميزات وحدود الخطة الجديدة
  4. أكّد الترقية
  5. يُطبَّق رسم تناسبي على الفور
  6. تُفعَّل الحدود الجديدة على الفور

8. الميزات المتقدمة

8.1 الجمع بين السياجات الجغرافية والقواعد الزمنية

مثال على حالة استخدام: سلسلة مطاعم

  1. أنشئ رمز QR متعدد المواقع
  2. أضف سياجات جغرافية لكل موقع مطعم
  3. أضف قواعد زمنية للقوائم (فطور، غداء، عشاء)

نظام الأولوية:

  • تطابق السياج الجغرافي + القاعدة الزمنية = أعلى أولوية
  • تطابق السياج الجغرافي فقط = أولوية متوسطة
  • تطابق القاعدة الزمنية فقط = أولوية منخفضة
  • لا يوجد تطابق = عنوان URL الافتراضي

مرّر معلومات حول عملية المسح إلى عنوان URL الوجهة:

المعلمات المتاحة:

  • {scan_id} – معرّف المسح الفريد
  • {qr_code_id} – معرّف رمز QR
  • {timestamp} – طابع Unix الزمني
  • {lat} – خط العرض
  • {lng} – خط الطول

https://example.com/track?scan={scan_id}&location={lat},{lng}&time={timestamp}

9. استكشاف الأخطاء وإصلاحها

9.1 رمز QR لا يُمسح

الأسباب المحتملة:

  • جودة صورة رمز QR منخفضة جدًا
  • ظروف إضاءة سيئة
  • مشكلات في تركيز الكاميرا
  • رمز QR صغير جدًا أو كبير جدًا

الحلول:

  • نزّل رمز QR بدقة أعلى (300×300 أو 500×500)
  • تأكّد من وجود تباين جيد (داكن على خلفية فاتحة)
  • حافظ على حد أدنى للحجم يبلغ 2cm x 2cm عند الطباعة

الأسباب:

  • GPS معطّل على الجهاز
  • موقع داخلي (إشارات GPS ضعيفة)
  • دقة GPS للجهاز منخفضة
  • رفض المستخدم إذن الموقع

الحلول:

  • اطلب من المستخدمين تفعيل خدمات الموقع
  • زد نصف قطر السياج الجغرافي للاستخدام الداخلي
  • وفّر عنوان URL احتياطيًا لحالات فشل تحديد الموقع

قائمة التحقق:

  • هل السياج الجغرافي نشط؟ (تحقق من الحالة في لوحة التحكم)
  • هل نوع رمز QR مضبوط على “Geofence”؟
  • هل نصف القطر مناسب للمنطقة؟
  • هل اختبرت على جهاز مع تفعيل الموقع؟
  • هل الإحداثيات صحيحة؟ (تحقق على الخريطة)

10. أفضل الممارسات

10.1 تصميم رمز QR

✓ افعل:

  • استخدم تباينًا عاليًا (الأسود على الأبيض مثالي)
  • اترك مساحة بيضاء حول الرمز (المنطقة الهادئة)
  • اختبر قبل الطباعة بكميات كبيرة
  • أدرج نصًا واضحًا للحث على الإجراء

✗ لا تفعل:

  • تستخدم ألوانًا تقلّل التباين
  • تجعل رمز QR صغيرًا جدًا (بحد أدنى 2cm x 2cm)
  • تضعه على أسطح منحنية
  • تستخدم صورًا منخفضة الدقة

التخطيط:

  • حدّد جميع المواقع أولًا
  • حدّد نصف القطر المناسب لكل منها
  • ضع في الاعتبار دقة GPS في كل منطقة
  • اختبر سيناريوهات التداخل

التحسين:

  • ابدأ بأنصاف أقطار أكبر، ثم ضيّقها بعد الاختبار
  • استخدم التحليلات للتحقق من دقة السياج الجغرافي
  • اضبط بناءً على بيانات المسح في العالم الحقيقي

حماية حسابك:

  • استخدم كلمة مرور قوية وفريدة
  • فعّل المصادقة الثنائية (قريبًا)
  • لا تشارك بيانات اعتماد تسجيل الدخول
  • راجع وصول أعضاء الفريق بانتظام

خصوصية المستخدم:

  • اجمع بيانات الموقع الضرورية فقط
  • التزم بلوائح GDPR/الخصوصية
  • أمّن عناوين URL الوجهة عبر HTTPS