बाहरी सेगमेंट

बाहरी सेगमेंट आपको उन लोगों को लक्षित करने देते हैं जो पहले से ही आपके अपने डेटाबेस में संग्रहीत हैं, जैसे कि आपका CRM या डेटा वेयरहाउस, उन्हें CSV में निर्यात करने और सूची बदलने पर हर बार इसे फिर से अपलोड करने के बजाय। आप Pushwoosh को एक SQL क्वेरी देते हैं जो सही उपयोगकर्ता आईडी लौटाती है, और Pushwoosh सेगमेंट को अद्यतित रखने के लिए उस क्वेरी को फिर से चलाता रहता है। एक बार सेट हो जाने के बाद, आप इन उपयोगकर्ताओं का उपयोग किसी अन्य सेगमेंट की तरह ही कर सकते हैं।

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

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

कनेक्शन सेट करना आपके प्रोडक्शन डेटाबेस को प्रभावित करता है। शुरू करने से पहले, अपने डेवलपर या डेटाबेस प्रशासक से यह करवाएँ:

• एक रीड-ओनली उपयोगकर्ता तैयार करें (या, BigQuery के लिए, एक रीड-ओनली सेवा खाता)
• उस क्वेरी की पुष्टि करें जिसका आप उपयोग करने की योजना बना रहे हैं
• यदि डेटाबेस फ़ायरवॉल के पीछे है, तो Pushwoosh सहायता से पूछें कि किन IP पतों की अनुमति दी जाए

एक बाहरी सेगमेंट बनाएँ

सेगमेंट को नाम दें और डेटाबेस चुनें

1. Audience → External Segments पर जाएँ।
2. Create external segment पर क्लिक करें।

3. सेगमेंट के लिए एक Name दर्ज करें (100 वर्णों तक)।
4. Database type चुनें: PostgreSQL, MySQL, Google BigQuery, Microsoft SQL Server / Fabric, या Google Analytics 4 audience।

कनेक्शन फ़ील्ड भरें

PostgreSQL और MySQL

PostgreSQL और MySQL के लिए, भरें:

• Host और Port: आपके डेटाबेस सर्वर का पता। Pushwoosh को एक सार्वजनिक रूप से पहुँच योग्य होस्ट की आवश्यकता होती है और कनेक्शन की जाँच करते समय या सेगमेंट को सहेजते समय निजी, आंतरिक, या लूपबैक पतों को अस्वीकार कर देता है।
• Database: डेटाबेस का नाम।
• User और Password: एक रीड-ओनली खाते के लिए क्रेडेंशियल।
• SSL mode (केवल PostgreSQL, क्योंकि MySQL कनेक्शन TLS का उपयोग नहीं करते हैं) यह सेट करता है कि SSL/TLS, जो कनेक्शन को एन्क्रिप्ट करने वाला प्रोटोकॉल है, आपके डेटाबेस कनेक्शन पर कैसे लागू होता है। अपने डेटाबेस प्रशासक से पूछें कि किस मोड का उपयोग करना है:
  • Disable: कोई एन्क्रिप्शन नहीं।
  • Require: कनेक्शन को एन्क्रिप्ट करता है, लेकिन डेटाबेस सर्वर की पहचान की जाँच नहीं करता है।
  • Verify CA: कनेक्शन को एन्क्रिप्ट करता है और जाँचता है कि सर्वर का प्रमाणपत्र एक विश्वसनीय प्रमाणपत्र प्राधिकरण (CA) द्वारा जारी किया गया था।
  • Verify full: Verify CA के समान, और यह भी जाँचता है कि प्रमाणपत्र आपके डेटाबेस के होस्टनाम से मेल खाता है। सबसे मजबूत विकल्प।
• Disable के अलावा किसी भी मोड के लिए, Certificate source (Upload files या Paste PEM) के तहत CA certificate प्रदान करें, साथ ही एक Client certificate और Client key यदि आपके डेटाबेस को उनकी आवश्यकता है।

BigQuery

Google BigQuery के लिए, भरें:

