सिंगुलर इंटीग्रेशन

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

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

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

Singular एक मार्केटिंग एनालिटिक्स और एट्रिब्यूशन प्लेटफॉर्म है। इसे Pushwoosh के साथ कनेक्ट करें ताकि आप अपने पुश अभियानों से ऐप ओपन को एट्रिब्यूट कर सकें और अन्य मार्केटिंग चैनलों के साथ Singular में पुश प्रदर्शन को माप सकें। आप पोस्टबैक के माध्यम से Singular से Pushwoosh में एट्रिब्यूशन डेटा भी भेज सकते हैं और इसे सेगमेंटेशन और मैसेजिंग के लिए उपयोग कर सकते हैं।

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

• पुश नोटिफिकेशन एट्रिब्यूशन: Singular में Pushwoosh पुश अभियानों से ऐप ओपन को एट्रिब्यूट करें जब उपयोगकर्ता आपके नोटिफिकेशन पर टैप करते हैं।
• अभियान प्रदर्शन विश्लेषण: Singular एनालिटिक्स डैशबोर्ड में अन्य मार्केटिंग चैनलों के साथ पुश अभियान के परिणामों की तुलना करें।
• ROI ऑप्टिमाइज़ेशन: Singular में अपने सबसे अच्छा प्रदर्शन करने वाले पुश अभियानों की पहचान करें और Pushwoosh में नए अभियानों की योजना बनाते समय उन जानकारियों को लागू करें।
• Pushwoosh में सेगमेंटेशन: Pushwoosh में सेगमेंट बनाने और अभियानों को व्यक्तिगत बनाने के लिए Singular पोस्टबैक से इंस्टॉल और इन-ऐप इवेंट डेटा का उपयोग करें।

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

• सक्रिय Pushwoosh अकाउंट
• सक्रिय Singular अकाउंट
• आपके ऐप में Singular SDK इंटीग्रेटेड हो
• आपके Pushwoosh अकाउंट से एप्लिकेशन कोड और API एक्सेस टोकन

न्यूनतम Singular SDK संस्करण

• Android: Singular Android SDK 12.11.0 या नया (पुराने संस्करण पुश पेलोड एट्रिब्यूशन का समर्थन नहीं करते हैं)
• iOS: Singular iOS SDK 12.0.5 या नया

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

