صِل متجرك. اعرض منتجاتك.

المنتجات والتنبيهات منفصلة

استخدم تحقيق الدخل (Monetization) في SSN للترويج للمنتجات العامة وصفحات الدعم، أو استقبال النشاط، أو كليهما. يغطي هذا الدليل Fourthwall وKo-fi وBuy Me a Coffee. بالنسبة إلى NinjaBacker وThrone وAmazon وeBay، راجع دليل تحقيق الدخل.

توصيل التنبيهات · Fourthwall · Ko-fi · Buy Me a Coffee · استيراد منتج · OBS ورموز QR · استكشاف المشكلات وإصلاحها

توصيل تنبيهات النشاط

1. افتح تحقيق الدخل (Monetization) ← تنبيهات Fourthwall وKo-fi وBuy Me a Coffee واختر مزوّدك.
2. انقر على إعداد المستقبِل. فعّل المفتاح الموجود التحكم في الإضافة عن بُعد عبر API ، ثم أبقِ SSN مشغّلاً.
3. عُد إلى تحقيق الدخل (Monetization) وانقر على نسخ رابط Webhook ‏(Copy webhook URL). الصق هذا العنوان الخاص في إعدادات Webhook لدى المزوّد الموضحة أدناه.
4. تحقق من حالة المستقبِل. المستقبِل متصل (Receiver connected) يعني أن SSN يستمع، وليس أنه تم التحقق من إعداد المزوّد. يتحدث سطر آخر حدث عندما يصل حدث مزوّد محلل وغير مكرر إلى هذا التطبيق قيد التشغيل؛ ويُعاد ضبطه عند إعادة التشغيل.
5. استخدم معاينة تنبيه نموذجي للتحقق من المظهر في صفحة نموذج منفصلة. لا يرسل هذا دفعة، أو يحدّث الإجماليات، أو يشغّل Event Flow، أو يتحقق من تسليم Webhook.

تعتمد نقاط النهاية الثلاث الحالية هذه، المبنية على رابط الجلسة، على إبقاء الرابط خاصاً؛ ولا يقبل إعداد SSN الحالي أسرار التوقيع الخاصة بها. وهي مناسبة لتنبيهات البث، وليست إثبات دفع لتنفيذ الطلبات. لا تنشر عنوان Webhook أو تستخدمه كوجهة QR للمشاهدين.

Fourthwall

1. في Fourthwall، افتح الإعدادات (Settings) ← للمطورين (For Developers) ← Webhooks.
2. أنشئ Webhook والصق رابط Fourthwall المنسوخ من SSN.
3. حدد الأحداث المدعومة التي تحتاجها: ORDER_PLACED, GIFT_PURCHASE, DONATION و SUBSCRIPTION_PURCHASED.
4. احفظ Webhook وأبقِ SSN قيد التشغيل.

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

توثيق Webhook في Fourthwall · معاينة شراء نموذجي

Ko-fi

1. افتح Ko-fi Webhooks.
2. الصق رابط Ko-fi المنسوخ من SSN في رابط Webhook، ثم احفظه أو حدّثه.
3. أبقِ SSN قيد التشغيل. تستخدم التبرعات العامة ومدفوعات العضوية وطلبات المتجر والأعمال المكلف بها الاتصال نفسه.

تُستبعد المدفوعات الخاصة. تظهر مدفوعات العضوية كنشاط عضوية؛ وتظهر طلبات المتجر والأعمال المكلف بها كمشتريات دون إضافتها إلى إجماليات التبرعات. لا يوفر Ko-fi إشعارات إلغاء العضوية عبر هذا الـWebhook.

الاختبار: استخدم معاينة النموذج المستقلة في SSN أولاً. قد تشبه مدفوعات Ko-fi النموذجية المدفوعات الحقيقية، ويمكنها تشغيل التنبيهات والإجماليات والإجراءات إذا أُرسلت إلى المستقبِل النشط. لا تستخدم اختبار المزوّد في جلسة فُعّلت فيها المكافآت المدفوعة.

توثيق Webhook في Ko-fi · معاينة دعم نموذجي

Buy Me a Coffee

1. افتح التكاملات (Integrations) في لوحة تحكم المبدع واختر Webhook جديد (New webhook).
2. امنحه اسماً والصق رابط SSN الخاص بـ Buy Me a Coffee كنقطة نهاية.
3. اختر donation.created, extra_purchase.created, commission_order.created, wishlist_payment.created و membership.started حسب الحاجة.
4. احفظ واترك التسليم مفعّلاً. استخدم سجل تسليم الأحداث لدى المزوّد للتحقيق في حالات الفشل.

طلبات المتجر والأعمال المكلف بها مشتريات. مدفوعات قائمة الرغبات مساهمات هدايا. بدايات العضوية إعلانات عضوية، وليست رسوماً مؤكدة منفصلة. تبقى الملاحظات المخفية مخفية، والداعمون المجهولون مجهولين. اختبارات لوحة التحكم الموسومة live_mode: false تُتخطى دون تنبيهات مدفوعة. لا تنشئ الاستردادات وتحديثات دورة الحياة مدفوعات ولا تعكس الإجماليات الحالية.

توثيق Webhook في Buy Me a Coffee · معاينة مساهمة نموذجية

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

