अमेरिकी बिलिंग रिपोर्ट

यह पृष्ठ उन डेटा फ़ाइलों का वर्णन करता है जिन्हें RCS for Business, US RBM फ्रेमवर्क के तहत अमेरिकी कैरियर्स को बिलिंग और ऑडिटिंग में सहायता करने के लिए तैयार करता है। US RBM फ्रेमवर्क के बारे में अधिक जानने के लिए, आप usrbm.org पर भी जा सकते हैं।

बिलिंग रिपोर्ट लॉन्च किए गए एजेंटों और उपयोगकर्ताओं के बीच बिल योग्य घटनाओं की एक समग्र रिपोर्ट है। बिल योग्य का सीधा सा मतलब है कि कोई घटना शुल्क के लिए पात्र है। कैरियर यह निर्धारित करते हैं कि बिल योग्य घटनाओं पर शुल्क लगाया जाए या नहीं और कैसे लगाया जाए। RCS फॉर बिजनेस का सक्रिय रूप से संचालन करने वाले सभी अमेरिकी कैरियर बिलिंग रिपोर्ट तक पहुंच सकते हैं।

अमेरिकी बिलिंग वर्गीकरण मॉडल के बारे में विस्तृत जानकारी के लिए, अमेरिकी बिलिंग संबंधी अक्सर पूछे जाने वाले प्रश्न देखें।

फ़ाइल निर्माण

अधिक जानकारी के लिए, फ़ाइल निर्माण देखें।

फ़ाइल संग्रहण और पहुंच

अधिक जानकारी के लिए, फ़ाइल संग्रहण और पहुँच देखें।

फ़ाइल की उपलब्धता

अधिक जानकारी के लिए, फ़ाइल उपलब्धता देखें।

बिलिंग रिपोर्ट

बिलिंग रिपोर्ट, बिल योग्य गतिविधियों का रिकॉर्ड होती हैं, जिनकी गणना एजेंट की बिलिंग श्रेणी और उसके द्वारा भेजे गए संदेशों के प्रकार के आधार पर की जाती है। बिलिंग रिपोर्ट उन सभी कैरियर्स के लिए उपलब्ध हैं जो सक्रिय रूप से RCS फॉर बिजनेस का संचालन कर रहे हैं।

बिलिंग रिपोर्ट में गोपनीय जानकारी होती है, लेकिन इसमें उपयोगकर्ता की कोई व्यक्तिगत पहचान योग्य जानकारी (पीआईआई) नहीं होती है, जैसे कि एमएसआईएसडीएन, हैश्ड एमएसआईएसडीएन, या कोई भी उपयोगकर्ता विशिष्ट पहचानकर्ता।

बिलिंग श्रेणियां बनाम बिल योग्य घटनाएँ

एजेंट बिलिंग श्रेणियों और बिल योग्य घटनाओं के बीच का अंतर यह समझने के लिए महत्वपूर्ण है कि आपका एजेंट किस प्रकार बिल योग्य है।

  • बिलिंग श्रेणी एक निश्चित वर्गीकरण है जिसे आप अपने एजेंट को बनाते समय चुनते हैं। यह निर्धारित करता है कि आपके एजेंट का बिल किस विधि से लिया जाएगा: प्रति संदेश (गैर-संवादात्मक एजेंट) या प्रति सत्र (संवादात्मक एजेंट)।
  • बिल करने योग्य इवेंट, आरसीएस फॉर बिजनेस एजेंट और उपयोगकर्ता के बीच की बातचीत होती है जिसे बिलिंग उद्देश्यों के लिए ट्रैक किया जाता है (उदाहरण के लिए, rich_message )।

अमेरिकी एजेंट बिलिंग श्रेणियाँ

