اعرض منتجات Shopify ومشترياته.

Shopify في Social Stream Ninja

روّج للمنتجات العامة بالصور والأسعار والروابط الواضحة ورموز QR. استقبل إشعارات الطلبات المدفوعة الموقّعة كتنبيهات purchase في موجز النشاط والتنبيهات المتعددة وEvent Flow. يعمل الترويج للمنتجات بصورة مستقلة عن تنبيهات الدفع.

ربط المشتريات · استيراد المنتجات · تراكبات OBS · الاختبار بأمان · الحدود وحل المشكلات

التوفر: تتطلب التنبيهات التلقائية نشر مستقبل Shopify وتفعيله في SSN API. إذا لم يتوفر، يبلغ Save setup عن خطأ ولا يفعّل Shopify. يعمل استيراد المنتجات العامة والترويج اليدوي بصورة مستقلة. يصف هذا الدليل شفرة التكامل؛ ولا يزال يلزم اختبار تاجر حقيقي قبل الادعاء بالتحقق من الخدمة الفعلية.

ربط المشتريات المدفوعة

1. في Shopify، افتح الإعدادات → الإشعارات → خطافات الويب (Settings → Notifications → Webhooks). اعثر على سر التوقيع المعروض لخطافات الويب المنشأة يدويًا. وهو مختلف عن رمز Storefront.
2. في SSN، افتح تحقيق الدخل → مشتريات Shopify → الإعداد (Monetization → Shopify purchases → Setup). أدخل نطاقك الدائم your-store.myshopify.com وسر توقيع خطاف الويب. فعّل مشتريات Shopify، ثم انقر حفظ الإعداد (Save setup).
3. انقر على نسخ رابط الاستقبال (Copy receiver URL). في Shopify، أنشئ خطاف ويب بالحدث دفع الطلب (Order payment)، والتنسيق JSON، ورابط الاستقبال ذلك. اختر إصدار API مستقرًا ومدعومًا لخطافات الويب؛ طُوّر هذا التكامل وفق عقد الطلبات 2026-07.
4. احفظ خطاف ويب Shopify. أبقِ SSN قيد التشغيل لمعالجة المشتريات. يتحقق المستقبل من HMAC للجسم الخام ومن مطابقة المتجر قبل قبول بيانات الطلب.

يُشفَّر سر التوقيع على مستقبل SSN ويُمسح من حقل الإدخال بعد الحفظ. يبقى مفتاح قراءة خاص منفصل على هذا الجهاز. لا يُضمَّن أي منهما في روابط OBS أو رموز QR للمشاهدين. يستخدم Shopify مستقبله المخصص؛ ولا يلزم مفتاح التحكم عن بُعد القديم عبر API.

وجود رابط مُنشأ يعني حفظ التهيئة، وليس أن Shopify سلّم أي شيء. تميّز الحالة بين الانتظار والاختبار المتحقق منه والحدث المتجاوز والشراء المستلم. يتطلب تغيير المتجر استخدام Disconnect أولًا. يؤدي إيقاف Shopify إلى تعليق المعالجة المحلية؛ ويحذف Disconnect مستقبله والأحداث المنتظرة. أزل خطاف ويب Shopify المقابل عند قطع الاتصال.

Shopify: إنشاء خطافات الويب يدويًا · Shopify: التحقق من الإيصالات

استيراد منتج عام

1. أدخل myshopify.com في إعداد Shopify. لا تحتاج إلى تفعيل تنبيهات الشراء أو إدخال سر توقيع لاستيراد المنتجات.
2. وسّع استيراد منتج، والصق رابط منتج عامًا، وانقر تحميل تفاصيل المنتج (Load product details).
3. إذا لم يُتح الوصول دون رمز إلى المنتج، فقدم رمز Storefront عامًا. تستطيع قناة Headless في Shopify إنشاء واحد. انشر المنتج في واجهة المتجر تلك وفي Online Store. لا تلصق رمز Admin API أو رمز Storefront خاصًا.
4. يفتح SSN محرر روابط المنتجات والدعم (Products & support links) الحالي بالعنوان والصورة والسعر والرابط العام المعتمد الذي أعاده Shopify. راجعها، وانقر إضافة منتج أو رابط (Add product or link)، فعّل الكتالوج و حفظ الإعداد (Save setup).

