المنتجات المباشرة وروابط المشاهدين

إضافة منتج في 5 خطوات

افتح تحقيق الدخل ← المنتجات وروابط الدعم ← إعداد المنتجات والروابط.
الصق رابطاً عاماً من نوع https:// وانقر تحميل التفاصيل من الرابط (Load details from link).
تحقّق من العنوان والصورة والسعر والعملة و غرض الرابط. يُترك السعر فارغاً، لذا أدخله إذا أردت عرضه.
انقر على إضافة منتج أو رابط (Add product or link).
فعّل روابط المنتجات والدعم (Products & support links) وانقر حفظ الإعداد (Save setup).

أي الروابط تُحمّل تلقائياً؟ صفحات Gumroad وitch.io وKo-fi وBuy Me a Coffee وFourthwall العامة. قد تتطلب المواقع الأخرى إدخالاً يدوياً. لا يلزم حساب متجر. يتوفر استيراد كامل لـ Shopify و Fourthwall.

تحدد خيارات تسوّق وهدية ودعم وانضمام تسمية الرابط فقط. لا تغيّر طريقة احتساب المدفوعات. البطاقات لقطات ثابتة؛ تظهر الأسعار والمخزون الفعليان عند الدفع.

التحكم بما يظهر على الشاشة

أضف محفز روابط المنتجات والدعم (Products & support links) إلى OBS (العرض والتنبيهات يعرض التنبيهات أيضاً). ثم استخدم هذه الأزرار:

الزر	ما الذي يفعله
عرض الآن (Show now) (على منتج محفوظ)	يعرض ذلك المنتج فوراً متجاهلاً الجدول.
المنتج التالي (Next product)	يعرض المنتج المحفوظ التالي.
إخفاء المنتجات (Hide products)	يخفي بطاقات المنتجات. تظل تنبيهات الشراء والهدايا ظاهرة.
استئناف الجدول (Resume schedule)	يعود إلى التدوير المحفوظ أو المنتج الأول المثبّت.

اضبط مدة العرض أو الإخفاء بالثواني أولاً. 0 = حتى تغيّره. من 1 إلى 3600 = العودة إلى الجدول بعد تلك المدة.

قائمة منتجات SSApp مع Show now وعناصر تحكم العرض المباشر — أدوات التحكم المباشر داخل التطبيق، مع منتجات تجريبية.

معلومات مفيدة

تُعاد التغييرات المباشرة إلى الوضع الافتراضي عند إعادة تشغيل SSN.
في Stream Deck، يظل المنتج المحفوظ المفقود ظاهراً على المفتاح بدلاً من التبديل بصمت.
تُعلّم المنتجات غير المحفوظة. ويظل زر عرض الآن (Show now) معطّلاً حتى تنقر حفظ الإعداد (Save setup).
تعرض الحالة المنتج المختار والثواني المتبقية. لا يمكنها معرفة ما إذا كان OBS يبث أو المصدر ظاهراً.
يتم العثور على المنتجات عبر روابطها المحفوظة المطابقة تماماً، لذا لا تؤدي إعادة ترتيب القائمة إلى تعطيل الأتمتة.

تريد أزراراً داخل OBS؟ استخدم لوحة إرساء التحكم في المنتجات في OBS. أبقِ أدوات التحكم خارج التراكب الموجّه للجمهور.

منح المشاهدين رابطاً واحداً

افتح خيارات العرض ← صفحة المشاهد العامة.
انقر على نشر الروابط المحفوظة (Publish saved links). يجعل هذا جميع منتجاتك المحفوظة عامة: العناوين والصور والأسعار والأغراض.
انقر على نسخ رابط المشاهد (Copy viewer link) وشاركه.

تشير رموز QR للمنتجات إلى هنا، ليجد المشاهدون المنتج حتى بعد خروجه من الشاشة. يحدّث الحفظ والتحكم المباشر الرابط نفسه. تتحدث الصفحة كل 15 ثانية، وتحدد المنتج المميز، وتعرض الجميع حتى عندما تكون البطاقات مخفية.

صفحة مشاهد على الهاتف تعرض منتجات مميزة ورابط دعم — تحتوي الصفحة العامة على الروابط التي اخترتها فقط. لا تتضمن معرّف الجلسة أو مفتاح التحكم.

أريد أن…	افعل هذا
إزالة الصفحة	انقر على إلغاء النشر (Unpublish). تتوقف الروابط القديمة عن العمل، وتعود رموز QR إلى الرابط الخاص بكل منتج.
استعادة الرابط نفسه	انشر مجدداً من الكمبيوتر نفسه.

احتفظ بملف تعريف SSN. يحتفظ بالمفتاح الخاص اللازم لتحديث صفحتك أو إزالتها.

