Shopify सेट अप करें

इंटीग्रेशन ओवरव्यू

Pushwoosh Shopify के साथ सहजता से इंटीग्रेट होता है, जो एक अग्रणी ई-कॉमर्स प्लेटफ़ॉर्म है जो व्यवसायों को ऑनलाइन स्टोर बनाने, प्रबंधित करने और स्केल करने में सक्षम बनाता है। यह गाइड आपको आपके Shopify स्टोर में Pushwoosh ऐप इंस्टॉल और कॉन्फ़िगर करने, यूज़र आइडेंटिफिकेशन सेट अप करने, और push, email, SMS, और WhatsApp जैसे चैनलों के ज़रिए ग्राहकों से जुड़ने के लिए नोटिफिकेशन और ऑटोमेशन टूल का उपयोग करने में मार्गदर्शन करता है।

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

• डेस्टिनेशन: Shopify ग्राहक डेटा Pushwoosh को भेजता है, जहाँ इसका उपयोग टारगेटिंग और मैसेजिंग के लिए किया जाता है।

पूर्वापेक्षाएँ

• एक Pushwoosh अकाउंट
• आपके Shopify एडमिन पैनल तक एक्सेस
• Pushwoosh का डिवाइस API टोकन और Application Code
• ग्राहक और ऑर्डर डेटा वाला एक Shopify स्टोर
• ऑर्डर/कार्ट इवेंट्स के लिए read_orders एक्सेस स्कोप, और चेकआउट स्टेप्स को ट्रैक करने के लिए write_pixels तथा read_customer_events की स्वीकृति

पहले से कनेक्टेड है? आपसे फिर से एक्सेस स्वीकृत करने को कहा जाएगा

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

सिंक्रोनाइज़्ड एंटिटीज़

• ग्राहक: Shopify मेटाफ़ील्ड्स के ज़रिए Pushwoosh User ID असाइन और पहचानने के लिए उपयोग होता है

नोट

Pushwoosh में ग्राहक सिंक्रोनाइज़ेशन के तरीके

तकनीकी सीमाओं के कारण, Pushwoosh नोटिफिकेशन के लिए उपयोग किए जाने वाले कम्युनिकेशन चैनल के आधार पर कई ग्राहक सिंक्रोनाइज़ेशन तरीके प्रदान करता है:

• Email, Web, SMS और WhatsApp: डिवाइस/यूज़र्स स्वचालित रूप से Pushwoosh ऐप में रजिस्टर हो जाते हैं।
• मोबाइल और डेस्कटॉप ऐप्स: डिवाइस/यूज़र्स को Pushwoosh और Shopify एडमिन पैनल के ज़रिए मैन्युअली सिंक किया जा सकता है।
• वेब प्लेटफ़ॉर्म (Chrome, Firefox, Safari): डिवाइस/यूज़र्स को Shopify थीम एम्बेड द्वारा ही मैनेज किया जाता है।

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

सिंक्रोनाइज़ेशन प्रक्रिया इस प्रकार काम करती है:

1. सिस्टम email या फ़ोन नंबर प्राप्त करने के लिए वर्तमान यूज़र सेशन को पुनः प्राप्त करने का प्रयास करता है (ऐसे आइडेंटिफायर जो अतिरिक्त कॉन्फ़िगरेशन के बिना काम करते हैं)।
2. सफल होने पर, email या फ़ोन नंबर को Pushwoosh के लिए और ग्राहक डेटा में pushwoosh_userid प्रॉपर्टी के लिए userID आइडेंटिफायर के रूप में सेट किया जाता है।
3. यदि यह संभव नहीं है, तो Pushwoosh SDK का डिफ़ॉल्ट userID, Pushwoosh और pushwoosh_userid प्रॉपर्टी दोनों के लिए आइडेंटिफायर के रूप में असाइन किया जाता है।
4. किसी भी मामले में, दोनों तरफ़ एक userID असाइन किया जाएगा, जो सुसंगत सिंक्रोनाइज़ेशन सुनिश्चित करता है।

