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

این صفحه فایل‌های داده‌ای را که RBM برای کمک به شرکت‌های مخابراتی در صدور صورت‌حساب و حسابرسی ایجاد می‌کند، شرح می‌دهد.

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

تولید فایل

هر فایل داده نشان دهنده یک روز استفاده از RBM در زمان هماهنگ جهانی (UTC) است. فایل ها روزانه بین ساعت 10:00 تا 12:00 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 می باشد.

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

نکات کلیدی:

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

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

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

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

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

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

برای بازیابی فایل های داده توسط 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 برای گزارش وجود نداشته باشد، فایلی ایجاد نخواهد شد. این بدان معناست که ممکن است چند روز باشد که هیچ فایلی تولید نشود. اگر برای ساده‌سازی فرآیند خود به فایل‌های خالی نیاز دارید، با rbm-support@google.com تماس بگیرید.

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

گزارش‌های رویداد صورت‌حساب سوابقی از رویدادهای صورت‌حساب هستند که بر اساس دسته صورت‌حساب نماینده و نوع پیام‌هایی که ارسال می‌کند محاسبه می‌شوند. گزارش‌های رویداد صورت‌حساب برای همه شرکت‌هایی که دارای MDA RBM هستند در دسترس است.

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

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

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

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

غیر مکالمه ای

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

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

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

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

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

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

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

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

  • به نمایندگان مکالمه نرخ ثابتی برای مکالمات صورت‌حساب دریافت می‌شود که شامل تمام پیام‌های رد و بدل شده در یک دوره 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_conversation و p2a_conversation ، این زمانی است که مکالمه شروع شده است.
  • برای رویدادهای single_message و basic_message ، این زمانی است که رویداد رخ داده است.
 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

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

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

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

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

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

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

از آنجایی که گزارش‌های فعالیت حاوی اطلاعات شناسایی شخصی (PII)، مانند اطلاعات دقیق تراکنش و MSISDN‌های مشترک هستند، تنها زمانی در دسترس هستند که یک شرکت مخابراتی RCS را تحت شرایط خدمات خود اجرا کند. اگر ترافیک RBM در شبکه‌های خود دارید و فعالیت RCS را با Google RCS Cloud تحت شرایط سرویس 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 تاریخ و زمان ارسال رویداد به پلتفرم RBM در قالب 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

مهر زمانی

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

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

سوالات متداول

مکالمه چیست؟

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

  • مکالمه A2P : مکالمه ای که توسط برند آغاز شده است.
  • مکالمه P2A : مکالمه ای که توسط کاربر آغاز شده است.

نحوه کار مکالمات

  • شروع : مکالمه زمانی شروع می شود که یکی از طرفین (نماینده یا کاربر) به پیامی از طرف دیگر در عرض 24 ساعت پس از دریافت آن، خارج از هر مکالمه موجود، پاسخ دهد.

    • مکالمه A2P : زمانی شروع می شود که کاربر به پیام نماینده پاسخ می دهد.
    • مکالمه P2A : زمانی شروع می شود که نماینده به پیام کاربر پاسخ دهد.

  • پنجره مکالمه : مکالمه تا 24 ساعت پس از شروع فعال باقی می ماند. مکالمه شامل تمام پیام های این پنجره 24 ساعته و همچنین اولین پیامی است که در ابتدا به آن پاسخ داده شد.

  • صورت‌حساب : به‌جای صورت‌حساب برای هر پیام جداگانه، نمایندگان مکالمه براساس کل مکالمه صورت‌حساب دریافت می‌کنند. این بدان معناست که هزینه مربوط به موضوع گفتگو است، نه تعداد پیام‌های موجود در آن.

مهم :

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

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

،

این صفحه فایل‌های داده‌ای را که RBM برای کمک به شرکت‌های مخابراتی در صدور صورت‌حساب و حسابرسی ایجاد می‌کند، شرح می‌دهد.

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

تولید فایل

هر فایل داده نشان دهنده یک روز استفاده از RBM در زمان هماهنگ جهانی (UTC) است. فایل ها روزانه بین ساعت 10:00 تا 12:00 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 می باشد.

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

نکات کلیدی:

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

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

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

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

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

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

برای بازیابی فایل های داده توسط 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 برای گزارش وجود نداشته باشد، فایلی ایجاد نخواهد شد. این بدان معناست که ممکن است چند روز باشد که هیچ فایلی تولید نشود. اگر برای ساده‌سازی فرآیند خود به فایل‌های خالی نیاز دارید، با rbm-support@google.com تماس بگیرید.

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

گزارش‌های رویداد صورت‌حساب سوابقی از رویدادهای صورت‌حساب هستند که بر اساس دسته صورت‌حساب نماینده و نوع پیام‌هایی که ارسال می‌کند محاسبه می‌شوند. گزارش‌های رویداد صورت‌حساب برای همه شرکت‌هایی که دارای MDA RBM هستند در دسترس است.

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

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

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

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

غیر مکالمه ای

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

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

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

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

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

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

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

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

  • به نمایندگان مکالمه نرخ ثابتی برای مکالمات صورت‌حساب دریافت می‌شود که شامل تمام پیام‌های رد و بدل شده در یک دوره 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_conversation و p2a_conversation ، این زمانی است که مکالمه شروع شده است.
  • برای رویدادهای single_message و basic_message ، این زمانی است که رویداد رخ داده است.
 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

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

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

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

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

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

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

از آنجایی که گزارش‌های فعالیت حاوی اطلاعات شناسایی شخصی (PII)، مانند اطلاعات دقیق تراکنش و MSISDN‌های مشترک هستند، تنها زمانی در دسترس هستند که یک شرکت مخابراتی RCS را تحت شرایط خدمات خود اجرا کند. اگر ترافیک RBM در شبکه‌های خود دارید و فعالیت RCS را با Google RCS Cloud تحت شرایط سرویس 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 تاریخ و زمان ارسال رویداد به پلتفرم RBM در قالب 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

مهر زمانی

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

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

سوالات متداول

مکالمه چیست؟

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

  • مکالمه A2P : مکالمه ای که توسط برند آغاز شده است.
  • مکالمه P2A : مکالمه ای که توسط کاربر آغاز شده است.

نحوه کار مکالمات

  • شروع : مکالمه زمانی شروع می شود که یکی از طرفین (نماینده یا کاربر) به پیامی از طرف دیگر در عرض 24 ساعت پس از دریافت آن، خارج از هر مکالمه موجود، پاسخ دهد.

    • مکالمه A2P : زمانی شروع می شود که کاربر به پیام نماینده پاسخ می دهد.
    • مکالمه P2A : زمانی شروع می شود که نماینده به پیام کاربر پاسخ دهد.

  • پنجره مکالمه : مکالمه تا 24 ساعت پس از شروع فعال باقی می ماند. مکالمه شامل تمام پیام های این پنجره 24 ساعته و همچنین اولین پیامی است که در ابتدا به آن پاسخ داده شد.

  • صورت‌حساب : به‌جای صورت‌حساب برای هر پیام جداگانه، نمایندگان مکالمه براساس کل مکالمه صورت‌حساب دریافت می‌کنند. این بدان معناست که هزینه مربوط به موضوع گفتگو است، نه تعداد پیام‌های موجود در آن.

مهم :

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

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