ऐप स्टोर सब्सक्रिप्शन ट्रैकिंग

डेवलपर सहायता की आवश्यकता है

इस इंटीग्रेशन को सेट अप करने के लिए आपको अपनी डेवलपमेंट टीम की मदद की आवश्यकता होगी। कृपया यह गाइड उनके साथ साझा करें।

इंटीग्रेशन का अवलोकन

ऐप स्टोर सर्वर नोटिफिकेशन्स Apple की सर्वर-टू-सर्वर सेवा है जो आपके बैकएंड को वास्तविक समय में एक संदेश भेजती है जब भी किसी सब्सक्रिप्शन की स्थिति बदलती है।

ऐप स्टोर सर्वर नोटिफिकेशन्स को Pushwoosh से कनेक्ट करके, आप अपना खुद का बैकएंड इंफ्रास्ट्रक्चर बनाए बिना कैंसलेशन पर प्रतिक्रिया दे सकते हैं। जब कोई उपयोगकर्ता अपने ऐप स्टोर खाते में किसी सब्सक्रिप्शन के लिए ऑटो-रिन्यूअल बंद कर देता है, तो Apple Pushwoosh को सूचित करता है, और Pushwoosh मिलान करने वाले उपयोगकर्ता प्रोफ़ाइल पर एक PW_SubscriptionCancel इवेंट फायर करता है।

नोट

यह इंटीग्रेशन वर्तमान में iOS सब्सक्रिप्शन (ऐप स्टोर सर्वर नोटिफिकेशन्स V2) का समर्थन करता है।

इंटीग्रेशन का प्रकार

स्रोत: ऐप स्टोर सर्वर नोटिफिकेशन्स Apple से Pushwoosh को भेजे जाते हैं।

सिंक्रनाइज़्ड इवेंट

इवेंट का नाम	विवरण	एट्रिब्यूट्स
PW_SubscriptionCancel	जब कोई उपयोगकर्ता ऐप स्टोर सब्सक्रिप्शन के लिए ऑटो-रिन्यूअल बंद कर देता है तो यह फायर होता है।	productID — रद्द किए गए सब्सक्रिप्शन का ऐप स्टोर उत्पाद पहचानकर्ता।

यह कैसे काम करता है

1. एक उपयोगकर्ता ऐप स्टोर में अपने सब्सक्रिप्शन के लिए ऑटो-रिन्यूअल को अक्षम कर देता है।
2. Apple आपके Pushwoosh नोटिफिकेशन URL पर एक ऐप स्टोर सर्वर नोटिफिकेशन (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 है, ठीक वही प्रारूप जो Apple को appAccountToken के लिए चाहिए। Pushwoosh फिर उस डिवाइस से वर्तमान में जुड़े उपयोगकर्ता को स्वचालित रूप से हल करता है, इसलिए यह काम करता है चाहे आप setUserId के साथ अपनी खुद की User ID असाइन करें या नहीं।

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 बनाने के लिए आपको एप्लीकेशन कोड की आवश्यकता होगी।

ऐप स्टोर कनेक्ट में नोटिफिकेशन URL जोड़ें

1. ऐप स्टोर कनेक्ट में, ऐप्स → आपका ऐप → ऐप जानकारी (सामान्य के अंतर्गत) पर जाएं, और ऐप स्टोर सर्वर नोटिफिकेशन्स तक स्क्रॉल करें।
2. संस्करण 2 नोटिफिकेशन चुनें।
3. प्रोडक्शन सर्वर URL और सैंडबॉक्स सर्वर URL दोनों को इस पर सेट करें:

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

4. YOUR_APPLICATION_CODE को पिछले चरण से प्राप्त एप्लीकेशन कोड से बदलें। अंतिम स्लैश को बनाए रखें।

नोट

यदि आपका खाता यूएस डेटा सेंटर में होस्ट किया गया है, तो इसके बजाय https://appstore-notifications.pushwoosh.us/appstore/YOUR_APPLICATION_CODE/ का उपयोग करें। यदि आप अनिश्चित हैं कि आपका खाता किस डेटा सेंटर का उपयोग करता है, तो अपने कस्टमर सक्सेस मैनेजर या Pushwoosh सपोर्ट से संपर्क करें।

Pushwoosh में इवेंट की पुष्टि करें

जब Pushwoosh पहले ऐप स्टोर नोटिफिकेशन को प्रोसेस करता है, तो यह आपके प्रोजेक्ट में PW_SubscriptionCancel को एक स्ट्रिंग एट्रिब्यूट productID के साथ पंजीकृत करता है। एक सैंडबॉक्स परीक्षण के बाद, इवेंट दिखाई देने की पुष्टि करने के लिए ऑडियंस → इवेंट्स खोलें। यह फिर सेगमेंटेशन, सांख्यिकी और Customer Journeys के लिए तैयार है।

अपना विन-बैक अभियान बनाएं

PW_SubscriptionCancel इवेंट पर एक ट्रिगर-आधारित एंट्री के साथ एक Customer Journey बनाएं, और उन संदेशों को जोड़ें जिन्हें आप उन उपयोगकर्ताओं को भेजना चाहते हैं जो मंथन करने वाले हैं।

परीक्षण

ऐप स्टोर सर्वर नोटिफिकेशन्स को Apple के सैंडबॉक्स वातावरण में ट्रिगर किया जा सकता है। इंटीग्रेशन को सत्यापित करने के लिए:

1. ऊपर वर्णित अनुसार appAccountToken सेट करके एक सैंडबॉक्स सब्सक्रिप्शन खरीदें।
2. डिवाइस की सब्सक्रिप्शन प्रबंधन स्क्रीन से ऑटो-रिन्यूअल को अक्षम करें।
3. Pushwoosh कंट्रोल पैनल में, उपयोगकर्ता प्रोफ़ाइल खोलें और इवेंट्स हिस्ट्री पर जाएं।
4. पुष्टि करें कि PW_SubscriptionCancel कुछ ही क्षणों में दिखाई देता है।