आपकी शॉप LinkHarbor को बिक्री कैसे बताती है: क्लिक ID, callback secret और sale callback। साथ ही समर्थकों के भुगतान कन्वर्ज़न कैसे गिने जाते हैं।
कन्वर्ज़न एक बिक्री या समर्थक का भुगतान है, जिसे LinkHarbor आपके पेज पर हुए किसी क्लिक से जोड़ सकता है। इससे आप सिर्फ़ यह नहीं देखते कि किसी लिंक पर कितनी बार क्लिक हुआ, बल्कि यह भी कि उससे क्या हासिल हुआ। यह लेख अपनी शॉप वाले क्रिएटरों और शॉप को जोड़ने वाले डेवलपरों के लिए है। कन्वर्ज़न का विश्लेषण और callback secret बनाना Creator Pro से संभव है।
कन्वर्ज़न कहाँ से आते हैं
- वह बिक्री जो आपकी शॉप या सर्वर sale callback से बताता है
- Stripe से समर्थकों के भुगतान; रिफ़ंड होने पर कन्वर्ज़न फिर हट जाता है, देखें Stripe से समर्थकों के भुगतान
हर कन्वर्ज़न को उस क्लिक का डेटा मिलता है जिससे वह जुड़ा है: पेज, लिंक, देश, डिवाइस, रेफ़रर और UTM पैरामीटर। इसीलिए वह आँकड़ों में ठीक वहीं दिखता है जहाँ से क्लिक आया था।
जोड़ने की प्रक्रिया कैसे काम करती है
- कोई विज़िटर आपके पेज पर किसी लिंक पर क्लिक करता है
- LinkHarbor क्लिक गिनता है और रीडायरेक्ट करते समय लक्ष्य URL में एक यूनिक क्लिक ID के साथ lt_click_id पैरामीटर जोड़ देता है
- आपका लक्ष्य पेज (जैसे शॉप) पते से lt_click_id पढ़ता है और ख़रीदारी तक उसे सँभालकर रखता है
- ख़रीदारी के बाद आपका सर्वर इस क्लिक ID के साथ LinkHarbor को एक sale callback भेजता है
- कन्वर्ज़न डैशबोर्ड पर और पेज के आँकड़ों में दिखता है
क्लिक ID सिर्फ़ http:// या https:// से शुरू होने वाले लक्ष्यों में जोड़ी जाती है। mailto: या tel: वाले लिंक को यह नहीं मिलती, क्योंकि वहाँ यह पैरामीटर विषय या फ़ोन नंबर को बिगाड़ देगा। बॉट के क्लिक को भी क्लिक ID नहीं मिलती।
Callback secret बनाएँ
Sale callback को एक callback secret से अपनी पहचान देनी होती है। मालिक और एडमिन Creator Pro से मेन्यू के अकाउंट वाले हिस्से में “Callback और API” के तहत secret मैनेज करते हैं।
- “Callback और API” खोलें
- “Callback secrets” कार्ड में “+ नया secret बनाएँ” पर क्लिक करें
- चाहें तो कोई नाम डालें, जैसे “शॉप callback”
- “secret बनाएँ” पर क्लिक करें
- Secret तुरंत कॉपी करें: यह सिर्फ़ एक बार दिखाया जाता है
- “बदलें”
- नाम और स्थिति (सक्रिय या निष्क्रिय) बदलें। निष्क्रिय secret अस्वीकार कर दिया जाता है।
- “↺ बदलें”
- एक नया secret बनाता है। पुराना तुरंत काम करना बंद कर देता है – इसलिए नया secret तुरंत अपनी शॉप में डालें।
- “हटाएँ”
- पुष्टि के बाद secret हटा देता है।
- “आख़िरी callback:”
- दिखाता है कि secret आख़िरी बार कब इस्तेमाल हुआ, वरना “अभी इस्तेमाल नहीं हुआ”।
हर वर्कस्पेस में आप ज़्यादा से ज़्यादा 5 callback secret बना सकते हैं।
Sale callback भेजें
आपका सर्वर LinkHarbor API को एक POST अनुरोध भेजता है। Secret X-Callback-Secret हेडर में जाता है।
curl -X POST https://dock.at-harbor.com/v1/callbacks/sale \
-H "Content-Type: application/json" \
-H "X-Callback-Secret: YOUR_CALLBACK_SECRET" \
-d '{
"click_id": "3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a23",
"order_id": "B-10042",
"amount": "49.90",
"currency": "EUR"
}' - click_id
- ज़रूरी। lt_click_id से मिली क्लिक ID (10–36 अक्षर)।
- order_id
- ज़रूरी। आपका ऑर्डर नंबर (1–128 अक्षर)। हर ऑर्डर नंबर पर सिर्फ़ एक कन्वर्ज़न गिना जाता है, इसलिए दोहराया गया callback दूसरा कन्वर्ज़न नहीं बनाता।
- amount
- ज़रूरी। दशमलव संख्या के रूप में राशि।
- currency
- ज़रूरी। 3 अक्षरों वाला करेंसी कोड, जैसे EUR।
- occurred_at, meta
- वैकल्पिक। ख़रीदारी का समय और अतिरिक्त जानकारी के लिए ज़्यादा से ज़्यादा 50 अपनी keys (हर एक 1–64 अक्षर)। वैल्यू ज़्यादा से ज़्यादा 500 अक्षरों का टेक्स्ट, कोई संख्या, true/false या null होती है; API नेस्ट किए गए ऑब्जेक्ट अस्वीकार कर देता है।
जवाब
| स्टेटस | मतलब |
|---|---|
| 200 | कन्वर्ज़न सहेजा गया; जवाब में conversion_id होती है |
| 403 | Secret ग़लत या निष्क्रिय है – या, अगर आप workspace_id नहीं भेजते, तो क्लिक ID अज्ञात है |
| 404 | क्लिक ID अज्ञात (सिर्फ़ तब जब आप अपनी workspace_id भेजते हैं) |
| 413 | बॉडी 1 MB से बड़ी है (request_too_large) |
| 422 | कोई ज़रूरी फ़ील्ड नहीं है या उसका फ़ॉर्मैट ग़लत है, जैसे meta में बहुत लंबी या नेस्ट की गई वैल्यू |
| 429 | एक ही IP पते से प्रति मिनट 120 से ज़्यादा callback |
डेवलपरों के लिए सभी फ़ील्ड और त्रुटि कोड बिक्री और अपना डेटा भेजना में हैं।
कन्वर्ज़न का विश्लेषण
- डैशबोर्ड: “कन्वर्ज़न” और “CVR” टाइल, और UTM स्रोत और माध्यम के हिसाब से “कन्वर्ज़न” कार्ड
- पेज के आँकड़े: “कुल CVR”, “यूनिक CVR” और “ब्रेकडाउन” के साथ “कन्वर्ज़न” कार्ड
- कुल CVR = कन्वर्ज़न को क्लिक से भाग देकर; यूनिक CVR = कन्वर्ज़न को यूनिक क्लिक से भाग देकर
यह भी आपके काम आ सकता है
कुछ नहीं मिला?
हमें बताएँ कि आपको क्या चाहिए, और हमारी सपोर्ट टीम ख़ुद आपकी मदद करेगी।