API संदर्भ - घटनाएँ अधिग्रहण
उपयोग घटनाओं को अधिग्रहित करने के लिए पूर्ण API दस्तावेज़ तक पहुँचें और इंटरैक्टिव रूप से घटना अधिग्रहण अनुरोधों और प्रतिक्रियाओं का परीक्षण करें।
API संदर्भ - मीटर निर्माण
मीटर बनाने के लिए पूर्ण API दस्तावेज़ का अन्वेषण करें और इंटरैक्टिव रूप से मीटर निर्माण अनुरोधों और प्रतिक्रियाओं का परीक्षण करें।
मीटर बनाना
मीटर यह परिभाषित करते हैं कि आपकी उपयोग घटनाएँ बिलिंग उद्देश्यों के लिए कैसे संचित और मापी जाती हैं। मीटर बनाने से पहले, अपनी उपयोग ट्रैकिंग रणनीति की योजना बनाएं:- पहचानें कि आप कौन सी उपयोग घटनाएँ ट्रैक करना चाहते हैं
- निर्धारित करें कि घटनाओं को कैसे संचित किया जाना चाहिए (गिनती, योग, आदि)
- विशिष्ट उपयोग मामलों के लिए कोई फ़िल्टरिंग आवश्यकताओं को परिभाषित करें
चरण-दर-चरण मीटर निर्माण
अपने उपयोग मीटर को सेट करने के लिए इस व्यापक गाइड का पालन करें:1
बुनियादी जानकारी कॉन्फ़िगर करें
अपने मीटर के लिए मौलिक विवरण सेट करें।
एक स्पष्ट, वर्णनात्मक नाम चुनें जो यह पहचानता है कि यह मीटर क्या ट्रैक करता है।उदाहरण: “टोकन”, “API कॉल”, “स्टोरेज उपयोग”, “कंप्यूट घंटे”
इस मीटर द्वारा मापी जाने वाली चीज़ का विस्तृत विवरण प्रदान करें।उदाहरण: “ग्राहक द्वारा किए गए प्रत्येक POST /v1/orders अनुरोध की गिनती करता है”
उस घटना पहचानकर्ता को निर्दिष्ट करें जो इस मीटर को ट्रिगर करेगा।उदाहरण: “token”, “api.call”, “storage.usage”, “compute.session”
घटना नाम को ठीक उसी तरह से मेल खाना चाहिए जैसा आप अपनी उपयोग घटनाओं में भेजते हैं। घटना नाम केस-संवेदनशील होते हैं।
2
संघटन सेटिंग्स कॉन्फ़िगर करें
परिभाषित करें कि मीटर आपके घटनाओं से उपयोग कैसे गणना करता है।
चुनें कि घटनाओं को कैसे संचित किया जाना चाहिए:
- गिनती
- योग
- अधिकतम
- अंतिम
सिर्फ प्राप्त घटनाओं की संख्या की गिनती करता है।उपयोग मामला: API कॉल, पृष्ठ दृश्य, फ़ाइल अपलोडगणना: कुल घटनाओं की संख्या
घटना मेटाडेटा से उस संपत्ति का नाम जिसे संचित किया जाना है।
रिपोर्टों और बिलिंग में प्रदर्शित करने के लिए इकाई लेबल परिभाषित करें।उदाहरण: “कॉल”, “GB”, “घंटे”, “टोकन”
3
घटना फ़िल्टरिंग कॉन्फ़िगर करें (वैकल्पिक)
यह निर्धारित करने के लिए मानदंड सेट करें कि कौन सी घटनाएँ मीटर में शामिल की जाएँ।घटना फ़िल्टरिंग सक्षम करेंशर्तीय घटना प्रसंस्करण को सक्रिय करने के लिए घटना फ़िल्टरिंग सक्षम करें को टॉगल करें।फ़िल्टर लॉजिक चुनेंचुनें कि कई शर्तों का मूल्यांकन कैसे किया जाए:फ़िल्टर शर्तें सेट करना
घटना फ़िल्टरिंग आपको जटिल नियम बनाने की अनुमति देती है जो यह निर्धारित करते हैं कि कौन सी घटनाएँ आपकी उपयोग गणनाओं में योगदान करती हैं। यह परीक्षण घटनाओं को बाहर करने, उपयोगकर्ता स्तरों द्वारा फ़िल्टर करने, या विशिष्ट क्रियाओं पर ध्यान केंद्रित करने के लिए उपयोगी है।
- AND लॉजिक
- OR लॉजिक
एक घटना की गिनती करने के लिए सभी शर्तें सत्य होनी चाहिए। जब आपको घटनाओं को एक साथ कई सख्त मानदंडों को पूरा करने की आवश्यकता होती है तो इसका उपयोग करें।उदाहरण: उन API कॉलों की गिनती करें जहाँ
user_tier = "premium" AND endpoint = "/api/v2/users"1
शर्त जोड़ें
एक नया फ़िल्टर नियम बनाने के लिए शर्त जोड़ें पर क्लिक करें।
2
संपत्ति कुंजी कॉन्फ़िगर करें
अपने घटना मेटाडेटा से संपत्ति नाम निर्दिष्ट करें।
3
तुलनात्मक चुनें
उपलब्ध ऑपरेटरों में से चुनें:
equals- सटीक मेलnot equals- बहिष्करण फ़िल्टरgreater than- संख्यात्मक तुलनाgreater than or equals- संख्यात्मक तुलना (समावेशी)less than- संख्यात्मक तुलनाless than or equals- संख्यात्मक तुलना (समावेशी)contains- स्ट्रिंग उपस्ट्रिंग में शामिल हैdoes not contain- स्ट्रिंग बहिष्करण फ़िल्टर
4
तुलना मूल्य सेट करें
तुलना के लिए लक्ष्य मूल्य सेट करें।
5
समूह जोड़ें
जटिल लॉजिक के लिए अतिरिक्त शर्त समूह बनाने के लिए समूह जोड़ें का उपयोग करें।
4
मीटर बनाएं
अपने मीटर कॉन्फ़िगरेशन की समीक्षा करें और मीटर बनाएं पर क्लिक करें।
आपका मीटर अब उपयोग घटनाओं को प्राप्त करने और संचित करने के लिए तैयार है।
उत्पाद में मीटर लिंक करना
एक बार जब आप अपना मीटर बना लेते हैं, तो आपको उपयोग-आधारित बिलिंग सक्षम करने के लिए इसे एक उत्पाद से लिंक करना होगा। यह प्रक्रिया आपके मीटर के उपयोग डेटा को ग्राहक बिलिंग के लिए मूल्य निर्धारण नियमों से जोड़ती है। उत्पादों से मीटर को लिंक करना उपयोग ट्रैकिंग और बिलिंग के बीच संबंध स्थापित करता है:- उत्पाद मूल्य निर्धारण नियम और बिलिंग व्यवहार को परिभाषित करते हैं
- मीटर बिलिंग गणनाओं के लिए उपयोग डेटा प्रदान करते हैं
- जटिल बिलिंग परिदृश्यों के लिए एकल उत्पाद से कई मीटर को जोड़ा जा सकता है
उत्पाद कॉन्फ़िगरेशन प्रक्रिया
अपने उपयोग डेटा को बिल योग्य शुल्क में बदलने के लिए अपने उत्पाद सेटिंग्स को सही ढंग से कॉन्फ़िगर करें:1
उपयोग-आधारित बिलिंग उत्पाद प्रकार चुनें
अपने उत्पाद निर्माण या संपादन पृष्ठ पर जाएँ और उत्पाद प्रकार के रूप में उपयोग-आधारित का चयन करें।
2
संबंधित मीटर चुनें
संबंधित मीटर पर क्लिक करें ताकि साइड से मीटर चयन पैनल खोला जा सके।यह पैनल आपको यह कॉन्फ़िगर करने की अनुमति देता है कि कौन से मीटर इस उत्पाद के लिए उपयोग को ट्रैक करेंगे।
3
अपना मीटर जोड़ें
मीटर चयन पैनल में:
- उपलब्ध मीटर देखने के लिए मीटर जोड़ें पर क्लिक करें
- ड्रॉपडाउन सूची से आपने जो मीटर बनाया है उसे चुनें
- चयनित मीटर आपके उत्पाद कॉन्फ़िगरेशन में दिखाई देगा
4
प्रति इकाई मूल्य कॉन्फ़िगर करें
अपने मीटर द्वारा ट्रैक की गई प्रत्येक इकाई के लिए मूल्य सेट करें।
परिभाषित करें कि आपके मीटर द्वारा मापी गई प्रत्येक इकाई के लिए कितना चार्ज करना है।उदाहरण:
$0.50 प्रति इकाई सेट करना का मतलब है:- 1,000 इकाइयाँ उपभोग की गई = 1,000 × $0.50 = 500.00 चार्ज किया गया
- 500 इकाइयाँ उपभोग की गई = 500 × $0.50 = 250.00 चार्ज किया गया
- 100 इकाइयाँ उपभोग की गई = 100 × $0.50 = 50.00 चार्ज किया गया
5
मुफ्त सीमा सेट करें (वैकल्पिक)
बिलिंग शुरू होने से पहले एक मुफ्त उपयोग भत्ता कॉन्फ़िगर करें।
इकाइयों की संख्या जो ग्राहक बिना शुल्क के उपभोग कर सकते हैं इससे पहले कि भुगतान की गई उपयोग गणना शुरू हो।यह कैसे काम करता है:
- मुफ्त सीमा: 100 इकाइयाँ
- प्रति इकाई मूल्य: $0.50
- ग्राहक उपयोग: 250 इकाइयाँ
- गणना: (250 - 100) × 75.00** चार्ज किया गया
मुफ्त सीमाएँ फ्रीमियम मॉडल, परीक्षण अवधि, या ग्राहकों को उनके योजना में शामिल एक आधार भत्ता प्रदान करने के लिए आदर्श हैं।
मुफ्त सीमा प्रत्येक बिलिंग चक्र पर लागू होती है, ग्राहकों को मासिक या आपकी बिलिंग अनुसूची के अनुसार नए भत्ते देती है।
6
कॉन्फ़िगरेशन सहेजें
अपने मीटर और मूल्य निर्धारण कॉन्फ़िगरेशन की समीक्षा करें, फिर सेटअप को अंतिम रूप देने के लिए परिवर्तन सहेजें पर क्लिक करें।अगला क्या होता है:
आपका उत्पाद अब उपयोग-आधारित बिलिंग के लिए कॉन्फ़िगर किया गया है और स्वचालित रूप से ग्राहकों को उनके मापी गए उपभोग के आधार पर चार्ज करेगा।
- आपके मीटर को भेजी गई उपयोग घटनाएँ ट्रैक और संचित की जाएँगी
- बिलिंग गणनाएँ स्वचालित रूप से आपके मूल्य निर्धारण नियम लागू करेंगी
- ग्राहकों को प्रत्येक बिलिंग चक्र के दौरान वास्तविक उपभोग के आधार पर चार्ज किया जाएगा
याद रखें कि आप प्रति उत्पाद 10 मीटर तक जोड़ सकते हैं, जिससे API कॉल, स्टोरेज, कंप्यूट समय, और कस्टम मैट्रिक्स जैसे कई आयामों में जटिल उपयोग ट्रैकिंग सक्षम होती है।
उपयोग घटनाएँ भेजना
एक बार जब आपका मीटर कॉन्फ़िगर हो जाता है, तो आप अपने एप्लिकेशन से उपयोग घटनाएँ भेजना शुरू कर सकते हैं ताकि ग्राहक उपयोग को ट्रैक किया जा सके।घटना संरचना
प्रत्येक उपयोग घटना में इन आवश्यक फ़ील्ड्स को शामिल करना चाहिए:इस विशिष्ट घटना के लिए अद्वितीय पहचानकर्ता। सभी घटनाओं में अद्वितीय होना चाहिए।
Dodo Payments ग्राहक ID जिसे इस उपयोग को सौंपा जाना चाहिए।
घटना का नाम जो आपके मीटर कॉन्फ़िगरेशन से मेल खाता है। घटना नाम उपयुक्त मीटर को ट्रिगर करता है।
ISO 8601 टाइमस्टैम्प जब घटना हुई। यदि प्रदान नहीं किया गया तो वर्तमान समय पर डिफ़ॉल्ट होता है।
फ़िल्टरिंग और संगठन के लिए अतिरिक्त संपत्तियाँ। अपने मीटर के “संपत्ति पर” या फ़िल्टरिंग शर्तों में संदर्भित किसी भी मान को शामिल करें।
उपयोग घटनाएँ API उदाहरण
घटनाओं API का उपयोग करके अपने कॉन्फ़िगर किए गए मीटर को उपयोग घटनाएँ भेजें:उपयोग-आधारित बिलिंग विश्लेषण
अपने उपयोग-आधारित बिलिंग डेटा की निगरानी और विश्लेषण करें व्यापक विश्लेषण डैशबोर्ड के साथ। ग्राहक उपभोग पैटर्न, मीटर प्रदर्शन, और बिलिंग प्रवृत्तियों को ट्रैक करें ताकि आप अपनी मूल्य निर्धारण रणनीति को अनुकूलित कर सकें और उपयोग व्यवहार को समझ सकें।अवलोकन विश्लेषण
अवलोकन टैब आपके उपयोग-आधारित बिलिंग प्रदर्शन का एक व्यापक दृश्य प्रदान करता है:गतिविधि मैट्रिक्स
विभिन्न समय अवधियों में प्रमुख उपयोग सांख्यिकी को ट्रैक करें:वर्तमान बिलिंग अवधि के लिए उपयोग गतिविधि दिखाता है, जिससे आपको मासिक उपभोग पैटर्न को समझने में मदद मिलती है।
जब से आपने ट्रैकिंग शुरू की है तब से संचयी उपयोग सांख्यिकी प्रदर्शित करता है, दीर्घकालिक विकास अंतर्दृष्टि प्रदान करता है।
मीटर मात्राएँ चार्ट

