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

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

ইন্টিগ্রেশন সেট আপ করার জন্য আপনার ডেভেলপমেন্ট টিমের সাহায্যের প্রয়োজন হবে। অনুগ্রহ করে এই গাইডটি তাদের সাথে শেয়ার করুন।

RevenueCat একটি সাবস্ক্রিপশন ম্যানেজমেন্ট প্ল্যাটফর্ম যা iOS, অ্যান্ড্রয়েড এবং ওয়েব প্ল্যাটফর্ম জুড়ে ব্যবসার জন্য ইন-অ্যাপ পারচেজ এবং সাবস্ক্রিপশন সহজ করে। এটি ইন-অ্যাপ সাবস্ক্রিপশন তৈরি, বিশ্লেষণ এবং উন্নত করার জন্য ব্যাপক টুল সরবরাহ করে।

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

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

ব্যক্তিগতকৃত যোগাযোগ

ব্যবসাগুলি ক্লায়েন্টদের সাথে যোগাযোগ ব্যক্তিগতকৃত করতে ইন্টিগ্রেশন ব্যবহার করতে পারে। উদাহরণস্বরূপ, একটি ই-লার্নিং প্ল্যাটফর্ম সাবস্ক্রিপশন প্ল্যান পরিবর্তনের সময় ব্যক্তিগতকৃত পুশ নোটিফিকেশন পাঠিয়ে ব্যবহারকারীর এনগেজমেন্ট বাড়াতে পারে। এই নোটিফিকেশনগুলি পরিবর্তনের জন্য নির্দেশিকা, নতুন প্ল্যানের উপর ভিত্তি করে প্রাসঙ্গিক কোর্সের সুপারিশ এবং আপডেটের সাথে সামঞ্জস্যপূর্ণ বিশেষ সুবিধা প্রদান করে।

বিলিং সংক্রান্ত সমস্যার নোটিফিকেশন

যখন কোনও ব্যবহারকারীর সাবস্ক্রিপশনে বিলিং সংক্রান্ত সমস্যা দেখা দেয়, তখন ব্যবসাগুলি Pushwoosh-এর সাথে RevenueCat ইন্টিগ্রেশন ব্যবহার করে দ্রুত টার্গেটেড নোটিফিকেশন পাঠাতে পারে। উদাহরণস্বরূপ, একটি স্ট্রিমিং পরিষেবা ব্যবহারকারীকে বিলিং সমস্যা সম্পর্কে অবহিত করতে পারে এবং এটি সমাধানের জন্য নির্দেশাবলী প্রদান করতে পারে, যেমন পেমেন্ট তথ্য আপডেট করা।

নন-রিনিউইং পারচেজের নোটিফিকেশন

ব্যবসাগুলি এককালীন পারচেজকে দীর্ঘস্থায়ী গ্রাহক সম্পর্কে পরিণত করতে Pushwoosh-এর সাথে RevenueCat ইন্টিগ্রেশন ব্যবহার করতে পারে। উদাহরণস্বরূপ, একটি খাবার ডেলিভারি পরিষেবা পারচেজের পরে একটি পুশ নোটিফিকেশন পাঠিয়ে গ্রাহককে ধন্যবাদ জানাতে পারে এবং প্রাসঙ্গিক পণ্য সুপারিশ করতে পারে বা অবিচ্ছিন্ন সুবিধার জন্য একটি সাবস্ক্রিপশন প্ল্যান প্রচার করতে পারে। এটি গ্রাহকের আনুগত্য বাড়াবে, আপসেল সুযোগ তৈরি করবে এবং সম্ভাব্যভাবে এককালীন ক্রেতাদের সাবস্ক্রাইবারে পরিণত করবে।

টিয়ার আপগ্রেড প্রোমোশন

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

ইভেন্ট

RevenueCat-এর পাঠানো প্রতিটি ওয়েবহুক একটি Pushwoosh ইভেন্টে পরিণত হয়, যার নাম RC_ এবং তার পরে RevenueCat ইভেন্টের ধরণ, যেমন RC_INITIAL_PURCHASE, RC_RENEWAL, RC_CANCELLATION, RC_BILLING_ISSUE, বা RC_EXPIRATION। কোনো ধরণের প্রথম ওয়েবহুক এলে Pushwoosh ইভেন্টটি তৈরি করে, তাই নতুন RevenueCat ইভেন্টের ধরণগুলি আপনার অ্যাপে নিজে থেকেই দেখা যায়। সম্পূর্ণ তালিকার জন্য RevenueCat ডকুমেন্টেশনে ইভেন্টের ধরণ দেখুন।

