Social Stream Ninja
العربية
EnglishEspañolPortuguês (Brasil)РусскийFrançaisDeutsch日本語简体中文繁體中文ItalianoPolski한국어УкраїнськаالعربيةTürkçeČeštinaไทย

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

اعرض المنتجات مع رمز QR، وتلقَّ تنبيهاً عندما يشتري أحدهم.

عرض منتج Shopify في 5 خطوات

  1. في Social Stream Ninja، افتح تحقيق الدخل → مشتريات Shopify → الإعداد (Monetization → Shopify purchases → Setup).
  2. اكتب عنوان متجرك، مثل your-store.myshopify.com. لا يلزم سر.
  3. افتح استيراد منتج، والصق رابط المنتج العام، ثم انقر تحميل تفاصيل المنتج (Load product details).
  4. تحقق من الاسم والصورة والسعر والرابط، ثم انقر إضافة منتج أو رابط (Add product or link).
  5. فعّل روابط المنتجات والدعم (Products & support links) وانقر حفظ الإعداد (Save setup).
اسم منتج Shopify المستورد ورابط صورته وسعره ورابطه العام المعتمد في محرر المنتجات المشترك
تُحمّل تفاصيل المنتج في المحرر لتراجعها أولاً.
المنتج لا يُحمّل؟ أضف رمز Storefront عام (أنشئه عبر قناة Headless في Shopify، وانشر المنتج فيها وفي Online Store). لا تلصق مفتاح Admin API أو رمزاً خاصاً أبداً.
ما يملؤه الاستيراد
  • يحمّل منتجاً واحداً في كل مرة.
  • يُستخدم الرمز لذلك الطلب الواحد ثم يُمسح.
  • الرابط هو رابط المتجر العام من Shopify، بما فيه نطاقك المخصص إذا وفره Shopify.
  • يُملأ السعر فقط عندما تتساوى أسعار جميع الخيارات، وإلا يبقى فارغاً. لا تضف سعراً إلا إذا كان دقيقاً.
  • هذه لقطة ثابتة. لا تتحدث الأسعار والمخزون تلقائياً، لذا راجعها عندما يتغير متجرك.
  • لا يمكن استيراد المنتجات غير المتوفرة أو التي ليس لها رابط Online Store عام.
  • يمكنك دائماً إدخال المنتج يدوياً بدلاً من ذلك.

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

احصل على تنبيه عند الشراء

لم يُفعّل بعد. تحتاج تنبيهات الشراء إلى مستقبِل Shopify على خادم SSN، ويظل معطلاً حتى يجتاز اختبار متجر حقيقي. وحتى ذلك الحين، حفظ الإعداد (Save setup) يعرض خطأ. يظل عرض المنتجات يعمل.
  1. في Shopify، انتقل إلى الإعدادات → الإشعارات → خطافات الويب (Settings → Notifications → Webhooks). ابحث عن webhook سر التوقيع. (هذا ليس رمز Storefront.)
  2. في Social Stream Ninja، افتح تحقيق الدخل → مشتريات Shopify → الإعداد (Monetization → Shopify purchases → Setup).
  3. أدخل myshopify.com وسر التوقيع.
  4. فعّل مشتريات Shopify وانقر حفظ الإعداد (Save setup).
  5. انقر على نسخ رابط الاستقبال (Copy receiver URL).
  6. في Shopify، أنشئ webhook. الحدث: دفع الطلب (Order payment). التنسيق: JSON. العنوان: عنوان المستقبِل.
  7. اختر إصدار API مستقراً واحفظ. (بُني SSN على إصدار 2026-07.)
  8. أبقِ Social Stream Ninja قيد التشغيل.
إعداد Shopify في SSApp مع نطاق المتجر وحقل سر التوقيع الممسوح ورابط الاستقبال والحالة
إعداد Shopify داخل التطبيق باستخدام متجر مثالي. انقر للتكبير.
هل يعمل؟ راقب سطر الحالة: انتظار أو استلام اختبار أو تجاهل حدث أو استلام شراء. وجود عنوان مستقبِل يعني حفظ الإعداد فقط.
أريد أن…افعل هذا
إيقاف التنبيهات مؤقتاًعطّل مشتريات Shopify.
التوقف نهائياً أو تبديل المتجرانقر على قطع اتصال Shopify (يحذف المستقبِل والأحداث المنتظرة). احذف webhook من Shopify أيضاً.
أين يُحفظ سرك
  • يُحفظ سر التوقيع مشفراً في مستقبِل SSN. يُفرغ الحقل بعد الحفظ.
  • يبقى مفتاح قراءة خاص منفصل على هذا الحاسوب.
  • لا يُدرج أي منهما أبداً في روابط OBS أو رموز QR للمشاهدين.
  • يتحقق المستقبِل من توقيع Shopify واسم متجرك قبل قبول الطلب.
  • لدى Shopify مستقبِل خاص به، لذا لا تحتاج إلى مفتاح Remote API Control القديم.

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

أضفه إلى OBS

  1. ضمن تراكب OBS لـ، اختر روابط المنتجات والدعم (Products & support links).
  2. افتح خيارات رابط التراكب واختر عرض التراكب: عرض المنتجات فقط (صور وأسعار ورموز QR)، بطاقة الدعم فقط (رابط متجر صغير)، أو تنبيهات النشاط فقط (مشتريات).
  3. انقر على نسخ رابط OBS. أضفه إلى OBS بوصفه مصدر المتصفح، بدءاً من 800 × 600. استخدم مصدراً لكل عرض.
  4. امسح رمز QR بهاتفك بالحجم النهائي الذي سيظهر في البث.