1. في قسم Fourthwall المسمى الإعدادات (Settings) ← للمطورين (For Developers)، أنشئ رمز Storefront. استخدم رمز Storefront للوصول إلى الكتالوج العام، وليس مفتاح API إدارياً.
2. في SSN، افتح روابط المنتجات والدعم (Products & support links) ← إعداد المنتجات والروابط (Set up products and links) ← استيراد منتج Fourthwall ‏(Import a Fourthwall product).
3. الصق رابط المنتج العام والرمز، ثم انقر على تحميل تفاصيل المنتج (Load product details).
4. راجع الاسم والصورة والسعر والرابط العام المحمّلة. تأكد من انتماء الرابط إلى المتجر نفسه الخاص بالرمز، بما في ذلك أي نطاق مخصص. يحدد الرمز كتالوج المتجر الذي يُستعلم عنه.
5. اختر تسوق (Shop) أو هدية (Gift) أو دعم (Support) أو انضمام (Join) لوصف ما سيفعله المشاهدون. انقر على إضافة منتج أو رابط (Add product or link)، وفعّل روابط المنتجات والدعم (Products & support links)، ثم حفظ الإعداد (Save setup).

يستورد هذا منتجاً عاماً متاحاً واحداً في كل مرة عبر Fourthwall Storefront API. يُستخدم الرمز لذلك الطلب، ثم يُمسح ولا يُحفظ أو يُرسل إلى التراكبات. تُترك أسعار الخيارات المختلفة والحزم فارغة لتجنب الإيحاء بإجمالي دفع ثابت. الاستيراد لقطة لحظية: لا تتحدث الأسعار والمخزون والصور تلقائياً. أعد الاستيراد أو عدّلها عندما تتغير. يستوعب الكتالوج حتى 20 إدخالاً؛ وتؤدي الإضافة مجدداً إلى إنشاء إدخال آخر.

إنشاء رمز Storefront · حقول منتج Fourthwall

عرض المنتجات والروابط العامة ورموز QR

يمكنك أيضاً إدخال رابط منتج أو دعم عام يدوياً من أي موقع، بما في ذلك Shopify أو Tiltify أو Patreon. أضف رابط صورة وسعراً اختيارياً، واختر الغرض، وفعّل الكتالوج واحفظ. لا تؤدي إضافة رابط إلى توصيل تدفق مدفوعات.

1. اختر روابط المنتجات والدعم (Products & support links) ضمن رابط التراكب لـ.
2. افتح خيارات رابط التراكب. اختر عرض المنتج (Product showcase) أو بطاقة الدعم (Support card) أو تنبيهات النشاط (Activity alerts) أو العرض المدمج.
3. انقر على نسخ رابط OBS والصقه في مصدر متصفح OBS. ابدأ بحجم 800 × 600. لطبقات ترويج ونشاط منفصلة، أنشئ مصدراً لكل عرض.
4. استخدم خيارات العرض (Display options) لتثبيت المنتج الأول أو التناوب بين الإدخالات. فعّل رموز QR ليتمكن المشاهدون من مسح الوجهة العامة. استخدم نسخ الرابط العام (Copy public link) بجانب إدخال لمشاركة عنوانه القابل للنقر بنفسك في الدردشة.

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

بالنسبة إلى Multi-Alerts أو خلاصة النشاط، استخدم روابط التراكب الموجودة لهما مع جلسة SSN نفسها. لا يلزم تفعيل كتالوج المنتجات لهذه التراكبات الحالية للنشاط. يتطلب عرض نشاط تحقيق الدخل العام تفعيل الكتالوج. في Event Flow، يظل Donation مشغّلاً للصفوف التي تحتوي على hasDonation؛ استخدم نوع الحدث (Event Type) للمشتريات أو اكتمال الهدية. راجع تعيين الأحداث.

إذا لم يظهر شيء

• المستقبِل معطّل: فعّل التحكم في الإضافة عن بُعد عبر API. تخدم مفاتيح API الأخرى استخدامات مختلفة.
• غير متصل: أبقِ SSN مشغّلاً وتحقق من الوصول إلى الشبكة. هذه الحالة تخص اتصال المستقبِل المشترك، وليست حالة التسليم في لوحة تحكم المزوّد.
• لم يُستقبل حدث: تحقق من المزوّد المحدد والرابط الخاص وإعدادات التسليم لدى المزوّد. نجاح المعاينة المحلية يتحقق من المظهر فقط.
• تم تخطي الحدث: تُستبعد الاختبارات الموسومة والمدفوعات الخاصة وأنواع الأحداث غير المدعومة والمبالغ غير الصالحة. لا تُعرض تفاصيل المشترين في الحالة.
• وُصل الحدث لكن التراكب لا يظهر: تحقق من الجلسة وكلمة المرور ومرشحات المصدر وفئات الأحداث وقواعد SSN والظهور في OBS. المشتريات ليست اشتراكات؛ ومعظم المشتريات ليست تبرعات.
• التكرارات: تجنب إدخال الدفعة نفسها عبر المزوّد المباشر ومجمّع في آن واحد. تستخدم إزالة تكرار محاولات الإرسال معرّفات التسليم من المزوّد.
• فشل الاستيراد: تحقق من الاسم المختصر للمنتج ورمز Storefront، ومن كون المنتج عاماً ومتاحاً. يظل الإدخال اليدوي متاحاً.

هذا نشاط بث مباشر، وليس سجل طلبات. استخدم لوحة تحكم المزوّد لتأكيد الدفع والاستردادات وتنفيذ الطلبات. أصبح لـ Shopify إعداده الخاص لاستيراد المنتجات والطلبات المدفوعة الموقّعة. يظل نشاط حملات Tiltify وعضويات Patreon المدفوعة ضمن التكاملات المستقبلية.