این صفحه فایل‌های داده‌ای را که ‹RCS ویژه «کسب‌وکار»› برای کمک به شرکت‌های مخابراتی در صدور صورت‌حساب و حسابرسی ایجاد می‌کند شرح می‌دهد.
| فایل | شرح | افرادی که دسترسی دارند |
|---|---|---|
| گزارش صورت‌حساب | گزارش انبوهیده رویدادهای صورت‌حساب‌دار بین کاربران و نمایندگان راه‌اندازی‌شده. | همه شرکت‌های مخابراتی که به‌طور فعال «سرویس‌های ارتباطی غنی ویژه کسب‌وکارها» را ارائه می‌دهند. |
| گزارش فعالیت | گزارش داده‌های خام فعالیت «RCS ویژه کسب‌وکارها»، شامل رویدادهای صورت‌حساب‌شدنی. | شرکت‌های مخابراتی که به‌طور فعال ‹RCS ویژه «کسب‌وکارها»› را اداره می‌کنند و «سرویس RCS Google» را تحت «شرایط خدمات» (ToS) خودشان اداره می‌کنند. |
«سرویس‌های ارتباطی غنی ویژه کسب‌وکارها» از مدل صورت‌حساب استاندارد برای ترافیک غیرایالات متحده استفاده می‌کند. برای جزئیات، به پرسشگان صورت‌حساب مراجعه کنید.
تولید فایل
هر فایل داده نشان‌دهنده یک روز استفاده از «سرویس‌های ارتباطی غنی برای کسب‌وکار» در «زمان استاندارد اقیانوس آرام» (PST) است. فایل‌ها به‌صورت روزانه تولید می‌شوند و فعالیت‌های ۲۴ ساعت قبلی (از نیمه‌شب تا نیمه‌شب) را منعکس می‌کنند. فرایند تولید می‌تواند چند ساعت طول بکشد و زمان تکمیل ممکن است متفاوت باشد.
- برای عامل‌های غیرمکالمه‌ای، فایل‌ها حاوی داده‌های مربوط به دوره ۲۴ ساعته‌ای است که بلافاصله قبل‌از روز تولید فایل بوده است. برای مثال، گزارشی که در ۵ مه تولید می‌شود، داده‌های مربوط به ساعت ۱۲:۰۰ بامداد ۴ مه تا ۱۲:۰۰ بامداد ۵ مه را پوشش می‌دهد. زمان مشخص‌شده در منطقه زمانی «زمان استاندارد اقیانوس آرام» است.
برای عامل‌های مکالمه‌ای، فایل‌ها حاوی داده‌های دوره ۲۴ ساعته ۱ تا ۲ روز قبل‌از زمان تولید فایل است. برای مثال، گزارشی که در ۵ مه تولید می‌شود، داده‌های مربوط به بازه ۲۴ ساعته ۲ یا ۳ مه را پوشش می‌دهد. زمان مشخص‌شده در منطقه زمانی PST است.
دلیل تأخیر این است که فعالیت «سرویس‌های ارتباطی غنی ویژه کسب‌وکارها» برای عامل‌های مکالمه‌ای به جلسه‌ها پیوند داده می‌شود که تکمیل آن‌ها ممکن است تا ۲۴ ساعت طول بکشد. این تأخیر به «سرویس‌های ارتباطی غنی ویژه کسب‌وکارها» اجازه می‌دهد همه پیام‌های درون مکالمه را قبل‌از محاسبه رویداد صورت‌حساب‌دار ضبط کند. برای اطلاعات بیشتر درباره نمایندگان مکالمه‌ای، به دسته‌های صورت‌حساب نماینده مراجعه کنید.
نکات کلیدی:
- بدون فعالیت: به‌طور پیش‌فرض، اگر در یک روز مشخص فعالیت پلاتفرمی وجود نداشته باشد، هیچ فایلی تولید نمی‌شود. بااین‌حال، درصورت نیاز می‌توانید با دریافت فایل‌های خالی موافقت کنید. برای موافقت کردن، با rbm-support@google.com تماس بگیرید.
- نام‌گذاری: تاریخ موجود در نام فایل، تاریخ تولید فایل است، نه تاریخ داده‌های درون آن.
- نگهداری: فایل‌ها حداکثر تا ۶۳ روز قبل‌از حذف شدن ذخیره می‌شوند.
می‌توانید از این فایل‌ها برای به‌روزرسانی انبار داده‌هایتان با جدیدترین سنجه‌های استفاده از پلاتفرم استفاده کنید.
ذخیره‌سازی و دسترسی به فایل
فایل‌های داده در حالت سکون و درحین انتقال رمزگذاری می‌شوند.
برای بازیابی فایل‌های داده با «پروتکل انتقال فایل امن» (SFTP)، کلید عمومی SFTP خودتان را ارائه دهید. برای تولید کلیدها، به تولید جفت کلید پوسته امن (SSH) برای SFTP dropbox مراجعه کنید.
سرور SFTP partnerupload.google.com است و اتصال برای امنیت بیشتر روی درگاه
شماره بالا (۱۹۳۲۱) است.
برای دسترسی به فایل‌های داده‌تان می‌توانید از فرمان زیر استفاده کنید:
sftp -i <path_to_private_key> -P 19321 <username>@partnerupload.google.com
Google نام‌های کاربری حساب را در قالب‌های زیر ارائه می‌دهد:
rbmreports-billableevents-<carrier name>rbmreports-activity-<carrier name>
Google <carrier name> را مشخص می‌کند و برای هر نوع گزارش حساب جداگانه‌ای ارائه می‌دهد.
حساب‌های جداگانه‌ای برای دسترسی به انواع مختلف گزارش ارائه می‌شود.
دردسترس بودن فایل
اگر هنوز فایل داده‌ای تولید نشده باشد، خطای SFTP مشابه
remote readdir("/"): No such file or directory را خواهید دید که طبیعی است.
اگر ترافیک «سرویس‌های ارتباطی غنی ویژه کسب‌وکارها» برای گزارش وجود نداشته باشد، فایلی تولید نخواهد شد. این یعنی ممکن است روزهایی باشد که هیچ فایلی تولید نشود. اگر برای ساده‌سازی فرایندتان به فایل‌های خالی نیاز دارید، با تیم پشتیبانی «سرویس‌های ارتباطی غنی برای کسب‌وکار» تماس بگیرید.
گزارش‌های صورت‌حساب
گزارش‌های صورت‌حساب سوابق رویدادهای صورتحسابپذیر است که براساس دسته صورت‌حساب نماینده و نوع پیام‌هایی که ارسال می‌کند محاسبه می‌شود. گزارش‌های صورت‌حساب برای همه شرکت‌های مخابراتی که به‌طور فعال از «سرویس‌های ارتباطی غنی ویژه کسب‌وکارها» استفاده می‌کنند دردسترس است.
گزارش‌های صورت‌حساب حاوی اطلاعات محرمانه است، اما حاوی «اطلاعات شناساننده شخصی» (PII) کاربر، مثل MSISDN، MSISDN درهم‌سازی‌شده، یا هرگونه شناسه یکتای کاربر نیست.
دسته‌های صورت‌حساب نماینده
هنگام ایجاد یک عامل، مالک دسته صورت‌حساب آن را براساس نحوه تعامل عامل با کاربران تعیین می‌کند. دسته صورت‌حساب تعداد یا نوع پیام‌هایی را که نماینده می‌تواند ارسال کند محدود نمی‌کند. اما تعیین می‌کند صورت‌حساب نماینده برای پیام‌ها چگونه صادر شود. دو دسته اصلی صورت‌حساب در جدول زیر توضیح داده شده است.
| دسته صورت‌حساب | نوع نماینده | موارد استفاده نمونه | روش صدور صورت‌حساب |
|---|---|---|---|
| غیرمکالمه‌ای | نمایندگانی که عمدتاً پیام‌های یک‌طرفه ارسال می‌کنند. |
|
برای هر پیامی که به کاربر تحویل داده می‌شود صورت‌حساب صادر می‌شود. |
| مکالمه‌ای | عامل‌هایی که برای تبادل‌های رفت‌وبرگشتی با کاربران طراحی شده‌اند. |
|
صورت‌حساب براساس هر مکالمه: اگر یکی از طرفین (عامل یا کاربر) ظرف ۲۴ ساعت به پیام طرف دیگر پاسخ دهد، مکالمه‌ای شروع می‌شود. درطول پنجره مکالمه (۲۴ ساعت پس‌از اولین پاسخ)، عامل و کاربر می‌توانند هر تعداد پیام که بخواهند مبادله کنند، و عامل نرخ ثابتی برای مکالمه از او کسر خواهد شد. صورت‌حساب براساس پیام: اگر عامل پیامی را ارسال کند که کاربر ظرف ۲۴ ساعت به آن پاسخ ندهد، صورت‌حساب عامل برای آن پیام جداگانه صادر می‌شود، مشابه عامل غیرمکالمه‌ای. |
نمودار زیر نمونه‌ای از جلسه صورت‌حساب A2P برای عامل‌های مکالمه‌ای را نشان می‌دهد:
عامل‌های مکالمه‌ای دربرابر عامل‌های غیرمکالمه‌ای
دو دسته اصلی صورت‌حساب وجود دارد: مکالمه‌ای و غیرمکالمه‌ای.
تفاوت اصلی در دسته‌های صورت‌حساب بین عامل‌های مکالمه‌ای و غیرمکالمه‌ای است:
کارگزاران غیرمکالمه‌ای برای هر پیامی که به کاربر تحویل می‌دهند صورت‌حساب دریافت می‌کنند.
- این دسته برای نمایندگانی که انتظار پاسخ‌های مکرر ندارند بهترین است.
کارمزد نمایندگان مکالمه‌ای براساس نرخ ثابت برای مکالمه‌ها محاسبه می‌شود، که شامل همه پیام‌های مبادله‌شده در یک دوره ۲۴ ساعته است.
- این دسته برای نمایندگانی که با کاربران در مکالمه‌های چند نوبتی شرکت می‌کنند بهترین گزینه است.
رویدادهای صورتحسابپذیر
پنج نوع رویداد صورتحسابپذیر در گزارش‌های صورت‌حساب ضبط می‌شود. این رویدادها شامل رویدادهای MT و MO است که به‌عنوان رویدادهای A2P و P2A شناخته می‌شوند.
- A2P (برنامه به شخص) همان MT (پایانه تلفن همراه) است: پیامی که کسب‌وکار ارسال می‌کند.
- P2A (شخص به برنامه) همان MO (از تلفن همراه) است: پیام یا کنشی که کاربر آغاز می‌کند.
جدول زیر هر رویداد صورت‌حساب‌دار را دررابطه‌با عامل‌های غیرمکالمه‌ای و مکالمه‌ای شرح می‌دهد.
| رویداد | شرح | عامل‌های غیرمکالمه‌ای | عامل‌های مکالمه‌ای |
|---|---|---|---|
basic_message
|
پیام A2P که فقط شامل نوشتار با ۱۶۰ نویسه یا کمتر است. اگر نوشتار شامل نشانی وب برای وب‌سایتی با برچسب‌های openGraph باشد، ممکن است پیام پیش‌نمایش تصویری را بدون هزینه اضافی برای شریک نشان دهد. | همیشه به‌عنوان رویداد صورت‌حساب‌دار جداگانه درنظر گرفته می‌شود، صرف‌نظر از اینکه کاربر پاسخ دهد یا نه. | به‌عنوان رویداد قابل‌پرداخت فردی درنظر گرفته می‌شود، مگر اینکه کاربر ظرف ۲۴ ساعت پاسخ دهد. در این صورت، پیام بخشی از a2p_conversation می‌شود.
|
single_message
|
پیام برنامه به شخص که یا محتوای غنی دارد یا پیام فقط نوشتاری با بیش‌از ۱۶۰ نویسه است. | همیشه به‌عنوان رویداد صورت‌حساب‌دار جداگانه درنظر گرفته می‌شود، صرف‌نظر از اینکه کاربر پاسخ دهد یا نه. | به‌عنوان رویداد قابل‌پرداخت فردی درنظر گرفته می‌شود، مگر اینکه کاربر ظرف ۲۴ ساعت پاسخ دهد. در این صورت، پیام بخشی از a2p_conversation می‌شود.
|
a2p_conversation (آغازشده ازسوی کسب‌وکار)
|
وقتی کاربری ظرف ۲۴ ساعت پس‌از دریافت پیام A2P به آن پاسخ می‌دهد، خارج از مکالمه موجود شروع می‌شود. | موجود نیست. عامل‌های غیرمکالمه‌ای هرگز این نوع رویداد را تولید نمی‌کنند. | اگر پیام «شخص به برنامه» ظرف ۲۴ ساعت پس‌از چندین پیام «برنامه به شخص» تحویل داده شود، فقط از پیام «برنامه به شخص» که بلافاصله قبل‌از پیام «شخص به برنامه» ارسال شده است برای شروع مکالمه استفاده می‌شود. این پیام A2P و هر پیامی که ظرف ۲۴ ساعت آینده ارسال شود، بخشی از a2p_conversation است.
|
p2a_conversation (کاربر آغاز کرد)
|
وقتی نماینده‌ای ظرف ۲۴ ساعت پس‌از دریافت پیام P2A به آن پاسخ می‌دهد، خارج از مکالمه موجود شروع می‌شود. | موجود نیست. عامل‌های غیرمکالمه‌ای هرگز این نوع رویداد را تولید نمی‌کنند. | اگر پیام A2P ظرف ۲۴ ساعت پس‌از چندین پیام P2A تحویل داده شود، فقط از پیام P2A که بلافاصله قبل‌از پیام A2P ارسال شده است برای شروع مکالمه استفاده می‌شود. این پیام P2A و هر پیامی که در ۲۴ ساعت آینده ارسال شود بخشی از p2a_conversation است.
|
p2a_message
|
پیام شخص به برنامه از هر نوعی. | همیشه به‌عنوان رویداد قابل‌پرداخت جداگانه درنظر گرفته می‌شود، صرف‌نظر از اینکه نماینده پاسخ دهد یا نه. | به‌عنوان رویداد صورتحسابپذیر جداگانه درنظر گرفته می‌شود، مگر اینکه نماینده ظرف ۲۴ ساعت پاسخ دهد. |
دسته‌های صورت‌حساب دربرابر رویدادهای صورتحسابپذیر
تفاوت بین دسته‌های صورت‌حساب نماینده و رویدادهای صورتحسابپذیر برای درک نحوه صورت‌حساب نماینده شما بسیار مهم است.
- دسته صورت‌حساب یک طبقه‌بندی ثابت است که هنگام ایجاد عامل خود انتخاب می‌کنید. این تنظیم روش صورت‌حساب عاملتان را تعیین می‌کند: براساس پیام (عامل‌های غیرمکالمه‌ای) یا براساس مکالمه (عامل‌های مکالمه‌ای).
- رویدادهای صورتحسابپذیر تعاملات بین نماینده «سرویس‌های ارتباطی غنی ویژه کسب‌وکارها» و کاربر است که برای اهداف صورت‌حساب‌گیری پیگیری می‌شوند (برای مثال،
basic_message،single_message،a2p_conversation).
تولید گزارش صورت‌حساب
فقط کارگزارانی که ترافیک غیرآزمایشی دارند رویدادهای صورت‌حساب‌دار تولید می‌کنند. فعالیت شماره تلفن‌های آزمایشی در گزارش‌های صورت‌حساب نشان داده نمی‌شود.
این گزارش‌ها فرض می‌کنند که رویدادها زمانی صورت‌حساب می‌شوند که پیام‌ها تحویل داده می‌شوند، نه زمانی که پیام‌ها ارسال می‌شوند. پیام تحویل‌نشده یا پیامی که قبل‌از تحویل لغو شده است باعث ایجاد رویداد صورت‌حساب‌دار نمی‌شود.
قالب گزارش صورت‌حساب
گزارش‌های صورت‌حساب از قالب نام فایل rbm_billable_events_YYYY-MM-DD.csv استفاده می‌کنند.
تاریخ موجود در نام فایل، تاریخ تولید فایل است.
هر خط در گزارش یک سابقه است که نشان‌دهنده یک رویداد صورت‌حساب‌شدنی است. فیلدهای در یک گزارش با برگه از هم جدا می‌شوند. برای مثال، دو مکالمه A2P با یک نماینده یکسان دو رویداد صورت‌حساب جداگانه و دو سابقه در گزارش صورت‌حساب ایجاد می‌کند.
فایل‌ها بدون علامت ترتیب بایت در قالب UTF-8 کدبندی می‌شوند و از فیدهای خط برای پایان خط استفاده می‌کنند. خط اول هر فایل ردیف سرصفحه با نام‌های فیلد است.
هر رکورد در گزارش حاوی اطلاعات زیر برای هر رویداد صورت‌حساب‌شدنی است.
| فیلد | قالب | شرح | مثال |
|---|---|---|---|
billing_event_id
|
رشته | شناسه تولیدشده‌ای که رویداد صورتحسابپذیر را متمایز می‌کند. | 242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff
|
type
|
رشته | نوع رویداد:
|
single_message
|
agent_id
|
رشته | شناسه یکتای کارگزاری که در رویداد شرکت کرده است. | rbm-welcome-bot@rbm.goog
|
agent_owner
|
رشته | نشانی ایمیل مالک فعلی حساب شریک که نماینده در آن ایجاد شده است. | name@aggregator.com
|
billing_party
|
رشته | طرفی که صورت‌حساب رویدادها را صادر می‌کند.
|
carrier
|
max_duration_single_message
|
شماره | حداکثر زمان (به ساعت) مجاز برای کاربر جهت پاسخ دادن به پیام کارگزار قبل‌از اینکه پنجره شروع مکالمه بسته شود و پیام به‌عنوان رویداد single_message طبقه‌بندی شود.
|
24
|
max_duration_a2p_conversation
|
شماره | حداکثر مدت مکالمه A2P، برحسب ساعت. از اولین پاسخ کاربر به پیام اولیه عامل اندازه‌گیری می‌شود. | 24
|
max_duration_p2a_conversation
|
شماره | حداکثر مدت مکالمه P2A، برحسب ساعت. از اولین پیام کاربر در مکالمه اندازه‌گیری می‌شود. | 24
|
start_time
|
YYYY-mm-ddTHH:00:00Z | تاریخ/زمان شروع رویداد به زمان UTC در قالب ISO 8601 که به نزدیک‌ترین ساعت گرد شده است.
پیام‌های A2P
پیام‌های شخص به برنامه
|
2019-07-25T08:00:00Z
|
duration
|
شماره | مدت رویداد، گردشده به نزدیک‌ترین دقیقه.
مقدار برای هر رویداد غیرمکالمه‌ای ۰ است. |
45
|
mt_messages
|
شماره | تعداد پیام‌های خاتمه‌یافته تلفن همراه (A2P) در رویداد. | 11
|
mo_messages
|
شماره | تعداد پیام‌های آغازشده از تلفن همراه (P2A) در رویداد. | 9
|
size_kilobytes
|
شماره | اندازه همه فایل‌های پیوست‌شده به پیام‌های رویداد، گردشده به نزدیک‌ترین کیلوبایت (۱ کیلوبایت برابر با ۱۰۲۴ بایت است). | 912
|
agent_name
|
رشته |
نام کارگزاری که در رویداد شرکت کرده است. |
XYZ Mobile USA
|
owner_name
|
رشته | نام مالک فعلی حساب شریک که نماینده در آن ایجاد شده است. | XYZ Mobile
|
گزارش صورت‌حساب نمونه
گزارش‌های نمونه برای بارگیری دردسترس است:
اندازه معمول فایل
اندازه گزارش روزانه از شریک فعال «سرویس‌های ارتباطی غنی برای کسب‌وکار» به میزان فعالیت او در شبکه شرکت مخابراتی بستگی دارد. برای مثال، اگر ۵۳٬۰۰۰ گزارش در گزارش وجود داشته باشد، اندازه فایل تقریباً ۸ مگابایت خواهد بود.
گزارش‌های فعالیت
گزارش‌های فعالیت داده‌های خام درباره فعالیت در پلاتفرم «RCS ویژه کسب‌وکارها» ارائه می‌دهد. می‌توانید از این گزارش‌ها برای ممیزی رویدادهای صورت‌حساب‌دار و ایجاد رویدادهای سفارشی استفاده کنید.
ازآنجایی‌که گزارش‌های فعالیت حاوی «اطلاعات شناسایی شخصی» (PII) است، مثل اطلاعات دقیق تراکنش و MSISDN مشترکان، این گزارش‌ها فقط زمانی دردسترس قرار می‌گیرند که شرکت مخابراتی تحت «شرایط خدمات» خودش از «سرویس‌های ارتباطی غنی» استفاده کند. اگر در شبکه‌هایتان ترافیک «سرویس‌های ارتباطی غنی ویژه کسب‌وکارها» دارید و فعالیت «سرویس‌های ارتباطی غنی» را با «سرویس‌های ارتباطی غنی Google» تحت «شرایط خدمات Google» فعال کنید، به گزارش‌های فعالیت دسترسی نخواهید داشت.
قالب گزارش فعالیت
گزارش‌های فعالیت از قالب نام فایل rbm_activity_YYYY-MM-DD.csv استفاده می‌کنند. تاریخ موجود در
نام فایل، تاریخ تولید فایل است.
فیلدهای موجود در یک گزارش با کلید جهش جدا می‌شوند و در هر خط یک گزارش وجود دارد.
فایل‌ها بدون علامت ترتیب بایت در قالب UTF-8 کدبندی می‌شوند و از فیدهای خط برای پایان خط استفاده می‌کنند. خط اول هر فایل ردیف سرصفحه با نام‌های فیلد است.
هر سابقه در گزارش فعالیت شامل فیلدهای زیر برای هر فعالیت است:
| فیلد | قالب | شرح | مثال |
|---|---|---|---|
activity_id
|
رشته | شناسه یکتای فعالیت. | b422e1d3-ac99-442a-853d-a875d5e61762
|
billing_event_id
|
رشته | شناسه یکتای رویداد قابل‌پرداخت منسوب. اگر فعالیت با رویداد صورت‌حساب‌دار مرتبط نباشد، مثلاً text_message بدون delivery_receipt_event مربوطه، می‌تواند خالی باشد.
|
91yeb201-7c3b-412b-98d2-b0a0f7abe536
|
agent_id
|
رشته | شناسه یکتای کارگزار. | welcome-bot@rbm.goog
|
user_id
|
رشته | شماره دیجیتال خدمات یکپارچه مشترکین تلفن همراه کاربر. | 918369110173
|
direction
|
رشته | جهت ارسال پیام:
|
MT
|
time
|
YYYY-mm-ddTHH:MM:SS.SSSZ | تاریخ و زمان ارسال رویداد به پلاتفرم «RCS ویژه کسب‌وکارها» در قالب «ساعت هماهنگ جهانی». مُهرهای زمان را ببینید. | 2019-07-25T00:29:07.033Z
|
type
|
رشته | نوع فعالیت:
|
text_message
|
size_bytes
|
رشته | اندازه فایل‌های پیوست‌شده به فعالیت، برحسب بایت. | 912
|
مهرهای زمان
مهر زمان در گزارش‌های فعالیت زمان ارسال رویداد به پلاتفرم «RCS ویژه کسب‌وکارها» را ثبت می‌کند. برای رویدادهایی که محتوا را به کاربر ارائه می‌دهند، رویداد تا زمانی که پیام تحویل داده نشود در گزارش فعالیت ثبت نخواهد شد.
برای مثال، اگر پیام «آرسی‌اس برای کسب‌وکار» در ساعت ۱۳:۰۰ چهارشنبه به کاربری ارسال شود و گیرنده تا ساعت ۹:۰۰ یکشنبه آفلاین باشد، رویداد در گزارش فعالیت تولیدشده برای یکشنبه نشان داده خواهد شد، اما مُهر زمان آن چهارشنبه ساعت ۱۳:۰۰ خواهد بود.