توضّح هذه الصفحة ملفات البيانات التي تنشئها خدمة "RCS للأعمال" لمساعدة مشغّلي شبكات الجوّال في عمليات الفوترة والتدقيق. يُرجى الرجوع إلى الأسئلة الشائعة حول الفوترة للحصول على إجابات عن الأسئلة الشائعة حول نموذج الفوترة الخاص بميزة "RCS للأعمال".
| ملف | الوصف | من لديه إمكانية الوصول |
|---|---|---|
| تقرير أحداث الفوترة | تقرير مجمّع عن الأحداث القابلة للفوترة بين البرامج التي تم إطلاقها والمستخدمين | جميع مشغّلي شبكات الجوّال الذين يوفّرون خدمة "RCS للأعمال" بشكل نشط |
| سجلّ الأنشطة | سجلّ البيانات الأولية لنشاط "خدمات الاتصالات التفاعلية (RCS) للمؤسسات"، بما في ذلك الأحداث القابلة للفوترة | مشغّلو شبكات الجوّال الذين يقدّمون خدمة "الاتصالات التفاعلية (RCS) للمؤسسات" ويشغّلون خدمة RCS من Google بموجب بنود الخدمة الخاصة بهم |
إنشاء الملفات
يمثّل كل ملف بيانات يومًا واحدًا من استخدام RCS for Business بالتوقيت العالمي المنسَّق (UTC). يتم إنشاء الملفات يوميًا. قد تستغرق عملية الإنشاء عدة ساعات، وقد يختلف وقت اكتمالها.
بالنسبة إلى البرامج غير الحوارية، تحتوي الملفات على بيانات من فترة الـ 24 ساعة التي سبقت مباشرةً وقت إنشاء الملف. على سبيل المثال، إذا تم إنشاء تقرير أحداث الفوترة في الساعة 11:00 بالتوقيت العالمي المتفق عليه (UTC) يوم 5 مايو، سيتضمّن بيانات من الساعة 11:00 بالتوقيت العالمي المتفق عليه (UTC) يوم 4 مايو إلى الساعة 11:00 بالتوقيت العالمي المتفق عليه (UTC) يوم 5 مايو.
بالنسبة إلى الوكلاء الحواريين، تحتوي الملفات على بيانات من فترة الـ 24 ساعة التي تسبق وقت إنشاء الملف بيوم أو يومَين. على سبيل المثال، إذا تم إنشاء تقرير عن حدث الفوترة في الساعة 11:00 بالتوقيت العالمي المتفق عليه (UTC) من يوم 5 مايو، قد يحتوي على بيانات من الساعة 11:00 بالتوقيت العالمي المتفق عليه (UTC) من يوم 3 مايو إلى الساعة 11:00 بالتوقيت العالمي المتفق عليه (UTC) من يوم 4 مايو.
سبب التأخير هو أنّ نشاط "المراسلة التجارية من خلال خدمات الاتصالات التفاعلية" لوكلاء المحادثة مرتبط بالمحادثات، والتي قد تستغرق مدة تصل إلى 48 ساعة لإكمالها. يسمح هذا التأخير لميزة "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS)" بتسجيل جميع الرسائل ضمن محادثة قبل احتساب حدث الفوترة. لمزيد من المعلومات حول برامج الوكلاء الحوارية، يُرجى الاطّلاع على فئات فوترة الوكلاء.
النقاط الرئيسية:
عدم توفّر نشاط: إذا لم يكن هناك أي نشاط على المنصة في يوم معيّن، لن يتم إنشاء أي ملف.
التسمية: يشير التاريخ في اسم الملف إلى تاريخ إنشاء الملف، وليس إلى تاريخ البيانات الواردة فيه.
الاحتفاظ بالبيانات: يتم تخزين الملفات لمدة 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 للأعمال" لإعداد تقرير عنها. وهذا يعني أنّه قد لا يتم إنشاء أي ملفات في بعض الأيام. إذا كنت بحاجة إلى ملفات فارغة لتسهيل عملية التحميل، يُرجى التواصل معنا من خلال rbm-support@google.com.
تقارير أحداث الفوترة
تقارير أحداث الفوترة هي سجلات أحداث الفوترة، والتي يتم احتسابها استنادًا إلى فئة الفوترة الخاصة بالوكيل ونوع الرسائل التي يرسلها. تتوفّر تقارير أحداث الفوترة لجميع شركات النقل التي تشغّل خدمة "RCS للأعمال" بشكل نشط.
تحتوي تقارير أحداث الفوترة على معلومات سرية، ولكنّها لا تتضمّن أي معلومات تحديد الهوية الشخصية (PII) للمستخدمين، مثل رقم MSISDN أو رقم MSISDN المجزّأ أو أي معرّف فريد للمستخدم.
فئات فوترة الوكلاء
عند إنشاء وكيل، يحدّد المالك فئة الفوترة استنادًا إلى طريقة تفاعل الوكيل مع المستخدمين. لا تقيّد فئة الفوترة عدد الرسائل أو نوعها التي يمكن أن يرسلها أحد العملاء. ولكنّه يحدّد طريقة محاسبة الوكيل على الرسائل. تم وصف فئتَي الفوترة الرئيسيتَين في الجدول التالي.
| فئة الفوترة | نوع الوكيل | أمثلة على حالات الاستخدام | طريقة الفوترة |
|---|---|---|---|
غير حوارية (يشمل ذلك فئتَي "الرسالة الأساسية" و"الرسالة الفردية". ملاحظة: لم يعُد هناك أي فرق بين هاتين الفئتين. سيتم تحصيل رسوم من الوكيل في أي من الفئتين باعتباره وكيلًا غير حواري. |
برامج الدردشة التي ترسل بشكل أساسي رسائل أحادية الاتجاه |
|
يتم تحصيل رسوم مقابل كل رسالة يتم تسليمها إلى المستخدم. |
| أسلوب المحادثة | الوكلاء المصمّمون لإجراء محادثات ذهابًا وإيابًا مع المستخدمين |
|
الفوترة حسب المحادثة: إذا ردّ أحد الطرفين (الوكيل أو المستخدم) على رسالة من الطرف الآخر في غضون 24 ساعة، تبدأ محادثة. خلال فترة المحادثة (24 ساعة بعد الرد الأول)، يمكن للوكيل والمستخدم تبادل أي عدد من الرسائل، وسيتم تحصيل سعر ثابت من الوكيل مقابل المحادثة. الفوترة حسب الرسالة: إذا أرسل برنامج الدردشة رسالة ولم يردّ عليها المستخدم خلال 24 ساعة، ستتم فوترة برنامج الدردشة على الرسالة الفردية، على غرار برنامج الدردشة غير الحواري. |
يوضّح الرسم البياني التالي مثالاً على جلسة فوترة من تطبيق إلى شخص (A2P) خاصة ببرامج المحادثة:
الوكلاء الحواريون وغير الحواريين
هناك فئتان رئيسيتان للفوترة: المحادثات وغير المحادثات. تتضمّن الفئة غير الحوارية فئتَي "الرسالة الأساسية" و"الرسالة الفردية"، وهما متطابقتان من الناحية الوظيفية. يتم تحصيل رسوم من الوكيل في أي من هاتين الفئتين باعتباره وكيلًا غير حواري.
يكمن الاختلاف الرئيسي في فئات الفوترة بين البرامج الحوارية وغير الحوارية على النحو التالي:
تتم فوترة الوكلاء غير الحواريين مقابل كل رسالة يرسلونها إلى المستخدم.
- هذه الفئة هي الأنسب للوكلاء الذين لا يتوقّعون تلقّي ردود متكرّرة.
يتم تحصيل رسوم ثابتة من وكلاء المحادثات مقابل المحادثات، التي تشمل جميع الرسائل المتبادلة خلال فترة 24 ساعة.
- هذه الفئة هي الأنسب للوكلاء الذين يجرون محادثات متعدّدة الأدوار مع المستخدمين.
أحداث الفوترة
يتم تسجيل خمسة أنواع مختلفة من أحداث الفوترة في تقارير أحداث الفوترة. وتشمل هذه الأحداث الرسائل من التطبيق إلى الشخص (A2P) ومن الشخص إلى التطبيق (P2A).
- رسائل من التطبيق إلى المستخدم (A2P): يتم إرسالها من النشاط التجاري.
- رسالة من المستخدم إلى التطبيق (P2A): يتم إرسالها من المستخدم.
يوضِّح الجدول التالي كل حدث من أحداث الفوترة حسب صلته بالوكلاء غير الحواريين والحواريين.
| الحدث | الوصف | الوكلاء غير الحواريين | الوكلاء الحواريون |
|---|---|---|---|
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 ساعة. |
أحداث الفوترة مقارنةً بفئات الفوترة
يجب عدم الخلط بين أحداث الفوترة 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
|
سلسلة | نوع الحدث:
|
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 | تمثّل هذه السمة تاريخ/وقت بدء الحدث بالتوقيت العالمي المنسّق بتنسيق ISO 8601 مع التقريب إلى أقرب ساعة.
رسائل من التطبيق إلى المستخدم
رسائل من المستخدم إلى التطبيق
|
2019-07-25T08:00:00Z
|
duration
|
الرقم | مدة الحدث، يتم تقريبها إلى أقرب دقيقة
عندما يكون نوع الحدث |
45
|
mt_messages
|
الرقم | عدد الرسائل التي تم إنهاؤها على الأجهزة الجوّالة (من التطبيق إلى الشخص) في الحدث. | 11
|
mo_messages
|
الرقم | عدد الرسائل التي تم إنشاؤها على الأجهزة الجوّالة (من شخص إلى تطبيق) في الحدث. | 9
|
size_kilobytes
|
الرقم | حجم جميع الملفات المرفقة بالرسائل في الحدث، ويتم تقريبه إلى أقرب كيلوبايت (1 كيلوبايت = 1024 بايت). | 912
|
agent_name
|
سلسلة |
اسم الموظّف الذي شارك في الحدث. |
XYZ Mobile USA
|
owner_name
|
سلسلة | اسم المالك الحالي لحساب الشريك الذي تم إنشاء موظّف الدعم فيه | XYZ Mobile
|
نموذج تقرير أحداث الفوترة
يتوفّر نموذج ملف لتقرير الفوترة للتنزيل.
حجم الملف المعتاد
يعتمد حجم التقرير اليومي من شريك نشط في برنامج "RCS للأعمال" على مقدار النشاط الذي سجّله على شبكة مشغّل شبكة الجوّال. على سبيل المثال، إذا كان التقرير يتضمّن 53,000 سجلّ، سيبلغ حجم الملف 8 ميغابايت تقريبًا.
سجلات الأنشطة
توفّر سجلّات الأنشطة بيانات أولية حول النشاط على منصة "RCS للأنشطة التجارية". يمكنك استخدام هذه السجلات لتدقيق أحداث الفوترة وإنشاء أحداث مخصّصة.
ملاحظة: يتم تضمين الزيارات الواردة من أرقام هواتف غير مستخدَمة في الاختبار في سجلّات الأنشطة فقط.
بما أنّ سجلّات الأنشطة تحتوي على معلومات تحديد الهوية الشخصية، مثل معلومات المعاملات التفصيلية وأرقام MSISDN الخاصة بالمشتركين، لا تتوفّر هذه السجلّات إلا عندما تشغّل شركة الاتصالات خدمات RCS بموجب بنود الخدمة الخاصة بها. إذا كان لديك زيارات من خدمة "RCS للشركات" على شبكاتك وفعّلت نشاط 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)" بتنسيق التوقيت العالمي المنسّق. اطّلِع على الطوابع الزمنية. | 2019-07-25T00:29:07.033Z
|
type
|
سلسلة | نوع النشاط:
|
text_message
|
size_bytes
|
سلسلة | حجم الملفات المرفقة بالنشاط، بالبايت | 912
|
الطوابع الزمنية
تسجّل الطوابع الزمنية في سجلّات الأنشطة وقت إرسال حدث إلى منصة "خدمات الاتصالات التفاعلية (RCS) للأنشطة التجارية". بالنسبة إلى الأحداث التي تقدّم محتوًى إلى مستخدم، لن يتم تسجيل الحدث في سجلّ الأنشطة إلى أن يتم تسليم الرسالة.
على سبيل المثال، إذا تم إرسال رسالة RCS for Business إلى مستخدم يوم الأربعاء الساعة 13:00 وكان المستلِم غير متصل بالإنترنت حتى يوم الأحد الساعة 9:00، سيظهر الحدث في سجلّ الأنشطة الذي تم إنشاؤه ليوم الأحد، ولكن سيكون الطابع الزمني هو الأربعاء الساعة 13:00.