تقارير الفوترة وسجلّات الأنشطة العادية

توضّح هذه الصفحة ملفات البيانات التي تنشئها خدمة RCS for Business لمساعدة شركات الاتصالات في عمليات الفوترة والتدقيق.

ملف الوصف من لديه إمكانية الوصول
تقرير الفوترة تقرير مجمّع عن الأحداث القابلة للفوترة بين البرامج التي تم إطلاقها والمستخدمين جميع مشغّلي شبكات الجوّال الذين يوفّرون خدمة RCS for Business بشكل نشط
سجلّ الأنشطة سجلّ البيانات الأولية لنشاط RCS for Business، بما في ذلك الأحداث القابلة للفوترة مشغّلو شبكات الجوّال الذين يشغّلون حاليًا خدمة RCS for Business ويشغّلون "خدمة RCS من Google" بموجب بنود الخدمة الخاصة بهم

تستخدم "خدمات الاتصالات التفاعلية (RCS) للمؤسسات" نموذج فوترة عاديًا لعدد الزيارات من خارج الولايات المتحدة. لمعرفة التفاصيل، يُرجى الاطّلاع على الأسئلة الشائعة حول الفوترة.

إنشاء الملفات

يمثّل كل ملف بيانات يومًا واحدًا من استخدام RCS for Business حسب توقيت المحيط الهادئ الرسمي (PST). يتم إنشاء الملفات يوميًا وتعكس النشاط خلال فترة الـ 24 ساعة السابقة (من منتصف الليل إلى منتصف الليل). يمكن أن تستغرق عملية الإنشاء عدة ساعات، وقد يختلف وقت إكمالها.

  • بالنسبة إلى الوكلاء غير الحواريين، تحتوي الملفات على بيانات من فترة الـ 24 ساعة التي سبقت مباشرةً اليوم الذي تم فيه إنشاء الملف. على سبيل المثال، يغطّي التقرير الذي تم إنشاؤه في 5 مايو البيانات من الساعة 12:00 صباحًا في 4 مايو إلى الساعة 12:00 صباحًا في 5 مايو. الوقت المحدّد هو بتوقيت المحيط الهادئ.

  • بالنسبة إلى الوكلاء الحواريين، تحتوي الملفات على بيانات من فترة 24 ساعة قبل يوم أو يومَين من وقت إنشاء الملف. على سبيل المثال، يتضمّن التقرير الذي تم إنشاؤه في 5 أيار (مايو) بيانات من الفترة الزمنية التي تبلغ 24 ساعة في 2 أو 3 أيار (مايو). الوقت المحدّد هو بتوقيت المحيط الهادئ.

    سبب التأخير هو أنّ نشاط RCS for Business لوكلاء المحادثة مرتبط بالجلسات، وقد يستغرق إكماله مدة تصل إلى 24 ساعة. يسمح هذا التأخير لميزة RCS for Business بتسجيل جميع الرسائل ضمن محادثة قبل احتساب الحدث القابل للفوترة. لمزيد من المعلومات حول برامج الوكلاء الحوارية، يُرجى الاطّلاع على فئات الفوترة الخاصة بالوكلاء.

النقاط الرئيسية:

  • عدم توفّر نشاط: تلقائيًا، لا يتم إنشاء أي ملف إذا لم يكن هناك أي نشاط على المنصة في يوم معيّن. ومع ذلك، يمكنك الموافقة على تلقّي ملفات فارغة إذا كنت بحاجة إليها. للموافقة على استخدام هذه الميزة، يُرجى التواصل مع rbm-support@google.com.
  • التسمية: يشير التاريخ في اسم الملف إلى تاريخ إنشاء الملف، وليس إلى تاريخ البيانات الواردة فيه.
  • الاحتفاظ بالبيانات: يتم تخزين الملفات لمدة 63 يومًا كحد أقصى قبل حذفها.

