این صفحه فایلهای دادهای را که RCS for Business برای کمک به اپراتورهای آمریکایی در صدور صورتحساب و حسابرسی تحت چارچوب RBM ایالات متحده ایجاد میکند، شرح میدهد. برای کسب اطلاعات بیشتر در مورد چارچوب RBM ایالات متحده، میتوانید به usrbm.org نیز مراجعه کنید.
گزارش صورتحساب، گزارشی تجمیعی از رویدادهای قابل پرداخت بین نمایندگان راهاندازی شده و کاربران است. قابل پرداخت به سادگی به این معنی است که یک رویداد واجد شرایط دریافت هزینه است. اپراتورها تعیین میکنند که آیا و چگونه رویدادهای قابل پرداخت هزینه دریافت کنند. همه اپراتورهای آمریکایی که به طور فعال RCS for Business را اجرا میکنند، به گزارشهای صورتحساب دسترسی دارند.
برای جزئیات بیشتر در مورد مدل طبقهبندی صورتحساب ایالات متحده، به سوالات متداول صورتحساب ایالات متحده مراجعه کنید.
تولید فایل
برای اطلاعات بیشتر، به تولید فایل مراجعه کنید.
ذخیرهسازی و دسترسی به فایلها
برای اطلاعات بیشتر، به ذخیرهسازی و دسترسی به فایل مراجعه کنید.
در دسترس بودن فایل
برای اطلاعات بیشتر، به «دسترسی به فایل» مراجعه کنید.
گزارشهای صورتحساب
گزارشهای صورتحساب، سوابق رویدادهای قابل پرداخت هستند که بر اساس دسته صورتحساب اپراتور و نوع پیامهای ارسالی او محاسبه میشوند. گزارشهای صورتحساب برای همه اپراتورهایی که به طور فعال از RCS برای کسبوکارها استفاده میکنند، در دسترس است.
گزارشهای صورتحساب حاوی اطلاعات محرمانه هستند، اما هیچ اطلاعات شخصی قابل شناسایی کاربر (PII) مانند MSISDN، MSISDN هش شده یا هیچ شناسه منحصر به فرد کاربر در آنها وجود ندارد.
دسته بندی های صورتحساب در مقابل رویدادهای قابل پرداخت
تمایز بین دستههای صورتحساب نماینده و رویدادهای قابل پرداخت، کلید درک چگونگی قابل پرداخت بودن نماینده شما است.
- دستهبندی صورتحساب، یک طبقهبندی ثابت است که هنگام ایجاد نماینده خود انتخاب میکنید. این دستهبندی روشی را تعیین میکند که نماینده شما بر اساس آن قابل پرداخت است: به ازای هر پیام (نمایندگان غیر مکالمهای) یا به ازای هر جلسه (نمایندگان مکالمهای).
- رویدادهای قابل پرداخت، تعاملاتی بین یک نماینده RCS برای کسب و کار و یک کاربر هستند که برای اهداف پرداخت ردیابی میشوند (برای مثال،
rich_message).
دسته بندی های صورتحساب نمایندگان ایالات متحده
هنگام ایجاد یک نماینده، مالک دسته بندی صورتحساب خود را بر اساس نحوه تعامل نماینده با کاربران تنظیم میکند. دسته بندی صورتحساب تعداد یا نوع پیامهایی را که یک نماینده میتواند ارسال کند محدود نمیکند. اما نحوه محاسبه صورتحساب برای پیامها را تعیین میکند. دو دسته بندی اصلی صورتحساب در جدول زیر شرح داده شده است.
| دسته بندی صورتحساب | نوع عامل | موارد استفاده مثال | روش پرداخت |
|---|---|---|---|
| غیر محاورهای | عاملهایی که عمدتاً پیامهای یکطرفه ارسال میکنند. |
| برای هر پیام ارسالی به کاربر، هزینه دریافت میشود. |
| محاورهای | عاملهایی که برای تبادل نظر و گفتگو با کاربران، صرف نظر از اینکه چه کسی مکالمه را شروع میکند، طراحی شدهاند. |
| قابل پرداخت به ازای هر جلسه : در صورت برآورده شدن معیارهای جلسه، تمام پیامهای رسانهای غنی و غنی در بازه زمانی ۲۴ ساعته، صرف نظر از طول یا بخشها، با نرخ ثابتی قابل پرداخت هستند. هزینه به ازای هر پیام : اگر معیارهای جلسه برآورده نشود یا پیامی خارج از بازه زمانی ۲۴ ساعته جلسه قرار گیرد، هزینه پیام به صورت جداگانه و با نرخ هر پیام برای رسانههای غنی یا غنی، مطابق با کارت تعرفه اپراتور مربوطه، قابل پرداخت است. |
عوامل محاورهای در مقابل عوامل غیر محاورهای
دو دسته صورتحساب برای نمایندگان وجود دارد: مکالمهای و غیرمکالمهای.
برای نمایندگان غیر محاورهای، بابت هر پیامی که به کاربر تحویل میدهند، هزینه دریافت میشود.
- این دسته برای کارشناسانی که انتظار پاسخهای مکرر ندارند، بهترین گزینه است.
نمایندگان مکالمه برای هر جلسه (جلسات) نرخ ثابتی دریافت میکنند، مشروط بر اینکه جلسهای آغاز شود و سپس این نرخ شامل تمام پیامهای رد و بدل شده در یک دوره ۲۴ ساعته، از جمله پیامهایی که جلسه را آغاز کردهاند، میشود. نمایندگان مکالمه همچنان میتوانند برای پیامهایی که بخشی از یک جلسه ۲۴ ساعته نیستند، هزینه دریافت کنند.
- این دسته برای نمایندگانی که در مکالمات چند نوبتی با کاربران شرکت میکنند، بهترین گزینه است.
منطق پرداخت هزینه جلسه
طبق مدل صورتحساب ایالات متحده، یک جلسه با دنبالهای از ۴ پیام رسانهای غنی یا غنی (شامل حداقل ۲ پیام MO و حداقل ۱ پیام MT) که در یک بازه ۲۴ ساعته از اولین پیام در دنباله راهاندازی رد و بدل میشوند، آغاز میشود. پس از برآورده شدن این آستانه، تمام پیامهای درون آن بازه ۲۴ ساعته به عنوان یک جلسه واحد قابل محاسبه هستند. هر پیامی که خارج از این بازه قرار گیرد یا نتواند یک جلسه را آغاز کند، با نرخ استاندارد هر پیام برای رسانههای غنی یا غنی مطابق با کارت نرخ اپراتور مربوطه قابل محاسبه است.
نمودار زیر نمونهای از جلسه صورتحساب A2P برای نمایندگان مکالمهای را نشان میدهد.
- MT (موبایل قطع شده) پیامی است که توسط کسب و کار ارسال میشود.
- MO (Mobile Originated) پیام یا عملی است که توسط کاربر آغاز میشود.
رویدادهای قابل پرداخت
جریانهای پیامرسانی بر اساس مبدا و جهت آنها طبقهبندی میشوند. برای توصیف جهت ترافیک پیامرسانی، اپراتورهای آمریکایی معمولاً از اصطلاحات MT/MO استفاده میکنند. این اصطلاحات با اصطلاحات A2P/P2A که در سراسر مستندات RCS for Business استفاده میشود، مطابقت دارند. در اینجا خلاصهای از نحوه همترازی این اصطلاحات آورده شده است:
- A2P (درخواست به شخص) همان MT (موبایل خاتمه یافته) است : پیامی که توسط کسب و کار ارسال میشود.
- P2A (شخص به برنامه) در مقابل MO (موبایل منشا) قرار میگیرد : پیام یا عملی که توسط کاربر آغاز میشود.
| رویداد | توضیحات | عوامل غیر محاورهای | عوامل مکالمهای |
|---|---|---|---|
a2p_rich_message | پیامی ارسالشده توسط اپراتور که فقط شامل متن، پاسخهای پیشنهادی یا اقدامات پیشنهادی خاص (شمارهگیری، باز کردن URL در مرورگر) است. | همیشه به عنوان یک رویداد قابل پرداخت جداگانه در نظر گرفته میشود. هزینه به ازای هر پیام بر اساس بخشها قابل پرداخت است (هر بخش برابر با ۱۶۰ بایت UTF-8 است). | به عنوان یک رویداد جداگانه و قابل پرداخت در نظر گرفته میشود، مگر اینکه بخشی از یک جلسه شود. |
p2a_rich_message | پیامی که توسط کاربر ارسال شده و فقط حاوی متن آزاد یا متن حاصل از لمس یک پاسخ پیشنهادی است. | همیشه به عنوان یک رویداد قابل پرداخت جداگانه در نظر گرفته میشود. قابل پرداخت به ازای هر پیام بر اساس بخشها. | به عنوان یک رویداد جداگانه و قابل پرداخت در نظر گرفته میشود، مگر اینکه بخشی از یک جلسه شود. |
a2p_rich_media_message | پیامی که توسط عامل ارسال شده و حاوی رسانه (تصویر، ویدئو، صدا)، کارتهای غنی، چرخ فلک یا اقدامات پیچیدهای مانند «مشاهده موقعیت مکانی» است. | همیشه به عنوان یک رویداد قابل پرداخت جداگانه در نظر گرفته میشود. صرف نظر از اندازه یا محتوا، به عنوان یک رویداد واحد و با نرخ ثابت قابل پرداخت است. | به عنوان یک رویداد جداگانه و قابل پرداخت در نظر گرفته میشود، مگر اینکه بخشی از یک جلسه شود. |
p2a_rich_media_message | پیامی که توسط کاربر ارسال شده و حاوی یک فایل رسانهای آپلود شده (تصویر، ویدئو، صدا) است. | همیشه به عنوان یک رویداد قابل پرداخت جداگانه در نظر گرفته میشود. به عنوان یک رویداد واحد و با نرخ ثابت قابل پرداخت است. | به عنوان یک رویداد جداگانه و قابل پرداخت در نظر گرفته میشود، مگر اینکه بخشی از یک جلسه شود. |
p2a_suggested_action | کاربر روی هر اقدام پیشنهادی (مثلاً «مشاهده موقعیت مکانی») که پاسخ پیشنهادی نیست، ضربه میزند. | همیشه به عنوان یک رویداد قابل پرداخت جداگانه در نظر گرفته میشود. به ازای هر کلیک، یک رویداد قابل پرداخت ایجاد میکند. | به عنوان یک رویداد قابل پرداخت جداگانه در نظر گرفته میشود و به ازای هر کلیک، یک رویداد قابل پرداخت ایجاد میکند، مگر اینکه بخشی از یک جلسه (session) شود. |
a2p_session | یک پنجره تعامل ۲۴ ساعته که با شروع یک جلسه آغاز میشود و اولین پیام MT است. برای اطلاعات بیشتر، به جلسه چیست و چگونه کار میکند مراجعه کنید. | ناموجود. جلسات برای عوامل غیر مکالمهای اعمال نمیشود. | پس از فعال شدن، تمام پیامهای موجود در بازه زمانی ۲۴ ساعته مشمول هزینه یک جلسه میشوند. هر رویداد قابل پرداخت در جلسه ۲۴ ساعته به شناسه رویداد قابل پرداخت آن جلسه اختصاص داده میشود. |
p2a_session | یک پنجره تعامل ۲۴ ساعته که با شروع یک جلسه آغاز میشود و اولین پیام MO است. برای اطلاعات بیشتر، به جلسه چیست و چگونه کار میکند مراجعه کنید. | ناموجود. جلسات برای عوامل غیر مکالمهای اعمال نمیشود. | پس از فعال شدن، تمام پیامهای موجود در بازه زمانی ۲۴ ساعته مشمول هزینه یک جلسه میشوند. هر رویداد قابل پرداخت در جلسه ۲۴ ساعته به شناسه رویداد قابل پرداخت آن جلسه اختصاص داده میشود. |
تولید گزارش صورتحساب
فقط اپراتورهایی که ترافیک غیر آزمایشی دارند، رویدادهای قابل پرداخت ایجاد میکنند. فعالیت از شماره تلفنهای آزمایشی در گزارشهای صورتحساب نمایش داده نمیشود.
این گزارشها فرض میکنند که رویدادها زمانی قابل پرداخت هستند که پیامهای A2P تحویل داده شوند، نه زمانی که پیامها ارسال میشوند. پیامی که تحویل داده نشده یا پیامی که قبل از تحویل لغو شده است، رویدادی قابل پرداخت ایجاد نمیکند.
قالب گزارش صورتحساب
گزارشهای صورتحساب از قالب نام فایل rbm_billable_events_YYYY-MM-DD.csv استفاده میکنند. تاریخ موجود در نام فایل، تاریخ تولید فایل است.
هر خط در گزارش، رکوردی است که نشاندهنده یک رویداد قابل پرداخت است. جلسات A2P/P2A توسط چندین ردیف نمایش داده میشوند - هر ردیف برای هر پیام مبادله شده. هر ردیف مرتبط با یک جلسه (با اشتراکگذاری billing_event_id یکسان) تعداد کل پیامهای MT و MO را برای کل پنجره جلسه 24 ساعته در ستونهای mt_messages و mo_messages گزارش میدهد.
هر رکورد در گزارش شامل اطلاعات زیر برای هر رویداد قابل پرداخت است.
| میدان | قالب | توضیحات | مثال |
|---|---|---|---|
billing_event_id | رشته | شناسه تولید شده که رویداد قابل پرداخت را متمایز میکند. تمام پیامهایی که بخشی از یک جلسه هستند | 63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e |
type | رشته | نوع رویداد:a2p_rich_messagea2p_rich_media_messagep2a_rich_messagep2a_rich_media_messagep2a_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 . برای مدل ایالات متحده برای پیامهای غنی فردی قابل اجرا نیست. | ۲۴ |
max_duration_a2p_conversation | شماره | برای نسخه آزمایشی جلسات، این نشان دهنده بازه زمانی ۲۴ ساعته جلسه است که از اولین پیام در توالی فعالسازی اندازهگیری میشود. مدت زمان بر حسب ساعت اندازهگیری میشود. | ۲۴ |
max_duration_p2a_conversation | شماره | برای نسخه آزمایشی جلسات، این نشان دهنده بازه زمانی ۲۴ ساعته جلسه است که از اولین پیام در توالی فعالسازی اندازهگیری میشود. | ۲۴ |
start_time | YYYY-میلیمتر-روز-THH:00:00Z | تاریخ/زمان UTC که رویداد شروع شده است (ISO 8601). برای جلسات، این مهر زمانی اولین پیام در دنباله تریگر است. A2P a2p_rich_message و a2p_rich_media_message ، این زمانی است که پیام به کاربر تحویل داده میشود.a2p_session ، این زمانی است که اولین پیام در مکالمه به کاربر تحویل داده میشود.P2A p2a_rich_message و p2a_rich_media_message ، این زمانی است که پیام توسط کاربر ارسال میشود.p2a_session ، این زمانی است که اولین پیام در مکالمه توسط کاربر ارسال میشود. | ۲۰۲۵-۰۵-۲۰T۰۸:۰۰:۰۰Z |
duration | شماره | مدت زمان فقط مربوط به جلسات است و بر حسب دقیقه اندازهگیری میشود. وقتی رویداد یک رویداد غیر جلسهای باشد، مقدار آن ۰ است. | ۴۵ |
mt_messages | شماره | تعداد پیامهای خاتمهیافته توسط موبایل (A2P) در رویداد. برای جلسات، هر ردیف که billing_event_id یکسانی دارد، تعداد کل پیامهای MT در کل جلسه را نشان میدهد. | ۵ |
mo_messages | شماره | تعداد پیامهای ارسالی از طریق موبایل (P2A) در رویداد. برای جلسات، هر ردیف که billing_event_id یکسانی دارد، تعداد کل پیامهای MO در کل جلسه را نشان میدهد. | ۳ |
size_kilobytes | شماره | اندازه تمام فایلهای پیوستشده به پیامها در رویداد، گرد شده به نزدیکترین کیلوبایت (۱ کیلوبایت برابر با ۱۰۲۴ بایت است). | ۹۱۲ |
agent_name | رشته | نام نمایندهای که در این رویداد شرکت کرده است. | ACME Brand |
owner_name | رشته | نام مالک فعلی حساب شریک که نماینده در آن ایجاد شده است. | XYZ Aggregator |
segment_count | شماره | تعداد سگمنت محاسبهشده برای a2p_rich_message events و p2a_rich_message (هر سگمنت برابر با ۱۶۰ بایت UTF-8 است). وقتی رویداد یکی از موارد ذکر شده نباشد، مقدار ۰ است. | ۵ |
session_type | رشته | نوع جلسه:a2p_sessionp2a_session | a2p_session |
نمونه گزارش صورتحساب
نمونه گزارش برای دانلود موجود است:
اندازه فایل معمولی
اندازه گزارش روزانه از یک شریک فعال RCS برای کسبوکار، به میزان فعالیتی که آنها در شبکه اپراتور ایجاد کردهاند بستگی دارد.