एजेंट बनाते समय, मालिक इस आधार पर उसकी बिलिंग श्रेणी निर्धारित करता है कि एजेंट उपयोगकर्ताओं के साथ कैसे इंटरैक्ट करेगा। बिलिंग श्रेणी एजेंट द्वारा भेजे जा सकने वाले संदेशों की संख्या या प्रकार को सीमित नहीं करती है। लेकिन यह निर्धारित करती है कि संदेशों के लिए एजेंट से शुल्क कैसे लिया जाएगा। दो मुख्य बिलिंग श्रेणियों का विवरण निम्नलिखित तालिका में दिया गया है।

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

प्रति संदेश बिलिंग : यदि सत्र के मानदंड पूरे नहीं होते हैं या कोई संदेश 24 घंटे की सत्र अवधि से बाहर आता है, तो संदेश के लिए संबंधित कैरियर के रेट कार्ड के अनुसार रिच या रिच मीडिया के लिए प्रति संदेश दर पर अलग से बिलिंग की जाएगी।

संवादात्मक बनाम गैर-संवादात्मक एजेंट

एजेंट बिलिंग की दो श्रेणियां हैं: संवादात्मक और गैर-संवादात्मक।

  • गैर-संवादात्मक एजेंट उपयोगकर्ता को भेजे गए प्रत्येक संदेश के लिए शुल्क के दायरे में आते हैं।

    • यह श्रेणी उन एजेंटों के लिए सबसे उपयुक्त है जो बार-बार जवाब मिलने की उम्मीद नहीं करते हैं।

  • वार्तालाप एजेंटों से सत्र शुरू होने पर प्रति सत्र एक निश्चित शुल्क लिया जाता है, जिसमें सत्र शुरू करने वाले संदेश सहित 24 घंटे की अवधि के भीतर आदान-प्रदान किए गए सभी संदेश शामिल होते हैं। 24 घंटे के सत्र का हिस्सा न होने वाले संदेशों के लिए भी वार्तालाप एजेंटों से शुल्क लिया जा सकता है।

    • यह श्रेणी उन एजेंटों के लिए सबसे उपयुक्त है जो उपयोगकर्ताओं के साथ कई चरणों वाली बातचीत में संलग्न होते हैं।

सेशन बिलिंग लॉजिक

अमेरिकी बिलिंग मॉडल के तहत, एक सत्र तब शुरू होता है जब ट्रिगर अनुक्रम में पहले संदेश के 24 घंटे के भीतर 4 रिच या रिच मीडिया संदेशों (जिनमें कम से कम 2 मासिक और कम से कम 1 मासिक संदेश शामिल हों) का आदान-प्रदान होता है। एक बार यह सीमा पूरी हो जाने पर, उस 24 घंटे की अवधि के भीतर भेजे गए सभी संदेशों को एक ही सत्र के रूप में बिल किया जाता है। जो संदेश सत्र की अवधि से बाहर होते हैं या सत्र शुरू करने में विफल रहते हैं, उन पर संबंधित कैरियर के रेट कार्ड के अनुसार रिच या रिच मीडिया के लिए मानक प्रति-संदेश दर लागू होती है।

निम्नलिखित आरेख संवादात्मक एजेंटों के लिए A2P बिलिंग सत्र का एक उदाहरण दिखाता है।

  • एमटी (मोबाइल टर्मिनेटेड) एक संदेश है जो व्यवसाय द्वारा भेजा जाता है।
  • एमओ (मोबाइल ओरिजिनेटेड) उपयोगकर्ता द्वारा शुरू किया गया संदेश या कार्रवाई है।

US billing - Session

बिल योग्य घटनाएँ

संदेश प्रवाह को उनके उद्गम और दिशा के आधार पर वर्गीकृत किया जाता है। संदेश प्रवाह की दिशा का वर्णन करने के लिए, अमेरिकी वाहक आमतौर पर MT/MO शब्दावली का उपयोग करते हैं। ये शब्द RCS ​​फॉर बिजनेस दस्तावेज़ीकरण में प्रयुक्त A2P/P2A शब्दावली के अनुरूप हैं। यहाँ इन शब्दों के बीच संबंध का संक्षिप्त विवरण दिया गया है:

  • A2P (एप्लिकेशन-टू-पर्सन) MT (मोबाइल टर्मिनेटेड) है : व्यवसाय द्वारा भेजा गया संदेश।
  • P2A (पर्सन-टू-एप्लिकेशन) MO (मोबाइल ओरिजिनेटेड) है : उपयोगकर्ता द्वारा शुरू किया गया संदेश या कार्रवाई।