يقرأ الاستيراد منتجًا واحدًا كل مرة باستخدام Storefront API. الرمز اختياري ويُستخدم لذلك الطلب فقط ثم يُمسح. يصبح رابط Online Store المعتمد لدى Shopify الرابط العام، بما فيه النطاق المخصص عندما يعيده Shopify. تُستبعَد المنتجات غير المتاحة والمنتجات التي ليس لها رابط Online Store عام.

يُملأ السعر فقط عندما يتطابق أدنى سعر وأعلى سعر لمتغيرات المنتج. وإلا يبقى فارغًا؛ اختر سعرًا محددًا بنفسك فقط إذا كان يصف العرض بدقة. المعلومات المستوردة لقطة لحظية وليست مزامنة مستمرة للمخزون أو الأسعار. راجعها عند تغير متجرك. يمكنك دائمًا إدخال المنتج يدويًا بدلًا من ذلك.

مصادقة Shopify Storefront · استعلام المنتج · إنشاء رمز عام باستخدام Headless

استخدام التراكبات الحالية

ضمن رابط التراكب لـ، اختر روابط المنتجات والدعم (Products & support links). استخدم عرض المنتجات فقط للصور والأسعار ورموز QR، و بطاقة الدعم فقط لرابط متجر صغير دائم أو دوري، أو تنبيهات النشاط فقط للمشتريات. انسخ كل رابط OBS مطلوب إلى مصدر متصفح منفصل، وابدأ بحجم 800 × 600.

اضبط عامل تصفية مصدر التنبيهات الاختياري على shopify لعرض نشاط Shopify فقط في تراكب تحقيق الدخل العام. فعّل Products & support links لذلك العرض العام. تستقبل التنبيهات المتعددة وموجز النشاط الحاليان مشتريات Shopify بصورة مستقلة عن كتالوج المنتجات.

ترتبط بطاقات المنتجات بصفحات المنتجات العامة. استخدم نسخ الرابط العام (Copy public link) لمشاركة العنوان القابل للنقر في الدردشة، واختبر رمز QR من هاتف بحجم البث النهائي. لا يستعير تنبيه شراء رمز QR أو صورة من منتج متناوب غير ذي صلة أبدًا. لا توفر خطافات ويب الطلبات روابط صور منتجات موثوقة، لذا تستخدم تنبيهات الشراء النص؛ ويمكن للبطاقات الترويجية المستوردة عرض الصور.

في Event Flow، اختر Event Type purchase وصفِّ المصدر أو النوع إلى shopify. قارن meta.commerce.orderTotal لقواعد قيمة الطلب وتحقق من meta.commerce.currency قبل مقارنة المبالغ. هذه مشتريات: لا يُرسَل hasDonation أو donoValue ، ولا ترتفع أهداف التبرعات. بطاقة ترويجية تحمل تسمية Gift لا تغير تصنيف أحداث الطلبات. الشحن إلى شخص آخر ليس دليلًا على هدية لصانع المحتوى.

المعاينة والاختبار بأمان

معاينة نموذج (Preview sample) يفتح تراكبًا نموذجيًا معزولًا دون اتصال جلسة. لا يشغّل Event Flow ولا يغيّر الإجماليات ولا يتحقق من دفعة أبدًا.

طلبات Shopify الموسومة صراحة بأنها test: true يُقَر باستلامها وتُعرَض كاختبارات في حالة المستقبل، دون تنبيهات شراء أو إجراءات. تُتجاوَز أيضًا الطلبات التي تفتقر إلى علامات الاختبار، وغير المدفوعة أو المدفوعة جزئيًا، والملغاة، وذات الإجماليات الصفرية، والطوابع الزمنية القديمة أو غير الصالحة. استخدم متجر تطوير للاختبار الكامل من البداية إلى النهاية. لا ينبغي إرسال عينة إدارية تفتقر إلى علامة اختبار موثوقة إلى سير مكافآت نشط؛ معاينة SSN هي وسيلة فحص المظهر الآمنة.

