IOS में परिचयात्मक ऑफ़र की उपलब्धता की जांच कैसे करें

यदि आप अपने सदस्यता आवेदन (परीक्षण, भुगतान या पूर्व भुगतान के रूप में भुगतान) में परिचयात्मक ऑफ़र का उपयोग करते हैं, तो भुगतान स्क्रीन पर कीमत दिखाने से पहले, आपको उपयोगकर्ता को परिचयात्मक ऑफ़र की उपलब्धता निर्धारित करने की आवश्यकता है। यदि उपयोगकर्ता ने पहले ही कोई परीक्षण कर लिया है, तो आपको इसके लिए पूरी कीमत प्रदर्शित करनी होगी।

हाय सब, मैं Apphud से Renat के संपर्क में हूँ - एक सेवा है जो iOS- अनुप्रयोगों में सदस्यता के साथ काम को सरल करता है। आज मैं आपको बताऊंगा कि यह कैसे निर्धारित किया जाए कि किसी एकल उपयोगकर्ता को परिचयात्मक वाक्य को सक्रिय करने का अधिकार है या नहीं।

परिचयात्मक प्रस्ताव समान सदस्यता समूह के भीतर मान्य है। इसका मतलब यह है कि उपयोगकर्ता बिना किसी परीक्षण के नियमित साप्ताहिक सदस्यता जारी कर सकता है, सदस्यता समाप्त कर सकता है और बाद में मासिक सदस्यता के लिए एक परीक्षण जारी कर सकता है।

Apple प्रलेखन में एक आरेख होता है जब उपयोगकर्ता को एक परिचयात्मक वाक्य उपलब्ध होता है:

यह पता चला है कि उपयोगकर्ता परिचयात्मक वाक्य का उपयोग कर सकता है यदि:

• उसने पहले एक परिचयात्मक वाक्य का उपयोग नहीं किया था

और

• सदस्यता या तो जारी नहीं की गई है या समाप्त हो गई है

परिचयात्मक वाक्य की उपलब्धता की जांच करने के लिए, आपको 3 चरण करने होंगे:

1) ऐप स्टोर की जाँच करें और लेनदेन की सरणी को बाहर निकालें। यदि कोई लेन-देन नहीं है, तो हम कुछ भी जांच नहीं करते हैं, एक परिचयात्मक वाक्य उपलब्ध है। यदि लेनदेन हैं, तो निम्नलिखित दो चरण करें।

2) जाँच करें कि क्या परिचयात्मक वाक्य पहले इस्तेमाल किया गया था

3) वर्तमान सदस्यता की स्थिति की जाँच करें

आइए इन चरणों पर अधिक विस्तार से विचार करें।

1. ऐप स्टोर की जाँच की वैधता