आयोजन विवरण गैर-संवादात्मक एजेंट संवादात्मक एजेंट
a2p_rich_message एजेंट द्वारा भेजा गया एक संदेश जिसमें केवल पाठ, सुझाए गए उत्तर या विशिष्ट सुझाए गए कार्य (नंबर डायल करें, ब्राउज़र में यूआरएल खोलें) शामिल होते हैं। इसे हमेशा एक अलग बिल योग्य घटना के रूप में माना जाता है।

संदेश के खंडों के आधार पर प्रति संदेश बिल योग्य (1 खंड 160 UTF-8 बाइट्स के बराबर है)।

 जब तक यह किसी सत्र का हिस्सा नहीं बन जाता, तब तक इसे एक अलग बिल योग्य घटना के रूप में माना जाएगा।
p2a_rich_message उपयोगकर्ता द्वारा भेजा गया संदेश जिसमें केवल मुक्त-रूप पाठ या सुझाए गए उत्तर पर टैप करने से प्राप्त पाठ शामिल है। इसे हमेशा एक अलग बिल योग्य घटना के रूप में माना जाता है।

संदेश के खंडों के आधार पर प्रति संदेश बिलिंग की जाती है।

 जब तक यह किसी सत्र का हिस्सा नहीं बन जाता, तब तक इसे एक अलग बिल योग्य घटना के रूप में माना जाएगा।
a2p_rich_media_message एजेंट द्वारा भेजा गया एक संदेश जिसमें मीडिया (छवि, वीडियो, ऑडियो), रिच कार्ड, कैरोसेल या "स्थान देखें" जैसी जटिल क्रियाएं शामिल हैं। इसे हमेशा एक अलग बिल योग्य घटना के रूप में माना जाता है।

आकार या विषयवस्तु की परवाह किए बिना, इसे एक ही, निश्चित दर वाले कार्यक्रम के रूप में बिल किया जा सकता है।

 जब तक यह किसी सत्र का हिस्सा नहीं बन जाता, तब तक इसे एक अलग बिल योग्य घटना के रूप में माना जाएगा।
p2a_rich_media_message उपयोगकर्ता द्वारा भेजा गया एक संदेश जिसमें अपलोड की गई मीडिया फ़ाइल (छवि, वीडियो, ऑडियो) शामिल है। इसे हमेशा एक अलग बिल योग्य घटना के रूप में माना जाता है।

इसे एक ही, निश्चित दर वाली घटना के रूप में बिल किया जा सकता है।

 जब तक यह किसी सत्र का हिस्सा नहीं बन जाता, तब तक इसे एक अलग बिल योग्य घटना के रूप में माना जाएगा।
p2a_suggested_action उपयोगकर्ता किसी भी सुझाए गए एक्शन (जैसे, "स्थान देखें") पर टैप करता है जो सुझाया गया उत्तर नहीं है। इसे हमेशा एक अलग बिल योग्य घटना के रूप में माना जाता है।

प्रति क्लिक एक बिल योग्य इवेंट उत्पन्न करता है।

 इसे एक अलग बिल योग्य घटना के रूप में माना जाता है और सत्र का हिस्सा बनने तक प्रति क्लिक एक बिल योग्य घटना उत्पन्न होती है।
