توضّح هذه الصفحة ملفات البيانات التي تنشئها خدمة "الاتصالات التفاعلية (RCS) للأنشطة التجارية" لمساعدة مشغّلي شبكات الجوّال في عمليات الفوترة والتدقيق.
| ملف | الوصف | من لديه إمكانية الوصول |
|---|---|---|
| تقرير الفوترة | تقرير مجمّع عن الأحداث القابلة للفوترة بين العملاء والمستخدمين | جميع مشغّلي شبكات الجوّال الذين يوفّرون خدمة RCS for Business بشكل نشط |
| سجلّ الأنشطة | سجلّ البيانات الأولية لنشاط RCS for Business، بما في ذلك الأحداث القابلة للفوترة | مشغّلو شبكات الجوّال الذين يقدّمون خدمة "الاتصالات التفاعلية (RCS) للمؤسسات" بشكل نشط ويشغّلون خدمة الاتصالات التفاعلية (RCS) من Google بموجب بنود الخدمة الخاصة بهم |
تستخدم خدمة RCS for Business نموذجين للفوترة: نموذج الفوترة العادي للزيارات من خارج الولايات المتحدة ونموذج الفوترة في الولايات المتحدة للزيارات من الولايات المتحدة. يتم توضيح المعلومات الفريدة للنموذج العادي أو النموذج الأمريكي (على سبيل المثال، تصنيفات الأحداث المختلفة القابلة للفوترة أو حقول التقارير).
- للحصول على تفاصيل حول نموذج الفوترة العادي وملخّص لاختلافات نماذج الفوترة، يُرجى الرجوع إلى الأسئلة الشائعة حول الفوترة.
- للحصول على تفاصيل حول تصنيفات الفوترة في الولايات المتحدة، يُرجى الاطّلاع على دليل نموذج الفوترة في الولايات المتحدة.
إنشاء الملفات
يمثّل كل ملف بيانات يومًا واحدًا من استخدام خدمات RCS للمؤسسات حسب توقيت المحيط الهادئ الرسمي (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 for Business لإعداد تقرير عنها. وهذا يعني أنّه قد لا يتم إنشاء أي ملفات في بعض الأيام. إذا كنت بحاجة إلى ملفات فارغة لتسهيل عملية التحقّق، يُرجى التواصل مع فريق دعم RCS for Business.
تقارير الفوترة
تقارير الفوترة هي سجلّات الأحداث الخاضعة للفوترة، والتي يتم احتسابها استنادًا إلى فئة الفوترة الخاصة بالوكيل ونوع الرسائل التي يرسلها. تتوفّر تقارير الفوترة لجميع شركات النقل التي تشغّل خدمة "RCS للأعمال" بشكل نشط.
تحتوي تقارير الفوترة على معلومات سرية، ولكنها لا تتضمّن أي معلومات تحديد هوية شخصية (PII) للمستخدمين، مثل رقم MSISDN أو رقم MSISDN المجزّأ أو أي معرّف فريد للمستخدم.
فئات فوترة الوكلاء
عند إنشاء وكيل، يحدّد المالك فئة الفوترة استنادًا إلى طريقة تفاعل الوكيل مع المستخدمين. لا تقيّد فئة الفوترة عدد الرسائل أو نوعها التي يمكن للوكيل إرسالها. ولكنّه يحدّد طريقة محاسبة الوكيل على الرسائل. تم وصف فئتَي الفوترة الرئيسيتَين في الجدول التالي.
| فئة الفوترة | نوع الوكيل | أمثلة على حالات الاستخدام | طريقة الفوترة |
|---|---|---|---|
| غير حوارية | البرامج الآلية التي ترسل بشكل أساسي رسائل أحادية الاتجاه |
|
يتم تحصيل رسوم مقابل كل رسالة يتم تسليمها إلى المستخدم. |
| الوكيل | الوكلاء المصمَّمون لإجراء محادثات ذهابًا وإيابًا مع المستخدمين |
|
الفوترة حسب المحادثة: إذا ردّ أحد الطرفين (موظّف الدعم أو المستخدم) على رسالة من الطرف الآخر في غضون 24 ساعة، تبدأ محادثة. خلال فترة المحادثة (24 ساعة بعد الرد الأول)، يمكن للوكيل والمستخدم تبادل أي عدد من الرسائل، وسيتم تحصيل رسوم ثابتة من الوكيل مقابل المحادثة. الفوترة حسب الرسالة: إذا أرسل برنامج الدردشة رسالة ولم يردّ عليها المستخدم خلال 24 ساعة، ستتم فوترة برنامج الدردشة على الرسالة الفردية، على غرار برنامج الدردشة غير الحواري. |
يوضّح الرسم البياني التالي مثالاً على جلسة فوترة من تطبيق إلى شخص (A2P) خاصة ببرامج المحادثة:
الوكلاء الحواريون مقابل الوكلاء غير الحواريين
هناك فئتان رئيسيتان للفوترة: المحادثات وغير المحادثات.
يكمن الاختلاف الرئيسي بين فئات الفوترة في التمييز بين البرامج الحوارية وغير الحوارية:
تتم فوترة الوكلاء غير الحواريين مقابل كل رسالة يرسلونها إلى المستخدم.
- هذه الفئة هي الأنسب للوكلاء الذين لا يتوقّعون تلقّي ردود متكرّرة.
يتم تحصيل رسوم ثابتة من وكلاء المحادثات مقابل المحادثات، التي تشمل جميع الرسائل المتبادلة خلال فترة 24 ساعة.
- هذه الفئة هي الأنسب للوكلاء الذين يشاركون في محادثات متعدّدة الأدوار مع المستخدمين.
الأحداث القابلة للفوترة
يتم تسجيل خمسة أنواع من الأحداث القابلة للفوترة في تقارير الفوترة. وتشمل هذه الأحداث أحداث الرسائل القصيرة الواردة والصادرة، والتي يُشار إليها باسم أحداث 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
|
سلسلة | نوع الحدث:
نموذج الفوترة العادي نموذج الفوترة في الولايات المتحدة |
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
|
الرقم | الحد الأقصى لمدة محادثة بين شخصين، بالساعات يتم قياسها من أول رسالة يرسلها المستخدم في المحادثة. | 24
|
start_time
|
YYYY-mm-ddTHH:00:00Z | تمثّل هذه السمة تاريخ/وقت بدء الحدث بالتوقيت العالمي المنسّق بتنسيق ISO 8601 مع التقريب إلى أقرب ساعة.
رسائل من التطبيق إلى المستخدم
رسائل من المستخدم إلى التطبيق
|
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
|
segment_count
|
الرقم | نموذج الفوترة في الولايات المتحدة فقط
عدد الشرائح المحسوب للأحداث |
5
|
نموذج تقرير الفوترة
تتوفّر نماذج من التقارير للتنزيل:
حجم الملف المعتاد
يعتمد حجم التقرير اليومي من شريك نشط في برنامج 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
|
time
|
YYYY-mm-ddTHH:MM:SS.SSSZ | تمثّل هذه السمة تاريخ ووقت إرسال الحدث إلى منصة RCS for Business بتنسيق التوقيت العالمي المنسّق. اطّلِع على الطوابع الزمنية. | 2019-07-25T00:29:07.033Z
|
type
|
سلسلة | نوع النشاط:
|
text_message
|
size_bytes
|
سلسلة | حجم الملفات المرفقة بالنشاط، بالبايت | 912
|
الطوابع الزمنية
تسجّل الطوابع الزمنية في سجلّات الأنشطة وقت إرسال حدث إلى منصة "خدمات الاتصالات التفاعلية (RCS) للأنشطة التجارية". بالنسبة إلى الأحداث التي تقدّم محتوًى للمستخدم، لن يتم تسجيل الحدث في سجلّ الأنشطة إلى أن يتم تسليم الرسالة.
على سبيل المثال، إذا تم إرسال رسالة RCS for Business إلى مستخدم يوم الأربعاء الساعة 13:00 وكان المستلِم غير متصل بالإنترنت حتى يوم الأحد الساعة 9:00، سيظهر الحدث في سجلّ الأنشطة الذي تم إنشاؤه ليوم الأحد، ولكن سيكون الطابع الزمني هو الأربعاء الساعة 13:00.