অ্যাপ স্টোর সাবস্ক্রিপশন ট্র্যাকিং

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

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

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

App Store Server Notifications হলো অ্যাপলের একটি সার্ভার-টু-সার্ভার পরিষেবা যা সাবস্ক্রিপশনের স্ট্যাটাস পরিবর্তন হলে আপনার ব্যাকএন্ডে একটি রিয়েল-টাইম বার্তা পাঠায়।

App Store Server Notifications-কে Pushwoosh-এর সাথে সংযুক্ত করে, আপনি নিজের ব্যাকএন্ড পরিকাঠামো তৈরি না করেই বাতিলকরণের প্রতিক্রিয়া জানাতে পারেন। যখন একজন ব্যবহারকারী তাদের অ্যাপ স্টোর অ্যাকাউন্টে একটি সাবস্ক্রিপশনের জন্য অটো-রিনিউয়াল বন্ধ করে দেন, তখন অ্যাপল Pushwoosh-কে অবহিত করে, এবং Pushwoosh ম্যাচিং ব্যবহারকারী প্রোফাইলে একটি PW_SubscriptionCancel ইভেন্ট ফায়ার করে।

নোট

এই ইন্টিগ্রেশনটি বর্তমানে iOS সাবস্ক্রিপশন (App Store Server Notifications V2) সমর্থন করে।

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

উৎস: অ্যাপল থেকে Pushwoosh-এ App Store Server Notifications পাঠানো হয়।

সিঙ্ক্রোনাইজড ইভেন্ট

ইভেন্টের নাম	বিবরণ	অ্যাট্রিবিউট
PW_SubscriptionCancel	যখন একজন ব্যবহারকারী একটি অ্যাপ স্টোর সাবস্ক্রিপশনের জন্য অটো-রিনিউয়াল বন্ধ করে দেন তখন এটি ফায়ার হয়।	productID — বাতিল করা সাবস্ক্রিপশনের অ্যাপ স্টোর প্রোডাক্ট আইডেন্টিফায়ার।

এটি কীভাবে কাজ করে

1. একজন ব্যবহারকারী অ্যাপ স্টোরে তাদের সাবস্ক্রিপশনের জন্য অটো-রিনিউয়াল নিষ্ক্রিয় করে দেন।
2. অ্যাপল আপনার Pushwoosh নোটিফিকেশন URL-এ একটি App Store Server Notification (V2) পাঠায়।
3. Pushwoosh সাইন করা পেলোড ডিকোড করে এবং ট্রানজ্যাকশন থেকে appAccountToken পড়ে।
4. Pushwoosh সেই ডিভাইসটি খুঁজে বের করে যার HWID টোকেনের সাথে মেলে, তার সাথে আবদ্ধ ব্যবহারকারীকে খুঁজে বের করে এবং সেই ব্যবহারকারীর জন্য PW_SubscriptionCancel ইভেন্ট পোস্ট করে।

গুরুত্বপূর্ণ

একটি অ্যাপ স্টোর ট্রানজ্যাকশন এবং একজন Pushwoosh ব্যবহারকারীর মধ্যে ম্যাচ appAccountToken-এর উপর নির্ভর করে। যদি আপনার অ্যাপ কেনার সময় এই টোকেন সেট না করে, তাহলে Pushwoosh নোটিফিকেশন পায় কিন্তু কোনো ইভেন্ট পোস্ট করা হয় না। দেখুন appAccountToken কীভাবে সেট করবেন।

ব্যবহারের ক্ষেত্র: গ্রাহক ধরে রাখার জন্য প্রচেষ্টা

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

PW_SubscriptionCancel ইভেন্টের মাধ্যমে, আপনি অটো-রিনিউয়াল বন্ধ হওয়ার সাথে সাথেই একটি Customer Journey শুরু করতে পারেন। একটি রিটেনশন অফার সহ একটি পুশ নোটিফিকেশন পাঠান, ব্যবহারকারী যে ফিচারগুলো হারাবে তা হাইলাইট করে একটি ইমেল পাঠান, অথবা তাদের পরবর্তী রিনিউয়ালে একটি ডিসকাউন্ট সহ একটি ইন-অ্যাপ মেসেজ দেখান। সাবস্ক্রিপশনটি প্রকৃতপক্ষে শেষ হওয়ার আগেই আপনি ব্যবহারকারীদের কাছে পৌঁছাতে পারবেন।

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

ডিভাইসের Pushwoosh HWID-কে appAccountToken হিসেবে সেট করুন

Pushwoosh ডিভাইসের HWID থেকে সঠিক ব্যবহারকারীকে শনাক্ত করে, তাই আপনার অ্যাপকে অবশ্যই StoreKit-এর মাধ্যমে সাবস্ক্রিপশন কেনার সময় ডিভাইসের Pushwoosh HWID-কে appAccountToken হিসেবে সংযুক্ত করতে হবে।

ডিফল্টরূপে, Pushwoosh iOS SDK ডিভাইসের identifierForVendor (IDFV)-কে HWID হিসেবে ব্যবহার করে। IDFV ইতিমধ্যেই একটি UUID, যা অ্যাপলের appAccountToken-এর জন্য প্রয়োজনীয় ফরম্যাট। Pushwoosh তারপর স্বয়ংক্রিয়ভাবে সেই ডিভাইসের সাথে বর্তমানে আবদ্ধ ব্যবহারকারীকে খুঁজে বের করে, তাই এটি কাজ করে আপনি setUserId দিয়ে নিজের ইউজার আইডি অ্যাসাইন করুন বা না করুন।