a2p_session सत्र शुरू होने और पहला संदेश भेजे जाने पर 24 घंटे की अंतःक्रिया अवधि शुरू होती है। अधिक जानकारी के लिए, देखें सत्र क्या है और यह कैसे काम करता है । लागू नहीं। सत्र गैर-संवादात्मक एजेंटों पर लागू नहीं होते हैं। एक बार सक्रिय होने पर, 24 घंटे की अवधि में आने वाले सभी संदेशों पर एक ही सत्र शुल्क लागू होता है। 24 घंटे के सत्र में होने वाली हर बिल योग्य घटना को सत्र की बिल योग्य घटना आईडी से जोड़ दिया जाएगा।
p2a_session सत्र शुरू होने पर और पहला संदेश MO भेजे जाने पर 24 घंटे की अंतःक्रिया अवधि शुरू होती है। अधिक जानकारी के लिए, देखें सत्र क्या है और यह कैसे काम करता है । लागू नहीं। सत्र गैर-संवादात्मक एजेंटों पर लागू नहीं होते हैं। एक बार सक्रिय होने पर, 24 घंटे की अवधि में आने वाले सभी संदेशों पर एक ही सत्र शुल्क लागू होता है। 24 घंटे के सत्र में होने वाली हर बिल योग्य घटना को सत्र की बिल योग्य घटना आईडी से जोड़ दिया जाएगा।

बिलिंग रिपोर्ट तैयार करना

केवल गैर-परीक्षक ट्रैफ़िक वाले एजेंट ही बिल योग्य इवेंट उत्पन्न करते हैं। परीक्षण फ़ोन नंबरों से होने वाली गतिविधि बिलिंग रिपोर्ट में दिखाई नहीं देती है।

इन रिपोर्टों में यह माना गया है कि बिलिंग तब लागू होती है जब A2P संदेश डिलीवर हो जाते हैं, न कि जब संदेश भेजे जाते हैं। डिलीवर न हुआ संदेश या डिलीवरी से पहले रद्द किया गया संदेश बिलिंग योग्य घटना को ट्रिगर नहीं करता है।

बिलिंग रिपोर्ट प्रारूप

बिलिंग रिपोर्ट rbm_billable_events_YYYY-MM-DD.csv फ़ाइलनाम प्रारूप का उपयोग करती हैं। फ़ाइलनाम में दी गई तिथि फ़ाइल निर्माण तिथि है।

रिपोर्ट की प्रत्येक पंक्ति एक बिल योग्य घटना का रिकॉर्ड है। A2P/P2A सत्रों को कई पंक्तियों द्वारा दर्शाया जाता है—प्रत्येक संदेश के आदान-प्रदान के लिए एक पंक्ति। सत्र से संबंधित प्रत्येक पंक्ति (जिनका billing_event_id समान है) mt_messages और mo_messages कॉलम में पूरे 24 घंटे के सत्र के दौरान भेजे गए कुल MT और MO संदेशों की संख्या दर्शाती है।

रिपोर्ट में प्रत्येक रिकॉर्ड में प्रत्येक बिल योग्य घटना के लिए निम्नलिखित जानकारी शामिल है।

मैदान प्रारूप विवरण उदाहरण
billing_event_id डोरी जनरेट की गई आईडी जो बिल योग्य घटना को अलग करती है।

सेशन के सभी संदेशों का billing_event_id एक ही होगा।

 63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e
