Stripe ইন্টিগ্রেশন

ডেভেলপারের সহায়তা প্রয়োজন

Stripe Checkout সেশন তৈরি করার সময় মেটাডেটা (জার্নি, ব্যবহারকারী, ডিভাইস) পাস করার জন্য আপনার ডেভেলপমেন্ট টিমের সাহায্যের প্রয়োজন হবে। এই গাইডটি তাদের সাথে শেয়ার করুন।

Stripe একটি পেমেন্ট প্ল্যাটফর্ম যা আপনাকে পেমেন্ট গ্রহণ এবং সাবস্ক্রিপশন পরিচালনা করতে দেয়। Pushwoosh-এর সাথে Stripe ইন্টিগ্রেট করলে আপনি ক্যাম্পেইনে পেমেন্ট এবং সাবস্ক্রিপশন ট্র্যাক করতে, জার্নি এবং প্রোডাক্ট অনুযায়ী রাজস্ব বিশ্লেষণ করতে, পেমেন্ট ইভেন্টের মাধ্যমে ব্যবহারকারীদের সেগমেন্ট করতে এবং রাজস্বের অন্তর্দৃষ্টির জন্য ManyMoney AI ব্যবহার করতে পারবেন।

ইন্টিগ্রেশন ওভারভিউ

ইন্টিগ্রেশনের প্রকার

উৎস: পেমেন্ট এবং সাবস্ক্রিপশন ইভেন্ট Stripe থেকে Pushwoosh-এ পাঠানো হয়।

পূর্বশর্ত

Pushwoosh-এর সাথে Stripe ইন্টিগ্রেশন সেট আপ করার জন্য, নিম্নলিখিতগুলি নিশ্চিত করুন:

• আপনার একটি সক্রিয় Pushwoosh অ্যাকাউন্ট আছে।
• আপনার একটি Stripe অ্যাকাউন্ট আছে।

শব্দকোষ (এনটিটির নাম ভিন্ন হলে ম্যাপিং)

নিচের সারণীটি দেখায় কিভাবে Stripe এনটিটিগুলি Pushwoosh-এর সাথে ম্যাপ করা হয়। এই ম্যাপিংটি একটি Checkout সেশন তৈরি করার সময় সংশ্লিষ্ট ফিল্ডগুলিকে মেটাডেটা হিসাবে পাস করে অর্জন করা হয় (দেখুন মেটাডেটা কনফিগারেশন)।

Stripe	Pushwoosh
Customer	মেটাডেটাতে user_id (আবশ্যক), device_id (ঐচ্ছিক)
Payment / Charge	ইভেন্ট StripePaymentSucceeded (charge.succeeded)
Invoice (paid)	ইভেন্ট StripeInvoicePaid (invoice.paid)
Subscription	StripeSubscriptionCreated + StripeInvoicePaid-এর অ্যাট্রিবিউট
Product / Price	মেটাডেটা এবং ইভেন্ট অ্যাট্রিবিউটে product_id, product_name
Campaign (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-তে প্রদর্শিত হয়।

ব্যবহারের ক্ষেত্র

পেমেন্ট ট্র্যাক করুন

সমস্ত সফল পেমেন্ট এবং সাবস্ক্রিপশন সম্পর্কে স্বয়ংক্রিয়ভাবে তথ্য গ্রহণ করুন।

পেমেন্ট ক্যাম্পেইনের সাথে লিঙ্ক করুন

মেটাডেটা পাস করে লেনদেনগুলিকে নির্দিষ্ট কাস্টমার জার্নির সাথে যুক্ত করুন (দেখুন মেটাডেটা কনফিগারেশন)।

রাজস্ব বিশ্লেষণ করুন

ক্যাম্পেইন, প্রোডাক্ট, ব্যবহারকারী এবং ডিভাইস অনুযায়ী আয় দেখুন।

আপনার অডিয়েন্সকে সেগমেন্ট করুন

পেমেন্ট ইভেন্টের উপর ভিত্তি করে সেগমেন্ট তৈরি করুন।

AI অ্যানালিটিক্স

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-এ পরিবর্তিত হবে।

ইন্টিগ্রেশন ডিসকানেক্ট করুন

পদ্ধতি ১. Pushwoosh-এর মাধ্যমে

1. Settings → 3rd-party integrations-এ যান।
2. Stripe কার্ডটি খুঁজুন এবং SETTINGS বোতামে ক্লিক করুন।
3. পপআপ উইন্ডোতে, Disconnect বোতামে ক্লিক করুন।

পদ্ধতি ২. Stripe ড্যাশবোর্ডের মাধ্যমে

1. Stripe Dashboard-এ লগ ইন করুন।
2. Settings → Team and security → Installed apps-এ যান।
3. Connect Extensions বিভাগে অ্যাপ্লিকেশনটি খুঁজুন।

যখন আপনি Stripe-এর মাধ্যমে ডিসকানেক্ট করেন, Pushwoosh স্বয়ংক্রিয়ভাবে একটি বিজ্ঞপ্তি পায় এবং ইন্টিগ্রেশনটি সরিয়ে দেয়।

মেটাডেটা কনফিগারেশন

Stripe পেমেন্ট ইভেন্টগুলি Pushwoosh-এ পাঠায়, কিন্তু অতিরিক্ত ডেটা ছাড়া Pushwoosh বলতে পারে না যে পেমেন্টটি কোন ক্যাম্পেইন বা কোন ব্যবহারকারীর। যখন আপনি Checkout সেশন তৈরির সময় মেটাডেটা পাস করেন (ক্যাম্পেইন আইডি, ব্যবহারকারী বা ডিভাইস আইডি, প্রোডাক্ট), প্রতিটি পেমেন্ট সঠিক জার্নি এবং ব্যবহারকারীর সাথে অ্যাট্রিবিউট করা হয়।

এর ফলে আপনি Finance Overview-তে ক্যাম্পেইন অনুযায়ী রাজস্ব দেখতে পান, পেমেন্টকারীর উপর ভিত্তি করে সেগমেন্ট তৈরি করতে পারেন এবং সঠিক অ্যাট্রিবিউশন সহ 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 ইভেন্ট):