تنبيه شراء Shopify يعرض Anonymous buyer وعنوان المنتج العام
تنبيه شراء. يبقى اسم المشتري خاصاً.
أريد أن…افعل هذا
مشاركة رابط منتج في الدردشةانقر على نسخ الرابط العام (Copy public link) بجوار المنتج.
عرض تنبيهات Shopify فقط في تراكب Monetizationاضبط مرشح مصدر التنبيه إلى shopify. يجب تشغيل Products & support links.
عرض المشتريات في التنبيهات المتعددة أو موجز النشاطلا يلزم شيء إضافي. تستقبل مشتريات Shopify حتى دون قائمة المنتجات.
لماذا لا تظهر صورة في تنبيهات الشراء؟ لا تحتوي طلبات Shopify على صورة موثوقة، لذا فالتنبيهات نصية فقط. لا تستعير صورة بطاقة منتج أو رمز QR منها.
تدفق الأحداث وأهداف التبرعات
  • في Event Flow، اختر Event Type purchase وصفِّ المصدر أو النوع إلى shopify.
  • لقواعد قيمة الطلب، قارن meta.commerce.orderTotal. تحقق meta.commerce.currency أولاً.
  • المشتريات ليست تبرعات. ليس لها hasDonation أو donoValue، ولا ترتفع أهداف التبرعات.
  • وضع تسمية Gift على بطاقة منتج لا يغير طريقة احتساب الطلبات. الشحن لشخص آخر لا يجعله هدية لك.

الاختبار بأمان

انقر على معاينة نموذج (Preview sample) لمشاهدة المظهر. المعاينة غير متصلة بجلستك، لذا لا تشغّل Event Flow ولا تغير الإجماليات ولا تتحقق من الدفع. للاختبار الكامل، استخدم متجر تطوير Shopify. الطلبات الموسومة test: true تظهر في الحالة فقط دون تنبيهات.

انتبه لعينات لوحة إدارة Shopify. إذا لم تكن العينة موسومة بوضوح كاختبار، فلا ترسلها إلى إعداد يوزع مكافآت.
ما اختُبر دون متجر حقيقي

تغطي الاختبارات داخل التطبيق الحقيقي الرسائل الموقّعة بما فيها النصوص غير الإنجليزية، والتواقيع المعدلة، والتسليم المكرر، والطلبات التجريبية، وتقريب العملات، والطلبات الكبيرة، وإزالة بيانات العملاء الخاصة، واستدراك الطلبات بعد انقطاع الاتصال. لم تُستخدم طلبات حقيقية أو حساب تاجر.

يمكن لعينات webhook في Shopify CLI اختبار معالجة الرسائل، لكن لا تختبر الاشتراكات أو إعادة المحاولة، وما زالت تحتاج بيانات اعتماد التطبيق. راجع قيود اختبار خطافات الويب في Shopify CLI.

حل المشكلات

المشكلةجرّب هذا
يظهر خطأ عند حفظ الإعدادالمستقبِل غير مفعّل على الخادم بعد. لا تستخدم عنوان webhook القديم للجلسة بديلاً.
الحالة تبقى قيد الانتظارتحقق من webhook: دفع الطلب (Order payment), JSON، وعنوان المستقبِل المطابق تماماً، myshopify.com والسر. تستخدم webhooks للتطبيقات المخصصة سر التطبيق نفسه.
تم تجاهل الحدثفقط الطلبات المدفوعة بالكامل بقيمة أعلى من الصفر والموسومة test: false، والمحدّثة خلال آخر 7 أيام فقط. تُتجاهل الطلبات غير المدفوعة والمدفوعة جزئياً والملغاة.
كان SSN مغلقاً أثناء البيعتنتظر الطلبات حتى 7 أيام. شغّل SSN لتصل.
نُفذ إجراء مرتينتُمنع التكرارات لمدة 7 أيام، لكن تعطل البرنامج أثناء إجراء قد يكرره. أضف فحصك الخاص للأتمتة المهمة.
لا يظهر اسم المشتريهذا مقصود. لا تظهر الأسماء أو رسائل البريد أو العناوين أو الملاحظات أو الحقول المخصصة أو روابط الدفع أو معرّفات الطلبات.
رد المبلغ لم يزل التنبيهرد المبالغ والإلغاء والتعديل لا تلغي التنبيهات. هذا ليس نظام محاسبة.
كيفية عمل الطلبات المنتظرة والمكررة
  • يمكن أن تكون أوقات الطلبات في المستقبل بما يصل إلى خمس دقائق بسبب اختلاف الساعات.
  • لا يُستنتج الدفع من إنشاء الطلب أو الشحن أو تغير المخزون. تُتجاهل الطلبات التي تفتقد علامة الاختبار.
  • تبقى الحالة والطلبات المنتظرة بعد إعادة تشغيل المستقبِل.
  • التخزين محدود. إذا تعذر على المستقبِل حفظ طلب بأمان، يطلب من Shopify إعادة إرساله لاحقاً.
  • تُطابق التكرارات بحسب المتجر والطلب، حتى لو اختلفت معرّفات التسليم في Shopify.
  • يحفظ SSN الطلبات التي عالجها قبل تأكيد استلامها.

راجع تفاصيل أحداث Shopify و دليل المنتجات ورموز QR.