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

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

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

تولید فایل

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

  • برای عوامل غیرمکالمه‌ای ، فایل‌ها حاوی داده‌هایی از دوره 24 ساعته هستند که بلافاصله قبل از زمان تولید فایل است. برای مثال، اگر گزارش رویداد صورت‌حساب در ساعت 11:00 UTC در 5 مه ایجاد شود، حاوی داده‌هایی از ساعت 11:00 UTC در 4 مه تا ساعت 11:00 UTC در 5 مه خواهد بود.

  • برای نمایندگان مکالمه ، فایل ها حاوی داده هایی از دوره 24 ساعته 1-2 روز قبل از زمان تولید فایل هستند. برای مثال، اگر گزارش رویداد صورت‌حساب در ساعت 11:00 UTC در 5 مه ایجاد شود، ممکن است حاوی داده‌هایی از ساعت 11:00 UTC در 3 مه تا ساعت 11:00 UTC در 4 می باشد.

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

نکات کلیدی:

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

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

  • حفظ : فایل ها قبل از حذف حداکثر به مدت 63 روز ذخیره می شوند.

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

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

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

برای بازیابی فایل های داده توسط پروتکل انتقال فایل امن (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 ، که انتظار می رود.

اگر RCS برای گزارش ترافیک تجاری وجود نداشته باشد، فایلی ایجاد نخواهد شد. این بدان معناست که ممکن است چند روز باشد که هیچ فایلی تولید نشود. اگر برای ساده‌سازی فرآیند خود به فایل‌های خالی نیاز دارید، با rbm-support@google.com تماس بگیرید.

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

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

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

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

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

دسته صورتحساب نوع عامل موارد استفاده نمونه روش صورتحساب

غیر مکالمه ای

(شامل دسته‌های پیام اصلی و پیام واحد است. توجه : دیگر هیچ تفاوتی بین این دو دسته وجود ندارد. یک نماینده در هر دسته به عنوان نماینده غیرمکالمه‌ای صورت‌حساب دریافت می‌کند.)		 عواملی که در درجه اول پیام های یک طرفه ارسال می کنند.
  • OTP ها
  • هشدارها
  • پیشنهادات تبلیغاتی
 برای هر پیامی که به کاربر تحویل داده می شود صورتحساب دریافت می شود.
محاوره ای عواملی که برای مبادلات رفت و برگشت با کاربران طراحی شده اند.
  • یافتن محصول مناسب
  • رزرو بلیط
  • عیب یابی یک مشکل

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

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

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

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

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

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

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

  • عوامل غیرمکالمه ای برای هر پیامی که به کاربر تحویل می دهند صورتحساب دریافت می کنند.

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

  • به نمایندگان مکالمه نرخ ثابتی برای مکالمات صورت‌حساب دریافت می‌شود که شامل تمام پیام‌های رد و بدل شده در یک دوره 24 ساعته می‌شود.

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

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

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

  • A2P (Application-to-Person) : ارسال شده توسط کسب و کار.
  • P2A (Person-to-Application) : توسط کاربر ارسال می شود.

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

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

رویدادهای صورت‌حساب در مقابل دسته‌های صورت‌حساب

رویدادهای صورت‌حساب basic_message و single_message نباید با دسته‌های صورت‌حساب Basic Message و Single Message اشتباه گرفت.

  • هر عاملی (بدون توجه به دسته‌بندی صورت‌حسابش ) می‌تواند رویدادهای صورت‌حساب basic_message و single_message را ایجاد کند.

  • دسته‌های صورت‌حساب پیام اصلی و پیام تک برای طبقه‌بندی عوامل غیرمکالمه‌ای استفاده می‌شوند. نمایندگان در این دسته‌های صورت‌حساب، رویدادهای صورت‌حساب محاوره‌ای را ایجاد نمی‌کنند ( a2p_conversations یا p2a_conversations ). در عوض، رویدادهای صورت‌حساب basic_message ، single_message و p2a_message را ایجاد می‌کنند.

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

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

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

فرمت گزارش صورتحساب

گزارش‌های رویداد صورت‌حساب از قالب نام فایل 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
 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

  • برای رویدادهای 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 شماره اندازه همه فایل‌های پیوست شده به پیام‌ها در رویداد، به نزدیک‌ترین کیلوبایت گرد شده (1 کیلوبایت = 1024 بایت). 912
agent_name رشته

نام عاملی که در رویداد شرکت کرده است.

 XYZ Mobile USA
owner_name رشته نام مالک فعلی حساب شریکی که نماینده در آن ایجاد شده است. XYZ Mobile

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

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

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

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

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

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

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

از آنجایی که گزارش‌های فعالیت حاوی اطلاعات شناسایی شخصی (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 رشته شناسه منحصر به فرد برای عامل. welcome-bot@rbm.goog
user_id رشته MSISDN کاربر. 918369110173
direction رشته جهت ارسال پیام:
  • MT (پایان دهنده تلفن همراه) برای فعالیت های عامل به کاربر
  • MO (منشا تلفن همراه) برای فعالیت های کاربر به عامل
 MT
time YYYY-mm-ddTHH:MM:SS.SSSZ تاریخ و زمان ارسال رویداد به پلتفرم RCS for Business در قالب UTC. مهر زمان را ببینید. 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 برای کسب و کار روز چهارشنبه ساعت 13:00 برای کاربر ارسال شود و گیرنده تا ساعت 9:00 یکشنبه آفلاین باشد، رویداد در گزارش فعالیت تولید شده برای یکشنبه ظاهر می شود، اما مهر زمانی چهارشنبه، 13:00 خواهد بود.