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

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

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

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

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

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

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

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

1. ऑडियंस → बाहरी सेगमेंट पर जाएँ।
2. बाहरी सेगमेंट बनाएँ पर क्लिक करें।

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

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

PostgreSQL और MySQL

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

• होस्ट और पोर्ट: आपके डेटाबेस सर्वर का पता। Pushwoosh को एक सार्वजनिक रूप से पहुँच योग्य होस्ट की आवश्यकता होती है और कनेक्शन की जाँच करते समय या सेगमेंट को सहेजते समय निजी, आंतरिक, या लूपबैक पतों को अस्वीकार कर देता है।
• डेटाबेस: डेटाबेस का नाम।
• उपयोगकर्ता और पासवर्ड: एक रीड-ओनली खाते के लिए क्रेडेंशियल।
• SSL मोड (केवल PostgreSQL, क्योंकि MySQL कनेक्शन TLS का उपयोग नहीं करते हैं) यह सेट करता है कि SSL/TLS, जो कनेक्शन को एन्क्रिप्ट करने वाला प्रोटोकॉल है, आपके डेटाबेस कनेक्शन पर कैसे लागू होता है। अपने डेटाबेस प्रशासक से पूछें कि किस मोड का उपयोग करना है:
  • अक्षम: कोई एन्क्रिप्शन नहीं।
  • आवश्यक: कनेक्शन को एन्क्रिप्ट करता है, लेकिन डेटाबेस सर्वर की पहचान की जाँच नहीं करता है।
  • CA सत्यापित करें: कनेक्शन को एन्क्रिप्ट करता है और जाँचता है कि सर्वर का प्रमाणपत्र एक विश्वसनीय प्रमाणपत्र प्राधिकरण (CA) द्वारा जारी किया गया था।
  • पूर्ण सत्यापन: CA सत्यापित करें के समान, और यह भी जाँचता है कि प्रमाणपत्र आपके डेटाबेस के होस्टनाम से मेल खाता है। सबसे मजबूत विकल्प।
• अक्षम के अलावा किसी भी मोड के लिए, प्रमाणपत्र स्रोत (फ़ाइलें अपलोड करें या PEM पेस्ट करें) के तहत CA प्रमाणपत्र प्रदान करें, साथ ही एक क्लाइंट प्रमाणपत्र और क्लाइंट कुंजी यदि आपके डेटाबेस को उनकी आवश्यकता है।

BigQuery

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

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

SQL Server / Fabric

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

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

Google Analytics 4 audience

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

• GA4 प्रॉपर्टी 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 सक्षम करें।
• ऑडियंस: ऑडियंस लोड करें पर क्लिक करें, फिर ऑडियंस चुनें। यदि सूची खाली है, तो पहले Google Analytics में एक ऑडियंस बनाएँ।

Google Analytics की ओर के सेटअप के लिए, गूगल एनालिटिक्स इंटीग्रेशन देखें। फिर कनेक्शन जांचें पर क्लिक करें। जाँच सफल होने पर, बनाएँ पर क्लिक करें।

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

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

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

SELECT user_id FROM loyalty_members WHERE tier = 'gold'

नोट

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

बाहरी सेगमेंट सूची पर, प्रत्येक पंक्ति दिखाती है:

• सेगमेंट का नाम।
• कोड: API कॉल में सेगमेंट को संदर्भित करने के लिए उपयोग किया जाने वाला पहचानकर्ता।
• डेटाबेस प्रकार।
• होस्ट, या Google Analytics 4 audience के लिए प्रॉपर्टी।
• स्थिति, वैध या अमान्य।

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