- समय-श्रृंखला दृश्यता: दिनों, हफ्तों, या महीनों में उपयोग पैटर्न को ट्रैक करें
- कई मीटर समर्थन: एक साथ विभिन्न मीटर से डेटा देखें
- प्रवृत्ति विश्लेषण: उपयोग स्पाइक्स, पैटर्न, और विकास की प्रवृत्तियों की पहचान करें
चार्ट स्वचालित रूप से आपके उपयोग मात्रा और चयनित समय सीमा के आधार पर स्केल करता है, छोटे उतार-चढ़ाव और प्रमुख उपयोग परिवर्तनों दोनों में स्पष्ट दृश्यता प्रदान करता है।
घटनाएँ विश्लेषण

घटना जानकारी प्रदर्शन
घटनाएँ तालिका व्यक्तिगत उपयोग घटनाओं का स्पष्ट दृश्य प्रदान करती है जिसमें निम्नलिखित कॉलम होते हैं:- घटना नाम: विशिष्ट क्रिया या ट्रिगर जो उपयोग घटना उत्पन्न करता है
- घटना आईडी: प्रत्येक घटना उदाहरण के लिए अद्वितीय पहचानकर्ता
- ग्राहक आईडी: घटना से संबंधित ग्राहक
- टाइमस्टैम्प: जब घटना हुई
यह दृश्य आपको अपने ग्राहक आधार में व्यक्तिगत उपयोग घटनाओं को ट्रैक और मॉनिटर करने की अनुमति देता है, बिलिंग गणनाओं और उपयोग पैटर्न में पारदर्शिता प्रदान करता है।
ग्राहक विश्लेषण
ग्राहक टैब ग्राहक उपयोग डेटा का विस्तृत तालिका दृश्य प्रदान करता है जिसमें निम्नलिखित जानकारी होती है:उपलब्ध डेटा कॉलम
पहचान के लिए ग्राहक का ईमेल पता।
ग्राहक की सदस्यता के लिए अद्वितीय पहचानकर्ता।
चार्ज लागू होने से पहले ग्राहक की योजना में शामिल मुफ्त इकाइयों की संख्या।
मुफ्त सीमा से परे उपयोग के लिए प्रति इकाई लागत।
ग्राहक की सबसे हाल की उपयोग घटना का टाइमस्टैम्प।
उपयोग-आधारित बिलिंग के लिए ग्राहक से चार्ज किया गया कुल राशि।
ग्राहक द्वारा उपभोग की गई कुल इकाइयों की संख्या।
वे इकाइयाँ जो मुफ्त सीमा से अधिक हैं और चार्ज की जा रही हैं।
तालिका विशेषताएँ
- कॉलम फ़िल्टरिंग: विशिष्ट डेटा कॉलम दिखाने/छिपाने के लिए “कॉलम संपादित करें” सुविधा का उपयोग करें
- वास्तविक समय अपडेट: उपयोग डेटा सबसे वर्तमान उपभोग मैट्रिक्स को दर्शाता है
संगठन उदाहरण
यहाँ विभिन्न संगठन प्रकारों के काम करने के व्यावहारिक उदाहरण हैं:संगठन प्रकारों को समझना
विभिन्न संगठन प्रकार विभिन्न बिलिंग परिदृश्यों के लिए सेवा करते हैं। उपयोग को मापने और चार्ज करने के तरीके के आधार पर सही प्रकार चुनें।व्यावहारिक कार्यान्वयन उदाहरण
ये उदाहरण प्रत्येक संगठन प्रकार के वास्तविक दुनिया के अनुप्रयोगों को नमूना घटनाओं और अपेक्षित परिणामों के साथ प्रदर्शित करते हैं।गिनती संगठन - API कॉल
गिनती संगठन - API कॉल
परिदृश्य: API अनुरोधों की कुल संख्या को ट्रैक करेंमीटर कॉन्फ़िगरेशन:परिणाम: ग्राहक को 3 कॉल चार्ज किए गए
- घटना नाम:
api.call - संगठन प्रकार: गिनती
- मापने की इकाई:
calls
योग संगठन - डेटा स्थानांतरण
योग संगठन - डेटा स्थानांतरण
परिदृश्य: कुल बाइट्स स्थानांतरित करने के आधार पर बिल करेंमीटर कॉन्फ़िगरेशन:परिणाम: ग्राहक को 1.5 GB कुल स्थानांतरण चार्ज किया गया
- घटना नाम:
data.transfer - संगठन प्रकार: योग
- संपत्ति पर:
bytes - मापने की इकाई:
GB
अधिकतम संगठन - पीक समवर्ती उपयोगकर्ता
अधिकतम संगठन - पीक समवर्ती उपयोगकर्ता
परिदृश्य: उच्चतम समवर्ती उपयोगकर्ता संख्या के आधार पर बिल करेंमीटर कॉन्फ़िगरेशन:परिणाम: ग्राहक को 23 पीक समवर्ती उपयोगकर्ता चार्ज किए गए
- घटना नाम:
concurrent.users - संगठन प्रकार: अधिकतम
- संपत्ति पर:
count - मापने की इकाई:
users
घटना फ़िल्टरिंग उदाहरण
- API एंडपॉइंट द्वारा फ़िल्टर करें
- मान सीमा द्वारा फ़िल्टर करें
- जटिल मल्टी-शर्त फ़िल्टर
केवल विशिष्ट एंडपॉइंट्स पर API कॉल की गिनती करें:फ़िल्टर कॉन्फ़िगरेशन:परिणाम: फ़िल्टर मानदंड से मेल खाने वाली घटनाएँ गिनी जाएँगी। विभिन्न एंडपॉइंट्स वाली घटनाएँ अनदेखी की जाएँगी।
- संपत्ति:
endpoint - तुलनात्मक:
equals - मूल्य:
/v1/orders
समस्या निवारण
उपयोग-आधारित बिलिंग कार्यान्वयन के साथ सामान्य समस्याओं को हल करें और सटीक ट्रैकिंग और बिलिंग सुनिश्चित करें।सामान्य समस्याएँ
अधिकांश उपयोग-आधारित बिलिंग समस्याएँ इन श्रेणियों में आती हैं:- घटना वितरण और प्रसंस्करण समस्याएँ
- मीटर कॉन्फ़िगरेशन समस्याएँ
- डेटा प्रकार और स्वरूपण त्रुटियाँ
- ग्राहक आईडी और प्रमाणीकरण समस्याएँ
डिबगिंग चरण
जब उपयोग-आधारित बिलिंग की समस्या निवारण करते समय:- घटनाओं विश्लेषण टैब में घटना वितरण की पुष्टि करें
- जांचें कि मीटर कॉन्फ़िगरेशन आपकी घटना संरचना से मेल खाता है
- ग्राहक आईडी और API प्रमाणीकरण को मान्य करें
- फ़िल्टरिंग शर्तों और संगठन सेटिंग्स की समीक्षा करें
समाधान और सुधार
मीटर में घटनाएँ नहीं दिख रही हैं
मीटर में घटनाएँ नहीं दिख रही हैं
सामान्य कारण:
- घटना नाम मीटर कॉन्फ़िगरेशन से ठीक से मेल नहीं खाता
- घटना फ़िल्टरिंग शर्तें आपकी घटनाओं को बाहर कर रही हैं
- ग्राहक आईडी आपके Dodo Payments खाते में मौजूद नहीं है
- घटना टाइमस्टैम्प वर्तमान बिलिंग अवधि के बाहर है
- घटना नाम की वर्तनी और केस संवेदनशीलता की पुष्टि करें
- अपनी फ़िल्टरिंग शर्तों की समीक्षा और परीक्षण करें
- पुष्टि करें कि ग्राहक आईडी मान्य और सक्रिय है
- जांचें कि घटना टाइमस्टैम्प हाल के और सही स्वरूपित हैं
संगठन अपेक्षित रूप से काम नहीं कर रहा है
संगठन अपेक्षित रूप से काम नहीं कर रहा है
सामान्य कारण:
- संपत्ति पर नाम घटना मेटाडेटा कुंजी से मेल नहीं खाता
- मेटाडेटा मान गलत डेटा प्रकार (स्ट्रिंग बनाम संख्या)
- आवश्यक मेटाडेटा संपत्तियों की कमी
- सुनिश्चित करें कि मेटाडेटा कुंजी आपके संपत्ति पर सेटिंग से ठीक से मेल खाती हैं
- अपनी घटनाओं में स्ट्रिंग संख्याओं को वास्तविक संख्याओं में परिवर्तित करें
- प्रत्येक घटना में सभी आवश्यक संपत्तियों को शामिल करें
फ़िल्टरिंग काम नहीं कर रही
फ़िल्टरिंग काम नहीं कर रही
सामान्य कारण:
- फ़िल्टर संपत्ति नाम घटना मेटाडेटा से मेल नहीं खाते
- डेटा प्रकार के लिए गलत तुलनात्मक (स्ट्रिंग बनाम संख्या)
- स्ट्रिंग तुलना में केस संवेदनशीलता
- सुनिश्चित करें कि संपत्ति नाम ठीक से मेल खाते हैं
- अपने डेटा प्रकार के लिए उपयुक्त तुलनात्मक का उपयोग करें
- फ़िल्टरिंग करते समय केस संवेदनशीलता पर विचार करें