• ग्राहक सेगमेंट्स: समूह-आधारित टारगेटिंग और मैसेजिंग के लिए उपयोग होता है
• इवेंट्स और ट्रिगर्स (जैसे, ऑर्डर प्लेस करना, टैग लागू करना): चैनलों में मैसेजिंग को ऑटोमेट करने के लिए Shopify Flow में उपयोग होते हैं
• स्टोरफ्रंट: एम्बेडेड स्क्रिप्ट्स के ज़रिए web push ऑप्ट-इन कैप्चर करने के लिए उपयोग होता है
• प्रोडक्ट फ़ीड: आपके स्टोर का स्टोरफ्रंट फ़ीड (products.json) ऐप कनेक्ट करने पर स्वचालित रूप से Pushwoosh के प्रोडक्ट कैटलॉग से जुड़ जाता है, और इसे अनइंस्टॉल करने पर स्वचालित रूप से डिसकनेक्ट हो जाता है।
• ऑर्डर और कार्ट: Shopify के orders/paid, checkouts/create, और checkouts/update वेबहुक से सर्वर-टू-सर्वर इवेंट्स। देखें Shopify इवेंट्स और कैंपेन।
• स्टोरफ्रंट ब्राउज़िंग व्यवहार: प्रोडक्ट व्यूज़ और एड-टू-कार्ट एक्शन, वही थीम एम्बेड द्वारा एकत्र किए जाते हैं जो web push ऑप्ट-इन के लिए उपयोग होता है।
• चेकआउट स्टेप्स: दर्ज की गई संपर्क जानकारी और सबमिट की गई भुगतान जानकारी, एक Shopify Web Pixel के ज़रिए एकत्र की जाती है।

शब्दावली (यदि नाम अलग हों तो एंटिटी नामों का मिलान)

Shopify	Pushwoosh
Customer	User ID
orders/paid वेबहुक	इवेंट PW_OrderCreated — अन्य ई-कॉमर्स इंटीग्रेशन के साथ साझा (जैसे Magento)
checkouts/create वेबहुक	इवेंट PW_AbandonedCart — वही साझा इवेंट, Products ब्लॉक के Cart सोर्स द्वारा भी उपयोग किया जाता है
checkouts/update वेबहुक	इवेंट PW_AbandonedCartUpdate — जब खरीदार उसी चेकआउट को एडिट करना जारी रखता है, तब ट्रिगर होता है, और PW_AbandonedCart से सहेजे गए कार्ट को ओवरराइट करता है
प्रोडक्ट पेज व्यू	इवेंट PW_ProductViewed
कार्ट में जोड़ना (पेज रीलोड के बिना)	इवेंट PW_AddToCart
Web Pixel checkout_contact_info_submitted	इवेंट PW_CheckoutContactInfo
Web Pixel payment_info_submitted	इवेंट PW_PaymentInfoSubmitted

इंटीग्रेशन कैसे काम करता है

Pushwoosh Shopify के लिए एक मैसेजिंग डेस्टिनेशन के रूप में काम करता है। इंटीग्रेट होने के बाद, Shopify ग्राहक और व्यवहार डेटा Pushwoosh को भेजता है, जहाँ यह रीयल-टाइम नोटिफिकेशन, ग्राहक सेगमेंटेशन, और चैनलों में पर्सनलाइज़्ड मैसेजिंग को शक्ति देता है।

इंटीग्रेशन के मुख्य घटक

1. मेटाफ़ील्ड्स के ज़रिए ग्राहक पहचान प्रत्येक Shopify ग्राहक को एक यूनीक User ID असाइन किया जाता है, जो एक मेटाफ़ील्ड (custom.pushwoosh_userid) में संग्रहीत होता है। यह ID Pushwoosh को सभी प्लेटफ़ॉर्म पर लगातार यूज़र्स को पहचानने और उन्हें मैसेज करने में सक्षम बनाता है।

2. Shopify Flow के ज़रिए इवेंट-चालित ऑटोमेशन Pushwoosh Flow एक्शन्स प्रदान करता है जो आपको Shopify इवेंट्स के आधार पर मैसेजिंग (push, email, SMS, WhatsApp) को ऑटोमेट करने देते हैं, जैसे:

   • नया ऑर्डर प्लेस किया गया
   • ग्राहक पर टैग लागू किया गया
   • कार्ट एबैंडनमेंट

