आरबीएम ऐसी डेटा फ़ाइलें बनाता है जो खास जानकारी और लेन-देन के लेवल पर, उपयोगकर्ता और एजेंट की गतिविधि की रिपोर्ट करती हैं. डेटा को कई फ़ाइलों में बांटा जाता है:
| फ़ाइल | ब्यौरा | जिनके पास ऐक्सेस हो |
|---|---|---|
| बिलिंग इवेंट की रिपोर्ट | लॉन्च किए गए एजेंट और उपयोगकर्ताओं के बीच, बिल करने लायक इवेंट का रिकॉर्ड | मोबाइल और इंटरनेट सेवा देने वाली वे सभी कंपनियां जिनके नेटवर्क पर आरबीएम ट्रैफ़िक है |
| गतिविधि लॉग | आरबीएम प्लैटफ़ॉर्म की गतिविधि का रॉ डेटा | मोबाइल और इंटरनेट सेवा देने वाली ऐसी कंपनियां जिनके नेटवर्क पर आरबीएम ट्रैफ़िक है और जो अपनी सेवा की शर्तों (ToS) के तहत Jibe Cloud के साथ आरसीएस गतिविधि चालू करती हैं |
पीढ़ी
बिलिंग इवेंट रिपोर्ट और गतिविधि लॉग को जनरेट होने में दो दिन की देरी होती है.
Google किसी गतिविधि इवेंट की रिपोर्ट सिर्फ़ तब करता है, जब उससे जुड़ा बिलिंग सेशन पूरा हो जाता है. किसी सेशन को पूरा होने में 24 घंटे लग सकते हैं. हमारी बिलिंग पाइपलाइन दिन में एक बार एक्ज़ीक्यूट होती है और सिर्फ़ उन बिलिंग सेशन को रिपोर्ट करती है जिनके पूरा होना पक्का है (इसलिए, कम से कम 24 घंटे पुराने हों).
उदाहरण के लिए:
d दिन को एक मैसेज भेजा जाता है और बिलिंग सेशन शुरू करता है, लेकिन उससे एक घंटा पहले पाइपलाइन नहीं चल पाती थी. इसलिए, किसी भी गतिविधि की रिपोर्ट नहीं दी जाती.
जब d+1 पर फिर से पाइपलाइन चलती है, तो शुरू किया गया सेशन सिर्फ़ 23 घंटे पुराना होता है. इसलिए, इस मैसेज के लिए कोई भी गतिविधि इवेंट d+1 पर रिपोर्ट नहीं किया जाता.
जब d+2 पर फिर से पाइपलाइन चलती है, तो सेशन पूरा हो जाता है. इसलिए, बिलिंग सेशन के साथ गतिविधि इवेंट को रिपोर्ट किया जाता है.
स्टोरेज और ऐक्सेस
डेटा फ़ाइलों को इस्तेमाल न होने पर और ट्रांसफ़र के दौरान एन्क्रिप्ट (सुरक्षित) किया जाता है.
एसएफ़टीपी के ज़रिए डेटा फ़ाइलें पाने के लिए, आपको अपनी एसएफ़टीपी सार्वजनिक कुंजी देनी होगी. कुंजियां जनरेट करने के लिए, एसएफ़टीपी ड्रॉपबॉक्स के लिए सिक्योर शेल (एसएसएच) कुंजी का जोड़ा जनरेट करें देखें.
एसएफ़टीपी सर्वर partnerupload.google.com है. अतिरिक्त सुरक्षा के लिए, कनेक्शन एक हाई पोर्ट नंबर (19321) पर है.
अपनी डेटा फ़ाइलें ऐक्सेस करने के लिए, नीचे दिए गए कमांड का इस्तेमाल किया जा सकता है:
sftp -i <path_to_private_key> -P 19321 <username>@partnerupload.google.com
Google इन फ़ॉर्मैट में खाते के उपयोगकर्ता नाम उपलब्ध कराता है:
rbmreports-billableevents-<carrier name>rbmreports-activity-<carrier name>
Google, <carrier name> के बारे में बताता है और हर तरह की रिपोर्ट के लिए अलग-अलग खाता उपलब्ध कराता है.
अलग-अलग तरह की रिपोर्ट ऐक्सेस करने के लिए, अलग-अलग खाते दिए जाते हैं.
फ़ाइल की उपलब्धता
अगर अब तक कोई भी रिपोर्ट फ़ाइल जनरेट नहीं की गई है, तो आपको remote readdir("/"): No such file or directory की तरह ही, एसएफ़टीपी गड़बड़ी दिखेगी. ऐसा होता है.
अगर रिपोर्ट करने के लिए कोई आरबीएम ट्रैफ़िक नहीं है, तो फ़ाइल जनरेट नहीं होगी. इसका मतलब है कि ऐसे कुछ दिन हो सकते हैं जब फ़ाइलें जनरेट नहीं होती हैं. अगर ऐसी स्थिति में खाली फ़ाइलें जनरेट करनी हैं, तो rbm-support@google.com से संपर्क करें.
रीफ़्रेश करें और निजी डेटा का रखरखाव करें
हर डेटा फ़ाइल में, यूटीसी समय के हिसाब से प्लैटफ़ॉर्म का एक दिन का इस्तेमाल दिखाया जाता है. किसी दिन के रिकॉर्ड एक बार जनरेट किए जाते हैं और दिन खत्म होने के बाद दो दिन (48 घंटे) में फ़ाइनल कर दिए जाते हैं. अगर इन फ़ाइलों को किसी डेटा वेयरहाउस में लोड किया जाता है, तो मौजूदा महीने की मेट्रिक अपडेट की जा सकती हैं.
अगर खाते में कोई गतिविधि नहीं है, तो फ़ाइल जनरेट नहीं होगी.
हर फ़ाइल के नाम में मौजूद तारीख, फ़ाइल जनरेट होने की तारीख होती है. फ़ाइल के रिकॉर्ड में, फ़ाइल की तारीख से दो दिन पहले आने वाला यूटीसी दिन शामिल होगा.
फ़ाइलों को जनरेट करने वाली एक्सपोर्ट प्रोसेस, रात 2 से 4 बजे पीएसटी के बीच पूरी होती है.
डेटा फ़ाइलों को ज़्यादा से ज़्यादा 30 दिनों तक सेव रखा जाता है. इसके बाद, उन्हें मिटाया जाता है.
बिलिंग इवेंट की रिपोर्ट
बिलिंग इवेंट रिपोर्ट, बिल करने लायक इवेंट का रिकॉर्ड होती हैं. इन्हें बिलिंग की सुझाई गई इकाइयों का इस्तेमाल करके दिए गए मैसेज से कैलकुलेट किया जाता है. बिल करने लायक इवेंट में गोपनीय जानकारी होती है, लेकिन उपयोगकर्ता की व्यक्तिगत पहचान से जुड़ी जानकारी नहीं होती है (उदाहरण के लिए, कोई मॉनिटरी एसडीएन नहीं, हैश किया गया छोटा-सिखाना या यूनीक आइडेंटिफ़ायर).
सिर्फ़ लॉन्च किए गए एजेंट ही बिलिंग इवेंट जनरेट करते हैं. बिलिंग रिपोर्ट में, लॉन्च होने से पहले या लॉन्च नहीं किए गए एजेंट की गतिविधि नहीं दिखती.
बिलिंग रिपोर्ट में यह माना जाता है कि इवेंट की बिलिंग, मैसेज की डिलीवरी के बाद की जाती है, न कि मैसेज भेजे जाने पर. डिलीवरी से पहले डिलीवर नहीं किया गया या रद्द किया गया मैसेज, बिलिंग इवेंट को ट्रिगर नहीं करता है.
हर आरबीएम एजेंट की एक बिलिंग कैटगरी होती है, जिसे एजेंट लॉन्च के लिए सबमिट करने से पहले एजेंट सेट करता है. बिलिंग कैटगरी यह तय करती है कि एजेंट के भेजे गए मैसेज अलग-अलग हैं या उन्हें बातचीत वाले बिलिंग इवेंट में जोड़ा जा सकता है.
बिल करने लायक इवेंट पांच तरह के होते हैं:
| इवेंट | परिभाषा |
|---|---|
| बेसिक मैसेज | ऐप्लिकेशन-टू-पर्सन (A2P) मैसेज, जो
सिर्फ़ बातचीत वाले एजेंट: अगर अगले 24 घंटे में A2P मैसेज के जवाब के तौर पर कोई P2A मैसेज डिलीवर होता है, तो बेसिक मैसेज A2P बातचीत का हिस्सा बन जाता है. ऐसा न होने पर, सेशन खत्म हो जाता है. एक सामान्य मैसेज, हमेशा किसी एजेंट से उपयोगकर्ता को डिलीवर किया जाता है. |
| सिंगल मैसेज | ऐप्लिकेशन-टू-पर्सन (A2P) मैसेज, जो
सिर्फ़ बातचीत वाले एजेंट: अगर कोई P2A मैसेज अगले 24 घंटे में डिलीवर होता है, तो सिंगल मैसेज A2P बातचीत का हिस्सा बन जाता है. ऐसा न होने पर, सेशन खत्म हो जाता है. किसी एजेंट से एक मैसेज को हमेशा उपयोगकर्ता को डिलीवर किया जाता है. |
| A2P बातचीत | सिर्फ़ बातचीत वाले एजेंट पर लागू होता है: A2P बातचीत तब शुरू होती है, जब किसी A2P सिंगल मैसेज या A2P बेसिक मैसेज के 24 घंटे के अंदर P2A मैसेज डिलीवर हो जाता है. ध्यान दें कि अगर एक से ज़्यादा A2P मैसेज के 24 घंटों के अंदर P2A मैसेज डिलीवर किया जाता है, तो बातचीत का सेशन बनाने के लिए सिर्फ़ P2A मैसेज के ठीक पहले वाले A2P मैसेज का इस्तेमाल किया जाता है. यह A2P मैसेज और अगले 24 घंटे में डिलीवर किए गए सभी मैसेज, नई A2P बातचीत का हिस्सा हैं. |
| P2A बातचीत | सिर्फ़ बातचीत वाले एजेंट पर लागू होता है: P2A बातचीत तब शुरू होती है, जब कोई चालू सेशन (A2P सिंगल मैसेज, A2P बातचीत या P2A बातचीत) न हो और एक P2A मैसेज डिलीवर हो और कारोबार 24 घंटे में जवाब देता हो. |
| P2A मैसेज | बातचीत न करने वाले एजेंट: सिंगल मैसेज या बेसिक मैसेज की बिलिंग कैटगरी वाले किसी एजेंट को
उपयोगकर्ता को भेजा जाने वाला P2A मैसेज.
बातचीत करने वाले एजेंट: उपयोगकर्ता का किसी एजेंट को भेजा गया P2A मैसेज, जहां कोई बातचीत पहले से मौजूद नहीं होती. साथ ही, एजेंट कोई जवाब नहीं देता. |
उपलब्धता
बिलिंग इवेंट की रिपोर्ट, मोबाइल और इंटरनेट सेवा देने वाली उन सभी कंपनियों के लिए उपलब्ध हैं जिनके नेटवर्क पर आरबीएम ट्रैफ़िक है.
फ़ॉर्मैट
बिलिंग इवेंट रिपोर्ट में फ़ाइल नाम के फ़ॉर्मैट का इस्तेमाल किया जाता है
YYYY/MM/DD/rbm_billable_events_YYYY-MM-DD.csv.
फ़ाइल नाम में मौजूद तारीख, फ़ाइल जनरेट होने की तारीख होती है. फ़ाइल के रिकॉर्ड में आम तौर पर उस दिन की गतिविधि शामिल होगी जो इस तारीख से दो दिन पहले की थी.
किसी रिकॉर्ड के फ़ील्ड टैब से अलग किए गए होते हैं और हर लाइन में एक रिकॉर्ड होता है.
हर बिलिंग इवेंट के लिए एक रिकॉर्ड होगा. इसका मतलब है कि एक ही एजेंट के साथ A2P की दो बातचीत के आधार पर, बिलिंग रिपोर्ट में दो बिलिंग इवेंट और दो रिकॉर्ड जनरेट होंगे.
बिलिंग के लायक इवेंट की रिपोर्ट के हर रिकॉर्ड में हर इवेंट के लिए, नीचे दी गई जानकारी होती है:
| फ़ील्ड | फ़ॉर्मैट | ब्यौरा | उदाहरण |
|---|---|---|---|
billing_event_id
|
स्ट्रिंग | यूयूआईडी आइडेंटिफ़ायर एक रैंडम नंबर है. यह हर नए इवेंट को बनाते समय जनरेट होता है. | |
type
|
स्ट्रिंग | इवेंट किस तरह का है:
|
single_message
|
agent_id
|
स्ट्रिंग | इवेंट में हिस्सा लेने वाले एजेंट का आइडेंटिफ़ायर. | rbm-welcome-bot@rbm.goog
|
agent_owner
|
स्ट्रिंग | इवेंट में हिस्सा लेने वाले एजेंट के मालिक का ईमेल. आरबीएम एजेंट इसी पक्ष को रजिस्टर करता है. ज़्यादातर मामलों में, एग्रीगेटर होता है. हालांकि, कुछ मामलों में यह ब्रैंड भी हो सकता है. यह वैल्यू 'आरबीएम Google खाते' फ़ील्ड से ली जाती है. यह फ़ील्ड तब दिया जाता है, जब डेवलपर आरबीएम का इस्तेमाल करने के लिए रजिस्टर होता है. | name@aggregator.com
|
billing_party
|
स्ट्रिंग | वह पक्ष जो इवेंट के लिए बिल देता है.
|
carrier
|
max_duration_single_message
|
नंबर | किसी एक मैसेज सेशन की पहचान करने का जवाब न मिलने पर, एजेंट के मैसेज को जाने का समय (घंटों में). | 24
|
max_duration_a2p_conversation
|
नंबर | A2P सेशन की ज़्यादा से ज़्यादा अवधि, घंटों में. इसे तब मेज़र किया जाता है, जब उपयोगकर्ता के पहले मैसेज पर पहले जवाब दिया जाता है. | 24
|
max_duration_p2a_conversation
|
नंबर | P2A सेशन की ज़्यादा से ज़्यादा अवधि, घंटों में. इसे बातचीत में उपयोगकर्ता के पहले मैसेज से मापा जाता है. | 24
|
start_time
|
YYYY-mm-ddTHH:00:00Z | ISO 8601 फ़ॉर्मैट में इवेंट शुरू होने की यूटीसी तारीख/समय को नज़दीकी घंटे में बदल दिया जाता है.
|
2019-07-25T08:00:00Z
|
duration
|
नंबर | इवेंट का कुल समय, नज़दीकी मिनट में बदल दिया जाता है.
जब इवेंट टाइप |
45
|
mt_messages
|
नंबर | इवेंट में मोबाइल से बंद किए गए मैसेज की संख्या. | 11
|
mo_messages
|
नंबर | इवेंट में मोबाइल से जनरेट किए गए मैसेज की संख्या. | 9
|
size_kilobytes
|
नंबर | इवेंट में, मैसेज के साथ अटैच की गई सभी फ़ाइलों का साइज़, सबसे करीबी किलोबाइट (1kB = 1024 बाइट) में बदल दिया जाता है. | 912
|
agent_name
|
स्ट्रिंग |
इवेंट में हिस्सा लेने वाला एजेंट. |
XYZ Mobile USA
|
owner_name
|
स्ट्रिंग | उस एजेंट का मालिक जिसने इवेंट में हिस्सा लिया. इस पक्ष ने आरबीएम एजेंट को रजिस्टर किया था. ज़्यादातर मामलों में, एग्रीगेटर होता है. हालांकि, कुछ मामलों में यह ब्रैंड भी हो सकता है. यह वैल्यू "आपके पार्टनर खाते के लिए पसंदीदा डिसप्ले नेम" से ली गई है. इसे तब दिया गया था, जब डेवलपर ने आरबीएम का इस्तेमाल करने के लिए रजिस्टर किया था. | XYZ Mobile
|
सैंपल फ़ाइल
सैंपल बिलिंग रिपोर्ट फ़ाइल डाउनलोड करने के लिए उपलब्ध है.
फ़ाइल का सामान्य साइज़
किसी सक्रिय पार्टनर की रोज़ाना रिपोर्ट वाली फ़ाइल का साइज़ करीब 53,000 रिकॉर्ड और करीब 8 एमबी हो सकता है.
गतिविधि लॉग
गतिविधि लॉग, आरबीएम प्लैटफ़ॉर्म पर गतिविधि का रॉ डेटा लॉग होता है. इसका मकसद बिलिंग के लायक इवेंट का ऑडिट करना और कस्टम इवेंट बनाना होता है.
उपलब्धता
गतिविधि लॉग, मोबाइल और इंटरनेट सेवा देने वाली सिर्फ़ उन कंपनियों के लिए उपलब्ध होते हैं जिनके नेटवर्क पर आरबीएम ट्रैफ़िक होता है और जो अपनी सेवा की शर्तों (ToS) के तहत Jibe Cloud के साथ आरसीएस गतिविधि चालू करते हैं. अगर आपने Jibe की सेवा की शर्तों के तहत Jibe Cloud का इस्तेमाल किया है, तो आपको गतिविधि लॉग का ऐक्सेस नहीं मिलेगा.
फ़ॉर्मैट
गतिविधि लॉग, फ़ाइल नाम के फ़ॉर्मैट YYYY/MM/DD/rbm_activity_YYYY-MM-DD.csv का इस्तेमाल करते हैं.
फ़ाइल नाम में मौजूद तारीख, फ़ाइल जनरेट होने की तारीख होती है. फ़ाइल के रिकॉर्ड में आम तौर पर उस दिन की गतिविधि शामिल होगी जो इस तारीख से दो दिन पहले की थी.
किसी रिकॉर्ड के फ़ील्ड टैब से अलग किए गए होते हैं और हर लाइन में एक रिकॉर्ड होता है.
गतिविधि लॉग के हर रिकॉर्ड में हर गतिविधि इवेंट के लिए नीचे दिए गए फ़ील्ड होते हैं.
| फ़ील्ड | फ़ॉर्मैट | ब्यौरा | उदाहरण |
|---|---|---|---|
activity_id
|
स्ट्रिंग | गतिविधि के लिए आइडेंटिफ़ायर. | |
billing_event_id
|
स्ट्रिंग | उस बिलिंग इवेंट का आइडेंटिफ़ायर जिसमें गतिविधि हुई है. अगर कोई गतिविधि किसी भी सेशन से जुड़ी हुई नहीं है, तो फ़ील्ड खाली हो सकता है. जैसे, text_message से जुड़ा delivery_receipt_event.
| |
agent_id
|
स्ट्रिंग | एजेंट का आइडेंटिफ़ायर. | welcome-bot@rbm.goog
|
user_id
|
स्ट्रिंग | उपयोगकर्ता का MDMSDN. | 918369110173
|
direction
|
स्ट्रिंग | संदेश भेजे जाने की दिशा:
|
MT
|
time
|
YYYY-mm-ddTHH:MM:SS.SSSZ | आरबीएम प्लैटफ़ॉर्म पर इवेंट सबमिट करने की यूटीसी तारीख/समय. नीचे दिया गया नोट देखें. | 2019-07-25T00:29:07.033Z
|
type
|
स्ट्रिंग | गतिविधि का टाइप:
|
text_message
|
size_bytes
|
स्ट्रिंग | गतिविधि से अटैच की गई फ़ाइलों का साइज़, बाइट में. | 912
|
टाइमस्टैंप के बारे में जानकारी
गतिविधि लॉग में मौजूद टाइमस्टैंप, आरबीएम प्लैटफ़ॉर्म पर किसी इवेंट को सबमिट किए जाने का समय रिकॉर्ड करते हैं. ऐसे इवेंट जो किसी उपयोगकर्ता को कॉन्टेंट डिलीवर करते हैं, उनके लिए इवेंट को गतिविधि लॉग में तब तक नहीं लिखा जाएगा, जब तक मैसेज डिलीवर नहीं हो जाता.
उदाहरण के लिए, अगर किसी उपयोगकर्ता को बुधवार को 13:00 बजे एक आरबीएम मैसेज भेजा गया है और ईमेल पाने वाला व्यक्ति रविवार 09:00 बजे तक ऑफ़लाइन है, तो वह इवेंट रविवार के लिए जनरेट किए गए ऐक्टिविटी लॉग में दिखेगा. गतिविधि लॉग में इवेंट का टाइमस्टैंप बुधवार, 13:00 बजे होगा.