ইনভয়েস মেটাডেটা → যদি খালি থাকে → সাবস্ক্রিপশন মেটাডেটা

এককালীন পেমেন্টের জন্য (charge.succeeded ইভেন্ট):

চার্জ মেটাডেটা (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"

ডেটা দেখুন

সফল ইন্টিগ্রেশনের পর, Dashboards বিভাগে একটি নতুন Finance Overview ড্যাশবোর্ড প্রদর্শিত হবে। সেখানে আপনি ক্যাম্পেইন (জার্নি) অনুযায়ী মোট রাজস্ব এবং নতুন সাবস্ক্রিপশনের পরিসংখ্যান দেখতে পারবেন।

আরও বিস্তারিত তথ্যের জন্য, আপনার Stripe ড্যাশবোর্ড দেখুন।

পেমেন্টের উপর ভিত্তি করে সেগমেন্ট তৈরি করুন

ব্যবহারকারী সেগমেন্ট তৈরি করতে Stripe ইভেন্ট ব্যবহার করুন:

1. Audience → Segments খুলুন।
2. Create Segment → Build Segment-এ ক্লিক করুন।
3. Add filter by-এ, Event-এ ক্লিক করুন।
4. ড্রপডাউন থেকে একটি Stripe ইভেন্ট নির্বাচন করুন (উপলব্ধ ইভেন্টের জন্য নিচের সারণী দেখুন)।

নোট

ইন্টিগ্রেশন কানেক্ট হওয়ার পর এবং পেমেন্ট ডেটা পাওয়ার পর Stripe ইভেন্টগুলি তালিকায় প্রদর্শিত হয়।

5. শর্ত সেট করুন: ইভেন্টটি কতবার ঘটেছে এবং সময়সীমা (যেমন গত ৩০ দিনে, তারিখের মধ্যে)।
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. আরও ইভেন্ট যোগ করতে, আরেকটি Event ফিল্টার যোগ করুন এবং শর্তগুলির মধ্যে একটি অপারেটর (AND বা OR) বেছে নিন।

সেগমেন্ট তৈরি সম্পর্কে আরও জানুন।

ManyMoney AI অ্যাসিস্ট্যান্ট

সফল Stripe ইন্টিগ্রেশনের পর, ManyMoney AI অ্যাসিস্ট্যান্ট স্বয়ংক্রিয়ভাবে পেমেন্ট এবং সাবস্ক্রিপশন পরিসংখ্যানে অ্যাক্সেস পায়।

ManyMoney ড্যাশবোর্ড ইন্টারফেসে উপলব্ধ। আপনি Stripe কানেক্ট করার পর, পেমেন্ট ডেটা বিশ্লেষণের জন্য স্বয়ংক্রিয়ভাবে উপলব্ধ হয়। কোনো অতিরিক্ত কনফিগারেশনের প্রয়োজন নেই।

ManyMoney কী করতে পারে

• রাজস্ব বিশ্লেষণ: আয়, রূপান্তর এবং ক্যাম্পেইনের কার্যকারিতা সম্পর্কে প্রশ্নের উত্তর দেয়।
• সময়কালের তুলনা: বিভিন্ন সময়কালের মধ্যে পেমেন্ট এবং সাবস্ক্রিপশনের গতিশীলতা দেখায়।
• ট্রেন্ড শনাক্তকরণ: ক্রমবর্ধমান এবং হ্রাসমান প্রোডাক্ট এবং অডিয়েন্স সেগমেন্ট শনাক্ত করে।
• সুপারিশ প্রদান: পেমেন্ট ডেটার উপর ভিত্তি করে অপ্টিমাইজেশনের পরামর্শ দেয়।

প্রম্পট উদাহরণ

• গত মাসে ক্যাম্পেইনটি কত রাজস্ব আয় করেছে?
• জানুয়ারি এবং ফেব্রুয়ারির মধ্যে সাবস্ক্রিপশন রূপান্তর হারের তুলনা করুন
• রিফান্ডের পরিসংখ্যান দেখান