گزارش‌های صورت‌حساب و گزارش‌های فعالیت

این صفحه فایل‌های داده‌ای را که RCS for Business برای کمک به اپراتورهای تلفن همراه در صدور صورتحساب و حسابرسی ایجاد می‌کند، شرح می‌دهد.

فایل	توضیحات	چه کسی دسترسی دارد؟
گزارش صورتحساب	گزارش تجمیعی از رویدادهای قابل پرداخت بین نمایندگان راه‌اندازی شده و کاربران.	تمام اپراتورهایی که به طور فعال از RCS برای کسب‌وکارها استفاده می‌کنند.
گزارش فعالیت	گزارش داده‌های خام فعالیت‌های RCS برای کسب‌وکار، شامل رویدادهای قابل پرداخت.	شرکت‌های مخابراتی که به‌طور فعال از RCS برای کسب‌وکارها استفاده می‌کنند و سرویس RCS گوگل را تحت شرایط خدمات (ToS) خود اداره می‌کنند.

RCS برای کسب و کار از دو مدل صورتحساب استفاده می‌کند: مدل صورتحساب استاندارد برای ترافیک غیر آمریکایی و مدل صورتحساب آمریکایی برای ترافیک آمریکایی. اطلاعات منحصر به فرد برای مدل استاندارد یا مدل آمریکایی (به عنوان مثال، طبقه‌بندی‌های مختلف رویدادهای قابل پرداخت یا فیلدهای گزارش) به صراحت ذکر شده است.

• برای جزئیات بیشتر در مورد مدل استاندارد صورتحساب و خلاصه‌ای از تفاوت‌های مدل‌های صورتحساب، به سوالات متداول صورتحساب مراجعه کنید.
• برای جزئیات بیشتر در مورد طبقه‌بندی‌های صورتحساب ایالات متحده، به راهنمای مدل صورتحساب ایالات متحده مراجعه کنید.

تولید فایل

هر فایل داده، نشان‌دهنده یک روز استفاده از RCS برای کسب و کار بر اساس زمان هماهنگ جهانی (UTC) است. فایل‌ها روزانه تولید می‌شوند. فرآیند تولید می‌تواند چندین ساعت طول بکشد و زمان تکمیل آن ممکن است متفاوت باشد.

• برای کارگزاران غیر محاوره‌ای ، فایل‌ها حاوی داده‌هایی از دوره ۲۴ ساعته هستند که بلافاصله قبل از زمان تولید فایل قرار دارند. برای مثال، اگر یک گزارش صورتحساب در ساعت ۱۱:۰۰ UTC در تاریخ ۵ می تولید شود، شامل داده‌هایی از ساعت ۱۱:۰۰ UTC در تاریخ ۴ می تا ۱۱:۰۰ UTC در تاریخ ۵ می خواهد بود.

• برای اپراتورهای مکالمه ، فایل‌ها حاوی داده‌هایی از دوره ۲۴ ساعته ۱-۲ روز قبل از زمان تولید فایل هستند. برای مثال، اگر یک گزارش صورتحساب در ساعت ۱۱:۰۰ UTC در تاریخ ۵ می تولید شود، ممکن است حاوی داده‌هایی از ساعت ۱۱:۰۰ UTC در تاریخ ۳ می تا ۱۱:۰۰ UTC در تاریخ ۴ می باشد.

  دلیل این تأخیر این است که فعالیت RCS برای اپراتورهای مکالمه‌ای به مکالماتی مرتبط است که تکمیل آنها می‌تواند تا ۴۸ ساعت طول بکشد. این تأخیر به RCS برای کسب‌وکارها اجازه می‌دهد تا قبل از محاسبه رویداد قابل پرداخت، تمام پیام‌های درون یک مکالمه را ضبط کند. برای اطلاعات بیشتر در مورد اپراتورهای مکالمه‌ای، به دسته‌بندی‌های صورتحساب اپراتور مراجعه کنید.

نکات کلیدی:

• بدون فعالیت : اگر در یک روز مشخص هیچ فعالیتی در پلتفرم وجود نداشته باشد، هیچ فایلی ایجاد نمی‌شود.

• نامگذاری : تاریخ موجود در نام فایل، تاریخ ایجاد فایل است، نه تاریخ داده‌های درون آن.

• نگهداری : فایل‌ها حداکثر ۶۳ روز قبل از حذف ذخیره می‌شوند.

شما می‌توانید از این فایل‌ها برای به‌روزرسانی انبار داده خود با جدیدترین معیارهای استفاده از پلتفرم استفاده کنید.

ذخیره‌سازی و دسترسی به فایل‌ها

فایل‌های داده در حالت استراحت و در حین انتقال رمزگذاری می‌شوند.

برای بازیابی فایل‌های داده از طریق پروتکل انتقال امن فایل (SFTP)، کلید عمومی SFTP خود را ارائه دهید. برای تولید کلیدها، به بخش «ایجاد یک جفت کلید Secure Shell (SSH) برای یک دراپ باکس SFTP» مراجعه کنید.

سرور SFTP، partnerupload.google.com است و اتصال برای امنیت بیشتر روی شماره پورت بالایی (۱۹۳۲۱) است.

برای دسترسی به فایل‌های داده خود می‌توانید از دستور زیر استفاده کنید:

sftp -i <path_to_private_key> -P 19321 <username>@partnerupload.google.com

گوگل نام‌های کاربری حساب‌های کاربری را در قالب‌های زیر ارائه می‌دهد:

• rbmreports-billableevents-<carrier name>
• rbmreports-activity-<carrier name>

گوگل <carrier name> را مشخص می‌کند و برای هر نوع گزارش، حساب جداگانه‌ای ارائه می‌دهد.

حساب‌های جداگانه‌ای برای دسترسی به انواع گزارش‌های مختلف ارائه شده است.

در دسترس بودن فایل

اگر هنوز هیچ فایل داده‌ای ایجاد نشده باشد، خطای SFTP مشابه remote readdir("/"): No such file or directory مشاهده خواهید کرد، که مورد انتظار است.

اگر RCS برای ترافیک تجاری برای گزارش وجود نداشته باشد، فایلی ایجاد نمی‌شود. این بدان معناست که ممکن است برخی روزها هیچ فایلی ایجاد نشود. اگر برای ساده‌سازی فرآیند خود به فایل‌های خالی نیاز دارید، با [e-mail] تماس بگیرید.

گزارش‌های صورتحساب

گزارش‌های صورتحساب، سوابق رویدادهای قابل پرداخت هستند که بر اساس دسته صورتحساب اپراتور و نوع پیام‌های ارسالی او محاسبه می‌شوند. گزارش‌های صورتحساب برای همه اپراتورهایی که به طور فعال از RCS برای کسب‌وکارها استفاده می‌کنند، در دسترس است.

گزارش‌های صورتحساب حاوی اطلاعات محرمانه هستند، اما هیچ اطلاعات شخصی قابل شناسایی کاربر (PII) مانند MSISDN، MSISDN هش شده یا هیچ شناسه منحصر به فرد کاربر در آنها وجود ندارد.

دسته بندی های صورتحساب نماینده

هنگام ایجاد یک نماینده، مالک دسته بندی صورتحساب خود را بر اساس نحوه تعامل نماینده با کاربران تنظیم می‌کند. دسته بندی صورتحساب تعداد یا نوع پیام‌هایی را که یک نماینده می‌تواند ارسال کند محدود نمی‌کند. اما نحوه محاسبه صورتحساب برای پیام‌ها را تعیین می‌کند. دو دسته بندی اصلی صورتحساب در جدول زیر شرح داده شده است.

