گزارش ها و گزارش ها

RBM فایل های داده ای ایجاد می کند که فعالیت کاربر و عامل را در سطوح خلاصه و تراکنش گزارش می کند. داده ها به چندین فایل جدا می شوند:

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

نسل

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

Google یک رویداد فعالیت را تنها زمانی گزارش می‌کند که جلسه صورت‌حساب به آن تعلق دارد. یک جلسه می‌تواند تا 24 ساعت طول بکشد، و خط لوله صورت‌حساب ما یک بار در روز اجرا می‌شود و فقط جلسات صورت‌حساب‌هایی را گزارش می‌کند که مطمئناً تکمیل شده‌اند (بنابراین حداقل 24 ساعت گذشته هستند).

مثلا:

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

• هنگامی که خط لوله دوباره در d+1 اجرا می شود، جلسه ای که پیام آغاز شده تنها 23 ساعت است. بنابراین، هیچ رویداد فعالیتی برای این پیام در d+1 گزارش نشده است.

• هنگامی که خط لوله دوباره در d+2 اجرا می شود، جلسه تکمیل شده است، بنابراین رویداد فعالیت همراه با جلسه صورتحساب گزارش می شود.

ذخیره سازی و دسترسی

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

برای بازیابی فایل های داده توسط SFTP، باید کلید عمومی SFTP خود را ارائه دهید. برای تولید کلیدها، به ایجاد جفت کلید پوسته ایمن (SSH) برای دراپ باکس SFTP مراجعه کنید.

سرور SFTP partnerupload.google.com است و برای امنیت بیشتر، اتصال بر روی یک شماره پورت بالا (19321) است.

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

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

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

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

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

حساب های جداگانه برای دسترسی به انواع گزارش ارائه شده است.

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

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

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

تازه کردن و حفظ کردن

هر فایل داده نشان دهنده یک روز استفاده از پلتفرم در زمان UTC است. رکوردهای یک روز معین یک بار تولید می شوند و ظرف 2 روز (48 ساعت) پس از پایان روز نهایی می شوند. اگر این فایل‌ها را در انبار داده بارگیری کنید، می‌توانید معیارهای ماه جاری را به‌روزرسانی کنید.

اگر هیچ فعالیتی برای حساب کردن وجود نداشته باشد، فایلی ایجاد نمی شود.

تاریخ در نام هر فایل، تاریخی است که فایل تولید شده است. سوابق موجود در فایل روز UTC را که 2 روز قبل از تاریخ پرونده می آید پوشش می دهد.

فرآیند صادرات که فایل‌ها را تولید می‌کند بین ساعت 2 تا 4 صبح PST اجرا می‌شود.

فایل های داده قبل از حذف حداکثر تا 30 روز نگهداری می شوند.

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

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

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

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

هر عامل RBM دارای یک دسته صورتحساب است که توسط توسعه دهنده عامل قبل از ارسال نماینده برای راه اندازی تنظیم می شود. دسته صورت‌حساب تعیین می‌کند که آیا پیام‌هایی که نماینده ارسال می‌کند مجزا هستند یا ممکن است در رویدادهای صورت‌حساب محاوره‌ای ترکیب شوند.

پنج نوع رویداد قابل پرداخت وجود دارد:

رویداد	تعریف
پیام اصلی	یک پیام کاربردی به شخص (A2P) که حداکثر 160 کاراکتر است فقط شامل متن است فقط عوامل مکالمه : اگر یک پیام P2A به عنوان پاسخ به یک پیام A2P در 24 ساعت آینده تحویل داده شود، پیام اصلی بخشی از یک مکالمه A2P می شود. در غیر این صورت جلسه خاتمه می یابد. یک پیام اساسی همیشه از یک نماینده به یک کاربر تحویل داده می شود.
پیام تک	یک پیام کاربردی به شخص (A2P) که حاوی چند رسانه ای یا متنی با بیش از 160 کاراکتر فقط عوامل مکالمه : اگر یک پیام P2A در 24 ساعت آینده تحویل داده شود، پیام واحد بخشی از یک مکالمه A2P می شود. در غیر این صورت جلسه خاتمه می یابد. یک پیام واحد همیشه از یک نماینده به یک کاربر تحویل داده می شود.
مکالمه A2P	فقط برای نمایندگان مکالمه اعمال می شود : یک مکالمه A2P زمانی آغاز می شود که یک پیام P2A ظرف 24 ساعت پس از یک پیام واحد A2P یا پیام اصلی A2P تحویل داده شود. توجه داشته باشید که اگر یک پیام P2A در عرض 24 ساعت پس از چندین پیام A2P تحویل داده شود، فقط از پیام 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	رشته	نوع رویداد: Basic_message single_message a2p_conversation p2a_conversation p2a_message	single_message
agent_id	رشته	شناسه عاملی که در رویداد شرکت کرده است.	[e-mail]
agent_owner	رشته	ایمیل صاحب نماینده ای که در رویداد شرکت کرده است. این طرفی است که عامل RBM را ثبت کرده است، در بیشتر موارد جمع‌آور، اما در برخی موارد نادر ممکن است برند باشد. این مقدار از فیلد «حساب RBM Google» گرفته شده است که هنگام ثبت نام سازنده برای استفاده از RBM ارائه شده است.	[e-mail]
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	تاریخ/زمان UTC رویداد در قالب ISO 8601 شروع شد و به نزدیکترین ساعت گرد شد. برای رویدادهای a2p_conversation و p2a_conversation ، این زمان شروع جلسه است. برای رویدادهای single_message و basic_message ، این زمانی است که رویداد رخ داده است.	2019-07-25T08:00:00Z
duration	عدد	مدت زمان رویداد، به نزدیکترین دقیقه گرد می شود. وقتی نوع رویداد single_message یا basic_message باشد، این عدد 0 خواهد بود.	45
mt_messages	عدد	تعداد پیام‌های پایان‌داده‌شده توسط تلفن همراه در رویداد.	11
mo_messages	عدد	تعداد پیام‌های منشا تلفن همراه در رویداد.	9
size_kilobytes	عدد	اندازه همه فایل‌های پیوست شده به پیام‌ها در رویداد، به نزدیک‌ترین کیلوبایت گرد شده (1 کیلوبایت = 1024 بایت).	912
agent_name	رشته	عاملی که در این رویداد شرکت کرد.	XYZ Mobile USA
owner_name	رشته	صاحب نماینده ای که در این رویداد شرکت کرده است. این طرفی است که عامل RBM را ثبت کرده است. در بیشتر موارد این تجمیع کننده است، اما در برخی موارد نادر ممکن است نام تجاری باشد. این مقدار از «نام نمایش ترجیحی برای حساب شریک شما» گرفته شده است که هنگام ثبت نام توسعه دهنده برای استفاده از RBM ارائه شده است.	XYZ Mobile

فایل نمونه

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

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

یک فایل گزارش روزانه از یک شریک فعال ممکن است حدود 53000 رکورد و تقریباً 8 مگابایت حجم داشته باشد.

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

گزارش‌های فعالیت، گزارش داده‌های خام فعالیت در پلتفرم RBM برای اهداف ممیزی رویدادهای قابل پرداخت و ساخت رویدادهای سفارشی هستند.

دسترسی

گزارش‌های فعالیت فقط برای شرکت‌هایی در دسترس هستند که ترافیک RBM در شبکه‌های خود دارند و فعالیت RCS را با Jibe Cloud تحت شرایط خدمات (ToS) خود فعال می‌کنند. اگر از Jibe Cloud تحت شرایط سرویس Jibe استفاده می‌کنید، به گزارش‌های فعالیت دسترسی نخواهید داشت.

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

قالب

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

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

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

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

رشته	قالب	شرح	مثال
activity_id	رشته	شناسه فعالیت
billing_event_id	رشته	شناسه رویداد صورت‌حساب که فعالیت در آن انجام شده است. اگر فعالیت با هیچ جلسه مرتبط نباشد، مانند یک text_message بدون delivery_receipt_event مربوطه، می‌تواند خالی باشد.
agent_id	رشته	شناسه عامل.	[e-mail]
user_id	رشته	MSISDN کاربر.	918369110173
direction	رشته	جهت ارسال پیام: MT (پایان دهنده تلفن همراه) برای فعالیت های عامل به کاربر MO (منشا تلفن همراه) برای فعالیت های کاربر به عامل	MT
time	YYYY-mm-ddTHH:MM:SS.SSSZ	تاریخ/زمان UTC که رویداد به پلتفرم RBM ارسال شد. به یادداشت زیر مراجعه کنید.	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

یادداشتی در مورد مهر زمانی

مُهرهای زمانی در گزارش‌های فعالیت، زمان ارسال یک رویداد به پلتفرم RBM را ثبت می‌کنند. برای رویدادهایی که محتوا را به کاربر تحویل می دهند، تا زمانی که پیام تحویل داده نشود، رویداد در گزارش فعالیت نوشته نمی شود.

به عنوان مثال، اگر یک پیام RBM در روز چهارشنبه ساعت 13:00 برای کاربر ارسال شود و گیرنده تا ساعت 09:00 یکشنبه آفلاین باشد، رویداد در گزارش فعالیت تولید شده برای یکشنبه ظاهر می شود. مهر زمانی رویداد در گزارش فعالیت، چهارشنبه، 13:00 خواهد بود.