StoreKit 2

// ডিভাইসের Pushwoosh HWID (ডিফল্ট IDFV) appAccountToken হিসেবে সংযুক্ত করুন
var options: Set<Product.PurchaseOption> = []
if let hwid = UIDevice.current.identifierForVendor {
    options.insert(.appAccountToken(hwid))
}

let result = try await product.purchase(options: options)

StoreKit 1

// appAccountToken পপুলেট করার জন্য applicationUsername অবশ্যই একটি UUID স্ট্রিং হতে হবে
let payment = SKMutablePayment(product: product)
payment.applicationUsername = UIDevice.current.identifierForVendor?.uuidString
SKPaymentQueue.default().add(payment)

সতর্কতা

যদি আপনার অ্যাপ Pushwoosh HWID ওভাররাইড করে (উদাহরণস্বরূপ, PushwooshKeychain পারসিস্টেন্ট HWID মডিউল বা একটি কাস্টম মানের মাধ্যমে), তাহলে appAccountToken-কে সেই একই HWID-তে সেট করুন। টোকেনটি অবশ্যই Pushwoosh-এ থাকা ডিভাইসের HWID-এর সাথে মিলতে হবে, নতুবা ইভেন্টটি অ্যাট্রিবিউট করা যাবে না।

আপনার Pushwoosh অ্যাপ্লিকেশন কোড খুঁজুন

Pushwoosh কন্ট্রোল প্যানেলে আপনার অ্যাপ্লিকেশনটি খুলুন। আপনার অ্যাপ্লিকেশন কোড (ফরম্যাট XXXXX-XXXXX) সাইডবারে প্রোজেক্টের নামের নিচে দেখানো হয়েছে।

নোটিফিকেশন URL তৈরি করার জন্য আপনার অ্যাপ্লিকেশন কোডের প্রয়োজন হবে।

App Store Connect-এ নোটিফিকেশন URL যোগ করুন

1. App Store Connect-এ, Apps → আপনার অ্যাপ → App Information (General-এর অধীনে)-এ যান, এবং App Store Server Notifications-এ স্ক্রোল করুন।
2. Version 2 নোটিফিকেশন নির্বাচন করুন।
3. Production Server URL এবং Sandbox Server URL উভয়কেই এতে সেট করুন:

https://appstore-notifications.pushwoosh.com/appstore/YOUR_APPLICATION_CODE/

4. YOUR_APPLICATION_CODE-কে আগের ধাপ থেকে পাওয়া অ্যাপ্লিকেশন কোড দিয়ে প্রতিস্থাপন করুন। শেষের স্ল্যাশটি রাখুন।

নোট

যদি আপনার অ্যাকাউন্ট US ডেটা সেন্টারে হোস্ট করা থাকে, তাহলে এর পরিবর্তে https://appstore-notifications.pushwoosh.us/appstore/YOUR_APPLICATION_CODE/ ব্যবহার করুন। আপনার অ্যাকাউন্ট কোন ডেটা সেন্টার ব্যবহার করে সে সম্পর্কে আপনি যদি অনিশ্চিত হন, তাহলে আপনার কাস্টমার সাকসেস ম্যানেজারের সাথে বা Pushwoosh সাপোর্ট-এর সাথে যোগাযোগ করুন।

Pushwoosh-এ ইভেন্টটি নিশ্চিত করুন

যখন Pushwoosh প্রথম অ্যাপ স্টোর নোটিফিকেশন প্রসেস করে, তখন এটি আপনার প্রোজেক্টে PW_SubscriptionCancel-কে একটি স্ট্রিং অ্যাট্রিবিউট productID সহ রেজিস্টার করে। একটি স্যান্ডবক্স পরীক্ষার পরে, ইভেন্টটি প্রদর্শিত হচ্ছে কিনা তা যাচাই করতে Audience → Events খুলুন। এরপর এটি সেগমেন্টেশন, পরিসংখ্যান এবং Customer Journeys-এর জন্য প্রস্তুত হয়ে যাবে।

আপনার উইন-ব্যাক ক্যাম্পেইন তৈরি করুন

PW_SubscriptionCancel ইভেন্টে একটি ট্রিগার-ভিত্তিক এন্ট্রি সহ একটি Customer Journey তৈরি করুন, এবং যে ব্যবহারকারীরা চলে যেতে চলেছেন তাদের কাছে আপনি যে বার্তাগুলি পাঠাতে চান তা যোগ করুন।

টেস্টিং

অ্যাপলের স্যান্ডবক্স পরিবেশে App Store Server Notifications ট্রিগার করা যেতে পারে। ইন্টিগ্রেশন যাচাই করতে:

1. উপরে বর্ণিত হিসাবে appAccountToken সেট করে একটি স্যান্ডবক্স সাবস্ক্রিপশন কিনুন।
2. ডিভাইসের সাবস্ক্রিপশন ম্যানেজমেন্ট স্ক্রিন থেকে অটো-রিনিউয়াল নিষ্ক্রিয় করুন।
3. Pushwoosh কন্ট্রোল প্যানেলে, ব্যবহারকারীর প্রোফাইল খুলুন এবং Events history-এ যান।
4. নিশ্চিত করুন যে PW_SubscriptionCancel কয়েক মুহূর্তের মধ্যে প্রদর্শিত হয়।