يمكنك استخدام هذه الملفات لتعديل مستودع البيانات باستخدام أحدث مقاييس استخدام المنصة.

تخزين الملفات والوصول إليها

يتم تشفير ملفات البيانات أثناء الراحة وأثناء النقل.

لاسترداد ملفات البيانات باستخدام بروتوكول النقل الآمن للملفات (SFTP)، يجب تقديم مفتاح SFTP العام. لإنشاء مفاتيح، يُرجى الاطّلاع على إنشاء مفتاحَي بروتوكول النقل الآمن (SSH) لصندوق تحميل SFTP.

خادم بروتوكول SFTP هو partnerupload.google.com، ويتم الاتصال عبر رقم منفذ مرتفع (19321) لتوفير أمان إضافي.

يمكنك استخدام الأمر التالي للوصول إلى ملفات البيانات:

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

توفّر Google أسماء مستخدمين للحسابات بالتنسيقات التالية:

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

تحدّد Google <carrier name> وتوفّر حسابًا منفصلاً لكل نوع من أنواع التقارير.

يتم توفير حسابات منفصلة للوصول إلى أنواع التقارير المختلفة.

توفُّر الملف

إذا لم يتم إنشاء أي ملفات بيانات بعد، سيظهر لك خطأ في بروتوكول SFTP مشابه لما يلي: remote readdir("/"): No such file or directory، وهذا أمر متوقّع.

لن يتم إنشاء ملف إذا لم تكن هناك زيارات إلى "RCS للأعمال" لإعداد تقرير عنها. وهذا يعني أنّه قد لا يتم إنشاء أي ملفات في بعض الأيام. إذا كنت بحاجة إلى ملفات فارغة لتسهيل عملية التحقّق، يُرجى التواصل مع فريق دعم RCS for Business.

تقارير الفوترة

تقارير الفوترة هي سجلّات الأحداث الخاضعة للفوترة، والتي يتم احتسابها استنادًا إلى فئة الفوترة الخاصة بالوكيل ونوع الرسائل التي يرسلها. تتوفّر تقارير الفوترة لجميع مشغّلي شبكات الجوّال الذين يقدّمون خدمة "RCS للأعمال" بشكل نشط.

تحتوي تقارير الفوترة على معلومات سرية، ولكنها لا تتضمّن أي معلومات تحديد الهوية الشخصية (PII) للمستخدمين، مثل رقم MSISDN أو رقم MSISDN المجزّأ أو أي معرّف فريد للمستخدم.

فئات الفوترة للوكلاء

عند إنشاء وكيل، يحدّد المالك فئة الفوترة استنادًا إلى طريقة تفاعل الوكيل مع المستخدمين. لا تفرض فئة الفوترة أي قيود على عدد الرسائل أو نوعها التي يمكن أن يرسلها الوكيل. ولكنّه يحدّد طريقة محاسبة الوكيل على الرسائل. تم وصف فئتَي الفوترة الرئيسيتَين في الجدول التالي.

فئة الفوترة نوع الوكيل أمثلة على حالات الاستخدام طريقة الفوترة
غير حوارية برامج الدردشة الآلية التي ترسل بشكل أساسي رسائل أحادية الاتجاه
  • رسائل كلمات المرور لمرة واحدة (OTP)
  • التنبيهات
  • العروض الترويجية
 يتم تحصيل رسوم مقابل كل رسالة يتم تسليمها إلى المستخدم.
الوكيل الوكلاء المصمَّمون لإجراء محادثات مع المستخدمين
  • العثور على المنتج المناسب
  • حجز تذكرة
  • تحديد المشكلة وحلّها

الفوترة حسب المحادثة: إذا ردّ أحد الطرفين (الموظف أو المستخدم) على رسالة من الطرف الآخر في غضون 24 ساعة، تبدأ محادثة. خلال فترة المحادثة (24 ساعة بعد الرد الأول)، يمكن للوكيل والمستخدم تبادل أي عدد من الرسائل، وسيتم تحصيل رسوم ثابتة من الوكيل مقابل المحادثة.