• Project ID: GCP प्रोजेक्ट जिसमें आपका डेटासेट है।
• Service account JSON: BigQuery रीड एक्सेस वाले सेवा खाते के लिए कुंजी।
• Location: डेटासेट का क्षेत्र (उदाहरण के लिए, EU, US, या europe-west3)। डेटासेट से स्थान को स्वचालित रूप से हल करने के लिए इसे खाली छोड़ दें।

SQL Server / Fabric

Microsoft SQL Server / Fabric के लिए, भरें:

• Host और Port: आपके डेटाबेस सर्वर का पता, या आपका Fabric SQL एनालिटिक्स एंडपॉइंट। Pushwoosh को एक सार्वजनिक रूप से पहुँच योग्य होस्ट की आवश्यकता होती है और कनेक्शन की जाँच करते समय या सेगमेंट को सहेजते समय निजी, आंतरिक, या लूपबैक पतों को अस्वीकार कर देता है।
• Database: डेटाबेस का नाम।
• User और Password: एक रीड-ओनली खाते के लिए क्रेडेंशियल।
• Microsoft Entra tenant ID: वैकल्पिक। SQL Server लॉगिन के लिए इसे खाली छोड़ दें। Microsoft Fabric के लिए, जिसके SQL एनालिटिक्स एंडपॉइंट में कोई SQL लॉगिन नहीं है, इसे इसके बजाय एक सेवा प्रिंसिपल के रूप में साइन इन करने के लिए सेट करें। इसकी एप्लिकेशन (क्लाइंट) आईडी को User के रूप में और इसके क्लाइंट सीक्रेट को Password के रूप में दर्ज करें।

Google Analytics 4 audience

Google Analytics 4 audience सेगमेंट अपने उपयोगकर्ता उस ऑडियंस से लेता है जिसे आपने Google Analytics में बनाया है, इसलिए इसमें कोई क्वेरी नहीं होती। भरें:

• GA4 property ID: Google Analytics प्रॉपर्टी की आईडी, जो Google Analytics में Admin → Property details के अंतर्गत दिखाई देती है।
• Service account JSON: उस प्रॉपर्टी पर Viewer भूमिका वाले सेवा खाते के लिए कुंजी। Google Analytics में Admin → Property access management के अंतर्गत भूमिका प्रदान करें, और सेवा खाते के Google Cloud प्रोजेक्ट में Google Analytics Data API और Admin API सक्षम करें।
• Audience: Load audiences पर क्लिक करें, फिर ऑडियंस चुनें। यदि सूची खाली है, तो पहले Google Analytics में एक ऑडियंस बनाएँ।

फिर Check connection और Create पर क्लिक करें, और अगला अनुभाग छोड़ दें। Google Analytics की ओर के सेटअप के लिए, गूगल एनालिटिक्स इंटीग्रेशन देखें।

क्वेरी दर्ज करें

Google Analytics 4 audience को छोड़कर हर डेटाबेस प्रकार के लिए:

1. Query दर्ज करें। इसे user_id नामक एक एकल कॉलम लौटाना होगा, जिसमें प्रत्येक उपयोगकर्ता के लिए एक पंक्ति हो जिसे आप सेगमेंट में चाहते हैं। उदाहरण के लिए:

SELECT user_id FROM loyalty_members WHERE tier = 'gold'

नोट

user_id मान आपके उपयोगकर्ताओं के लिए आपके द्वारा सेट किए गए Pushwoosh User ID से मेल खाना चाहिए (वही पहचानकर्ता जो उपयोगकर्ता आईडी द्वारा सेगमेंट बनाएँ द्वारा उपयोग किया जाता है)। एक क्वेरी जो उन आईडी को लौटाती है जिन्हें Pushwoosh नहीं पहचानता है, किसी भी डिवाइस से मेल नहीं खाएगी।

2. यह पुष्टि करने के लिए Check connection पर क्लिक करें कि Pushwoosh डेटाबेस तक पहुँच सकता है (30 सेकंड के बाद टाइम आउट हो जाता है)।
3. यह पुष्टि करने के लिए Check query पर क्लिक करें कि क्वेरी चलती है और सही कॉलम लौटाती है (यह भी 30 सेकंड के बाद टाइम आउट हो जाता है)।

