تكامل Stripe

تحتاج إلى مساعدة فريق التطوير

ستحتاج إلى مساعدة من فريق التطوير لتمرير البيانات الوصفية (journey، المستخدم، الجهاز) عند إنشاء جلسات Stripe Checkout. شارك هذا الدليل معهم.

Stripe هي منصة دفع تتيح لك قبول المدفوعات وإدارة الاشتراكات. يتيح لك تكامل Stripe مع Pushwoosh تتبع المدفوعات والاشتراكات في الحملات، وتحليل الإيرادات حسب كل journey والمنتج، وتقسيم المستخدمين حسب أحداث الدفع، واستخدام ManyMoney AI للحصول على رؤى حول الإيرادات.

نظرة عامة على التكامل

نوع التكامل

المصدر: يتم إرسال أحداث الدفع والاشتراك من Stripe إلى Pushwoosh.

المتطلبات الأساسية

لإعداد تكامل Stripe مع Pushwoosh، تأكد مما يلي:

• لديك حساب Pushwoosh نشط.
• لديك حساب Stripe.

مسرد المصطلحات (ربط أسماء الكيانات إذا كانت مختلفة)

يوضح الجدول أدناه كيفية ربط كيانات Stripe بـ Pushwoosh. يتم تحقيق هذا الربط عن طريق تمرير الحقول المقابلة كبيانات وصفية عند إنشاء جلسة Checkout (انظر تكوين البيانات الوصفية).

Stripe	Pushwoosh
العميل	user_id (مطلوب)، device_id (اختياري) في البيانات الوصفية
الدفع / الرسوم	حدث StripePaymentSucceeded (charge.succeeded)
الفاتورة (مدفوعة)	حدث StripeInvoicePaid (invoice.paid)
الاشتراك	StripeSubscriptionCreated + السمات في StripeInvoicePaid
المنتج / السعر	product_id، product_name في البيانات الوصفية وسمات الحدث
الحملة (journey)	journey_uuids في البيانات الوصفية

الكيانات المتزامنة

• أحداث الدفع (المدفوعات لمرة واحدة، فواتير الاشتراك)
• أحداث الاشتراك (تم إنشاء الاشتراك، تم دفع فاتورة الاشتراك)

كيف يعمل التكامل؟

بعد ربط حساب Stripe الخاص بك بـ Pushwoosh عبر Stripe Connect، يتلقى Pushwoosh بيانات الدفع والاشتراك من Stripe. يمكنك ربط كل معاملة بحملة ومستخدم أو جهاز عن طريق تمرير البيانات الوصفية عند إنشاء جلسة Checkout (انظر تكوين البيانات الوصفية).

ينشئ Pushwoosh أحداثًا يمكنك استخدامها في التقسيم والتحليلات.

تدفق البيانات

1. تقوم بربط حساب Stripe الخاص بك بـ Pushwoosh مرة واحدة عبر Stripe Connect في Settings → 3rd-party integrations.
2. عند إنشاء جلسة Checkout، تقوم بتمرير البيانات الوصفية حتى يمكن إسناد الدفعة لاحقًا (انظر تكوين البيانات الوصفية).
3. عند حدوث حدث دفع أو اشتراك في Stripe (على سبيل المثال charge.succeeded لمرة واحدة، invoice.paid للاشتراك)، يرسل Stripe البيانات إلى Pushwoosh.
4. ينشئ Pushwoosh الأحداث المقابلة ويستخدم البيانات الوصفية للإسناد. تظهر هذه البيانات في Finance Overview، و Audience → Events، و ManyMoney.

حالات الاستخدام

تتبع المدفوعات

استقبل تلقائيًا معلومات حول جميع المدفوعات والاشتراكات الناجحة.

ربط المدفوعات بالحملات

اربط المعاملات بـ customer journeys محددة عن طريق تمرير البيانات الوصفية (انظر تكوين البيانات الوصفية).

تحليل الإيرادات

عرض الدخل حسب الحملات والمنتجات والمستخدمين والأجهزة.

تقسيم جمهورك

أنشئ شرائح بناءً على أحداث الدفع.

تحليلات الذكاء الاصطناعي

يتلقى مساعد ManyMoney AI تلقائيًا إحصائيات الدفع والاشتراك ويمكنه اتخاذ قرارات بناءً على هذه البيانات.

إعداد التكامل

ربط Stripe بـ Pushwoosh