প্রতিটি ইভেন্ট RevenueCat ওয়েবহুকের ফিল্ডগুলিকে ইভেন্ট অ্যাট্রিবিউট হিসাবে বহন করে, যেমন price, price_in_purchased_currency, currency, product_id, store, period_type, environment, country_code, এবং entitlement_ids:

• যে ফিল্ডগুলিতে সময় মিলিসেকেন্ডে থাকে, সেগুলি _ms প্রত্যয় ছাড়া তারিখে পরিণত হয়, যেমন purchased_at এবং expiration_at। ওয়েবহুক পাঠানোর তারিখ হলো timestamp অ্যাট্রিবিউট।
• এই তারিখগুলি UTC-তে এবং YYYY-MM-DD ফরম্যাটে থাকে, দিনের সময় ছাড়া।
• RevenueCat-এ আপনার সেট করা কাস্টমার অ্যাট্রিবিউট-গুলিও ইভেন্ট অ্যাট্রিবিউটে পরিণত হয়। যে অ্যাট্রিবিউটগুলি কোনো ব্যক্তি বা ডিভাইসকে শনাক্ত করে, যেমন ইমেইল, ফোন নম্বর, ডিসপ্লে নাম, IP ঠিকানা, বিজ্ঞাপন ID এবং পুশ টোকেন, সেগুলি Pushwoosh-এ পাঠানো হয় না।
• একটি ইভেন্টে সর্বোচ্চ 100টি অ্যাট্রিবিউট রাখা হয়।

App Store, Google Play, Mac App Store এবং Amazon থেকে করা পারচেজ iOS, Android, macOS এবং Amazon প্ল্যাটফর্মে রেকর্ড করা হয়। অন্যান্য স্টোর, যেমন Stripe, RevenueCat Billing বা প্রমোশনাল গ্রান্ট থেকে করা পারচেজ কোনো প্ল্যাটফর্ম ছাড়াই রেকর্ড করা হয়।

আপনি আপনার কাস্টমার জার্নিতে এই ইভেন্টগুলি ব্যবহার করতে পারেন। price অ্যাট্রিবিউট সহ ইভেন্টগুলি RFM সেগমেন্টেশন এর সাথে ব্যবহার করা যেতে পারে।

টিপ

আপনি RC_INITIAL_PURCHASE, RC_RENEWAL, বা RC_NON_RENEWING_PURCHASE এর মতো ইভেন্টগুলির জন্য (তাদের price এবং currency অ্যাট্রিবিউট ব্যবহার করে) রূপান্তর ইভেন্ট হিসাবে আয়ও ট্র্যাক করতে পারেন। RC_CANCELLATION বা RC_EXPIRATION এর জন্য আয় ট্র্যাক করা থেকে বিরত থাকুন। রূপান্তর ইভেন্টগুলি রিফান্ড বা রিভার্সাল সমর্থন করে না, তাই সেগুলি আয় হিসাবে গণনা করা থাকবে।

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

ইন্টিগ্রেশনটি RevenueCat ওয়েবহুকের মাধ্যমে কাজ করে, যা RevenueCat-এর Pro প্ল্যানে পাওয়া যায়।

RevenueCat কাস্টমারদের Pushwoosh ব্যবহারকারীদের সাথে মেলান

Pushwoosh একটি ওয়েবহুক সেই Pushwoosh ব্যবহারকারীর জন্য রেকর্ড করে যার নাম ওয়েবহুকে দেওয়া থাকে, এবং যে ওয়েবহুকে কোনো ব্যবহারকারীর নাম নেই তা এড়িয়ে যায়। RevenueCat কীভাবে ব্যবহারকারীকে চিহ্নিত করবে তা বেছে নিন:

• যদি আপনার অ্যাপ নিজস্ব ID দিয়ে ব্যবহারকারীদের শনাক্ত করে এবং তা RevenueCat-এ App User ID হিসাবে পাঠায়, তাহলে App User ID-কে Pushwoosh User ID হিসাবে ব্যবহার করুন।
• যদি App User ID, Pushwoosh User ID থেকে আলাদা হয়, যেমন যখন RevenueCat $RCAnonymousID:… এর মতো বেনামী ID ব্যবহার করে, তাহলে Pushwoosh ID-গুলি RevenueCat অ্যাট্রিবিউট হিসাবে পাঠান। এগুলি ছাড়া, ইভেন্টগুলি এমন একটি User ID-তে যায় যা Pushwoosh-এ নেই।

RevenueCat App User ID-কে Pushwoosh User ID হিসাবে ব্যবহার করুন

