# सेगमेंट इंटीग्रेशन

<Aside type="caution" icon="setting" title="डेवलपर सहायता की आवश्यकता है">
 आपको इंटीग्रेशन सेटअप करने के लिए अपनी डेवलपमेंट टीम से मदद की आवश्यकता होगी। कृपया यह गाइड उनके साथ साझा करें।
</Aside>


[सेगमेंट](https://segment.com/) एक ग्राहक डेटा प्लेटफ़ॉर्म है जो उपयोगकर्ता डेटा एकत्र करना सरल बनाता है और आपको इसका प्रभावी ढंग से लाभ उठाने में मदद करता है। यदि आप अपना ग्राहक डेटा सेगमेंट में संग्रहीत करते हैं, तो आप कुछ ही क्लिक में पुशवूश के साथ इंटीग्रेशन सेटअप कर सकते हैं।

एक बार इंटीग्रेशन सेट हो जाने के बाद, सेगमेंट निम्नलिखित डेटा पुशवूश को भेजेगा:

* उपयोगकर्ता एट्रिब्यूट्स: नाम, डिवाइस, प्राथमिकताएं, स्थान, व्यवहार, आदि। पुशवूश इस डेटा को प्रत्येक उपयोगकर्ता के लिए [टैग्स](/hi/product/audience-data-and-segmentation/user-data-tags/tags/) और उनके मानों के रूप में सहेजेगा।
* इवेंट्स: प्रत्येक सेगमेंट इवेंट को पुशवूश में स्थानांतरित किया जाएगा और उसी नाम के साथ [पुशवूश इवेंट](/hi/product/audience-data-and-segmentation/events/) के रूप में सहेजा जाएगा। पुशवूश को यह भी जानकारी मिलेगी कि प्रत्येक उपयोगकर्ता ने कौन से इवेंट ट्रिगर किए हैं।

सेगमेंट डेटा का उपयोग करके, आप पुशवूश में सहज संचार के साथ अपने दर्शकों का अनुसरण कर सकते हैं। नीचे दो प्लेटफार्मों की शक्ति का लाभ उठाने के दो उदाहरण दिए गए हैं:

**1. उपयोगकर्ता व्यवहार डेटा के आधार पर लक्षित अभियान बनाएं।** विशिष्ट उपयोगकर्ता व्यवहार के आधार पर पुशवूश में सटीक उपयोगकर्ता सेगमेंट बनाने के लिए सेगमेंट से इवेंट डेटा का उपयोग करें।

उदाहरण के लिए, सेगमेंट _SubscribedToOffers_ इवेंट के बारे में डेटा पुशवूश को भेजता है। आप पुशवूश में उन उपयोगकर्ताओं से मिलकर एक उपयोगकर्ता सेगमेंट बना सकते हैं जिन्होंने विशेष ऑफ़र के लिए सब्सक्राइब किया है:

<img src="/integrations-segment-integration-1.webp" alt="SubscribedToOffers इवेंट पर आधारित उपयोगकर्ता सेगमेंट"/>

फिर, आप उन उपयोगकर्ताओं के लिए प्रोमो संदेशों और छूटों के साथ आकर्षक कस्टमर जर्नी बना सकते हैं जिन्होंने आपके ऑफ़र के लिए सब्सक्राइब किया है:

<img src="/integrations-segment-integration-2.webp" alt="सब्सक्राइबर्स के लिए प्रोमो संदेशों के साथ कस्टमर जर्नी"/>

**2. सेगमेंट से उपयोगकर्ता एट्रिब्यूट्स के आधार पर संदेशों को पर्सनलाइज़ करें।** आप अपने पुश नोटिफिकेशन, इन-ऐप संदेशों और ईमेल की सामग्री को संशोधित करने के लिए सेगमेंट से प्राप्त उपयोगकर्ता एट्रिब्यूट्स का लाभ उठा सकते हैं। यह आपको प्रासंगिक और उच्च-रूपांतरण संचार स्थापित करने की अनुमति देगा।

उदाहरण के लिए, सेगमेंट _searched_product_ एट्रिब्यूट मानों को पुशवूश को भेजता है। आप एक पुश प्रीसेट बना सकते हैं जो उस श्रेणी के उत्पादों पर छूट प्रदान करता है जिसे उपयोगकर्ता ने पहले खोजा है:

<img src="/integrations-segment-integration-3.webp" alt="उत्पाद श्रेणी के लिए डायनामिक कंटेंट के साथ पुश प्रीसेट"/>

प्रत्येक उपयोगकर्ता को ठीक उसी उत्पाद श्रेणी पर छूट की पेशकश करने वाला एक पुश प्राप्त होगा जिसे उन्होंने पहले ब्राउज़ किया था। उदाहरण के लिए, जिन्होंने स्पोर्ट्स शूज़ की खोज की थी, वे यह संदेश देखेंगे:

<img src="/integrations-segment-integration-4.webp" alt="स्पोर्ट्स शूज़ श्रेणी के लिए पुश नोटिफिकेशन का उदाहरण" width="375"/>

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

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

* **डेस्टिनेशन**: डेटा सेगमेंट से पुशवूश को भेजा जाता है।
* **सोर्स**: डेटा पुशवूश से सेगमेंट को भेजा जाता है।

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

पुशवूश और सेगमेंट दोनों में पेड अकाउंट

### सिंक्रनाइज़ की गई एंटिटीज़

**सोर्स**

* पुश आँकड़े


**डेस्टिनेशन**

* डिवाइस
* टैग्स

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

**नोटिफिकेशन ट्रैक करना**

पुश नोटिफिकेशन भेजें और उनकी स्थिति को ट्रैक करें, जिसमें यह भी शामिल है कि क्या वे सफलतापूर्वक भेजे और वितरित किए गए थे।

**इवेंट विश्लेषण**

उपयोगकर्ता-ट्रिगर किए गए इवेंट का विश्लेषण करें, जैसे कि पुश नोटिफिकेशन या ईमेल डिलीवरी, और सुनिश्चित करें कि ये इवेंट सेगमेंट में सटीक रूप से दर्ज किए गए हैं।

**यूज़र मैनेजमेंट**

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

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

<Aside type="note">
सेगमेंट के साथ इंटीग्रेशन सेटअप करने से पहले, सुनिश्चित करें कि [पुशवूश SDK](/hi/developer/first-steps/integrate-pushwoosh-sdk) को इंटीग्रेट कर लें।
</Aside>

### डेस्टिनेशन कॉन्फ़िगर करना

1. [सेगमेंट इंटरफ़ेस में](https://app.segment.com/login/), **Connections** → **Destinations** पर नेविगेट करें और **Add Destination** पर क्लिक करें।

2. **Pushwoosh** खोजें और इसे चुनें।

3. उन सोर्सेज़ को चुनें जिन्हें आप डेस्टिनेशन से कनेक्ट करना चाहते हैं।

4. डेस्टिनेशन सेटिंग्स पर जाएं:

<img src="/integrations-segment-integration-5.webp" alt="सेगमेंट में डेस्टिनेशन सेटिंग्स"/>

5. **पुशवूश API की** और **एप्लीकेशन कोड** दर्ज करें। सुनिश्चित करें कि **Enable Destination** स्विच चालू है। उसके बाद, **Save Changes** पर क्लिक करें।

<details>

<summary>मैं API की और एप्लीकेशन कोड कहां ढूंढ सकता हूं?</summary>

आप API की को **Settings** → **API Access** सेक्शन में पा सकते हैं:

<img src="/integrations-segment-integration-6.webp" alt="पुशवूश सेटिंग्स में API एक्सेस सेक्शन" data-size="original"/>

एप्लीकेशन कोड पुशवूश इंटरफ़ेस के ऊपरी बाएं कोने में, प्रोजेक्ट नाम के ठीक नीचे पाया जा सकता है:

<img src="/integrations-segment-integration-7.webp" alt="पुशवूश इंटरफ़ेस में एप्लीकेशन कोड" data-size="original"/>

</details>

6. **Mappings** टैब पर जाएं और सुनिश्चित करें कि **Create or Update User Profile** और **Track Events** विकल्प सक्षम हैं:

<img src="/integrations-segment-integration-8.webp" alt="Create or Update User Profile विकल्प के साथ मैपिंग्स टैब"/>

यह सत्यापित करना महत्वपूर्ण है कि आपके सोर्स से पुशवूश तक इवेंट फ़ील्ड की मैपिंग सही है ताकि यह सुनिश्चित हो सके कि आपके इवेंट सही ढंग से संसाधित हों।

यदि किसी इवेंट में _**device_platform**_ फ़ील्ड नहीं है या यह फ़ील्ड गलत है, तो आपके इवेंट को नज़रअंदाज़ कर दिया जाएगा। इसके अतिरिक्त, यदि किसी इवेंट में _**userId**_ या _**deviceId**_ नहीं है, तो उसे भी नज़रअंदाज़ कर दिया जाएगा।

यह सुनिश्चित करने के लिए कि आपकी मैपिंग सही ढंग से कॉन्फ़िगर की गई है, **Pushwoosh as Destination > Settings** पर जाएं।

<img src="/integrations-segment-integration-9.webp" alt="मैपिंग कॉन्फ़िगरेशन के लिए डेस्टिनेशन सेटिंग्स"/>

फिर, **Mapping** टैब चुनें और **Track Events** विधि के लिए **Edit Mapping** पर क्लिक करें।

<img src="/integrations-segment-integration-10.webp" alt="Track Events विधि के लिए मैपिंग संपादित करें"/>

इसके बाद, सुनिश्चित करें कि आपके इवेंट्स की मैपिंग पुशवूश को भेजे गए इवेंट्स के लिए सही है, और **Device Platform** और **External User ID** (या **Device ID**) फ़ील्ड ठीक से मेल खाते हैं।

<img src="/integrations-segment-integration-11.webp" alt="डिवाइस प्लेटफ़ॉर्म और एक्सटर्नल यूज़र आईडी के साथ इवेंट मैपिंग"/>

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

यदि इंटीग्रेशन सही ढंग से कॉन्फ़िगर किया गया है, तो पुशवूश सेगमेंट से इवेंट्स और उपयोगकर्ता एट्रिब्यूट्स प्राप्त करना शुरू कर देगा। इस डेटा के आधार पर, आप अत्यधिक लक्षित [कस्टमर जर्नी](/hi/product/customer-journey/pushwoosh-journey-overview) बना सकते हैं और अपने पुश नोटिफिकेशन, इन-ऐप संदेशों और ईमेल को [पर्सनलाइज़](/hi/product/personalization/dynamic-content/) कर सकते हैं।

### सोर्स कॉन्फ़िगर करना

1. अपने वर्कस्पेस के [सोर्सेज़ कैटलॉग पेज](https://app.segment.com/goto-my-workspace/sources/catalog) से, **Add Source** पर क्लिक करें।
2. सोर्सेज़ कैटलॉग में "**Pushwoosh**" खोजें, पुशवूश चुनें, और **Add Source** पर क्लिक करें।
3. अगली स्क्रीन पर, सोर्स को एक नाम दें और कोई अन्य सेटिंग्स कॉन्फ़िगर करें।

<Aside type="note">
नाम का उपयोग सेगमेंट ऐप में एक लेबल के रूप में किया जाता है, और सेगमेंट आपके वेयरहाउस में एक संबंधित स्कीमा नाम बनाता है। नाम कुछ भी हो सकता है, लेकिन पुशवूश कुछ ऐसा उपयोग करने की सलाह देता है जो सोर्स को ही दर्शाता है और आपके वातावरणों के बीच अंतर करता है (उदाहरण के लिए: Pushwoosh_Prod, Pushwoosh_Staging, Pushwoosh_Dev)।
</Aside>

4. अपनी सेटिंग्स को सहेजने के लिए **Add Source** पर क्लिक करें।
5. सेगमेंट UI से **राइट की** कॉपी करें।
6. अपने पुशवूश खाते में लॉग इन करें, और उस एप्लीकेशन का चयन करें जिसे आप कनेक्ट करना चाहते हैं।
7. **Settings > 3rd party integration > Segment** पर नेविगेट करें, **Configure बटन** पर क्लिक करें, और अपने सेगमेंट वर्कस्पेस से अपनी **राइट की** दर्ज करें।
8. उन इवेंट्स को सूचीबद्ध करें जिन्हें आप **Events** फ़ील्ड में `,` सीमांकक का उपयोग करके निर्यात करना चाहते हैं, या यदि आप सभी इवेंट्स को निर्यात करना चाहते हैं तो इसे खाली छोड़ दें, फिर **Apply** पर क्लिक करें।

#### स्ट्रीम

पुशवूश सेगमेंट इवेंट डेटा भेजने के लिए सेगमेंट स्ट्रीम सोर्स कंपोनेंट का उपयोग करता है। यह सेगमेंट को डेटा भेजने के लिए सर्वर-साइड ट्रैक विधि का उपयोग करता है। ये इवेंट फिर किसी भी डेस्टिनेशन में उपलब्ध होते हैं जो सर्वर-साइड इवेंट स्वीकार करता है, और आपके डेटा वेयरहाउस में एक स्कीमा में उपलब्ध होते हैं।

डिफ़ॉल्ट रूप से, पुशवूश पुशवूश यूज़र आईडी को सेगमेंट userId प्रॉपर्टी के रूप में पास करता है। यदि कोई संबंधित यूज़र आईडी नहीं है, तो पुशवूश HWID को सेगमेंट anonymousId के रूप में पास करेगा।

#### इवेंट्स

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

| इवेंट का नाम      | विवरण                                          |
| ------------------ | ----------------------------------------------- |
| Email Sent         | ईमेल सफलतापूर्वक भेजा गया                      |
| Push Sent          | पुश नोटिफिकेशन सफलतापूर्वक भेजा गया             |
| SMS Sent           | प्राप्तकर्ता को SMS भेजा गया                    |
| Push Opened        | पुश नोटिफिकेशन खोला गया                       |
| Email Opened       | ईमेल नोटिफिकेशन खोला गया                      |
| Email Delivered    | ईमेल सफलतापूर्वक डिलीवर हुआ                    |
| Push Delivered     | पुश नोटिफिकेशन सफलतापूर्वक डिलीवर हुआ        |
| SMS Delivered      | SMS सफलतापूर्वक डिलीवर हुआ                      |
| SMS Not Delivered  | SMS डिलीवरी विफल रही                            |
| Email Bounced      | स्थायी त्रुटि के कारण ईमेल प्रेषक को वापस आ गया |
| Email Unsubscribed | ईमेल अनसब्सक्राइब लिंक पर क्लिक किया गया         |

#### इवेंट प्रॉपर्टीज़

नीचे दी गई तालिका ऊपर सूचीबद्ध इवेंट्स में शामिल प्रॉपर्टीज़ को सूचीबद्ध करती है।

| प्रॉपर्टी का नाम | विवरण                                               |
| --------------- | --------------------------------------------------------- |
| `message_type`  | संदेश का प्रकार (Push, Email, In-App या SMS) शामिल है |
| `campaign_code` | संदेश अभियान का अद्वितीय पहचानकर्ता                 |
| `device_type`   | डिवाइस का प्रकार                                        |

#### डेस्टिनेशन जोड़ना

अब जब आपका सोर्स सेट हो गया है, तो आप इसे डेस्टिनेशन से कनेक्ट कर सकते हैं।

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

यदि सेगमेंट में इवेंट्स के आने में कोई समस्या है, तो [हमारी सहायता टीम से संपर्क करें](mailto:support@pushwoosh.com)।

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

1. **पुश नोटिफिकेशन की शुरुआत**: एक क्लाइंट पुशवूश इंटरफ़ेस के माध्यम से पुश नोटिफिकेशन शुरू करके प्रक्रिया शुरू करता है।
2. **इवेंट उत्पादन**: पुशवूश बैकएंड पुश नोटिफिकेशन अनुरोध को संसाधित करता है और एक इवेंट उत्पन्न करता है। यह इवेंट फिर पुशवूश द्वारा प्रबंधित `channels-tracking-log` नामक काफ्का टॉपिक पर भेजा जाता है।
3. **इवेंट की खपत**: सेगमेंट इंटीग्रेशन सेवा लगातार `channels-tracking-log` काफ्का टॉपिक को सुनती है और जैसे ही वे आते हैं, इवेंट्स का उपभोग करती है।
4. **इवेंट प्रोसेसिंग**: उपभोग किए गए इवेंट्स को सेगमेंट इंटीग्रेशन सेवा द्वारा संसाधित किया जाता है, जो उन्हें सेगमेंट ट्रैक इवेंट्स में बदल देती है।
5. **इवेंट ट्रांसमिशन**: संसाधित सेगमेंट ट्रैक इवेंट्स को फिर आगे की हैंडलिंग और विश्लेषण के लिए सेगमेंट बैकएंड पर भेजा जाता है।

## आप कैसे जानते हैं कि इंटीग्रेशन काम कर रहा है?

#### डेस्टिनेशन

##### track-user

 अपने **Pushwoosh account > Your Connected Application > Audience > User Explorer** पर जाएं। अपने उपयोगकर्ता/डिवाइस को ढूंढें और उन टैग्स की जांच करें जो सेगमेंट ने भेजे हैं।

##### post-event

अपने **Pushwoosh account > Your Connected Application > Audience > Events** पर जाएं। इवेंट चुनें, तीन-डॉट मेनू पर क्लिक करें, और इवेंट आँकड़े चुनें। सुनिश्चित करें कि इवेंट गिना गया है।

##### delete-user

 अपने **PW account > Your Connected Application > Audience > User Explorer** पर जाएं। सुनिश्चित करें कि उपयोगकर्ता/डिवाइस मौजूद नहीं है।

#### सोर्स

[सोर्स डीबगर](https://segment.com/docs/connections/sources/debugger/) का उपयोग उन इवेंट्स का पता लगाने के लिए करें जो पुशवूश से सेगमेंट में भेजे गए थे।

## समस्या निवारण

### इंटीग्रेशन की स्थिति जांचें

पुशवूश इंटीग्रेशन के साथ समस्याओं का निवारण करने के लिए, निम्नलिखित को सत्यापित करके शुरू करें:

**डेस्टिनेशन**

* **Track-User**: पुशवूश में `Audience > User Explorer` के तहत उपयोगकर्ता/डिवाइस जानकारी और टैग सत्यापित करें।
* **Post-Event**: इवेंट आँकड़ों की जाँच करके सुनिश्चित करें कि इवेंट पुशवूश में गिना गया है।
* **Delete-User**: पुष्टि करें कि उपयोगकर्ता/डिवाइस अब पुशवूश में मौजूद नहीं है।

**सोर्स**

[सेगमेंट डीबगर](https://segment.com/docs/connections/sources/debugger/) पर सोर्स डीबगर का उपयोग यह जांचने के लिए करें कि पुशवूश से इवेंट सेगमेंट में ठीक से भेजे गए हैं या नहीं।

### इवेंट का बेमेल होना

 यदि इवेंट सेगमेंट में सही ढंग से दिखाई नहीं दे रहे हैं, तो सुनिश्चित करें कि पुशवूश इवेंट प्रदान किए गए मैपिंग नियमों के अनुसार सेगमेंट ट्रैक इवेंट्स से सही ढंग से मैप किए गए हैं।

### प्रमाणीकरण संबंधी समस्याएं

सत्यापित करें कि पुशवूश और सेगमेंट के अनुरोधों में सही प्रमाणीकरण टोकन या API की का उपयोग किया गया है।

### डेटा प्रवाह संबंधी समस्याएं

पुष्टि करें कि पुशवूश और सेगमेंट के बीच डेटा प्रवाह निर्बाध है और काफ्का टॉपिक्स की सही ढंग से निगरानी की जा रही है।

## अक्सर पूछे जाने वाले प्रश्न

### पुशवूश से सेगमेंट में किस प्रकार के इवेंट भेजे जाते हैं?

आरक्षित इवेंट जैसे कि **Push Sent, Email Sent, SMS Sent, Push Delivered, Email Delivered, SMS Delivered, और Email Bounced** सेगमेंट में भेजे जाते हैं।

### मैं यह कैसे सत्यापित कर सकता हूं कि इवेंट सेगमेंट में सही ढंग से भेजे गए हैं?

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

### अगर मुझे इंटीग्रेशन में कोई समस्या आती है तो मुझे क्या करना चाहिए?

पुशवूश में उपयोगकर्ता/डिवाइस जानकारी, इवेंट गणना, और उपयोगकर्ता विलोपन को सत्यापित करके इंटीग्रेशन की स्थिति की जांच करें। इसके अतिरिक्त, सुनिश्चित करें कि सही प्रमाणीकरण टोकन का उपयोग किया जाता है और डेटा प्रवाह निर्बाध है।

### इंटीग्रेशन में उपयोगकर्ता और डिवाइस की जानकारी को कैसे संभाला जाता है?

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

### मुझे इंटीग्रेशन के लिए विस्तृत दस्तावेज़ीकरण कहां मिल सकता है?

विस्तृत दस्तावेज़ीकरण सेगमेंट और पुशवूश इंटीग्रेशन मैनुअल के साथ-साथ उनके संबंधित API दस्तावेज़ीकरण में उपलब्ध है।