1. افتح أي تطبيق Pushwoosh (حساب Stripe مرتبط بحسابك بالكامل، وليس بتطبيق معين) وانتقل إلى Settings → 3rd-party integrations.
2. ابحث عن بطاقة Stripe وانقر على زر LOGIN PAGE.

3. سيتم إعادة توجيهك إلى صفحة تفويض Stripe.

4. في صفحة Stripe، أدخل بريدك الإلكتروني وانقر على Continue.
5. قم بتسجيل الدخول إلى حساب Stripe الخاص بك (أو أنشئ حسابًا جديدًا). إذا كان لديك حسابات متعددة، فحدد الحساب الذي تريد ربطه.
6. انقر على Connect للتأكيد.
7. بعد التفويض الناجح، سيتم إعادة توجيهك مرة أخرى إلى Pushwoosh. ستتغير حالة التكامل إلى Connected.

فصل التكامل

الطريقة 1. عبر Pushwoosh

1. اذهب إلى Settings → 3rd-party integrations.
2. ابحث عن بطاقة Stripe وانقر على زر SETTINGS.
3. في النافذة المنبثقة، انقر على زر Disconnect.

الطريقة 2. عبر لوحة تحكم Stripe

1. قم بتسجيل الدخول إلى Stripe Dashboard.
2. اذهب إلى Settings → Team and security → Installed apps.
3. ابحث عن التطبيق في قسم Connect Extensions.

عندما تقوم بالفصل من خلال Stripe، يتلقى Pushwoosh إشعارًا تلقائيًا ويزيل التكامل.

تكوين البيانات الوصفية

يرسل Stripe أحداث الدفع إلى Pushwoosh، ولكن بدون بيانات إضافية لا يمكن لـ Pushwoosh معرفة إلى أي حملة أو أي مستخدم تنتمي الدفعة. عندما تقوم بتمرير البيانات الوصفية عند إنشاء جلسة Checkout (معرفات الحملة، معرف المستخدم أو الجهاز، المنتج)، يتم إسناد كل دفعة إلى الـ journey والمستخدم الصحيحين.

بعد ذلك، سترى الإيرادات حسب الحملة في Finance Overview، وتبني شرائح حسب الدافعين، وتستخدم ManyMoney مع الإسناد الصحيح.

حقول البيانات الوصفية المتاحة

الحقل	الوصف	مطلوب	مثال
journey_uuids	معرفات الحملة (journey) مفصولة بفواصل منقوطة	لا	bfab4bc0-b0a5-414b-befc-4aaddc429b0e;a2bff710-6b49-44d1-96a7-3232feeca6e9
user_id	معرف المستخدم. مطلوب لجمع الأحداث ولكي يتم تطبيق device_id	نعم	user_12345 أو email@example.com
device_id	معرف الجهاز (HWID).	لا	hwid_abc123
product_id	معرف المنتج	لا	prod_premium
product_name	اسم المنتج	لا	Premium Plan

هام

• بدون user_id، لا يتم جمع الأحداث ويتم تجاهل device_id. للحصول على تحليلات شاملة، قم أيضًا بتوفير journey_uuids و device_id.

• journey_uuids اختياري ولا يمكن تعيينه إلا عبر البيانات الوصفية. لا يوفر Stripe بيانات الحملة أو الـ journey، لذا قم بتمريرها عند إنشاء جلسة Checkout إذا كنت تريد إسناد الإيرادات إلى journey.

• product_id و product_name اختياريان. يستخدم Pushwoosh البيانات الوصفية أولاً. إذا كان أي منهما مفقودًا في البيانات الوصفية، يتم أخذه من Stripe عند توفره. إذا لم يكن لدى أي من المصدرين قيمة، فلن يتم تخزين الحقل.

تمرير البيانات الوصفية عبر جلسة Checkout

يتم تمرير البيانات الوصفية عند إنشاء جلسة Checkout اعتمادًا على نوع الدفع:

نوع الدفع	المعلمة	حدث Stripe
دفعة لمرة واحدة (mode=payment)	payment_intent_data[metadata]	charge.succeeded
اشتراك (mode=subscription)	subscription_data[metadata]	invoice.paid

أولوية البيانات الوصفية أثناء المعالجة

للاشتراكات (حدث invoice.paid):

Invoice metadata → if empty → Subscription metadata

للمدفوعات لمرة واحدة (حدث charge.succeeded):

Charge metadata (from payment_intent_data)

إنشاء جلسة دفع عبر Stripe API (curl)

دفعة لمرة واحدة (mode=payment)