type डोरी ईवेंट का प्रकार:
  • a2p_rich_message
  • a2p_rich_media_message
  • p2a_rich_message
  • p2a_rich_media_message
  • p2a_suggested_action
    		•  p2a_rich_message
    agent_id डोरी इवेंट में भाग लेने वाले एजेंट के लिए विशिष्ट पहचानकर्ता। acme_342h23_agent@rbm.goog
    agent_owner डोरी उस पार्टनर खाते के वर्तमान स्वामी का ईमेल पता, जिसके तहत एजेंट बनाया गया था। marketing@xyzaggregator.com
    billing_party डोरी आयोजनों के लिए बिल भेजने वाली पार्टी। वाहक
    max_duration_single_message संख्या बातचीत शुरू होने की समय सीमा समाप्त होने और संदेश को single_message घटना के रूप में वर्गीकृत किए जाने से पहले उपयोगकर्ता को एजेंट संदेश का जवाब देने के लिए अनुमत अधिकतम समय (घंटों में)। व्यक्तिगत रिच संदेशों के लिए अमेरिकी मॉडल पर लागू नहीं होता है। 24
    max_duration_a2p_conversation संख्या इस पायलट प्रोजेक्ट के लिए, यह ट्रिगर अनुक्रम में पहले संदेश से मापी गई 24 घंटे की सत्र अवधि को दर्शाता है। अवधि घंटों में मापी जाती है। 24
    max_duration_p2a_conversation संख्या सेशन पायलट के लिए, यह ट्रिगर अनुक्रम में पहले संदेश से मापी गई 24 घंटे की सेशन अवधि को दर्शाता है। 24
    start_time YYYY-mm-ddTHH:00:00Z

    घटना शुरू होने की UTC तिथि/समय (ISO 8601)। सत्रों के लिए, यह ट्रिगर अनुक्रम में पहले संदेश का टाइमस्टैम्प है।

    ए2पी

  • a2p_rich_message और a2p_rich_media_message जैसी गैर-सेशन घटनाओं के लिए, यह वह समय है जब संदेश उपयोगकर्ता को डिलीवर किया जाता है।
  • a2p_session इवेंट के लिए, यह वह समय है जब वार्तालाप का पहला संदेश उपयोगकर्ता को डिलीवर किया जाता है।

    • पी2ए

  • p2a_rich_message और p2a_rich_media_message जैसी गैर-सेशन घटनाओं के लिए, यह वह समय है जब उपयोगकर्ता द्वारा संदेश भेजा जाता है।
  • p2a_session इवेंट के लिए, यह वह समय है जब उपयोगकर्ता द्वारा वार्तालाप में पहला संदेश भेजा जाता है।
    		•  2025-05-20T08:00:00Z
    duration संख्या अवधि केवल सत्रों से संबंधित है और इसे मिनटों में मापा जाता है। जब घटना सत्र से संबंधित नहीं होती है, तो मान 0 होता है। 45
    mt_messages संख्या इवेंट में मोबाइल-टर्मिनेटेड (A2P) संदेशों की संख्या। सत्रों के लिए, समान billing_event_id वाली प्रत्येक पंक्ति पूरे सत्र में कुल MT संदेशों की संख्या दर्शाती है। 5
    mo_messages संख्या इवेंट में मोबाइल से भेजे गए (P2A) संदेशों की संख्या। सत्रों के लिए, समान billing_event_id वाली प्रत्येक पंक्ति पूरे सत्र में मोबाइल संदेशों की कुल संख्या दर्शाती है। 3
    size_kilobytes संख्या इवेंट में संदेशों से जुड़ी सभी फाइलों का आकार, निकटतम किलोबाइट तक पूर्णांकित (1 किलोबाइट 1024 बाइट्स के बराबर होता है)। 912
    agent_name डोरी इस आयोजन में भाग लेने वाले एजेंट का नाम। ACME Brand
    owner_name डोरी उस पार्टनर खाते के वर्तमान स्वामी का नाम, जिसके तहत एजेंट बनाया गया था। XYZ Aggregator
    segment_count संख्या a2p_rich_message events और p2a_rich_message इवेंट के लिए गणना की गई सेगमेंट संख्या (1 सेगमेंट 160 UTF-8 बाइट्स के बराबर है)। यदि इवेंट ऊपर उल्लिखित श्रेणियों में से एक नहीं है, तो मान 0 होगा। 5
    session_type डोरी सत्र का प्रकार:
  • a2p_session
  • p2a_session
    • यदि गतिविधि सत्र के रूप में योग्य नहीं है तो यह खाली रहेगा।    		 a2p_session

    नमूना बिलिंग रिपोर्ट

    नमूना रिपोर्ट डाउनलोड के लिए उपलब्ध है:

    सामान्य फ़ाइल आकार

    किसी सक्रिय आरसीएस फॉर बिजनेस पार्टनर की दैनिक रिपोर्ट का आकार इस बात पर निर्भर करता है कि उन्होंने कैरियर के नेटवर्क पर कितनी गतिविधि उत्पन्न की है।