RBM ডেটা ফাইল তৈরি করে যা সারাংশ এবং লেনদেনের স্তরে ব্যবহারকারী এবং এজেন্ট কার্যকলাপের রিপোর্ট করে। ডেটা একাধিক ফাইলে বিভক্ত করা হয়েছে:
ফাইল | বর্ণনা | যার প্রবেশাধিকার আছে |
---|---|---|
বিলিং ইভেন্ট রিপোর্ট | লঞ্চ এজেন্ট এবং ব্যবহারকারীদের মধ্যে বিলযোগ্য ইভেন্টের একটি রেকর্ড | যে সমস্ত ক্যারিয়ারের নেটওয়ার্কে RBM ট্রাফিক আছে |
কার্য বিবরণ | কাঁচা RBM প্ল্যাটফর্ম কার্যকলাপ ডেটা | যেসব ক্যারিয়ারের নেটওয়ার্কে RBM ট্রাফিক রয়েছে এবং তাদের নিজস্ব পরিষেবার শর্তাবলী (ToS) এর অধীনে Jibe Cloud-এর সাথে RCS অ্যাক্টিভিটি সক্ষম করে |
প্রজন্ম
বিলিং ইভেন্ট রিপোর্ট এবং অ্যাক্টিভিটি লগের জেনারেশনে দুই দিন বিলম্ব হয়।
Google শুধুমাত্র একটি কার্যকলাপ ইভেন্ট রিপোর্ট করে যখন এটির অন্তর্গত বিলিং সেশন সম্পূর্ণ হয়। একটি সেশন সম্পূর্ণ হতে 24 ঘন্টা পর্যন্ত সময় লাগতে পারে এবং, আমাদের বিলিং পাইপলাইন দিনে একবার সঞ্চালিত হয় এবং শুধুমাত্র বিলিং সেশনগুলি রিপোর্ট করে যেগুলি সম্পূর্ণ হয়েছে নিশ্চিত (তাই কমপক্ষে 24 ঘন্টা পুরানো)।
উদাহরণ স্বরূপ:
d দিনে একটি বার্তা পাঠানো হয় এবং একটি বিলিং সেশন শুরু করে, কিন্তু এটি 1 ঘন্টা আগে পাইপলাইন সম্পাদন মিস করেছে। অতএব, কোন কার্যকলাপ ঘটনা রিপোর্ট করা হয় না.
যখন পাইপলাইনটি আবার d+1 এ চলে, তখন বার্তাটি শুরু করা সেশনের বয়স মাত্র 23 ঘন্টা। অতএব, এই বার্তার জন্য কোন কার্যকলাপ ইভেন্ট d+1 এ রিপোর্ট করা হয় না।
যখন পাইপলাইনটি আবার d+2 এ চলে, তখন সেশনটি সম্পন্ন হয় তাই বিলিং সেশনের সাথে কার্যকলাপ ইভেন্টটি রিপোর্ট করা হয়।
স্টোরেজ এবং অ্যাক্সেস
ডেটা ফাইলগুলি বিশ্রামে এবং স্থানান্তরের সময় এনক্রিপ্ট করা হয়।
SFTP দ্বারা ডেটা ফাইল পুনরুদ্ধার করতে, আপনাকে আপনার SFTP সর্বজনীন কী প্রদান করতে হবে। কী তৈরি করতে, একটি SFTP ড্রপবক্সের জন্য একটি সিকিউর শেল (SSH) কী জোড়া জেনারেট করুন দেখুন।
SFTP সার্ভার হল 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 ট্রাফিক না থাকলে একটি ফাইল তৈরি হবে না। এর মানে এমন কিছু দিন থাকতে পারে যখন ফাইল তৈরি হয় না। আপনার প্রক্রিয়াকরণ সহজ করার জন্য এই পরিস্থিতিতে খালি ফাইল তৈরি করতে হলে rbm-support@google.com- এ যোগাযোগ করুন।
রিফ্রেশ এবং ধরে রাখা
প্রতিটি ডেটা ফাইল UTC সময়ে প্ল্যাটফর্ম ব্যবহারের এক দিনের প্রতিনিধিত্ব করে। একটি নির্দিষ্ট দিনের জন্য রেকর্ডগুলি একবার তৈরি করা হয় এবং দিন শেষ হওয়ার 2 দিনের মধ্যে (48 ঘন্টা) চূড়ান্ত করা হয়। আপনি যদি এই ফাইলগুলিকে একটি ডেটা গুদামে লোড করেন তবে আপনি বর্তমান মাসের মেট্রিক্স আপডেট করতে পারেন৷
অ্যাকাউন্টের জন্য কোনো কার্যকলাপ না থাকলে একটি ফাইল তৈরি হয় না।
প্রতিটি ফাইলের নামে তারিখটি ফাইলটি তৈরি করার তারিখ। ফাইলের রেকর্ডগুলি UTC দিন কভার করবে যা ফাইলের তারিখের 2 দিন আগে আসে।
ফাইল তৈরির রপ্তানি প্রক্রিয়া 2 থেকে 4am PST-এর মধ্যে সঞ্চালিত হয়।
ডেটা ফাইলগুলি মুছে ফেলার আগে সর্বাধিক 30 দিনের জন্য ধরে রাখা হয়।
বিলিং ইভেন্ট রিপোর্ট
বিলিং ইভেন্ট রিপোর্ট হল বিলিং এর প্রস্তাবিত ইউনিট ব্যবহার করে অন্তর্নিহিত বার্তাগুলি থেকে গণনা করা বিলযোগ্য ইভেন্টের রেকর্ড। বিলযোগ্য ইভেন্টে গোপনীয় তথ্য থাকে, কিন্তু কোনো ব্যবহারকারীর PII নেই (যেমন, কোনো MSISDN, MSISDN হ্যাশ করা MSISDN বা কোনো ব্যবহারকারী অনন্য শনাক্তকারী)।
শুধুমাত্র লঞ্চ করা এজেন্টরা বিলিং ইভেন্ট তৈরি করে। এখনও চালু করা বা আনলঞ্চ করা এজেন্টের কার্যকলাপ বিলিং রিপোর্টে প্রদর্শিত হয় না।
বিলিং রিপোর্টগুলি অনুমান করে যে ইভেন্টগুলি বার্তাগুলির বিতরণের সময় বিল করা হয়, বার্তাগুলি পাঠানোর সময় নয়৷ ডেলিভারির আগে একটি অবিলম্বিত বা প্রত্যাহার করা বার্তা একটি বিলিং ইভেন্টকে ট্রিগার করে না।
প্রতিটি RBM এজেন্টের একটি বিলিং ক্যাটাগরি থাকে, যা এজেন্টকে লঞ্চের জন্য জমা দেওয়ার আগে এজেন্ট ডেভেলপার দ্বারা সেট করা হয়। বিলিং বিভাগ নির্ধারণ করে যে এজেন্ট যে বার্তাগুলি পাঠায় তা বিচ্ছিন্ন কিনা বা সেগুলি কথোপকথনমূলক বিলিং ইভেন্টগুলিতে একত্রিত হতে পারে কিনা।
পাঁচ ধরনের বিলযোগ্য ইভেন্ট রয়েছে:
ঘটনা | সংজ্ঞা |
---|---|
মৌলিক বার্তা | একটি অ্যাপ্লিকেশন-টু-পারসন (A2P) বার্তা যা
শুধুমাত্র কথোপকথনমূলক এজেন্ট : যদি পরবর্তী 24 ঘন্টার মধ্যে একটি A2P বার্তার প্রতিক্রিয়া হিসাবে একটি P2A বার্তা প্রদান করা হয়, তাহলে মৌলিক বার্তাটি একটি A2P কথোপকথনের অংশ হয়ে যায়; অন্যথায়, অধিবেশন সমাপ্ত হয়। একটি মৌলিক বার্তা সর্বদা একজন এজেন্ট থেকে একজন ব্যবহারকারীর কাছে বিতরণ করা হয়। |
একক বার্তা | একটি অ্যাপ্লিকেশন-টু-পারসন (A2P) বার্তা যা
শুধুমাত্র কথোপকথনমূলক এজেন্ট : যদি একটি P2A বার্তা পরবর্তী 24 ঘন্টার মধ্যে বিতরণ করা হয়, তাহলে একক বার্তাটি A2P কথোপকথনের অংশ হয়ে যায়; অন্যথায়, অধিবেশন সমাপ্ত হয়। একটি একক বার্তা সর্বদা একজন এজেন্ট থেকে একজন ব্যবহারকারীর কাছে বিতরণ করা হয়। |
A2P কথোপকথন | শুধুমাত্র কথোপকথনমূলক এজেন্টদের জন্য প্রযোজ্য : একটি A2P কথোপকথন শুরু হয় যখন একটি P2A বার্তা একটি A2P একক বার্তা বা A2P মৌলিক বার্তার 24 ঘন্টার মধ্যে বিতরণ করা হয়। মনে রাখবেন যে যদি একটি P2A বার্তা একাধিক A2P বার্তার 24 ঘন্টার মধ্যে বিতরণ করা হয়, তবে শুধুমাত্র A2P বার্তাটি যেটি P2A বার্তার আগে ছিল কথোপকথন সেশন তৈরি করতে ব্যবহৃত হয়। এই A2P বার্তা, পরবর্তী 24 ঘন্টার মধ্যে বিতরণ করা যেকোনো বার্তা সহ, নতুন A2P কথোপকথনের অংশ। |
P2A কথোপকথন | শুধুমাত্র কথোপকথনমূলক এজেন্টদের জন্য প্রযোজ্য : একটি P2A কথোপকথন শুরু হয় যখন কোন সক্রিয় সেশন না থাকে (A2P একক বার্তা, A2P কথোপকথন, বা P2A কথোপকথন) এবং একটি P2A বার্তা বিতরণ করা হয়, এবং ব্যবসা 24 ঘন্টার মধ্যে প্রতিক্রিয়া জানায়৷ |
P2A বার্তা | অ-কথোপকথনমূলক এজেন্ট : একটি P2A বার্তা একজন ব্যবহারকারীর কাছ থেকে একটি এজেন্টের কাছে পাঠানো হয়েছে যার একটি বিলিং বিভাগ একক বার্তা বা মৌলিক বার্তা রয়েছে। কথোপকথনমূলক এজেন্ট : একটি P2A বার্তা একজন ব্যবহারকারীর কাছ থেকে একটি এজেন্টের কাছে পাঠানো হয় যেখানে কোনও বিদ্যমান কথোপকথন নেই এবং এজেন্ট কোনও উত্তর ফেরত দেয় না। |
উপস্থিতি
বিলিং ইভেন্ট রিপোর্টগুলি তাদের নেটওয়ার্কে RBM ট্রাফিক আছে এমন সমস্ত ক্যারিয়ারের কাছে উপলব্ধ।
বিন্যাস
বিলিং ইভেন্ট রিপোর্ট YYYY/MM/DD/rbm_billable_events_YYYY-MM-DD.csv
ফাইলের নাম বিন্যাস ব্যবহার করে।
ফাইলের নামের তারিখটি ফাইলটি তৈরি হওয়ার তারিখ। ফাইলের রেকর্ডগুলি সাধারণত এই তারিখের 2 দিন আগেকার দিনের কার্যকলাপকে কভার করবে৷
একটি রেকর্ডের ক্ষেত্রগুলি ট্যাব দ্বারা পৃথক করা হয় এবং প্রতি লাইনে একটি রেকর্ড থাকে৷
প্রতিটি বিলিং ইভেন্টের জন্য একটি রেকর্ড থাকবে অর্থাৎ একই এজেন্টের সাথে দুটি A2P কথোপকথন দুটি বিলিং ইভেন্ট এবং বিলিং প্রতিবেদনে দুটি রেকর্ড তৈরি করবে।
বিলযোগ্য ইভেন্ট রিপোর্টের প্রতিটি রেকর্ডে প্রতিটি ইভেন্টের জন্য নিম্নলিখিত তথ্য রয়েছে:
মাঠ | বিন্যাস | বর্ণনা | উদাহরণ |
---|---|---|---|
billing_event_id | স্ট্রিং | UUID শনাক্তকারী, একটি এলোমেলো সংখ্যা, এটি তৈরি করার সময় প্রতিটি নতুন ইভেন্টের জন্য তৈরি হয়। | |
type | স্ট্রিং | ইভেন্টের ধরন:
| single_message |
agent_id | স্ট্রিং | ইভেন্টে অংশগ্রহণকারী এজেন্টের শনাক্তকারী। | rbm-welcome-bot@rbm.goog |
agent_owner | স্ট্রিং | ইভেন্টে অংশগ্রহণকারী এজেন্টের মালিকের ইমেল। এই দলটি RBM এজেন্টকে নিবন্ধিত করেছে, বেশিরভাগ ক্ষেত্রেই এগ্রিগেটর, কিন্তু কিছু বিরল ক্ষেত্রে এটি ব্র্যান্ড হতে পারে। এই মানটি 'RBM Google অ্যাকাউন্ট' ফিল্ড থেকে নেওয়া হয় যখন বিকাশকারী RBM ব্যবহার করার জন্য নিবন্ধিত হয় । | 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 ফরম্যাটে ইভেন্টটি শুরু হওয়া UTC তারিখ/সময় নিকটতম ঘন্টায় বৃত্তাকার।
| 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 | স্ট্রিং | অনুষ্ঠানে অংশগ্রহণকারী এজেন্টের মালিক মো. এই দলটি RBM এজেন্ট নিবন্ধিত। বেশীরভাগ ক্ষেত্রেই এটি সংযোজনকারী, কিন্তু কিছু বিরল ক্ষেত্রে এটি ব্র্যান্ড হতে পারে। এই মানটি "আপনার অংশীদার অ্যাকাউন্টের জন্য পছন্দের প্রদর্শন নাম" থেকে নেওয়া হয় যখন বিকাশকারী RBM ব্যবহার করার জন্য নিবন্ধিত হয় । | XYZ Mobile |
নমুনা ফাইল
একটি নমুনা বিলিং রিপোর্ট ফাইল ডাউনলোডের জন্য উপলব্ধ।
সাধারণ ফাইলের আকার
একজন সক্রিয় অংশীদার থেকে একটি দৈনিক রিপোর্ট ফাইল প্রায় 53,000 রেকর্ড এবং আনুমানিক 8Mb আকারের হতে পারে।
কার্যকলাপ লগ
অ্যাক্টিভিটি লগগুলি হল RBM প্ল্যাটফর্মে ক্রিয়াকলাপের কাঁচা ডেটা লগ বিলযোগ্য ইভেন্টগুলি অডিট করার এবং কাস্টম ইভেন্টগুলি তৈরি করার উদ্দেশ্যে।
উপস্থিতি
অ্যাক্টিভিটি লগগুলি শুধুমাত্র সেই পরিষেবার জন্য উপলব্ধ যাদের নেটওয়ার্কে RBM ট্র্যাফিক রয়েছে এবং তাদের নিজস্ব পরিষেবার শর্তাবলী (ToS)-এর অধীনে Jibe Cloud-এর সাথে RCS অ্যাক্টিভিটি সক্ষম করে৷ আপনি Jibe এর ToS এর অধীনে Jibe Cloud ব্যবহার করলে, আপনার কার্যকলাপ লগগুলিতে অ্যাক্সেস থাকবে না।
বিন্যাস
কার্যকলাপ লগগুলি ফাইলের নাম বিন্যাস YYYY/MM/DD/rbm_activity_YYYY-MM-DD.csv
ব্যবহার করে।
ফাইলের নামের তারিখটি ফাইলটি তৈরি হওয়ার তারিখ। ফাইলের রেকর্ডগুলি সাধারণত এই তারিখের 2 দিন আগেকার দিনের কার্যকলাপকে কভার করবে৷
একটি রেকর্ডের ক্ষেত্রগুলি ট্যাব দ্বারা পৃথক করা হয় এবং প্রতি লাইনে একটি রেকর্ড থাকে৷
কার্যকলাপ লগের প্রতিটি রেকর্ডে প্রতিটি কার্যকলাপ ইভেন্টের জন্য নিম্নলিখিত ক্ষেত্রগুলি রয়েছে৷
মাঠ | বিন্যাস | বর্ণনা | উদাহরণ |
---|---|---|---|
activity_id | স্ট্রিং | কার্যকলাপের জন্য শনাক্তকারী. | |
billing_event_id | স্ট্রিং | যে বিলিং ইভেন্টে কার্যকলাপটি হয়েছিল তার শনাক্তকারী৷ কার্যকলাপটি কোনো সেশনের সাথে যুক্ত না থাকলে খালি হতে পারে, যেমন সংশ্লিষ্ট delivery_receipt_event ছাড়াই একটি text_message । | |
agent_id | স্ট্রিং | এজেন্টের শনাক্তকারী। | welcome-bot@rbm.goog |
user_id | স্ট্রিং | ব্যবহারকারীর MSISDN. | 918369110173 |
direction | স্ট্রিং | বার্তাটি যে দিকে পাঠানো হয়েছিল:
| MT |
time | YYYY-mm-ddTHH:MM:SS.SSSZ | RBM প্ল্যাটফর্মে ইভেন্ট জমা দেওয়ার UTC তারিখ/সময়। নীচের নোট দেখুন. | 2019-07-25T00:29:07.033Z |
type | স্ট্রিং | কার্যকলাপের ধরন:
| text_message |
size_bytes | স্ট্রিং | কার্যকলাপের সাথে সংযুক্ত ফাইলের আকার, বাইটে। | 912 |
টাইমস্ট্যাম্পের উপর একটি নোট
অ্যাক্টিভিটি লগের টাইমস্ট্যাম্পগুলি RBM প্ল্যাটফর্মে একটি ইভেন্ট জমা দেওয়ার সময় রেকর্ড করে। ব্যবহারকারীর কাছে বিষয়বস্তু সরবরাহকারী ইভেন্টগুলির জন্য, বার্তাটি বিতরণ না হওয়া পর্যন্ত ইভেন্টটি কার্যকলাপ লগে লেখা হবে না।
উদাহরণস্বরূপ, যদি বুধবার 13:00-এ কোনও ব্যবহারকারীকে একটি RBM বার্তা পাঠানো হয় এবং প্রাপক রবিবার 09:00 পর্যন্ত অফলাইনে থাকেন, তাহলে রবিবারের জন্য তৈরি হওয়া কার্যকলাপ লগে ইভেন্টটি প্রদর্শিত হবে। অ্যাক্টিভিটি লগে ইভেন্টের টাইমস্ট্যাম্প হবে বুধবার, 13:00।