curl https://api.stripe.com/v1/checkout/sessions \
  -u sk_live_YOUR_SECRET_KEY: \
  -d "mode=payment" \
  -d "success_url=https://example.com/success" \
  -d "cancel_url=https://example.com/cancel" \
  -d "line_items[0][price]=price_1234567890" \
  -d "line_items[0][quantity]=1" \
  -d "payment_intent_data[metadata][journey_uuids]=bfab4bc0-b0a5-414b-befc-4aaddc429b0e" \
  -d "payment_intent_data[metadata][user_id]=user_12345" \
  -d "payment_intent_data[metadata][device_id]=hwid_abc123" \
  -d "payment_intent_data[metadata][product_id]=prod_premium" \
  -d "payment_intent_data[metadata][product_name]=Premium Plan"

اشتراك (mode=subscription)

curl https://api.stripe.com/v1/checkout/sessions \
  -u sk_live_YOUR_SECRET_KEY: \
  -d "mode=subscription" \
  -d "success_url=https://example.com/success" \
  -d "cancel_url=https://example.com/cancel" \
  -d "line_items[0][price]=price_monthly_premium" \
  -d "line_items[0][quantity]=1" \
  -d "subscription_data[metadata][journey_uuids]=bfab4bc0-b0a5-414b-befc-4aaddc429b0e" \
  -d "subscription_data[metadata][user_id]=user_12345" \
  -d "subscription_data[metadata][device_id]=hwid_abc123" \
  -d "subscription_data[metadata][product_name]=Monthly Premium"

عرض البيانات

بعد التكامل الناجح، تظهر لوحة تحكم Finance Overview جديدة في قسم Dashboards. هناك يمكنك عرض إحصائيات Gross Revenue و New Subscriptions مقسمة حسب الحملات (journey).

لمزيد من المعلومات التفصيلية، قم بزيارة لوحة تحكم Stripe الخاصة بك.

إنشاء شرائح بناءً على المدفوعات

استخدم أحداث Stripe لإنشاء شرائح المستخدمين:

1. افتح Audience → Segments.
2. انقر على Create Segment → Build Segment.
3. في Add filter by، انقر على Event.
4. حدد حدث Stripe من القائمة المنسدلة (انظر الجدول أدناه للأحداث المتاحة).

ملاحظة

تظهر أحداث Stripe في القائمة بعد توصيل التكامل وتلقي بيانات الدفع.

5. قم بتعيين الشرط: كم مرة وقع الحدث والإطار الزمني (على سبيل المثال، خلال آخر 30 يومًا، بين تواريخ).
6. اختياريًا، قم بتضييق الشريحة حسب سمات الحدث. يسرد الجدول أدناه السمات المتاحة لكل حدث.

الحدث	الوصف	السمات
StripePaymentSucceeded	دفعة ناجحة	__amount, __currency, invoice_id, journey_uuids, product_id, product_name, stripe_customer_id, subscription_id
StripeInvoicePaid	تم دفع فاتورة الاشتراك	__amount, __currency, journey_uuids, product_id, product_name, stripe_customer_id, transaction_id, transaction_type
StripeSubscriptionCreated	تم إنشاء الاشتراك	__amount, __currency, interval, journey_uuids, product_id, product_name, status, stripe_customer_id, subscription_id

7. لإضافة المزيد من الأحداث، أضف مرشح حدث آخر واختر عامل تشغيل (AND أو OR) بين الشروط.

تعرف على المزيد حول إنشاء الشرائح.

مساعد ManyMoney AI

بعد التكامل الناجح مع Stripe، يحصل مساعد الذكاء الاصطناعي ManyMoney تلقائيًا على إمكانية الوصول إلى إحصائيات الدفع والاشتراك.

ManyMoney متاح في واجهة لوحة التحكم. بعد توصيل Stripe، تتوفر بيانات الدفع للتحليل تلقائيًا. لا يلزم تكوين إضافي.

ما الذي يمكن لـ ManyMoney فعله

• تحليل الإيرادات: يجيب على الأسئلة حول الدخل والتحويلات وفعالية الحملة.
• مقارنة الفترات: يعرض ديناميكيات الدفع والاشتراك عبر فترات زمنية مختلفة.
• تحديد الاتجاهات: يكتشف المنتجات وشرائح الجمهور المتنامية والمتراجعة.
• تقديم توصيات: يقترح تحسينات بناءً على بيانات الدفع.

أمثلة على الأوامر

• ما هي الإيرادات التي حققتها الحملة الشهر الماضي؟
• قارن معدلات تحويل الاشتراك بين يناير وفبراير
• أظهر إحصائيات استرداد الأموال