دسته بندی صورتحساب	نوع عامل	موارد استفاده مثال	روش پرداخت
غیر محاوره‌ای	عامل‌هایی که عمدتاً پیام‌های یک‌طرفه ارسال می‌کنند.	رمزهای یکبار مصرف (OTP) هشدارها پیشنهادات تبلیغاتی	به ازای هر پیامی که به کاربر ارسال می‌شود، هزینه دریافت می‌شود.
محاوره‌ای	عامل‌هایی که برای تبادلات رو در رو با کاربران طراحی شده‌اند.	پیدا کردن محصول مناسب رزرو بلیط عیب‌یابی یک مشکل	هزینه به ازای هر مکالمه : اگر یکی از طرفین (کاربر یا نماینده) ظرف ۲۴ ساعت به پیامی از طرف دیگر پاسخ دهد، مکالمه شروع می‌شود. در طول مدت مکالمه (۲۴ ساعت پس از اولین پاسخ)، نماینده و کاربر می‌توانند هر تعداد پیام رد و بدل کنند و برای نماینده هزینه ثابتی برای مکالمه محاسبه خواهد شد. هزینه به ازای هر پیام : اگر اپراتور پیامی ارسال کند که کاربر ظرف ۲۴ ساعت به آن پاسخ ندهد، مانند یک اپراتور غیر مکالمه‌ای، هزینه هر پیام به صورت جداگانه از اپراتور دریافت می‌شود.

نمودار زیر نمونه‌ای از جلسه صورتحساب A2P برای نمایندگان مکالمه را نشان می‌دهد:

عوامل محاوره‌ای در مقابل عوامل غیر محاوره‌ای

دو دسته اصلی برای صورتحساب وجود دارد: مکالمه‌ای و غیرمکالمه‌ای.

تفاوت کلیدی در دسته بندی های صورتحساب، بین نمایندگان مکالمه محور و غیر مکالمه محور است:

• نمایندگان غیر مکالمه‌ای برای هر پیامی که به کاربر تحویل می‌دهند، هزینه دریافت می‌کنند.

  • این دسته برای کارشناسانی که انتظار پاسخ‌های مکرر ندارند، بهترین گزینه است.

• برای مکالمات، نمایندگان مکالمه نرخ ثابتی دریافت می‌کنند که شامل تمام پیام‌های رد و بدل شده در یک دوره ۲۴ ساعته می‌شود.

  • این دسته برای نمایندگانی که در مکالمات چند نوبتی با کاربران شرکت می‌کنند، بهترین گزینه است.

رویدادهای قابل پرداخت

توجه: رویدادهای این بخش فقط برای مدل صورتحساب استاندارد (ترافیک غیر آمریکایی) اعمال می‌شوند. برای کسب اطلاعات در مورد رویدادهای قابل پرداخت برای ترافیک ایالات متحده، به راهنمای مدل صورتحساب ایالات متحده مراجعه کنید.

پنج نوع رویداد قابل پرداخت در گزارش‌های صورتحساب ثبت می‌شوند. این رویدادها شامل رویدادهای MT و MO هستند که به آنها رویدادهای A2P و P2A گفته می‌شود.

• A2P (درخواست به شخص) همان MT (موبایل خاتمه یافته) است : پیامی که توسط کسب و کار ارسال می‌شود.
• P2A (شخص به برنامه) در مقابل MO (موبایل منشا) قرار می‌گیرد : پیام یا عملی که توسط کاربر آغاز می‌شود.

جدول زیر هر رویداد قابل پرداخت را در مورد نمایندگان غیر مکالمه‌ای و مکالمه‌ای شرح می‌دهد.