चेक को मान्य करने के लिए, आपको ऐप्पल को एक अनुरोध भेजना होगा, प्राप्त receiptData और sharedSecret । sharedSecret मान को अपने साथ बदलें। यदि आप अपने sharedSecret नहीं जानते हैं, तो यह यहां वर्णित है कि इसे कहां प्राप्त करना है।

 func isEligibleForIntroductory(callback: @escaping (Bool) -> Void){ guard let receiptUrl = Bundle.main.appStoreReceiptURL else { callback(true) return } #if DEBUG let urlString = "https://sandbox.itunes.apple.com/verifyReceipt" #else let urlString = "https://buy.itunes.apple.com/verifyReceipt" #endif let receiptData = try? Data(contentsOf: receiptUrl).base64EncodedString() let sharedSecret = "YOUR_SHARED_SECRET" let requestData = ["receipt-data" : receiptData ?? "", "password" : sharedSecret, "exclude-old-transactions" : false] as [String : Any] var request = URLRequest(url: URL(string: urlString)!) request.httpMethod = "POST" request.setValue("Application/json", forHTTPHeaderField: "Content-Type") let httpBody = try? JSONSerialization.data(withJSONObject: requestData, options: []) request.httpBody = httpBody URLSession.shared.dataTask(with: request) { (data, response, error) in // continue here }.resume() } 

ऊपर का उदाहरण सदस्यता के प्रकार को निर्धारित करने के लिए #if DEBUG मैक्रो का उपयोग करता है: sandbox या production । यदि आप अन्य मैक्रो का उपयोग करते हैं, तो आपको इस जगह कोड को अपडेट करना होगा।

2. जांचें कि क्या पहले एक परिचयात्मक वाक्य का उपयोग किया गया है

Apple से प्रतिक्रिया प्राप्त करने के बाद, हम इसे Dictionary में अनुवाद करते हैं और लेनदेन की एक सरणी प्राप्त करते हैं:

 // paste this code after "continue here" comment guard let data = data, let json = try? JSONSerialization.jsonObject(with: data, options: .allowFragments) as? [String : AnyHashable], let receipts_array = json["latest_receipt_info"] as? [[String : AnyHashable]] else { callback(true) return } // continue here 

हम लेन-देन की सरणी से is_trial_period और is_in_intro_offer_period और is_in_intro_offer_period के मूल्यों को is_in_intro_offer_period । यदि मूल्यों में से एक true , तो उपयोगकर्ता पहले ही एक परिचयात्मक वाक्य तैयार कर चुका है। ये मान एक स्ट्रिंग के रूप में आते हैं, इसलिए विश्वसनीयता के लिए हम बूल और स्ट्रिंग दोनों में मूल्य को बदलने की कोशिश करेंगे।

 // paste this code after "continue here" comment var latestExpiresDate = Date(timeIntervalSince1970: 0) let formatter = DateFormatter() for receipt in receipts_array { let used_trial : Bool = receipt["is_trial_period"] as? Bool ?? false || (receipt["is_trial_period"] as? NSString)?.boolValue ?? false let used_intro : Bool = receipt["is_in_intro_offer_period"] as? Bool ?? false || (receipt["is_in_intro_offer_period"] as? NSString)?.boolValue ?? false if used_trial || used_intro { callback(false) return } // continue here 

3. सदस्यता की वर्तमान स्थिति की जाँच करना

सदस्यता की वर्तमान स्थिति का पता लगाने के लिए, हमें नवीनतम expires_date खोजने और वर्तमान तिथि के साथ तुलना करने की आवश्यकता है। यदि सदस्यता समाप्त नहीं हुई है, तो परिचयात्मक प्रस्ताव उपलब्ध नहीं है:

 // paste this code after "continue here" comment formatter.dateFormat = "yyyy-MM-dd HH:mm:ss VV" if let expiresDateString = receipt["expires_date"] as? String, let date = formatter.date(from: expiresDateString) { if date > latestExpiresDate { latestExpiresDate = date } } } if latestExpiresDate > Date() { callback(false) } else { callback(true) } 

आप लेख के अंत में विधि के पूर्ण कोड का लिंक पा सकते हैं, हालांकि इस पद्धति में बहुत सारे "लेकिन" हैं।

नुकसान

• इस उदाहरण में, हमने केवल एक सदस्यता समूह के मामले को देखा। यदि आप किसी एप्लिकेशन में एक से अधिक सदस्यता समूह का उपयोग करते हैं, तो आपको इस विधि के लिए सदस्यता समूह पहचानकर्ता को पास करना होगा और receipt में receipt के मूल्य से इसे सत्यापित करना होगा।

  
  

• इस उदाहरण में, सदस्यता वापसी के मामले को ध्यान में नहीं रखा गया है। ऐसा करने के लिए, cancellation_date फ़ील्ड की उपस्थिति की जाँच करें:

  
  

   if receipt["cancellation_date"] != nil{ // if user made a refund, no need to check for eligibility callback(false) return } 

  
  

• और यहां ग्रेस पीरियड (बिलिंग ग्रेस पीरियड) पर ध्यान नहीं दिया जाता है। यदि उपयोगकर्ता सत्यापन के समय अनुग्रह अवधि में है, तो grace_period_expires_date में grace_period_expires_date फ़ील्ड होगा। इस मामले में, आपको एक डेवलपर के रूप में भुगतान स्क्रीन प्रदर्शित किए बिना उपयोगकर्ता को प्रीमियम कार्यक्षमता प्रदान करना आवश्यक है। और तदनुसार, यह परिचयात्मक वाक्य की उपलब्धता की जांच करने के लिए कोई मतलब नहीं है।

  
  

• समाप्ति तिथि की जाँच करने में कोई समस्या है। IOS डिवाइस पर सिस्टम का समय समाप्त हो सकता है और फिर हमारा कोड एक गलत परिणाम देगा: सदस्यता को सक्रिय माना जाएगा।

  
  

• डिवाइस पर एक चेक के सत्यापन की सिफारिश स्वयं ऐप्पल द्वारा नहीं की जाती है। उन्होंने WWDC (5:50 से) में कई बार इस बारे में बात की और यह प्रलेखन में इंगित किया गया है । यह असुरक्षित है क्योंकि एक हमलावर एक मध्य-मध्य हमले का उपयोग करके डेटा को बाधित कर सकता है। Apple चेक को मान्य करने के लिए आपके सर्वर का उपयोग करने की सलाह देता है।

  
  

प्रचार प्रस्ताव की उपलब्धता की जाँच करना

प्रचार प्रस्ताव की उपलब्धता के लिए शर्त सरल है - मुख्य बात यह है कि उपयोगकर्ता के पास एक सक्रिय या समाप्त सदस्यता है। ऐसा करने के लिए, अपने सदस्यता समूह के लिए pending_renewal_info की उपस्थिति देखें।

यह Apphud SDK में कैसे लागू किया जाता है

यह एक विधि को कॉल करने के लिए पर्याप्त है, इसमें अपने product को पास करना, जो आपको परिणाम लौटाएगा:

 Apphud.checkEligibilityForIntroductoryOffer(product: myProduct) { result in if result { // User is eligible to purchase introductory offer } } 

और इसी तरह प्रचार प्रस्ताव के लिए:

 Apphud.checkEligibilityForPromotionalOffer(product: myProduct) { result in if result { // User is eligible to purchase promotional offer } } 

एक बार में एक कॉल में कई उत्पादों की उपलब्धता की जाँच करने के तरीके भी हैं:

 func checkEligibilitiesForIntroductoryOffers(products: [SKProduct], callback: ApphudEligibilityCallback) func checkEligibilitiesForPromotionalOffers(products: [SKProduct], callback: ApphudEligibilityCallback) 

निष्कर्ष

पूर्ण विधि कोड यहां डाउनलोड किया जा सकता है ।

हम Apphud में पहले से ही एक सुविधाजनक खुले स्रोत SDK में परिचयात्मक और प्रचारक प्रस्तावों की उपलब्धता पर एक चेक लागू कर चुके हैं। Apphud आपको सदस्यता की स्थिति को ट्रैक करने, प्रमुख मीट्रिक का विश्लेषण करने, स्वचालित रूप से सदस्यता समाप्त करने वाले उपयोगकर्ताओं को छूट प्रदान करने में मदद करता है, और भी बहुत कुछ। यदि आप सदस्यता के साथ काम करते समय दर्द का अनुभव करते हैं , तो मुफ्त में हमारे समाधान का प्रयास करें।