ما اختبرناه دون متجر

تشمل الاختبارات المعزولة إيصال HTTP فعليًا مع JSON يونيكود موقّع، والتوقيعات المعدّلة، والإيصالات المكررة، وعزل الطلبات الاختبارية، ودقة العملات، والطلبات كبيرة الحجم، وإزالة بيانات العملاء الخاصة، والاسترداد بعد انقطاع الاتصال عبر بيئة SSApp الفعلية. لا تنشئ هذه الاختبارات طلبات ولا تتطلب حساب تاجر.

يبقى مستقبل Shopify الإنتاجي معطلًا بانتظار اختبار إيصال من متجر حقيقي. يمكن استخدام الترويج اليدوي للمنتجات بصورة مستقلة. قد تساعد خطافات الويب النموذجية في Shopify CLI على اختبار معالجة الحمولات، لكنها لا تتحقق من الاشتراكات أو إعادة المحاولة، وتظل تتطلب بيانات اعتماد تطبيق. راجع قيود اختبار خطافات الويب في Shopify CLI.

حدود الإيصال وحل المشكلات

• المستقبل غير متاح: يجب أن ينشر مشغّل SSN API مستقبل Shopify ويفعّله. راجع إعداد الخادم. لا تستخدم رابط خطاف ويب الجلسة القديم غير الموقّع بديلًا.
• انتظار حدث: تحقق من Order payment وJSON ورابط الاستقبال الدقيق وتطابق نطاق المتجر الدائم وسر توقيع خطاف الويب ذلك. يستخدم خطاف ويب التطبيق المخصص سر توقيع ذلك التطبيق، وليس سر Notifications اليدوي.
• تجاوز حدث موقّع: يتطلب هذا التكامل طلبًا موجب القيمة ومدفوعًا بالكامل، و test: false وجسمًا موقّعًا updated_at خلال الأيام السبعة الماضية (مع سماح بخمس دقائق لساعة متقدمة). ولا يستنتج الدفع من إنشاء الطلب أو تنفيذه أو المخزون.
• كان SSN غير متصل: تُحفَظ الأحداث المقبولة في قائمة انتظار لمدة تصل إلى سبعة أيام. أعد تشغيل SSN للاستئناف. تبقى الحالة والعمل المعلق بعد إعادة تشغيل المستقبل. سعة تخزين الخدمة محدودة، وتطلب من Shopify إعادة المحاولة عندما لا تستطيع حفظ العمل في قائمة انتظار بشكل دائم.
• التكرارات: يزيل المستقبل التكرار حسب المتجر والطلب، حتى إذا اختلفت معرّفات إيصال Shopify. تبقى سجلات إزالة التكرار سبعة أيام. يحفظ SSN المعرّفات المعالجة قبل الإقرار بالاستلام. قد يكرر التعطل بين إجراء خارجي وذلك الحفظ الإجراء رغم ذلك؛ استخدم حارسًا خاصًا لمنع تكرار التنفيذ في الأتمتة ذات النتائج المهمة.
• اسم المشتري مفقود: هذا مقصود. يستبعد SSN أسماء العملاء وبريدهم وعناوينهم وملاحظات الطلب والخصائص المخصصة لبنود الطلب وروابط الدفع ومعرّفات الطلب الخام. تبقى عناوين المنتجات العامة نصًا عاديًا.
• استردادات أو تغييرات في الطلب: هذا موجز تنبيهات مباشر، وليس نظام محاسبة أو تنفيذ طلبات. لا تعكس الاستردادات والإلغاءات والإجماليات المعدلة التنبيهات السابقة. لا يتضمن مطابقة سجل الطلبات أو إزالة المنتجات تلقائيًا.

راجع عقد أحداث Shopify و دليل المنتجات ورموز QR المشترك.