رویداد	توضیحات	عوامل غیر محاوره‌ای	عوامل مکالمه‌ای
basic_message	پیام A2P که فقط شامل متنی با ۱۶۰ کاراکتر یا کمتر است. اگر متن شامل URL یک وب‌سایت با برچسب‌های openGraph باشد، پیام ممکن است پیش‌نمایشی از تصویر را نشان دهد، بدون هیچ هزینه اضافی برای شریک.	صرف نظر از اینکه کاربر پاسخ دهد یا خیر، همیشه به عنوان یک رویداد قابل پرداخت جداگانه در نظر گرفته می‌شود.	به عنوان یک رویداد جداگانه و قابل پرداخت در نظر گرفته می‌شود، مگر اینکه کاربر ظرف ۲۴ ساعت پاسخ دهد. در این صورت، پیام بخشی از یک a2p_conversation می‌شود.
single_message	پیام A2P که یا محتوای غنی دارد یا فقط یک پیام متنی با بیش از ۱۶۰ کاراکتر است.	صرف نظر از اینکه کاربر پاسخ دهد یا خیر، همیشه به عنوان یک رویداد قابل پرداخت جداگانه در نظر گرفته می‌شود.	به عنوان یک رویداد جداگانه و قابل پرداخت در نظر گرفته می‌شود، مگر اینکه کاربر ظرف ۲۴ ساعت پاسخ دهد. در این صورت، پیام بخشی از یک a2p_conversation می‌شود.
a2p_conversation (آغاز شده توسط کسب و کار)	زمانی آغاز می‌شود که کاربر ظرف ۲۴ ساعت پس از دریافت یک پیام A2P، خارج از یک مکالمه موجود، به آن پاسخ می‌دهد.	ناموجود. عامل‌های غیر محاوره‌ای هرگز این نوع رویداد را ایجاد نمی‌کنند.	اگر یک پیام P2A ظرف ۲۴ ساعت پس از چندین پیام A2P تحویل داده شود، فقط پیام A2P که بلافاصله قبل از پیام P2A آمده است برای شروع مکالمه استفاده می‌شود. این پیام A2P و هر پیامی که ظرف ۲۴ ساعت آینده تحویل داده شود، بخشی از a2p_conversation هستند.
p2a_conversation (آغاز شده توسط کاربر)	زمانی آغاز می‌شود که یک اپراتور به یک پیام P2A ظرف ۲۴ ساعت پس از دریافت آن، خارج از مکالمه موجود، پاسخ می‌دهد.	ناموجود. عامل‌های غیر محاوره‌ای هرگز این نوع رویداد را ایجاد نمی‌کنند.	اگر یک پیام A2P ظرف ۲۴ ساعت پس از چندین پیام P2A تحویل داده شود، فقط پیام P2A که بلافاصله قبل از پیام A2P آمده است برای شروع مکالمه استفاده می‌شود. این پیام P2A و هر پیامی که ظرف ۲۴ ساعت آینده تحویل داده شود، بخشی از p2a_conversation هستند.
p2a_message	پیام P2A از هر نوع.	صرف نظر از اینکه نماینده پاسخ دهد یا خیر، همیشه به عنوان یک رویداد قابل پرداخت جداگانه در نظر گرفته می‌شود.	به عنوان یک رویداد جداگانه و قابل پرداخت در نظر گرفته می‌شود، مگر اینکه نماینده ظرف 24 ساعت پاسخ دهد.

دسته بندی های صورتحساب در مقابل رویدادهای قابل پرداخت

تمایز بین دسته‌های صورتحساب نماینده و رویدادهای قابل پرداخت ، کلید درک نحوه‌ی صدور صورتحساب برای نماینده‌ی شماست.

• دسته بندی صورتحساب، یک طبقه بندی ثابت است که هنگام ایجاد نماینده خود انتخاب می کنید. این دسته بندی، روشی را که بر اساس آن برای نماینده شما صورتحساب صادر می شود، تعیین می کند: به ازای هر پیام (نمایندگان غیر مکالمه ای) یا به ازای هر مکالمه (نمایندگان مکالمه ای).
• رویدادهای قابل پرداخت، تعاملاتی بین یک عامل RCS برای کسب و کار و یک کاربر هستند که برای اهداف پرداخت ردیابی می‌شوند (برای مثال، basic_message ، single_message ، a2p_conversation ).

تولید گزارش صورتحساب

فقط اپراتورهایی که ترافیک غیر آزمایشی دارند، رویدادهای قابل پرداخت ایجاد می‌کنند. فعالیت از شماره تلفن‌های آزمایشی در گزارش‌های صورتحساب نمایش داده نمی‌شود.