الفوترة حسب الرسالة: إذا أرسل الوكيل رسالة ولم يردّ عليها المستخدم خلال 24 ساعة، سيتم تحصيل رسوم من الوكيل مقابل الرسالة الفردية، على غرار الوكيل غير الحواري.

يوضّح المخطّط البياني التالي مثالاً على جلسة فوترة من تطبيق إلى شخص (A2P) خاصة بالوكلاء الحواريين:

مخطّط الفوترة

الوكلاء الحواريون مقابل الوكلاء غير الحواريين

هناك فئتان رئيسيتان للفوترة: المحادثات وغير المحادثات.

يكمن الاختلاف الرئيسي بين فئات الفوترة في ما يلي:

  • يتم تحصيل رسوم من العملاء مقابل كل رسالة يرسلها الوكيل غير الحواري إلى المستخدم.

    • هذه الفئة هي الأنسب للوكلاء الذين لا يتوقّعون تلقّي ردود متكرّرة.

  • يتم تحصيل رسوم ثابتة من وكلاء المحادثات مقابل المحادثات، التي تشمل جميع الرسائل المتبادلة خلال فترة 24 ساعة.

    • هذه الفئة هي الأنسب للوكلاء الذين يشاركون في محادثات مترابطة مع المستخدمين.

الأحداث القابلة للفوترة

يتم تسجيل خمسة أنواع من الأحداث القابلة للفوترة في تقارير الفوترة. وتشمل هذه الأحداث أحداث الرسائل المتنقلة (MT) والرسائل الواردة (MO)، والتي يُشار إليها باسم أحداث A2P وأحداث P2A.

  • رسائل A2P (من التطبيق إلى الشخص) هي رسائل MT (إنهاء المكالمة على الجهاز الجوّال): وهي رسالة يرسلها النشاط التجاري.
  • P2A (التواصل بين شخص وتطبيق) هو MO (رسالة صادرة من الجهاز الجوّال): رسالة أو إجراء يبدأه المستخدم.

يوضِّح الجدول التالي كل حدث قابل للفوترة حسب ما ينطبق على الوكلاء غير الحواريين والحواريين.

الحدث الوصف الوكلاء غير الحواريين الوكلاء الحواريون
basic_message رسالة من تطبيق إلى شخص تتضمّن نصًا فقط يتألف من 160 حرفًا أو أقل إذا كان النص يتضمّن عنوان URL لموقع إلكتروني يتضمّن علامات OpenGraph، قد تعرض الرسالة معاينة صورة بدون أي تكلفة إضافية على الشريك. يتم دائمًا التعامل معها كحدث فردي قابل للفوترة، بغض النظر عمّا إذا كان المستخدم يردّ أم لا. يُعتبَر حدثًا فرديًا قابلاً للفوترة، ما لم يردّ المستخدم خلال 24 ساعة. في هذه الحالة، تصبح الرسالة جزءًا من a2p_conversation.
single_message رسالة من التطبيق إلى المستخدم تتضمّن محتوًى وافٍ أو رسالة نصية فقط تتجاوز 160 حرفًا. يتم دائمًا التعامل معها كحدث فردي قابل للفوترة، بغض النظر عمّا إذا كان المستخدم يردّ أم لا. يُعتبَر حدثًا فرديًا قابلاً للفوترة، ما لم يردّ المستخدم خلال 24 ساعة. في هذه الحالة، تصبح الرسالة جزءًا من a2p_conversation.
a2p_conversation (بدأها النشاط التجاري) يتم بدء المحادثة عندما يردّ مستخدم على رسالة من تطبيق إلى شخص (A2P) في غضون 24 ساعة من تلقّيها، خارج محادثة حالية. لا ينطبق. لا تنشئ البرامج غير الحوارية هذا النوع من الأحداث أبدًا. إذا تم تسليم رسالة من شخص إلى تطبيق في غضون 24 ساعة من تلقّي عدة رسائل من تطبيق إلى شخص، سيتم استخدام الرسالة الأخيرة من تطبيق إلى شخص التي سبقت رسالة من شخص إلى تطبيق مباشرةً لبدء المحادثة. تُعدّ رسالة A2P هذه وأي رسائل يتم تسليمها خلال الـ 24 ساعة التالية جزءًا من a2p_conversation.
p2a_conversation (بدأها المستخدم) يتم بدء هذه المحادثة عندما يردّ وكيل على رسالة من شخص إلى تطبيق في غضون 24 ساعة من تلقّيها، خارج محادثة حالية. لا ينطبق. لا تنشئ البرامج غير الحوارية هذا النوع من الأحداث أبدًا. إذا تم تسليم رسالة من تطبيق إلى شخص (A2P) في غضون 24 ساعة من إرسال عدة رسائل من شخص إلى تطبيق (P2A)، سيتم استخدام رسالة P2A التي سبقت رسالة A2P مباشرةً لبدء المحادثة. تُعدّ رسالة P2A هذه وأي رسائل يتم تسليمها خلال الـ 24 ساعة التالية جزءًا من p2a_conversation.
p2a_message رسالة من المستخدم إلى التطبيق من أي نوع يتم دائمًا التعامل معها كحدث فردي قابل للفوترة، بغض النظر عمّا إذا كان الوكيل يردّ أم لا. يتم التعامل معها كحدث فردي قابل للفوترة، ما لم يردّ الموظّف خلال 24 ساعة.

