أي موقع: الواجهة البرمجية + أداة البحث

استخدم هذا الدليل إذا كان متجرك مبنيًا بكودك الخاص، أو على منصة ليس لها إضافة من SeekGist.

الخطوة 1: أبقِ منتجاتك متزامنة

من خادمك، وباستخدام المفتاح السري، استدعِ POST /v1/products/batch عند حفظ منتج، وعند تغيّر المخزون، وعند حذف منتج. يمكنك إرسال حتى 1,000 منتج في كل طلب. أرسل Idempotency-Key حتى لا تتكرر العملية عند إعادة المحاولة. تجد مثالًا في ابدأ هنا.

للمزامنة الكاملة (كل ليلة مثلًا)، أرسل كل المنتجات بقيمة sync_id نفسها، واجعل sync_complete: true في الدفعة الأخيرة. ومع replace_all: true تُحذف المنتجات التي لم ترسلها في هذه المزامنة.

الخطوة 2: أضف الاقتراحات أثناء الكتابة

أداة البحث من SeekGist سكربت صغير بلا اعتماديات (نحو 8 كيلوبايت بعد الضغط). تعمل من اليمين إلى اليسار، وتتبع ألوان متجرك، ويمكن استخدامها بلوحة المفاتيح. وتستخدم المفتاح العام فقط.

<script src="https://cdn.seekgist.com/widget/1/seekgist-widget.js" async
        data-key="sg_pub_..." data-input="input[name=q]" data-search-url="/search?q="
        data-locale="ar"></script>

تجد كل الخيارات والألوان وزر المحادثة في دليل أداة البحث بلغة JavaScript.

تُحفظ عمليات البحث الأخيرة في متصفح المتسوق فقط (حتى 10، مع زر «مسح»)، ولا تُرسل إلى SeekGist أبدًا.

الخطوة 3: اعرض نتائج البحث

أمامك طريقتان:

أ. اعرض النتائج في المتصفح. استدعِ /v1/search بالمفتاح العام واعرض hits. كل نتيجة فيها بطاقة منتج (الاسم والسعر والصورة والرابط).

ب. اعرض النتائج من خادمك (الأفضل عندما تختلف الأسعار حسب العميل). استدعِ /v1/search من خادمك، وخذ ids بالترتيب، وحمّل هذه المنتجات من قاعدة بياناتك، واعرض بطاقاتك الخاصة.

إذا استدعيت SeekGist من خادمك فاحمِ متجرك بالرجوع الآمن:

• لا تنتظر أكثر من 300 ملّي ثانية إجمالًا (و150 ملّي ثانية للاتصال).
• عند انتهاء المهلة، أو خطأ في الاتصال، أو رمز HTTP من فئة 5xx، أو 429 أو 401 أو 403، أو رد بلا ids، اعرض نتائج البحث الخاصة بمتجرك. لا تعرض صفحة خطأ أبدًا.
• بعد 5 أخطاء خلال 60 ثانية، تجاوز SeekGist لمدة 30 ثانية، ثم جرّب طلبًا واحدًا.

اقرأ الرجوع إلى بحث المتجر لتعرف القواعد كاملة.

الخطوة 4: أرسل النقرات والأحداث

• النقر على نتيجة: POST /v1/click مع search_id وproduct_id وposition.
• الإضافة إلى السلة أو الطلب أو المشاهدة: POST /v1/event مع type (add_to_cart أو order أو view)، حدثًا واحدًا أو دفعة حتى 100 حدث.

أرسلها في الخلفية، ولا تجعل المتسوق ينتظرها أبدًا.