تكامل Stripe

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

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

Stripe هي منصة دفع تتيح لك قبول المدفوعات وإدارة الاشتراكات. يتيح لك تكامل Stripe مع Pushwoosh تتبع المدفوعات والاشتراكات في الحملات، وتحليل الإيرادات حسب الرحلة والمنتج، وتقسيم المستخدمين حسب أحداث الدفع، واستخدام 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_uuids في البيانات الوصفية

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تقسيم جمهورك

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

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

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

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

ربط Stripe بـ Pushwoosh

1. افتح أي تطبيق Pushwoosh (حساب Stripe مرتبط بحسابك بالكامل، وليس بتطبيق معين) وانتقل إلى الإعدادات → تكاملات الجهات الخارجية.
2. ابحث عن بطاقة Stripe وانقر على زر صفحة تسجيل الدخول.

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

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

فصل التكامل

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

1. اذهب إلى الإعدادات → تكاملات الجهات الخارجية.
2. ابحث عن بطاقة Stripe وانقر على زر الإعدادات.
3. في النافذة المنبثقة، انقر على زر فصل الاتصال.

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

1. قم بتسجيل الدخول إلى لوحة تحكم Stripe.
2. اذهب إلى الإعدادات → الفريق والأمان → التطبيقات المثبتة.
3. ابحث عن التطبيق في قسم ملحقات الاتصال.

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

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

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

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

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

الحقل	الوصف	مطلوب	مثال
journey_uuids	معرفات الحملة (الرحلة) مفصولة بفواصل منقوطة	لا	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 بيانات الحملة أو الرحلة، لذا قم بتمريرها عند إنشاء جلسة Checkout إذا كنت تريد إسناد الإيرادات إلى رحلة.

• 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"

عرض البيانات

بعد التكامل الناجح، تظهر لوحة تحكم جديدة نظرة عامة على التمويل في قسم لوحات التحكم. هناك يمكنك عرض إحصاءات إجمالي الإيرادات والاشتراكات الجديدة مقسمة حسب الحملات (الرحلة).

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

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

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

1. افتح الجمهور → الشرائح.
2. انقر على إنشاء شريحة → بناء شريحة.
3. في إضافة مرشح حسب، انقر على حدث.
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 القيام به

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

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

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