सत्यापित करें और बनाएँ

जब दोनों जाँचें सफल हो जाती हैं, तो Create पर क्लिक करें। Pushwoosh सेगमेंट को सहेजता है और इसे तुरंत External Segments सूची में जोड़ता है।

सेगमेंट कैसे अद्यतित रहता है

Pushwoosh आपकी क्वेरी को एक निश्चित शेड्यूल पर नहीं चलाता है। इसके बजाय, यह सेगमेंट को इस आधार पर ताज़ा करता है कि इसे आखिरी बार कब उपयोग किया गया था:

• यदि सेगमेंट का डेटा एक घंटे से कम पुराना है, तो Pushwoosh वर्तमान डेटा का उपयोग करता है।
• यदि यह एक घंटे से अधिक पुराना है, तो Pushwoosh वर्तमान डेटा का उपयोग करना जारी रखता है जबकि यह पृष्ठभूमि में ताज़ा होता है।
• यदि यह तीन घंटे से अधिक पुराना है, तो Pushwoosh सेगमेंट का उपयोग करने से पहले एक ताज़ा रिफ्रेश की प्रतीक्षा करता है।

Google Analytics 4 audience सेगमेंट समान नियमों का पालन करता है, लेकिन लंबी अवधि के साथ: 24 घंटे और 72 घंटे, क्योंकि Google Analytics ऑडियंस सदस्यता को लगभग दिन में एक बार अपडेट करता है।

व्यवहार में, इसका मतलब है कि एक सेगमेंट जिसे आप नियमित रूप से उपयोग करते हैं (उदाहरण के लिए, एक आवर्ती यात्रा में) वर्तमान रहता है, जबकि एक सेगमेंट जिसे आप शायद ही कभी छूते हैं, उसे फिर से उपयोग करने पर पहली बार ताज़ा होने में थोड़ा समय लग सकता है।

यदि एक रिफ्रेश विफल हो जाता है (उदाहरण के लिए, डेटाबेस पहुँच से बाहर हो जाता है या क्वेरी में त्रुटि आने लगती है), तो Pushwoosh त्रुटि को रिकॉर्ड करता है, लेकिन External Segments सूची पर सेगमेंट की स्थिति अपने आप नहीं बदलती है। अपनी ओर से समस्या को ठीक करने के बाद, सेगमेंट खोलें और सुधार की पुष्टि करने के लिए Check connection पर क्लिक करें। अगली बार जब सेगमेंट का डेटा सफलतापूर्वक ताज़ा होता है तो त्रुटि स्वचालित रूप से साफ़ हो जाती है।

एक बाहरी सेगमेंट का उपयोग करें

एक बार जब आप इसे बना लेते हैं, तो बाहरी सेगमेंट स्वचालित रूप से Audience → Segments पर उसी नाम के तहत दिखाई देता है, जो किसी अन्य सेगमेंट की तरह उपयोग के लिए तैयार है, उदाहरण के लिए एक अभियान या यात्रा दर्शक के रूप में।

इसे अन्य शर्तों के साथ संयोजित करने के लिए, इसे एक फ़िल्टर के रूप में जोड़ें:

1. Audience → Segments → सेगमेंट बनाएँ पर जाएँ।
2. इसके द्वारा फ़िल्टर जोड़ें: → सेगमेंट पर क्लिक करें।
3. नाम से अपना बाहरी सेगमेंट चुनें।

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

जाँचें कि सेगमेंट में कितने लोग हैं

External Segments सूची सदस्यों की संख्या नहीं दिखाती है। Audience → Segments पर सेगमेंट के रैपर को खोलें (देखें एक बाहरी सेगमेंट का उपयोग करें) और वहाँ इसके आकार की गणना करें।

बाहरी सेगमेंट प्रबंधित करें

External Segments सूची पर, प्रत्येक पंक्ति सेगमेंट का नाम, Code (API कॉल में सेगमेंट को संदर्भित करने के लिए उपयोग किया जाने वाला पहचानकर्ता), डेटाबेस प्रकार, होस्ट (Google Analytics 4 audience के लिए प्रॉपर्टी), और स्थिति (valid या invalid) दिखाती है।

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