فئات الفوترة مقارنةً بالأحداث القابلة للفوترة

يُعدّ التمييز بين فئات الفوترة الخاصة بالوكيل والأحداث القابلة للفوترة أمرًا أساسيًا لفهم طريقة فوترة الوكيل.

  • فئة الفوترة هي تصنيف ثابت تختاره عند إنشاء وكيلك. تحدّد هذه السمة الطريقة التي يتم بها تحصيل الرسوم من وكيلك: لكل رسالة (الوكلاء غير الحواريين) أو لكل محادثة (الوكلاء الحواريون).
  • الأحداث القابلة للفوترة هي تفاعلات بين وكيل RCS for Business ومستخدم يتم تتبّعها لأغراض الفوترة (على سبيل المثال، basic_message وsingle_message وa2p_conversation).

إنشاء تقرير الفوترة

لا تُنشئ الأحداث القابلة للفوترة سوى البرامج التي لا تتضمّن زيارات اختبارية. لا يظهر النشاط من أرقام الهواتف التجريبية في تقارير الفوترة.

تفترض هذه التقارير أنّه يتم تحصيل رسوم الأحداث عند تسليم الرسائل، وليس عند إرسالها. لا تؤدي الرسالة التي لم يتم تسليمها أو الرسالة التي تم إلغاؤها قبل التسليم إلى إنشاء حدث قابل للفوترة.

تنسيق تقرير الفوترة

تستخدِم تقارير الفوترة تنسيق اسم الملف rbm_billable_events_YYYY-MM-DD.csv. التاريخ الوارد في اسم الملف هو تاريخ إنشاء الملف.

كل سطر في التقرير هو سجلّ يمثّل حدثًا واحدًا قابلاً للفوترة. يتم الفصل بين الحقول في السجل الواحد باستخدام علامات تبويب. على سبيل المثال، ستؤدي محادثتان بين التطبيق والشخص نفسه مع العميل نفسه إلى إنشاء حدثَين منفصلَين قابلَين للفوترة وسجلَّين في تقرير الفوترة.

يحتوي كل سجلّ في التقرير على المعلومات التالية لكل حدث قابل للفوترة.

الحقل التنسيق الوصف مثال
billing_event_id سلسلة معرّف تم إنشاؤه يميز الحدث القابل للفوترة. 242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff
type سلسلة نوع الحدث:
  • basic_message
  • single_message
  • a2p_conversation
  • p2a_conversation
  • p2a_message
 single_message