عندما يكون SSN غير متصل أو يتعطل الخادم

تبقى آخر صفحة منشورة متاحة أثناء توقف SSN، مع وقت حفظها.
تعني «مميز» آخر اختيار محفوظ أو تدوير. لا تعني أنك تبث مباشرة.
إذا تعطل الخادم، تظل أدوات التحكم داخل SSN تعمل. تعاد محاولة التحديثات أثناء فتح SSN، وتعرض النافذة المنبثقة الخطأ.
يتطلب النشر خدمة المتجر العام الاختيارية على الخادم. لا يتطلب حساب متجر أو دفع.

Stream Deck وEvent Flow

Stream Deck

أضف أمر مسبق (Preset Command) من مفاتيح المنتجات والدعم (Products & support): عرض منتج أو المنتج التالي أو إخفاء المنتجات أو استئناف المنتجات.
بالنسبة إلى عرض منتج، انقر على تحديث المنتجات والحالة واختر منتجاً. أو الصق رابطه العام، أو اتركه فارغاً لاستخدام المنتج الحالي أو الأول.
بالنسبة إلى التالي و إخفاء، وأضف مدة بالثواني إن أردت.

الخيار الاختياري حالة المنتج يعرض ما هو محدد أو مخفي أو مجدول (كل 5 ثوانٍ؛ تُختصر الأسماء الطويلة). تستخدم المفاتيح اتصال P2P أو WebSocket الموجود لديك وتنتظر تأكيد SSN.

Event Flow

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

تغيّر هذه الخيارات ما يظهر فقط. لا تنشئ أبداً تبرعات أو مشتريات أو منشورات دردشة أو مشغّلات دفع.

واجهة API للتحكم عن بُعد (متقدم)

تقبل واجهة API للتحكم عن بُعد في الجلسة show, next, hide، أو resume. عناصر تحكم المضيف مفعّلاً. احذف url للمنتج الحالي أو الأول.

{"action":"commerceControl","command":"show","url":"https://example.com/product","seconds":30}

لا تشارك رابط الجلسة أو التحكم الخاص بك أبداً. أعطِ المشاهدين رابط العرض.

معرفة وقت اكتمال أمر التحكم

ترسل الأوامر فقط monetization_update حالة العرض الحالية. hasDonation دون تغيير.
ينتظر إجراء المنتجات والدعم رد SSN قبل متابعة التدفق.
في بيانات الأحداث، meta.commerceControlResult يتضمن success مع أحد الخيارين الجديدين: commerce أو الحالة error.
يوقف الفشل الإجراءات اللاحقة في تلك السلسلة. تظل عملية الشراء أو التبرع الأصلية تصل إلى التدفقات والتراكبات الأخرى.
تؤكد النتيجة اختيار SSN أو حالة الإخفاء أو الجدول. لا تؤكد أن OBS يعرضه.
عدم وصول رد خلال ثماني ثوانٍ يعني انتهاء المهلة. ربما نجح التحكم رغم ذلك؛ تحقّق من النافذة المنبثقة أو لوحة Dock قبل الضغط على التالي مجدداً.
ينبغي لعملاء التحكم الخارجيين استخدام بروتوكول الطلب والرد وفحص النتيجة، بدلاً من افتراض نجاح الأمر لمجرد إرساله.
تبلغ الإجراءات الأخرى عن نتائجها الخاصة: يوفّر إجراء طباعة ملصق حراري meta.thermalPrintResult (إرسال المهمة لا يثبت طباعتها)، ويمكن لإجراء Webhook المتزامن إعادة حالة HTTP والاستجابة، والتوقف عند الفشل. هذه نتائج إجراءات وليست أحداث دفع جديدة.

راجع مرجع الأحداث لمعرفة تنسيق النتيجة الكامل.

حل المشكلات

المشكلة	جرّب هذا
زر العرض الآن معطّل	انقر على حفظ الإعداد (Save setup) أولاً.
تراجع التغيير المباشر من تلقاء نفسه	أُعيد تشغيل SSN أو انتهت المدة بالثواني. اضبط مدة العرض أو الإخفاء بالثواني إلى `0` للاحتفاظ به.
لم يعثر تحميل التفاصيل من الرابط على شيء	أدخل التفاصيل يدوياً.
تعرض صفحة المشاهد منتجات قديمة	أبقِ SSN مفتوحاً ليتمكن من إعادة المحاولة، وافحص النافذة المنبثقة بحثاً عن خطأ.
انتهت مهلة إجراء Event Flow	ربما نجح رغم ذلك. تحقّق من النافذة المنبثقة أو لوحة Dock قبل المحاولة مجدداً.

إعداد متجر المبدع · أصوات التجارة وإجراءاتها والطباعة · مرجع الأحداث