این گزارش‌ها فرض می‌کنند که هزینه رویدادها هنگام تحویل پیام‌ها محاسبه می‌شود، نه هنگام ارسال آنها. پیامی که تحویل داده نشده یا پیامی که قبل از تحویل لغو شده است، رویدادی را که هزینه داشته باشد، ایجاد نمی‌کند.

قالب گزارش صورتحساب

گزارش‌های صورتحساب از قالب نام فایل rbm_billable_events_YYYY-MM-DD.csv استفاده می‌کنند. تاریخ موجود در نام فایل، تاریخ تولید فایل است.

هر خط در گزارش، یک رکورد است که نشان‌دهنده یک رویداد قابل پرداخت است. فیلدهای درون یک رکورد با تب از هم جدا می‌شوند. برای مثال، دو مکالمه A2P با یک اپراتور، دو رویداد قابل پرداخت جداگانه و دو رکورد در گزارش صورتحساب ایجاد می‌کند.

هر رکورد در گزارش شامل اطلاعات زیر برای هر رویداد قابل پرداخت است.

میدان	قالب	توضیحات	مثال
billing_event_id	رشته	شناسه UUID. یک عدد تصادفی که برای هر رویداد جدید در زمان ایجاد آن تولید می‌شود.	242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff
type	رشته	نوع رویداد: مدل صورتحساب استاندارد basic_message single_message a2p_conversation p2a_conversation p2a_message مدل صورتحساب ایالات متحده a2P_rich_message a2p_rich_media_message p2a_rich_message p2a_rich_media_message suggested_action_click	single_message p2a_rich_message
agent_id	رشته	شناسه منحصر به فرد برای عاملی که در این رویداد شرکت کرده است.	[e-mail]
agent_owner	رشته	آدرس ایمیل مالک فعلی حساب کاربری شریک که نماینده در آن ایجاد شده است.	[e-mail]
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-میلی‌متر-روز-THH:00:00Z	تاریخ/زمان UTC که رویداد در قالب ISO 8601 آغاز شده و به نزدیکترین ساعت گرد شده است. پیام‌های A2P برای رویدادهای single_message و basic_message ، این زمانی است که پیام به کاربر تحویل داده می‌شود. برای رویداد a2p_conversation ، این زمانی است که اولین پیام در مکالمه به کاربر تحویل داده می‌شود. پیام‌های P2A برای رویدادهای single_message و basic_message ، این زمانی است که پیام توسط کاربر ارسال می‌شود. برای رویداد p2a_conversation ، این زمانی است که اولین پیام در مکالمه توسط کاربر ارسال می‌شود.	2019-07-25T08:00:00Z
duration	شماره	مدت زمان رویداد، گرد شده به نزدیکترین دقیقه. وقتی نوع رویداد single_message یا basic_message باشد، مقدار 0 است.	45
mt_messages	شماره	تعداد پیام‌های خاتمه‌یافته از طریق موبایل (A2P) در رویداد.	11
mo_messages	شماره	تعداد پیام‌های ارسالی از طریق موبایل (P2A) در رویداد.	9
size_kilobytes	شماره	اندازه تمام فایل‌های پیوست‌شده به پیام‌ها در رویداد، گرد شده به نزدیکترین کیلوبایت (1kB = 1024 bytes).	912
agent_name	رشته	نام نماینده‌ای که در این رویداد شرکت کرده است.	XYZ Mobile USA
owner_name	رشته	نام مالک فعلی حساب شریک که نماینده در آن ایجاد شده است.	XYZ Mobile
segment_count	شماره	فقط مدل صورتحساب ایالات متحده تعداد سگمنت محاسبه‌شده برای رویدادهای RICH_MESSAGE .	5

نمونه گزارش رویداد صورتحساب

نمونه گزارش‌ها برای دانلود در دسترس هستند:

• گزارش صورتحساب برای مدل صورتحساب استاندارد
• گزارش صورتحساب برای مدل صورتحساب ایالات متحده

اندازه فایل معمولی