p2a_rich_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 تمثّل هذه السمة تاريخ/وقت بدء الفعالية بالتوقيت العالمي المنسّق بتنسيق ISO 8601 مع التقريب إلى أقرب ساعة.

رسائل من التطبيق إلى المستخدم

  • بالنسبة إلى الحدثَين single_message وbasic_message، يمثّل هذا الوقت وقت تسليم الرسالة إلى المستخدم.
  • بالنسبة إلى الحدث a2p_conversation، هذا هو الوقت الذي يتم فيه تسليم أول رسالة في المحادثة إلى المستخدم.

رسائل من المستخدم إلى التطبيق

  • بالنسبة إلى الحدثَين single_message وbasic_message، يمثّل هذا الحقل الوقت الذي أرسل فيه المستخدم الرسالة.
  • بالنسبة إلى الحدث p2a_conversation، هذا هو الوقت الذي يرسل فيه المستخدم أول رسالة في المحادثة.
 2019-07-25T08:00:00Z
duration الرقم مدة الحدث، ويتم تقريبها إلى أقرب دقيقة

تكون القيمة 0 لأي حدث غير حواري.

 45
mt_messages الرقم عدد الرسائل التي تم إنهاؤها على الأجهزة الجوّالة (من التطبيق إلى الشخص) في الحدث 11
mo_messages الرقم عدد الرسائل التي تم إنشاؤها على الأجهزة الجوّالة (من شخص إلى تطبيق) في الحدث. 9
size_kilobytes الرقم حجم جميع الملفات المرفقة بالرسائل في الحدث، ويتم تقريبه إلى أقرب كيلوبايت (1 كيلوبايت يساوي 1024 بايت). 912
agent_name سلسلة

اسم الوكيل الذي شارك في الحدث.

 XYZ Mobile USA
owner_name سلسلة اسم المالك الحالي لحساب الشريك الذي تم إنشاء موظّف الدعم فيه XYZ Mobile

نموذج لتقرير الفوترة

تتوفّر نماذج من التقارير للتنزيل:

حجم الملف النموذجي

يعتمد حجم التقرير اليومي من شريك نشط في برنامج RCS for Business على مقدار النشاط الذي سجّله على شبكة مشغّل شبكة الجوّال. على سبيل المثال، إذا كان التقرير يتضمّن 53,000 سجلّ، سيكون حجم الملف 8 ميغابايت تقريبًا.

سجلات الأنشطة

تقدّم سجلّات الأنشطة بيانات أولية عن الأنشطة على منصة RCS for Business. يمكنك استخدام هذه السجلات لتدقيق الأحداث القابلة للفوترة وإنشاء أحداث مخصّصة.

بما أنّ سجلّات الأنشطة تحتوي على معلومات تكشف الهوية الشخصية (PII)، مثل معلومات المعاملات التفصيلية وأرقام MSISDN الخاصة بالمشتركين، لا تتوفّر هذه السجلّات إلا عندما تشغّل شركة الاتصالات خدمات الاتصالات التفاعلية (RCS) بموجب بنود الخدمة الخاصة بها. إذا كان لديك عدد كبير من الزيارات إلى شبكاتك من خلال خدمة RCS for Business وفعّلت نشاط RCS باستخدام خدمة RCS من Google بموجب بنود خدمة 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 بتنسيق التوقيت العالمي المنسّق. اطّلِع على الطوابع الزمنية. 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 for Business إلى مستخدم يوم الأربعاء الساعة 13:00، وكان المستلِم غير متصل بالإنترنت حتى يوم الأحد الساعة 9:00، سيظهر الحدث في سجلّ الأنشطة الذي تم إنشاؤه ليوم الأحد، ولكن سيكون الطابع الزمني هو الأربعاء الساعة 13:00.