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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Pushwoosh और सेगमेंट दोनों में भुगतान किए गए खाते

### सिंक्रनाइज़ की गई इकाइयाँ

**सोर्स**

* पुश सांख्यिकी


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

* डिवाइस
* टैग

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

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

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

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

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

**उपयोगकर्ता प्रबंधन**

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

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

<Aside type="note">
सेगमेंट के साथ इंटीग्रेशन सेट अप करने से पहले, [Pushwoosh 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. **Pushwoosh API की** और **एप्लिकेशन कोड** दर्ज करें। सुनिश्चित करें कि **Enable Destination** स्विच चालू है। उसके बाद, **Save Changes** पर क्लिक करें।

<details>

<summary>मुझे API की और एप्लिकेशन कोड कहाँ मिल सकता है?</summary>

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

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

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

<img src="/integrations-segment-integration-7.webp" alt="Pushwoosh इंटरफ़ेस में एप्लिकेशन कोड" 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 विकल्प के साथ मैपिंग्स टैब"/>

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

यदि किसी इवेंट में _**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="ट्रैक इवेंट्स विधि के लिए मैपिंग संपादित करें"/>

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

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

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

यदि इंटीग्रेशन सही ढंग से कॉन्फ़िगर किया गया है, तो Pushwoosh सेगमेंट से इवेंट्स और उपयोगकर्ता विशेषताएँ प्राप्त करना शुरू कर देगा। इस डेटा के आधार पर, आप अत्यधिक लक्षित [ग्राहक यात्राएँ](/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**" खोजें, Pushwoosh चुनें, और **Add Source** पर क्लिक करें।
3. अगली स्क्रीन पर, सोर्स को एक नाम दें और कोई अन्य सेटिंग्स कॉन्फ़िगर करें।

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

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

#### स्ट्रीम

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

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

#### इवेंट्स

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

| इवेंट का नाम        | विवरण                                           |
| ------------------ | ----------------------------------------------- |
| 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`  | संदेश का प्रकार (पुश, ईमेल, इन-ऐप या SMS) होता है         |
| `campaign_code` | संदेश अभियान का अद्वितीय पहचानकर्ता                       |
| `device_type`   | डिवाइस का प्रकार                                          |

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

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

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

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

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

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

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

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

##### track-user

 अपने **Pushwoosh खाते > आपका कनेक्टेड एप्लिकेशन > ऑडियंस > यूज़र एक्सप्लोरर** पर जाएँ। अपने उपयोगकर्ता/डिवाइस को ढूंढें और उन टैग्स की जाँच करें जो सेगमेंट ने भेजे हैं।

##### post-event

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

##### delete-user

 अपने **PW खाते > आपका कनेक्टेड एप्लिकेशन > ऑडियंस > यूज़र एक्सप्लोरर** पर जाएँ। सुनिश्चित करें कि उपयोगकर्ता/डिवाइस मौजूद नहीं है।

#### सोर्स

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

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

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

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

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

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

**सोर्स**

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

### इवेंट का मेल न खाना

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

### प्रमाणीकरण समस्याएँ

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

### डेटा प्रवाह समस्याएँ

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

## सामान्य प्रश्न

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

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

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

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

### यदि मुझे इंटीग्रेशन के साथ समस्याओं का सामना करना पड़ता है तो मुझे क्या करना चाहिए?

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

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

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

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

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