• स्रोत (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 में, परिभाषित करें कि यह लिंक किस ऐप के लिए है और उपयोगकर्ता इसे टैप करने पर कहाँ जाते हैं। और जानें।

4. Attribution Settings में, लिंक के लिए एट्रिब्यूशन विधियों और विंडो को कॉन्फ़िगर करें। और जानें।

5. Generate पर क्लिक करें।

6. Link Summary में, जेनरेट किए गए लिंक की समीक्षा करें। यदि आप पुश एट्रिब्यूशन सेट अप कर रहे हैं, तो Click-through tracking link को कॉपी करें। आप इसका उपयोग Pushwoosh में करेंगे।

Pushwoosh में पुश एट्रिब्यूशन सेट अप करें

अपने पुश नोटिफिकेशन में Singular ट्रैकिंग लिंक जोड़ें।

अपने Link Summary से Click-through tracking link को एक Push preset में On-click actions → Deep link in application में पेस्ट करें।

पोस्टबैक कॉन्फ़िगर करें

Singular इस बारे में एट्रिब्यूशन डेटा एकत्र करता है कि उपयोगकर्ता कहाँ से आते हैं और वे ऐप में क्या करते हैं। पोस्टबैक के साथ, आप उस डेटा को स्वचालित रूप से Pushwoosh को भेजते हैं।

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

1. Singular में, Partner Configuration पर जाएं।
2. एक नया कॉन्फ़िगरेशन बनाएं या किसी मौजूदा को संपादित करें।

3. अपना Pushwoosh Application Code और API Access Token दर्ज करें।

अपने क्रेडेंशियल कहाँ खोजें

• एप्लिकेशन कोड (XXXXX-XXXXX): Pushwoosh कंट्रोल पैनल में आपके एप्लिकेशन नाम के नीचे दिखाया गया है।
• API एक्सेस टोकन: Settings → API Access पर जाएं और टोकन कॉपी करें। विवरण के लिए API एक्सेस टोकन देखें।

4. Attribution Postbacks में, चुनें कि Singular कौन से इवेंट Pushwoosh को भेजता है:

• इंस्टॉल: Singular में एट्रिब्यूट किए गए नए ऐप इंस्टॉल। Pushwoosh इस डेटा का उपयोग यह रिकॉर्ड करने के लिए करता है कि उपयोगकर्ता कहाँ से आए थे।

• री-एंगेजमेंट: ट्रैक किए गए लिंक के लिए एट्रिब्यूट किए गए ऐप ओपन। यदि आप सेगमेंटेशन के लिए Pushwoosh में री-एंगेजमेंट स्रोत डेटा चाहते हैं तो इसे सक्षम करें।

  Singular सहायता केंद्र में पार्टनर सेटिंग्स और पोस्टबैक को कॉन्फ़िगर करना सीखें।

5. Attribution Windows Settings में, Installs के तहत, चुनें कि उपयोगकर्ता द्वारा आपके ट्रैकिंग लिंक पर क्लिक करने या विज्ञापन देखने के बाद Singular कितनी देर तक प्रतीक्षा कर सकता है, इससे पहले कि वह Pushwoosh को इंस्टॉल का श्रेय देना बंद कर दे। और जानें।

6. Re-engagements के तहत, चुनें कि क्लिक या विज्ञापन देखने के बाद Singular कितनी देर तक प्रतीक्षा कर सकता है, इससे पहले कि वह Pushwoosh को ओपन का श्रेय देना बंद कर दे। Override app level inactivity window for this partner को सक्षम करें ताकि यह सेट किया जा सके कि उस ओपन को री-एंगेजमेंट के रूप में गिनने से पहले उपयोगकर्ता को कितनी देर तक निष्क्रिय रहना चाहिए। और जानें।

7. In app Events Postback टैब खोलें और उन इवेंट्स को जोड़ें जिन्हें Pushwoosh को प्राप्त करना चाहिए (उदाहरण के लिए सत्रों के लिए __SESSION__*)। किसी भी स्रोत से उपयोगकर्ताओं को शामिल करने के लिए Send All सक्षम करें।

8. कॉन्फ़िगरेशन सहेजें।

Pushwoosh को क्या प्राप्त होता है

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

टैग

Pushwoosh मेल खाने वाले डिवाइस पर इन टैग को लिखता या अपडेट करता है:

टैग	स्रोत
OS संस्करण	डिवाइस OS संस्करण
एप्लिकेशन संस्करण	ऐप संस्करण
डिवाइस मॉडल	डिवाइस मॉडल
देश	एट्रिब्यूशन देश
शहर	एट्रिब्यूशन शहर

इवेंट्स

Pushwoosh उपयोगकर्ता प्रोफ़ाइल पर एक इवेंट रिकॉर्ड करता है। इवेंट का नाम पोस्टबैक प्रकार पर निर्भर करता है:

• इन-ऐप इवेंट्स: आपके द्वारा कॉन्फ़िगर किया गया Singular इवेंट नाम (उदाहरण के लिए, एक सत्र इवेंट)।
• इंस्टॉल या एट्रिब्यूशन पोस्टबैक: यदि पोस्टबैक में कोई इवेंट नाम नहीं है, तो Pushwoosh Singular Attribution Event रिकॉर्ड करता है। इस इवेंट नाम का उपयोग तब करें जब आप नए एट्रिब्यूट किए गए उपयोगकर्ताओं के सेगमेंट बनाते हैं।

अभियान और राजस्व डेटा इवेंट के साथ इवेंट एट्रिब्यूट के रूप में यात्रा करते हैं। आप Pushwoosh में उन पर सेगमेंट और फ़िल्टर कर सकते हैं:

एट्रिब्यूट	विवरण
अभियान का नाम / अभियान आईडी	एट्रिब्यूटेड अभियान
उप-अभियान का नाम / उप-अभियान आईडी	एट्रिब्यूटेड उप-अभियान
क्रिएटिव का नाम / क्रिएटिव आईडी	एट्रिब्यूटेड क्रिएटिव
राशि / राजस्व / मुद्रा	इवेंट का मौद्रिक मूल्य, यदि कोई हो
देश / शहर	इवेंट के साथ रिपोर्ट किया गया स्थान

डिवाइस मैचिंग

Pushwoosh प्रत्येक पोस्टबैक को Singular द्वारा भेजे गए पहचानकर्ता का उपयोग करके एक डिवाइस से मिलाता है: iOS पर IDFV, या Android पर GAID, AIFA, या Android ID। पोस्टबैक में आपका एप्लिकेशन कोड और प्लेटफ़ॉर्म भी शामिल होना चाहिए। यदि Pushwoosh डिवाइस से मेल नहीं खा सकता है, तो पोस्टबैक लागू नहीं होता है।

पोस्टबैक सत्यापित करें

Singular द्वारा कॉन्फ़िगर किए गए इवेंट के लिए पोस्टबैक भेजने के बाद, जांचें कि Pushwoosh ने इसे प्राप्त किया है:

1. Audience → Events खोलें और पुष्टि करें कि इवेंट दिखाई देता है।
2. User Explorer में उपयोगकर्ता प्रोफ़ाइल खोलें और Events history पर जाएं। पुष्टि करें कि इवेंट और उसके एट्रिब्यूट (उदाहरण के लिए, अभियान का नाम) उस उपयोगकर्ता के लिए रिकॉर्ड किए गए हैं।
3. इवेंट आमतौर पर कुछ मिनटों के भीतर दिखाई देते हैं।

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

सिंगुलर ट्रैकिंग लिंक कैप्चर नहीं हो रहा है

• सत्यापित करें कि Click-through tracking link On-click actions → Deep link in application में सेट है, Custom Data में नहीं।
• पुष्टि करें कि Singular SDK पुश नोटिफिकेशन पेलोड को संभालने के लिए कॉन्फ़िगर किया गया है। Android और iOS गाइड देखें।

डीप लिंक ऐप खोलता है लेकिन होम स्क्रीन पर नेविगेट करता है

• पुष्टि करें कि Singular ट्रैकिंग लिंक के अंदर _dl पैरामीटर ठीक से URL-एन्कोडेड है।
• सत्यापित करें कि आपके ऐप का डीप लिंक हैंडलर उपयोग की गई स्कीम के लिए सही ढंग से पंजीकृत है (उदाहरण के लिए, myapp://)।
• Android पर, जांचें कि सही Activity में AndroidManifest.xml में आपके डीप लिंक स्कीम के लिए इंटेंट फ़िल्टर है।

सिंगुलर में एट्रिब्यूशन दिखाई देता है लेकिन गलत अभियान को क्रेडिट किया जाता है

• सुनिश्चित करें कि Singular SDK पुश पेलोड को इनिशियलाइज़ेशन से पहले या उसके दौरान प्रोसेस करता है, जैसा कि Singular SDK गाइड में वर्णित है।
• पुष्टि करें कि आप इस अभियान के लिए Link Summary से सही Click-through tracking link का उपयोग कर रहे हैं।

वार्म स्टार्ट (ऐप पहले से खुला है): एट्रिब्यूशन रिकॉर्ड नहीं किया गया

• पुष्टि करें कि आपका ऐप पुश नोटिफिकेशन टैप को तब संभालता है जब यह पहले से ही बैकग्राउंड में चल रहा हो, जैसा कि Singular SDK गाइड में वर्णित है।
• यह वार्म स्टार्ट के लिए गुम एट्रिब्यूशन का सबसे आम कारण है।