3. सेगमेंट-आधारित टारगेटिंग Shopify से ग्राहक सेगमेंट्स का उपयोग विभिन्न चैनलों में समूह-विशिष्ट नोटिफिकेशन भेजने के लिए किया जा सकता है, जैसे पहली बार खरीदने वालों के लिए प्रमोशन या निष्क्रिय यूज़र्स के लिए रीएक्टिवेशन कैंपेन।

4. मैनुअल और रीयल-टाइम मैसेजिंग Shopify के ग्राहक या सेगमेंट व्यू से, आप Pushwoosh एक्सटेंशन का उपयोग करके मैन्युअली नोटिफिकेशन ट्रिगर कर सकते हैं:

   • Notification by Customer: व्यक्तिगत फ़ॉलो-अप या टेस्टिंग के लिए
   • Notification by Segment: कैंपेन-आधारित मैसेज के लिए

स्टोरफ्रंट एम्बेड के ज़रिए Web push नोटिफिकेशन

अपने Shopify थीम में Pushwoosh एम्बेड को सक्षम करके, आप वेबसाइट विज़िटर्स को बिना किसी मोबाइल ऐप के ब्राउज़र-आधारित push नोटिफिकेशन के लिए ऑप्ट-इन करने हेतु प्रेरित कर सकते हैं।

डेटा फ़्लो ओवरव्यू

Shopify ग्राहक और इवेंट डेटा
         ↓
Pushwoosh API (ऐप के ज़रिए)
         ↓
User ID → सेगमेंटेशन → ट्रिगर्ड या मैनुअल नोटिफिकेशन

यह इंटीग्रेशन आपको समयोचित, प्रासंगिक मैसेज भेजने में सक्षम बनाता है जो यूज़र रिटेंशन में सुधार करते हैं, कन्वर्ज़न बढ़ाते हैं, और ग्राहक अनुभव को बेहतर बनाते हैं — चाहे स्वचालित रूप से हो या मांग पर।

भाग 1। इंस्टॉलेशन

Shopify में लॉग इन करें

1. Shopify Admin पर जाएँ
2. डैशबोर्ड से अपना स्टोर चुनें

नोट

यह गाइड मानता है कि आपके पास पहले से ही एक Pushwoosh अकाउंट है। यदि नहीं, तो एक बनाएँ

Pushwoosh ऐप इंस्टॉल करें

1. Pushwoosh ऐप स्टोर पेज पर जाएँ
2. Install पर क्लिक करें
3. Shopify डायलॉग में इंस्टॉलेशन की पुष्टि करें

अपना Pushwoosh ऐप कनेक्ट करें

इंस्टॉलेशन के बाद, आपको Shopify के भीतर Pushwoosh ऐप पर रीडायरेक्ट किया जाएगा।

1. Connect पर क्लिक करें।

2. Application Code और API Key दर्ज करें, जिन्हें आप Pushwoosh Control Panel → Settings → API Access में पा सकते हैं। यहाँ API Key आपका डिवाइस API टोकन है।

कनेक्ट होने पर, एक सफलता संदेश दिखाई देगा: “Pushwoosh app connected.”

जब Shopify परमिशन मांगे (ऑर्डर, pixels, ग्राहक इवेंट्स), तो उन्हें स्वीकृत करें। Shopify इवेंट्स और कैंपेन को ट्रैक करने के लिए ये स्कोप आवश्यक हैं। यदि आपने पहले ऐप कनेक्ट किया था, तो देखें पहले से कनेक्टेड है? आपसे फिर से एक्सेस स्वीकृत करने को कहा जाएगा।

स्वचालित प्रोडक्ट कैटलॉग कनेक्शन

ऐप कनेक्ट करने से आपके स्टोर का स्टोरफ्रंट फ़ीड भी स्वचालित रूप से Pushwoosh के प्रोडक्ट कैटलॉग से जुड़ जाता है। अलग से फ़ीड सेटअप की आवश्यकता नहीं है। आपके स्टोर की करेंसी उसी समय कैप्चर की जाती है, और यदि आप बाद में अपने स्टोर की करेंसी बदलते हैं तो यह स्वचालित रूप से अपडेट हो जाती है।