RevenueCat-এ আপনি যে App User ID পাঠান, সেটিকে Pushwoosh User ID (setUserId) হিসাবে সেট করুন।

Android

Java

Pushwoosh.getInstance().setUserId(appUserID);

iOS

Swift

Pushwoosh.configure.setUserId(appUserID)

Pushwoosh ID-গুলি RevenueCat অ্যাট্রিবিউট হিসাবে পাঠান

RevenueCat-এ pushwooshUserId এবং pushwooshHwid অ্যাট্রিবিউট সেট করুন। Pushwoosh App User ID-এর পরিবর্তে এগুলি ব্যবহার করে:

• pushwooshUserId: কাস্টমারের Pushwoosh User ID।
• pushwooshHwid: কাস্টমারের ডিভাইসের Pushwoosh হার্ডওয়্যার ID (HWID)। এটি ঐচ্ছিক। এটি ছাড়া, Pushwoosh User ID-কে HWID হিসাবে ব্যবহার করে।

Android

Kotlin

Purchases.sharedInstance.setAttributes(mapOf(
    "pushwooshUserId" to pushwooshUserId,
    "pushwooshHwid" to Pushwoosh.getInstance().hwid
))

iOS

Swift

Purchases.shared.attribution.setAttributes([
    "pushwooshUserId": pushwooshUserId,
    "pushwooshHwid": Pushwoosh.configure.getHWID()
])

RevenueCat ওয়েবহুক Pushwoosh-এ পাঠান

আপনার RevenueCat ড্যাশবোর্ডে:

1. আপনার প্রজেক্ট খুলুন, বাম মেনুতে Integrations কার্ডটি খুঁজুন এবং + New এ ক্লিক করুন।

2. Webhooks বেছে নিন।

3. যদি RevenueCat আপনার ওয়েবহুকের তালিকা দেখায়, তাহলে Add new configuration এ ক্লিক করুন।
4. ইন্টিগ্রেশনটিকে একটি সহজবোধ্য নাম দিন, যেমন Pushwoosh, যাতে সহজে সনাক্ত করা যায়।
5. ওয়েবহুক URL হিসাবে নিম্নলিখিত URLটি প্রবেশ করান:

https://integration-revenuecat.svc-nue.pushwoosh.com/integration-revenuecat/v1/post-event?pwapp=APP_CODE

URL-এ, APP_CODE কে আপনার বিদ্যমান Pushwoosh অ্যাপ্লিকেশন কোড দিয়ে প্রতিস্থাপন করুন যা আপনার Pushwoosh অ্যাকাউন্টে আপনার অ্যাপ্লিকেশনের নামের নিচে অবস্থিত।

6. Authorization header value ফিল্ডে, আপনার Pushwoosh API টোকেন প্রবেশ করান। আপনি এই টোকেনটি Pushwoosh-এর Settings > API Access এর অধীনে খুঁজে পেতে পারেন।

7. আপনি প্রোডাকশন (লাইভ) পারচেজ, স্যান্ডবক্স (টেস্ট) পারচেজ, বা উভয়ের জন্য ইভেন্ট পাঠাতে চান কিনা তা নির্ধারণ করুন।
8. App ড্রপডাউনে, ওয়েবহুক ইভেন্টগুলি একটি একক অ্যাপের জন্য নাকি প্রজেক্টের সমস্ত অ্যাপের জন্য পাঠানো হবে তা নির্দিষ্ট করুন।
9. Event Type ড্রপডাউনে, সমস্ত ইভেন্ট পাঠাতে চান নাকি Pushwoosh-এ কোন ইভেন্টগুলি পাঠাতে হবে তা নির্দিষ্ট করতে চান তা নির্বাচন করুন।

10. সমস্ত ইভেন্ট, শুধুমাত্র সফল ইভেন্ট, বা শুধুমাত্র ব্যর্থ ইভেন্ট দেখানোর জন্য বেছে নিন।

সংযোগ পরীক্ষা করতে, RevenueCat থেকে একটি টেস্ট ওয়েবহুক পাঠান। সফল ডেলিভারির অর্থ হলো Pushwoosh URL এবং API টোকেন গ্রহণ করেছে। টেস্ট ওয়েবহুকটি নিজে ইভেন্ট হিসাবে রেকর্ড করা হয় না: সেই ধরণের প্রথম আসল ওয়েবহুক আসার পরে প্রতিটি RC_ ইভেন্ট আপনার Pushwoosh অ্যাপে অডিয়েন্স → ইভেন্ট এর অধীনে দেখা যায়।