اندازه گزارش روزانه از یک شریک فعال RCS برای کسب و کار بستگی به میزان فعالیتی دارد که آنها در شبکه اپراتور ایجاد کرده‌اند. برای مثال، اگر ۵۳۰۰۰ رکورد در گزارش وجود داشته باشد، حجم فایل تقریباً ۸ مگابایت خواهد بود.

گزارش‌های فعالیت

گزارش‌های فعالیت، داده‌های خامی درباره فعالیت در پلتفرم RCS for Business ارائه می‌دهند. می‌توانید از این گزارش‌ها برای حسابرسی رویدادهای صورتحساب و ایجاد رویدادهای سفارشی استفاده کنید.

توجه : فقط ترافیک از شماره تلفن‌های غیر آزمایشی در گزارش‌های فعالیت لحاظ می‌شود.

از آنجا که گزارش‌های فعالیت حاوی اطلاعات شخصی قابل شناسایی (PII)، مانند اطلاعات دقیق تراکنش‌ها و MSISDNهای مشترکین هستند، فقط زمانی در دسترس هستند که یک اپراتور RCS را تحت شرایط خدمات خود اجرا کند. اگر RCS برای ترافیک تجاری را در شبکه‌های خود دارید و فعالیت RCS را با Google RCS تحت شرایط خدمات Google فعال کرده‌اید، به گزارش‌های فعالیت دسترسی نخواهید داشت.

قالب گزارش فعالیت

گزارش‌های فعالیت از قالب نام فایل rbm_activity_YYYY-MM-DD.csv استفاده می‌کنند. تاریخ موجود در نام فایل، تاریخ تولید فایل است.

فیلدهای یک رکورد با تب از هم جدا می‌شوند و در هر خط یک رکورد وجود دارد.

هر رکورد در گزارش فعالیت شامل فیلدهای زیر برای هر فعالیت است:

میدان	قالب	توضیحات	مثال
activity_id	رشته	شناسه منحصر به فرد برای فعالیت.	b422e1d3-ac99-442a-853d-a875d5e61762
billing_event_id	رشته	شناسه منحصر به فرد برای رویداد صورتحساب مرتبط. اگر فعالیت با یک رویداد صورتحساب مرتبط نباشد، مانند یک text_message بدون delivery_receipt_event مربوطه، می‌تواند خالی باشد.	91yeb201-7c3b-412b-98d2-b0a0f7abe536
agent_id	رشته	شناسه منحصر به فرد برای عامل.	[e-mail]
user_id	رشته	MSISDN کاربر.	918369110173
direction	رشته	جهت ارسال پیام: MT (خاتمه موبایل) برای فعالیت‌های عامل به کاربر MO (مبدا موبایل) برای فعالیت‌های کاربر به عامل	MT
time	YYYY-میلی‌متر-روز/ماه/سال:میلی‌متر:SS.SSSZ	تاریخ و زمانی که رویداد با فرمت UTC به پلتفرم RCS for Business ارسال شده است. به مهرهای زمانی مراجعه کنید.	2019-07-25T00:29:07.033Z
type	رشته	نوع فعالیت: text_message file_transfer rich_card/carousel suggestion_tap delivery_receipt_event read_receipt_event spam_report	text_message
size_bytes	رشته	اندازه فایل‌های پیوست شده به فعالیت، بر حسب بایت.	912

مهرهای زمانی

مهرهای زمانی موجود در گزارش‌های فعالیت، زمان ارسال یک رویداد به پلتفرم RCS for Business را ثبت می‌کنند. برای رویدادهایی که محتوا را به کاربر ارائه می‌دهند، رویداد تا زمانی که پیام تحویل داده نشود، در گزارش فعالیت ثبت نمی‌شود.

برای مثال، اگر یک پیام RCS برای کسب‌وکار روز چهارشنبه ساعت ۱۳:۰۰ برای کاربری ارسال شود و گیرنده تا یکشنبه ساعت ۹:۰۰ آفلاین باشد، این رویداد در گزارش فعالیت ایجاد شده برای روز یکشنبه ظاهر می‌شود، اما مهر زمانی آن چهارشنبه، ساعت ۱۳:۰۰ خواهد بود.