एक प्लान सब्सक्राइब करें

1. Upgrade Subscription पर क्लिक करें
2. एक एकल उपयोग-आधारित प्लान दिखाया जाएगा।
3. बिलिंग की पुष्टि करें।

नोट

मैसेज डिलीवरी और सेगमेंटेशन फ़ीचर्स का उपयोग करने के लिए बिलिंग आवश्यक है।

भाग 2। सेटअप: मेटाफ़ील्ड्स के ज़रिए ग्राहक User ID

विभिन्न चैनलों (push, email, SMS, WhatsApp) में पहचाने गए यूज़र्स को नोटिफिकेशन डिलीवर करने के लिए, Pushwoosh प्रति ग्राहक एक यूनीक User ID का उपयोग करता है। Shopify इस वैल्यू को Shopify के ग्राहक मेटाफ़ील्ड्स में संग्रहीत करता है।

1. Settings → Metafields and metaobjects → Customers पर जाएँ

2. Add definition पर क्लिक करें और इन वैल्यूज़ का उपयोग करें:

फ़ील्ड	वैल्यू
Namespace and key	custom.pushwoosh_userid
Namespace	custom
Type	Single line text
Validation	None
Customer Account Access	Read and Write
Storefront API Access	Enabled

ऊपर दी गई टेबल के अनुसार Customer accounts access और Storefront API access सेट करें।

यह क्यों महत्वपूर्ण है

यह मेटाफ़ील्ड नोटिफिकेशन और सेगमेंटेशन के लिए मोबाइल/वेब डिवाइस पर एक स्थायी यूज़र आइडेंटिफायर है।

भाग 3। Pushwoosh एक्सटेंशन का उपयोग करना

Pushwoosh में सेगमेंट टारगेटिंग, ऑटोमेशन (Flow), और ग्राहक-विशिष्ट नोटिफिकेशन के लिए Shopify एक्सटेंशन शामिल हैं।

एक्सटेंशन 1। Send notification by customer

उपयोग का मामला

किसी विशिष्ट यूज़र को मैन्युअली पर्सनलाइज़्ड मैसेज या टेस्ट नोटिफिकेशन भेजें।

चरण

1. Customers → एक ग्राहक चुनें खोलें
2. More actions → Notification by customer पर क्लिक करें
   
3. मैसेजिंग प्लेटफ़ॉर्म (जैसे, Email) और एक कंटेंट प्रीसेट चुनें।
4. Send पर क्लिक करें

टिप

खरीद के बाद के रिमाइंडर, व्यक्तिगत धन्यवाद संदेश, या रीएक्टिवेशन प्रॉम्प्ट के लिए इसका उपयोग करें।

एक्सटेंशन 2। Notification by segment

उपयोग का मामला

ग्राहकों के समूहों को टारगेट करें — छोड़े गए कार्ट, पहली बार खरीदने वाले, अधिक खर्च करने वाले।

चरण

1. Customers → Segments पर जाएँ

2. एक सेगमेंट चुनें → Use Segment पर क्लिक करें

3. Notification by Segment चुनें
4. वांछित कम्युनिकेशन चैनल और मैसेज प्रीसेट चुनें। Send पर क्लिक करें।

टिप

सेगमेंट्स को खरीद इतिहास, स्थान, गतिविधि, या टैग के आधार पर बनाया जा सकता है।

एक्सटेंशन 3। Shopify Flow में Pushwoosh

उपयोग का मामला

ऑर्डर, टैग, या व्यवहार जैसे ट्रिगर्स का उपयोग करके ग्राहक यात्राओं में मैसेजिंग को ऑटोमेट करें।

चरण

1. Shopify Flow में एक नया Flow बनाएँ
2. एक्शन जोड़ें → Pushwoosh send notification चुनें

3. मैसेज और डायनामिक फ़ील्ड्स को कॉन्फ़िगर करें

उदाहरण के लिए:

• ऑर्डर प्लेस होने के बाद एक मैसेज भेजें

• कार्ट छोड़े जाने पर यूज़र को याद दिलाएँ

• 30 दिनों की निष्क्रियता के बाद एक रीएक्टिवेशन push भेजें

भाग 4। Web push सक्षम करें (और स्टोरफ्रंट ब्राउज़िंग इवेंट्स)

केवल web push के लिए वैकल्पिक। यदि आपको Shopify इवेंट्स और कैंपेन में प्रोडक्ट-व्यू और एड-टू-कार्ट इवेंट्स चाहिए तो आवश्यक।

अपने स्टोरफ्रंट पर ब्राउज़र web push के लिए थीम एम्बेड चालू करें:

1. Online Store → Themes → Customize पर जाएँ
   
2. बाएँ मेनू से App Embeds खोलें
3. Push Init Embed को चालू करें

नोट

अब आपका स्टोर सीधे स्टोरफ्रंट से यूज़र्स को web push के लिए ऑप्ट-इन करने के लिए प्रेरित कर सकता है। यदि आप इस टॉगल को छोड़ देते हैं, तो आपको Shopify इवेंट्स और कैंपेन में स्टोरफ्रंट ब्राउज़िंग इवेंट्स भी नहीं मिलेंगे। ऑर्डर पेड और चेकआउट इवेंट्स इसके बिना भी आते रहेंगे।

डेटा अनुपालन

Shopify हर पब्लिक ऐप को अपने अनिवार्य GDPR/CCPA वेबहुक्स का जवाब देने की आवश्यकता रखता है। Pushwoosh इन्हें इस प्रकार हैंडल करता है:

• customers/redact: जब कोई खरीदार स्टोर से अपना डेटा मिटाने के लिए कहता है, तो Pushwoosh, Shopify द्वारा भेजे गए किसी भी आइडेंटिफायर — email, फ़ोन, और Shopify ग्राहक ID — के अनुसार संबंधित Pushwoosh रिकॉर्ड्स को मिटा देता है।
• customers/data_request: जब कोई खरीदार अपने डेटा की एक कॉपी का अनुरोध करता है, तो Pushwoosh सपोर्ट के इंटरनल चैनल पर एक नोटिफिकेशन पोस्ट करता है, और एक व्यक्ति मैन्युअली अनुरोध को हैंडल करता है। Shopify को ऐप्स से 30 दिनों के भीतर इन अनुरोधों का जवाब देने की आवश्यकता होती है।
• shop/redact: कोई स्टोर ऐप अनइंस्टॉल करने के 48 घंटे बाद Shopify यह भेजता है, स्टोर के डेटा को मिटाने का अनुरोध करते हुए। Pushwoosh वही डिलीशन फिर से चलाता है जिसे अनइंस्टॉल स्वयं ट्रिगर करता है, किसी भी बचे हुए सेशन को साफ़ करता है और स्टोर के इंटीग्रेशन रिकॉर्ड को मिटाता है (डिवाइस API की, एप्लिकेशन कोड, और बिलिंग IDs सहित)। यह उस स्थिति के लिए एक सुरक्षा जाल के रूप में मौजूद है जहाँ अनइंस्टॉल पहली बार में पूरी तरह से साफ़ नहीं हुआ था।

उपयोग के मामलों का सारांश

सेटअप के बाद, Shopify से मैसेज भेजने के सामान्य तरीके:

परिदृश्य	उपयोग किया गया टूल
व्यक्तिगत फ़ॉलो-अप	Notification by Customer
सेगमेंट-आधारित प्रमोशन	Notification by Segment
साइन अप के बाद स्वागत संदेश	Flow + मेटाफ़ील्ड ट्रैकिंग
कार्ट एबैंडनमेंट रिमाइंडर	Shopify Flow + Pushwoosh एक्शन
Push ऑप्ट-इन	थीम एम्बेड + Push Init टॉगल

ऑर्डर, कार्ट, चेकआउट, और स्टोरफ्रंट इवेंट्स पर journeys और सेगमेंट्स के लिए, देखें Shopify इवेंट्स और कैंपेन।