# सिंगुलर इंटीग्रेशन
## इंटीग्रेशन का अवलोकन
[Singular](https://www.singular.net/) एक मार्केटिंग एनालिटिक्स और एट्रिब्यूशन प्लेटफॉर्म है। इसे Pushwoosh के साथ कनेक्ट करें ताकि आप अपने पुश अभियानों से ऐप ओपन को एट्रिब्यूट कर सकें और अन्य मार्केटिंग चैनलों के साथ Singular में पुश प्रदर्शन को माप सकें। आप पोस्टबैक के माध्यम से Singular से Pushwoosh में एट्रिब्यूशन डेटा भी भेज सकते हैं और इसे सेगमेंटेशन और मैसेजिंग के लिए उपयोग कर सकते हैं।
### उपयोग के मामले
* **पुश नोटिफिकेशन एट्रिब्यूशन:** Singular में Pushwoosh पुश अभियानों से ऐप ओपन को एट्रिब्यूट करें जब उपयोगकर्ता आपके नोटिफिकेशन पर टैप करते हैं।
* **अभियान प्रदर्शन विश्लेषण:** Singular एनालिटिक्स डैशबोर्ड में अन्य मार्केटिंग चैनलों के साथ पुश अभियान के परिणामों की तुलना करें।
* **ROI ऑप्टिमाइज़ेशन:** Singular में अपने सबसे अच्छा प्रदर्शन करने वाले पुश अभियानों की पहचान करें और Pushwoosh में नए अभियानों की योजना बनाते समय उन जानकारियों को लागू करें।
* **Pushwoosh में सेगमेंटेशन:** Pushwoosh में सेगमेंट बनाने और अभियानों को व्यक्तिगत बनाने के लिए Singular पोस्टबैक से इंस्टॉल और इन-ऐप इवेंट डेटा का उपयोग करें।
### पूर्वापेक्षाएँ
* सक्रिय Pushwoosh अकाउंट
* सक्रिय Singular अकाउंट
* आपके ऐप में Singular SDK इंटीग्रेटेड हो
* आपके Pushwoosh अकाउंट से [एप्लिकेशन कोड](/hi/developer/api-reference/api-identifiers/#application-code) और [API एक्सेस टोकन](/hi/developer/api-reference/api-identifiers/#api-access-token)
### इंटीग्रेशन का प्रकार
* **स्रोत (Pushwoosh → Singular):** एट्रिब्यूशन डेटा डिवाइस पर पुश पेलोड से Singular ट्रैकिंग लिंक के माध्यम से Singular में पास किया जाता है।
* **गंतव्य (Singular → Pushwoosh):** Singular पोस्टबैक के माध्यम से Pushwoosh को एट्रिब्यूशन डेटा भेजता है। Pushwoosh इसे सेगमेंटेशन और एनालिटिक्स के लिए टैग और इवेंट के रूप में संग्रहीत करता है।
### यह कैसे काम करता है
##### पुश एट्रिब्यूशन (Pushwoosh → Singular)
1. Pushwoosh एक डीप लिंक के रूप में Singular ट्रैकिंग लिंक के साथ एक पुश डिलीवर करता है।
2. उपयोगकर्ता नोटिफिकेशन पर टैप करता है।
3. ऐप लिंक को Singular SDK को पास करता है।
4. Singular ओपन को आपके पुश अभियान के लिए एट्रिब्यूटेड के रूप में रिकॉर्ड करता है।
##### पोस्टबैक (Singular → Pushwoosh)
1. एक उपयोगकर्ता ऐप इंस्टॉल करता है, एक ट्रैक किए गए लिंक से फिर से जुड़ता है, या एक इन-ऐप इवेंट को ट्रिगर करता है जिसे Singular एट्रिब्यूट करता है।
2. Singular एट्रिब्यूशन डेटा के साथ Pushwoosh को एक पोस्टबैक भेजता है।
3. Pushwoosh डेटा को उपयोगकर्ता प्रोफ़ाइल पर टैग और इवेंट के रूप में संग्रहीत करता है।
4. आप इस डेटा का उपयोग Pushwoosh में सेगमेंटेशन, एनालिटिक्स और अभियानों के लिए करते हैं।
## अपने एप्लिकेशन के लिए लिंक कॉन्फ़िगर करें
Singular में एक पार्टनर लिंक बनाकर Pushwoosh और Singular इंटीग्रेशन शुरू करें। यह चरण आवश्यक है चाहे आप पोस्टबैक, पुश एट्रिब्यूशन, या दोनों का उपयोग करें।
1. अपने Singular अकाउंट में, **Attribution Setup** → **Manage Links** पर जाएं।
2. **Link Type** → **Partner** चुनें और **Source Name** के रूप में **Pushwoosh** का चयन करें। एक **Tracking Link Name** दर्ज करें ताकि आप इस लिंक को Singular एनालिटिक्स में पहचान सकें। यह रिपोर्ट में **Tracker Name** के रूप में दिखाई देता है।
3. **Link Settings and Redirects** में, परिभाषित करें कि यह लिंक किस ऐप के लिए है और उपयोगकर्ता इसे टैप करने पर कहाँ जाते हैं। [और जानें](https://support.singular.net/hc/en-us/articles/13000445013531-How-to-Build-Tracking-Links)।
4. **Attribution Settings** में, लिंक के लिए एट्रिब्यूशन विधियों और विंडो को कॉन्फ़िगर करें। [और जानें](https://support.singular.net/hc/en-us/articles/13000445013531-How-to-Build-Tracking-Links#links_attribution_settings)।
5. **Generate** पर क्लिक करें।
6. **Link Summary** में, जेनरेट किए गए लिंक की समीक्षा करें। यदि आप [पुश एट्रिब्यूशन सेट अप कर रहे हैं](#set-up-push-attribution-in-pushwoosh), तो **Click-through tracking link** को कॉपी करें। आप इसका उपयोग Pushwoosh में करेंगे।
## Pushwoosh में पुश एट्रिब्यूशन सेट अप करें
अपने पुश नोटिफिकेशन में Singular ट्रैकिंग लिंक जोड़ें।
अपने **Link Summary** से **Click-through tracking link** को एक [Push preset](/hi/product/content/push-presets/#define-the-next-step-for-users-who-click-on-the-notification) में **On-click actions** → **Deep link in application** में पेस्ट करें।
## पोस्टबैक कॉन्फ़िगर करें
Singular इस बारे में एट्रिब्यूशन डेटा एकत्र करता है कि उपयोगकर्ता कहाँ से आते हैं और वे ऐप में क्या करते हैं। पोस्टबैक के साथ, आप उस डेटा को स्वचालित रूप से Pushwoosh को भेजते हैं।
उदाहरण के लिए, यदि Singular रिकॉर्ड करता है कि एक उपयोगकर्ता ने एक विशिष्ट विज्ञापन अभियान से ऐप इंस्टॉल किया है, तो Pushwoosh इसे एक टैग या इवेंट के रूप में प्राप्त कर सकता है। फिर आप उस अभियान के उपयोगकर्ताओं का एक सेगमेंट बना सकते हैं और उन्हें Pushwoosh में एक लक्षित पुश भेज सकते हैं।
1. Singular में, **Partner Configuration** पर जाएं।
2. एक नया कॉन्फ़िगरेशन बनाएं या किसी मौजूदा को संपादित करें।
3. अपना Pushwoosh **Application Code** और **API Access Token** दर्ज करें।
4. **Attribution Postbacks** में, चुनें कि Singular कौन से इवेंट Pushwoosh को भेजता है:
* **इंस्टॉल:** Singular में एट्रिब्यूट किए गए नए ऐप इंस्टॉल। Pushwoosh इस डेटा का उपयोग यह रिकॉर्ड करने के लिए करता है कि उपयोगकर्ता कहाँ से आए थे।
* **री-एंगेजमेंट:** ट्रैक किए गए लिंक के लिए एट्रिब्यूट किए गए ऐप ओपन। यदि आप सेगमेंटेशन के लिए Pushwoosh में री-एंगेजमेंट स्रोत डेटा चाहते हैं तो इसे सक्षम करें।
Singular सहायता केंद्र में [पार्टनर सेटिंग्स और पोस्टबैक को कॉन्फ़िगर करना सीखें](https://support.singular.net/hc/en-us/articles/360053018851-How-to-Configure-Partner-Settings-and-Postbacks)।
5. **Attribution Windows Settings** में, **Installs** के तहत, चुनें कि उपयोगकर्ता द्वारा आपके ट्रैकिंग लिंक पर क्लिक करने या विज्ञापन देखने के बाद Singular कितनी देर तक प्रतीक्षा कर सकता है, इससे पहले कि वह Pushwoosh को इंस्टॉल का श्रेय देना बंद कर दे। [और जानें](https://support.singular.net/hc/en-us/articles/115000526963-Understanding-Singular-Mobile-App-Attribution)।
6. **Re-engagements** के तहत, चुनें कि क्लिक या विज्ञापन देखने के बाद Singular कितनी देर तक प्रतीक्षा कर सकता है, इससे पहले कि वह Pushwoosh को ओपन का श्रेय देना बंद कर दे। **Override app level inactivity window for this partner** को सक्षम करें ताकि यह सेट किया जा सके कि उस ओपन को री-एंगेजमेंट के रूप में गिनने से पहले उपयोगकर्ता को कितनी देर तक निष्क्रिय रहना चाहिए। [और जानें](https://support.singular.net/hc/en-us/articles/360044494651-Re-engagement-FAQ)।
7. **In app Events Postback** टैब खोलें और उन इवेंट्स को जोड़ें जिन्हें Pushwoosh को प्राप्त करना चाहिए (उदाहरण के लिए सत्रों के लिए `__SESSION__*`)। किसी भी स्रोत से उपयोगकर्ताओं को शामिल करने के लिए **Send All** सक्षम करें।
8. कॉन्फ़िगरेशन सहेजें।
### Pushwoosh को क्या प्राप्त होता है
आपके सहेजने के बाद, कॉन्फ़िगर किए गए इवेंट होने पर Singular पोस्टबैक भेजता है। Pushwoosh प्रत्येक पोस्टबैक को डिवाइस **टैग** और उपयोगकर्ता प्रोफ़ाइल पर एक **इवेंट** में प्रोसेस करता है।
Pushwoosh मेल खाने वाले डिवाइस पर इन टैग को लिखता या अपडेट करता है:
| टैग | स्रोत |
| :-- | :----- |
| OS संस्करण | डिवाइस OS संस्करण |
| एप्लिकेशन संस्करण | ऐप संस्करण |
| डिवाइस मॉडल | डिवाइस मॉडल |
| देश | एट्रिब्यूशन देश |
| शहर | एट्रिब्यूशन शहर |
Pushwoosh उपयोगकर्ता प्रोफ़ाइल पर एक इवेंट रिकॉर्ड करता है। इवेंट का नाम पोस्टबैक प्रकार पर निर्भर करता है:
* **इन-ऐप इवेंट्स:** आपके द्वारा कॉन्फ़िगर किया गया Singular इवेंट नाम (उदाहरण के लिए, एक सत्र इवेंट)।
* **इंस्टॉल या एट्रिब्यूशन पोस्टबैक:** यदि पोस्टबैक में कोई इवेंट नाम नहीं है, तो Pushwoosh `Singular Attribution Event` रिकॉर्ड करता है। इस इवेंट नाम का उपयोग तब करें जब आप नए एट्रिब्यूट किए गए उपयोगकर्ताओं के सेगमेंट बनाते हैं।
अभियान और राजस्व डेटा इवेंट के साथ **इवेंट एट्रिब्यूट** के रूप में यात्रा करते हैं। आप Pushwoosh में उन पर सेगमेंट और फ़िल्टर कर सकते हैं:
| एट्रिब्यूट | विवरण |
| :-------- | :---------- |
| अभियान का नाम / अभियान आईडी | एट्रिब्यूटेड अभियान |
| उप-अभियान का नाम / उप-अभियान आईडी | एट्रिब्यूटेड उप-अभियान |
| क्रिएटिव का नाम / क्रिएटिव आईडी | एट्रिब्यूटेड क्रिएटिव |
| राशि / राजस्व / मुद्रा | इवेंट का मौद्रिक मूल्य, यदि कोई हो |
| देश / शहर | इवेंट के साथ रिपोर्ट किया गया स्थान |
### पोस्टबैक सत्यापित करें
Singular द्वारा कॉन्फ़िगर किए गए इवेंट के लिए पोस्टबैक भेजने के बाद, जांचें कि Pushwoosh ने इसे प्राप्त किया है:
1. **Audience → Events** खोलें और पुष्टि करें कि इवेंट दिखाई देता है।
2. [User Explorer](/hi/product/audience-data-and-segmentation/user-explorer/) में उपयोगकर्ता प्रोफ़ाइल खोलें और [Events history](/hi/product/audience-data-and-segmentation/user-explorer/#events-history-tab) पर जाएं। पुष्टि करें कि इवेंट और उसके एट्रिब्यूट (उदाहरण के लिए, अभियान का नाम) उस उपयोगकर्ता के लिए रिकॉर्ड किए गए हैं।
3. इवेंट आमतौर पर कुछ मिनटों के भीतर दिखाई देते हैं।
## समस्या निवारण
### सिंगुलर ट्रैकिंग लिंक कैप्चर नहीं हो रहा है
* सत्यापित करें कि **Click-through tracking link** **On-click actions** → **Deep link in application** में सेट है, **Custom Data** में नहीं।
* पुष्टि करें कि Singular SDK पुश नोटिफिकेशन पेलोड को संभालने के लिए कॉन्फ़िगर किया गया है। [Android](https://support.singular.net/hc/en-us/articles/35427027157275-Android-SDK-Supporting-Push-Notifications) और [iOS](https://support.singular.net/hc/en-us/articles/42098616285339-iOS-SDK-Configuration-Methods-Reference) गाइड देखें।
### डीप लिंक ऐप खोलता है लेकिन होम स्क्रीन पर नेविगेट करता है
* पुष्टि करें कि Singular ट्रैकिंग लिंक के अंदर `_dl` पैरामीटर ठीक से URL-एन्कोडेड है।
* सत्यापित करें कि आपके ऐप का डीप लिंक हैंडलर उपयोग की गई स्कीम के लिए सही ढंग से पंजीकृत है (उदाहरण के लिए, `myapp://`)।
* Android पर, जांचें कि सही `Activity` में `AndroidManifest.xml` में आपके डीप लिंक स्कीम के लिए इंटेंट फ़िल्टर है।
### सिंगुलर में एट्रिब्यूशन दिखाई देता है लेकिन गलत अभियान को क्रेडिट किया जाता है
* सुनिश्चित करें कि Singular SDK पुश पेलोड को इनिशियलाइज़ेशन से पहले या उसके दौरान प्रोसेस करता है, जैसा कि Singular SDK गाइड में वर्णित है।
* पुष्टि करें कि आप इस अभियान के लिए **Link Summary** से सही **Click-through tracking link** का उपयोग कर रहे हैं।
### वार्म स्टार्ट (ऐप पहले से खुला है): एट्रिब्यूशन रिकॉर्ड नहीं किया गया
* पुष्टि करें कि आपका ऐप पुश नोटिफिकेशन टैप को तब संभालता है जब यह पहले से ही बैकग्राउंड में चल रहा हो, जैसा कि Singular SDK गाइड में वर्णित है।
* यह वार्म स्टार्ट के लिए गुम एट्रिब्यूशन का सबसे आम कारण है।
2. **Link Type** → **Partner** चुनें और **Source Name** के रूप में **Pushwoosh** का चयन करें। एक **Tracking Link Name** दर्ज करें ताकि आप इस लिंक को Singular एनालिटिक्स में पहचान सकें। यह रिपोर्ट में **Tracker Name** के रूप में दिखाई देता है।
3. **Link Settings and Redirects** में, परिभाषित करें कि यह लिंक किस ऐप के लिए है और उपयोगकर्ता इसे टैप करने पर कहाँ जाते हैं। [और जानें](https://support.singular.net/hc/en-us/articles/13000445013531-How-to-Build-Tracking-Links)।
4. **Attribution Settings** में, लिंक के लिए एट्रिब्यूशन विधियों और विंडो को कॉन्फ़िगर करें। [और जानें](https://support.singular.net/hc/en-us/articles/13000445013531-How-to-Build-Tracking-Links#links_attribution_settings)।
5. **Generate** पर क्लिक करें।
6. **Link Summary** में, जेनरेट किए गए लिंक की समीक्षा करें। यदि आप [पुश एट्रिब्यूशन सेट अप कर रहे हैं](#set-up-push-attribution-in-pushwoosh), तो **Click-through tracking link** को कॉपी करें। आप इसका उपयोग Pushwoosh में करेंगे।
## Pushwoosh में पुश एट्रिब्यूशन सेट अप करें
अपने पुश नोटिफिकेशन में Singular ट्रैकिंग लिंक जोड़ें।
अपने **Link Summary** से **Click-through tracking link** को एक [Push preset](/hi/product/content/push-presets/#define-the-next-step-for-users-who-click-on-the-notification) में **On-click actions** → **Deep link in application** में पेस्ट करें।
## पोस्टबैक कॉन्फ़िगर करें
Singular इस बारे में एट्रिब्यूशन डेटा एकत्र करता है कि उपयोगकर्ता कहाँ से आते हैं और वे ऐप में क्या करते हैं। पोस्टबैक के साथ, आप उस डेटा को स्वचालित रूप से Pushwoosh को भेजते हैं।
उदाहरण के लिए, यदि Singular रिकॉर्ड करता है कि एक उपयोगकर्ता ने एक विशिष्ट विज्ञापन अभियान से ऐप इंस्टॉल किया है, तो Pushwoosh इसे एक टैग या इवेंट के रूप में प्राप्त कर सकता है। फिर आप उस अभियान के उपयोगकर्ताओं का एक सेगमेंट बना सकते हैं और उन्हें Pushwoosh में एक लक्षित पुश भेज सकते हैं।
1. Singular में, **Partner Configuration** पर जाएं।
2. एक नया कॉन्फ़िगरेशन बनाएं या किसी मौजूदा को संपादित करें।
3. अपना Pushwoosh **Application Code** और **API Access Token** दर्ज करें।
4. **Attribution Postbacks** में, चुनें कि Singular कौन से इवेंट Pushwoosh को भेजता है:
* **इंस्टॉल:** Singular में एट्रिब्यूट किए गए नए ऐप इंस्टॉल। Pushwoosh इस डेटा का उपयोग यह रिकॉर्ड करने के लिए करता है कि उपयोगकर्ता कहाँ से आए थे।
* **री-एंगेजमेंट:** ट्रैक किए गए लिंक के लिए एट्रिब्यूट किए गए ऐप ओपन। यदि आप सेगमेंटेशन के लिए Pushwoosh में री-एंगेजमेंट स्रोत डेटा चाहते हैं तो इसे सक्षम करें।
Singular सहायता केंद्र में [पार्टनर सेटिंग्स और पोस्टबैक को कॉन्फ़िगर करना सीखें](https://support.singular.net/hc/en-us/articles/360053018851-How-to-Configure-Partner-Settings-and-Postbacks)।
5. **Attribution Windows Settings** में, **Installs** के तहत, चुनें कि उपयोगकर्ता द्वारा आपके ट्रैकिंग लिंक पर क्लिक करने या विज्ञापन देखने के बाद Singular कितनी देर तक प्रतीक्षा कर सकता है, इससे पहले कि वह Pushwoosh को इंस्टॉल का श्रेय देना बंद कर दे। [और जानें](https://support.singular.net/hc/en-us/articles/115000526963-Understanding-Singular-Mobile-App-Attribution)।
6. **Re-engagements** के तहत, चुनें कि क्लिक या विज्ञापन देखने के बाद Singular कितनी देर तक प्रतीक्षा कर सकता है, इससे पहले कि वह Pushwoosh को ओपन का श्रेय देना बंद कर दे। **Override app level inactivity window for this partner** को सक्षम करें ताकि यह सेट किया जा सके कि उस ओपन को री-एंगेजमेंट के रूप में गिनने से पहले उपयोगकर्ता को कितनी देर तक निष्क्रिय रहना चाहिए। [और जानें](https://support.singular.net/hc/en-us/articles/360044494651-Re-engagement-FAQ)।
7. **In app Events Postback** टैब खोलें और उन इवेंट्स को जोड़ें जिन्हें Pushwoosh को प्राप्त करना चाहिए (उदाहरण के लिए सत्रों के लिए `__SESSION__*`)। किसी भी स्रोत से उपयोगकर्ताओं को शामिल करने के लिए **Send All** सक्षम करें।
8. कॉन्फ़िगरेशन सहेजें।
### Pushwoosh को क्या प्राप्त होता है
आपके सहेजने के बाद, कॉन्फ़िगर किए गए इवेंट होने पर Singular पोस्टबैक भेजता है। Pushwoosh प्रत्येक पोस्टबैक को डिवाइस **टैग** और उपयोगकर्ता प्रोफ़ाइल पर एक **इवेंट** में प्रोसेस करता है।