# एम्प्लिट्यूड इंटीग्रेशन

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

[एम्प्लिट्यूड](https://amplitude.com/), एक मजबूत उत्पाद एनालिटिक्स प्लेटफॉर्म, व्यवसायों को वास्तविक समय में उपयोगकर्ता के व्यवहार को समझने, इन-प्रोडक्ट इंटरैक्शन को ट्रैक करने और उपयोगकर्ता जुड़ाव, प्रतिधारण और राजस्व में मूल्यवान अंतर्दृष्टि प्राप्त करने का अधिकार देता है।

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

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

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

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

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

एम्प्लिट्यूड से पुशवूश तक इवेंट स्ट्रीमिंग और कोहोर्ट सिंक इंटीग्रेशन सेट अप करने के लिए, सुनिश्चित करें कि निम्नलिखित पूर्वापेक्षाएँ पूरी हों:

* आपके पास एक सक्रिय पुशवूश खाता होना चाहिए।
* डेटा भेजने के लिए पुशवूश में एक [API एक्सेस टोकन](/hi/developer/api-reference/api-access-token) जेनरेट करें।
* इंटीग्रेशन को कॉन्फ़िगर करने से पहले अपने पुशवूश ऐप कोड का पता लगाएँ।
* यह इंटीग्रेशन केवल भुगतान योजनाओं वाले एम्प्लिट्यूड ग्राहकों के लिए उपलब्ध है।
* इस इंटीग्रेशन का उपयोग करने के लिए आपके पास एक भुगतान किया हुआ पुशवूश प्लान होना चाहिए।

### शब्दावली (इकाई नामों का मानचित्रण यदि वे भिन्न हैं)

एम्प्लिट्यूड में **कोहोर्ट्स** = पुशवूश में **सेगमेंट्स**

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

* इवेंट्स
* टैग्स
* सेगमेंट्स

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

पुशवूश के साथ एम्प्लिट्यूड इंटीग्रेशन उपयोगकर्ता जुड़ाव और विभाजन को बढ़ाने के लिए दो प्लेटफार्मों के बीच डेटा को सिंक करके काम करता है। यहाँ यह कैसे काम करता है इसका विस्तृत विवरण दिया गया है:

##### डेटा ट्रांसमिशन

- **इवेंट्स**: एम्प्लिट्यूड इवेंट डेटा को पुशवूश को भेजता है। प्रत्येक इवेंट में एक उपयोगकर्ता आईडी (`external_id`), एक एप्लिकेशन कोड (`app_id`), एक टाइमस्टैम्प (`created_at`), और अतिरिक्त विशेषताएँ (`attributes`) होती हैं।

- **टैग्स**: पुशवूश को टैग प्राप्त होते हैं जो उपयोगकर्ता प्रोफाइल से जुड़े होते हैं। ये टैग एक उपयोगकर्ता आईडी (`external_id`), एक एप्लिकेशन कोड (`app_id`), और टैग गुण (`properties`) के साथ भेजे जाते हैं।

- **सेगमेंट्स**: सेगमेंट्स उसी तरह आयात किए जाते हैं जैसे पुशवूश CSV आयात को संभालता है। उपयोगकर्ताओं को अनुरोधों के माध्यम से सेगमेंट्स में जोड़ा या हटाया जाता है।

##### डेटा प्रवाह

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

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

##### अनुरोध

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


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

##### इवेंट ट्रैकिंग

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

##### उपयोगकर्ता टैगिंग

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

##### सेगमेंट प्रबंधन
एम्प्लिट्यूड में कॉन्फ़िगर किए गए डेटा और सेगमेंट के आधार पर पुशवूश में उपयोगकर्ता सेगमेंट बनाएं और प्रबंधित करें। यह व्यक्तिगत संदेशों के साथ उपयोगकर्ताओं के विशिष्ट समूहों को लक्षित करने में मदद करता है।

##### स्वचालित उपयोगकर्ता प्रबंधन

एम्प्लिट्यूड में उनके कार्यों या विशेषताओं के आधार पर उपयोगकर्ताओं को स्वचालित रूप से सेगमेंट से जोड़ें या हटाएं, जिससे पुशवूश में अप-टू-डेट विभाजन सुनिश्चित हो।

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


### कोहोर्ट सिंक

##### पुशवूश सेटअप

1. पुशवूश में, **Settings > Integrations** पर नेविगेट करें।
2. **Add Integration** पर क्लिक करें, फिर **Amplitude** ढूंढें और जोड़ें।

   <img src="/integrations-amplitude-integration-1.webp" alt="पुशवूश सेटिंग्स में एम्प्लिट्यूड इंटीग्रेशन विकल्प"/>

3. पुशवूश **API Key** और **App Code** को अपने क्लिपबोर्ड पर कॉपी करें।


##### एम्प्लिट्यूड सेटअप

एम्प्लिट्यूड को इंटीग्रेशन के लिए कॉन्फ़िगर करने के लिए, इन चरणों का पालन करें:

1. अपने एम्प्लिट्यूड **Data** में, **Catalog** पर जाएं और **Destinations** चुनें।
2. कोहोर्ट सेक्शन के तहत, **Pushwoosh** का पता लगाएँ और क्लिक करें।

<img src="/integrations-amplitude-integration-2.webp" alt="डेस्टिनेशन से पुशवूश चुनना"/>

3. **Add another destination** पर क्लिक करें।

<img src="/integrations-amplitude-integration-3.webp" alt="एक और डेस्टिनेशन जोड़ना"/>

4. एक नाम प्रदान करें और पुशवूश से कॉपी की गई API कुंजी पेस्ट करें।

<img src="/integrations-amplitude-integration-4.webp" alt="पुशवूश एपीआई एक्सेस टोकन और एप्लिकेशन कोड जोड़ना"/>

5. एम्प्लिट्यूड उपयोगकर्ता आईडी फ़ील्ड को पुशवूश उपयोगकर्ता आईडी फ़ील्ड से मैप करें।
6. जब आप पूरा कर लें तो अपनी सेटिंग्स सहेजें।

##### एक कोहोर्ट भेजना

अपना पहला कोहोर्ट सिंक्रनाइज़ करने के लिए, निम्नलिखित चरणों को पूरा करें:

1. एम्प्लिट्यूड में, उस कोहोर्ट को खोलें जिसे आप सिंक्रनाइज़ करना चाहते हैं, फिर **Sync** पर क्लिक करें।

<img src="/integrations-amplitude-integration-5.webp" alt="एक कोहोर्ट भेजना"/>

2. **Pushwoosh** चुनें और उस खाते का चयन करें जिसके साथ आप सिंक्रनाइज़ करना चाहते हैं। फिर, **Next** पर क्लिक करें।

<img src="/integrations-amplitude-integration-6.webp" alt="सिंक डेस्टिनेशन के रूप में पुशवूश का चयन करना"/>

3. सिंक्रनाइज़ेशन कैडेंस पर निर्णय लें और अपने कॉन्फ़िगरेशन को सहेजें।

<img src="/integrations-amplitude-integration-7.webp" alt="सिंक्रनाइज़ेशन कैडेंस सेट करना"/>

### इवेंट स्ट्रीमिंग

##### पुशवूश सेटअप
1. अपनी पुशवूश API कुंजी प्राप्त करें

2. अपने पुशवूश खाते में ऐप कोड का पता लगाएँ।

##### एम्प्लिट्यूड सेटअप
1. एम्प्लिट्यूड में, **Data Destinations** पर जाएं और **Pushwoosh - Event Stream** ढूंढें।

<img src="/integrations-amplitude-integration-8.webp" alt="डेटा डेस्टिनेशन जो पुशवूश इवेंट स्ट्रीम विकल्प दिखा रहा है"/>

2. एक सिंक नाम दर्ज करें और फिर **Create Sync** पर क्लिक करें।

<img src="/integrations-amplitude-integration-9.webp" alt="एम्प्लिट्यूड सिंक नाम निर्माण फ़ॉर्म"/>

3. स्थिति को **Disabled से Enabled** में बदलें और अपना पुशवूश API एक्सेस टोकन और ऐप कोड पेस्ट करें।

<img src="/integrations-amplitude-integration-10.webp" alt="एपीआई क्रेडेंशियल्स के साथ पुशवूश इवेंट स्ट्रीम को सक्षम करना"/>

4. बाएं ड्रॉपडाउन से, उस एम्प्लिट्यूड उपयोगकर्ता संपत्ति का चयन करें जो आपके पुशवूश UserID से मेल खाती है।
5. (वैकल्पिक) **Create & Update users** टॉगल को सक्षम करें यदि आप उपयोगकर्ताओं और उनकी संपत्तियों को वास्तविक समय में भेजना चाहते हैं जब भी एम्प्लिट्यूड किसी उपयोगकर्ता संपत्ति को बनाता या अपडेट करता है।

<img src="/integrations-amplitude-integration-11.webp" alt="उपयोगकर्ता बनाएं और अपडेट करें टॉगल विकल्प"/>

6. **Send Events** ("इवेंट्स पुशवूश को भेजे जाते हैं") को सक्षम करें यदि आप इवेंट्स को पुशवूश में स्ट्रीम करना चाहते हैं। यह स्वचालित रूप से इवेंट्स को पुशवूश को अग्रेषित करेगा जैसे ही वे एम्प्लिट्यूड में शामिल होते हैं। इस इंटीग्रेशन का उपयोग करके इवेंट्स को शेड्यूल पर या मांग पर नहीं भेजा जाता है।

<img src="/integrations-amplitude-integration-12.webp" alt="रीयल-टाइम इवेंट स्ट्रीमिंग के लिए इवेंट भेजें विकल्प"/>

8. फिर, चुनें कि आप **Select and Filter Events** सेक्शन में कौन से इवेंट भेजना चाहते हैं। केवल उन इवेंट्स का चयन करें जिनकी आपको पुशवूश में आवश्यकता है; रूपांतरित इवेंट्स समर्थित नहीं हैं।
9. एक बार हो जाने के बाद, डेस्टिनेशन को सक्षम करें और **Save** पर क्लिक करें।

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

यह सत्यापित करने के लिए कि एम्प्लिट्यूड और पुशवूश इंटीग्रेशन सही ढंग से काम कर रहा है, आप निम्नलिखित तरीकों का उपयोग कर सकते हैं:

##### पुशवूश डैशबोर्ड की निगरानी करें

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

##### API प्रतिक्रियाओं की जाँच करें

- **सफल प्रतिक्रियाएँ**: सुनिश्चित करें कि आपको पुशवूश API एंडपॉइंट्स से `200 OK` प्रतिक्रियाएँ प्राप्त होती हैं। यद्यपि हमेशा एक प्रतिक्रिया निकाय नहीं हो सकता है, `200 OK` स्थिति इंगित करती है कि अनुरोध सफलतापूर्वक प्राप्त हुआ था।
- **त्रुटि प्रतिक्रियाएँ**: यदि कुछ काम नहीं कर रहा है तो सुराग के लिए `200 OK` के अलावा किसी भी त्रुटि प्रतिक्रिया या स्थिति कोड की समीक्षा करें। सामान्य त्रुटियों में `400 Bad Request`, `401 Unauthorized`, या `500 Internal Server Error` शामिल हो सकते हैं।

##### अनुरोधों और प्रतिक्रियाओं को लॉग करें

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

##### नमूना डेटा के साथ परीक्षण करें

- **परीक्षण इवेंट्स/टैग्स भेजें**: एम्प्लिट्यूड से पुशवूश को परीक्षण इवेंट्स और टैग्स बनाएं और भेजें। सत्यापित करें कि ये परीक्षण प्रविष्टियाँ पुशवूश में सही ढंग से दिखाई देती हैं और अपेक्षित व्यवहारों को ट्रिगर करती हैं।
- **उपयोगकर्ता क्रियाओं का अनुकरण करें**: एम्प्लिट्यूड में ऐसी क्रियाएं करें जो पुशवूश में विशिष्ट इवेंट्स या अपडेट को ट्रिगर करनी चाहिए। जाँच करें कि क्या इन क्रियाओं के परिणामस्वरूप पुशवूश में अपेक्षित परिवर्तन होते हैं।

##### निगरानी उपकरणों का उपयोग करें

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

##### इंटीग्रेशन दस्तावेज़ीकरण की समीक्षा करें

- **कॉन्फ़िगरेशन समीक्षा**: यह सुनिश्चित करने के लिए एम्प्लिट्यूड और पुशवूश दोनों में इंटीग्रेशन कॉन्फ़िगरेशन की दोबारा जाँच करें कि सभी सेटिंग्स और मैपिंग सही ढंग से लागू हैं।
- **दस्तावेज़ीकरण अपडेट**: इंटीग्रेशन दस्तावेज़ीकरण में किसी भी परिवर्तन या अपडेट के साथ अपडेट रहें जो कार्यक्षमता को प्रभावित कर सकता है।

##### समर्थन से संपर्क करें

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

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

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

- **इवेंट पुशवूश में दिखाई नहीं दे रहा है**: सुनिश्चित करें कि इवेंट सही ढंग से मैप किया गया है, और सत्यापित करें कि पुशवूश एप्लिकेशन कोड और API टोकन ठीक से कॉन्फ़िगर किए गए हैं।

- **टैग सिंक नहीं हो रहे हैं**: पुष्टि करें कि टैग सही ढंग से स्वरूपित हैं और अनुरोध में सभी आवश्यक प्रमाणीकरण विवरण शामिल हैं।

##### सेगमेंट समस्याएं

- **सेगमेंट नहीं बनाया गया**: जाँच करें कि सेगमेंट बनाने का अनुरोध सही ढंग से स्वरूपित है और पुशवूश API टोकन मान्य है।

- **उपयोगकर्ताओं को जोड़ा/हटाया नहीं गया**: सत्यापित करें कि उपयोगकर्ता आईडी सही ढंग से निर्दिष्ट हैं और सेगमेंट आईडी मान्य है। सुनिश्चित करें कि अनुरोध पेलोड ठीक से स्वरूपित है।

##### प्रतिक्रिया मुद्दे

- **कोई प्रतिक्रिया निकाय नहीं**: यदि आपको `200 OK` प्रतिक्रिया मिलती है लेकिन कोई प्रतिक्रिया निकाय नहीं है, तो सत्यापित करें कि अनुरोध ठीक से स्वरूपित था और डेटा सही ढंग से भेजा गया था।

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

### यदि मुझे `400 Bad Request` त्रुटि मिलती है तो मुझे क्या करना चाहिए?
स्वरूपण त्रुटियों या गुम फ़ील्ड के लिए अनुरोध पेलोड की समीक्षा करें। सुनिश्चित करें कि सभी आवश्यक फ़ील्ड शामिल हैं और सही ढंग से स्वरूपित हैं।

### मैं कैसे सत्यापित कर सकता हूं कि इंटीग्रेशन काम कर रहा है?
आने वाले इवेंट्स, टैग्स और सेगमेंट अपडेट के लिए पुशवूश डैशबोर्ड की जाँच करें। आप सफल डेटा ट्रांसफर के लिए API एंडपॉइंट्स से लॉग या प्रतिक्रियाओं की भी निगरानी कर सकते हैं।

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

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

### मैं इस इंटीग्रेशन के लिए और जानकारी या समर्थन कहां पा सकता हूं?
एम्प्लिट्यूड और पुशवूश से आधिकारिक दस्तावेज़ीकरण देखें। आगे की सहायता के लिए, संबंधित सहायता टीमों से संपर्क करें।