اربط متجرك
ما تحتاجه كل منصة، وأين تجده في لوحة إدارة متجرك، وكيف يستخدمه إنسايتس.
افتح لوحة التحكمقبل أن تبدأ
يتصل إنسايتس بواجهة API الخاصة بمتجرك، باستخدام مفاتيح تنشئها أنت في لوحة إدارة المتجر. ولا يستخدمها إلا لقراءة الطلبات والمنتجات والعملاء والفئات، والكوبونات أيضًا في WooCommerce. تُحفظ المفاتيح مشفّرة، ولا تعرض صفحة «التكاملات» (Integrations) إلا جزءًا من كل مفتاح.
ربط المتجر متاح للمالك أو لمسؤول فقط. في WooCommerce وMagento، أدخل عنوان متجرك الفعلي بحيث يبدأ بـ https://. وفي Shopify، استخدم عنوان متجرك على .myshopify.com.
يربط كل حساب متجرًا واحدًا. وبعد ربطه، لا يعود زر «Connect Store» (ربط المتجر) ظاهرًا في «المتاجر المتصلة» (Connected Stores). للانتقال إلى متجر آخر، تواصل مع الدعم؛ إذ يجب فصل المتجر الحالي أولًا.
WooCommerce
يتصل WooCommerce بمفتاح REST API من جزأين: «Consumer Key» (مفتاح المستهلك) ويبدأ بـ ck_، و«Consumer Secret» (سر المستهلك) ويبدأ بـ cs_. ويجب أن يعمل متجرك عبر HTTPS.
صلاحية «Read» (قراءة) تكفي للمزامنة. لا تختر «Read/Write» (قراءة/كتابة) إلا إذا أردت أن يضبط إنسايتس الـ webhooks للتحديث الفوري عبر API. أما إضافة الربط (connector plugin) في صفحة «Sync Data» (مزامنة البيانات) فتضبطها دون صلاحية كتابة.
- افتح لوحة إدارة WordPress، واذهب إلى «WooCommerce» ثم «Settings» ثم «Advanced» ثم «REST API»، واضغط «Add key» (إضافة مفتاح).
- أدخل وصفًا مثل Ignitix Insights، واختر في حقل المستخدم حسابًا بصلاحيات المدير (administrator)، واضبط «Permissions» (الصلاحيات) على «Read».
- اضغط «Generate API key» (إنشاء مفتاح API)، وانسخ «Consumer key» و«Consumer secret». لا يعرض WooCommerce السر إلا مرة واحدة.
- الصقهما في إنسايتس داخل حقلي «Consumer Key» و«Consumer Secret»، ثم اضغط «Connect Store».
Shopify
يوصي التطبيق بخيار «Connect with Shopify OAuth» (الربط عبر Shopify OAuth). يطلب منك Shopify الموافقة على صلاحية قراءة المنتجات والعملاء والطلبات، ثم يعيدك إلى إنسايتس، الذي يأخذ اسم المتجر وعملته من Shopify ويبدأ المزامنة الأولى.
إذا كان لديك تطبيق مخصص (custom app) في لوحة إدارة Shopify، فيمكنك بدلًا من ذلك لصق رمز الوصول الخاص بـ Admin API (Admin API access token)، ويبدأ بـ shpat_، في حقل «Access Token» (رمز الوصول). ويحتاج هذا الرمز إلى الصلاحيات (scopes) read_products وread_customers وread_orders.
- اختر Shopify، وأدخل «Store Name» (اسم المتجر)، و«Store URL» (رابط المتجر) بالصيغة https://yourstore.myshopify.com، ثم اضغط «Next» (التالي).
- اضغط «Connect with Shopify OAuth» في خطوة «API Credentials» (بيانات الوصول إلى API).
- سجّل الدخول إلى Shopify إذا طُلب منك ذلك، ثم وافق على الطلب.
- انتظر ظهور رسالة «Store Connected!» (تم ربط المتجر). بعدها يفتح إنسايتس تحليلات متجرك.
Magento 2
يتصل Magento عبر رمز وصول خاص بتكامل (integration access token)، تلصقه في حقل «Bearer Token» (رمز المصادقة). وفي Magento 2.4.4 وما بعده، اضبط أيضًا الإعداد «Allow OAuth Access Tokens to be used as standalone Bearer tokens» (السماح باستخدام رموز OAuth كرموز Bearer مستقلة) على «Yes» (نعم). تجده في «Stores» ثم «Settings» ثم «Configuration» ثم «Services» ثم «OAuth» ثم «Consumer Settings».
لا تنتهي صلاحية رموز التكامل افتراضيًا. أما رمز المسؤول (admin token) فتنتهي صلاحيته بعد 4 ساعات. إذا كنت تستخدمه، فأضف بيانات دخول مسؤول في صفحة «Settings» (الإعدادات) ضمن قسم «Magento Admin Credentials» (بيانات دخول مسؤول Magento)، وسيجلب إنسايتس رمزًا جديدًا عند انتهاء صلاحية القديم.
- افتح لوحة إدارة Magento، واذهب إلى «System» ثم «Extensions» ثم «Integrations»، واضغط «Add New Integration» (إضافة تكامل جديد).
- أدخل «Name» (الاسم) وكلمة مرور المسؤول الخاصة بك. وفي تبويب «API»، امنح صلاحية الوصول إلى «Sales» (المبيعات) و«Catalog» (الكتالوج) و«Customers» (العملاء) و«Stores» (المتاجر).
- اضغط «Save» (حفظ)، ثم «Activate» (تفعيل) بجانب التكامل، ثم «Allow» (سماح).
- انسخ «Access Token»، والصقه في حقل «Bearer Token» في إنسايتس، ثم اضغط «Connect Store».
تحقّق من الاتصال
يختبر زر «Connect Store» مفاتيحك مع متجرك قبل حفظ أي شيء. إذا فشل الاختبار، توضح الشاشة ما يجب مراجعته، ولا يُحفظ شيء، فتستطيع تصحيح المفاتيح والضغط على «Connect Store» مرة أخرى. وإذا نجح، يُحفظ المتجر وتبدأ المزامنة الأولى.
للتحقق لاحقًا من متجر مربوط، افتح «التكاملات» واضغط «Test» (اختبار) ضمن «Store Connection» (اتصال المتجر). يجب أن ترى «Connection successful!» (تم الاتصال بنجاح).
إذا تغيرت مفاتيحك، فاضغط «Edit Credentials» (تعديل بيانات الوصول)، والصق المفاتيح الجديدة واضغط «Save»، ثم اضغط «Test» مرة أخرى. املأ حقول المفاتيح في كل مرة، واترك «Store URL» فارغًا لتحتفظ بالعنوان الحالي.