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

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

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

تستخدم "خدمات الاتصالات التفاعلية (RCS) للمؤسسات" نموذجين للفوترة: نموذج الفوترة العادي لعدد الزيارات من خارج الولايات المتحدة ونموذج الفوترة في الولايات المتحدة لعدد الزيارات من الولايات المتحدة. يتم توضيح المعلومات الفريدة للنموذج العادي أو النموذج الأمريكي (على سبيل المثال، تصنيفات الأحداث القابلة للفوترة أو حقول التقارير المختلفة).

• للحصول على تفاصيل حول نموذج الفوترة العادي وملخّص عن الاختلافات بين نماذج الفوترة، يُرجى الرجوع إلى الأسئلة الشائعة حول الفوترة.
• للحصول على تفاصيل حول تصنيفات الفوترة في الولايات المتحدة، يُرجى الاطّلاع على دليل نموذج الفوترة في الولايات المتحدة.

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

يمثّل كل ملف بيانات يومًا واحدًا من استخدام RCS للأعمال بالتوقيت العالمي المنسَّق (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 للأعمال" لإعداد تقرير عنها. وهذا يعني أنّه قد لا يتم إنشاء أي ملفات في بعض الأيام. إذا كنت بحاجة إلى ملفات فارغة لتسهيل عملية التحميل، يُرجى التواصل معنا من خلال [e-mail].

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

تقارير الفوترة هي سجلّات الأحداث الخاضعة للفوترة، والتي يتم احتسابها استنادًا إلى فئة الفوترة الخاصة بالوكيل ونوع الرسائل التي يرسلها. تتوفّر تقارير الفوترة لجميع مشغّلي شبكات الجوّال الذين يوفّرون خدمة "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 (بدأها النشاط التجاري)	يتم بدء المحادثة عندما يردّ مستخدم على رسالة من تطبيق إلى شخص في غضون 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	سلسلة	معرّف UUID رقم عشوائي يتم إنشاؤه لكل حدث جديد عند إنشائه.	242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff
type	سلسلة	نوع الحدث: نموذج الفوترة العادي basic_message single_message a2p_conversation p2a_conversation p2a_message نموذج الفوترة في الولايات المتحدة a2P_rich_message a2p_rich_media_message p2a_rich_message p2a_rich_media_message suggested_action_click	single_message p2a_rich_message
agent_id	سلسلة	معرّف فريد للوكيل الذي شارك في الحدث.	[e-mail]
agent_owner	سلسلة	عنوان البريد الإلكتروني لمالك حساب الشريك الحالي الذي تم إنشاء الوكيل فيه.	[e-mail]
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	الرقم	مدة الحدث، ويتم تقريبها إلى أقرب دقيقة عندما يكون نوع الحدث 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
segment_count	الرقم	نموذج الفوترة في الولايات المتحدة فقط عدد الشرائح المحسوب للأحداث RICH_MESSAGE.	5

نموذج تقرير أحداث الفوترة

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

• تقرير الفوترة لنموذج الفوترة العادي
• تقرير الفوترة لنموذج الفوترة في الولايات المتحدة

حجم الملف المعتاد

يعتمد حجم التقرير اليومي من شريك نشط في برنامج "خدمات الاتصالات التفاعلية (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	سلسلة	تمثّل هذه السمة المعرّف الفريد للوكيل.	[e-mail]
user_id	سلسلة	رقم MSISDN الخاص بالمستخدم.	918369110173
direction	سلسلة	اتجاه إرسال الرسالة: MT (إنهاء المكالمة على الجهاز الجوّال) لأنشطة التواصل بين الوكيل والمستخدم ‫MO (من الجهاز الجوّال) لأنشطة المستخدمين مع وكلاء الدعم	MT
time	YYYY-mm-ddTHH:MM:SS.SSSZ	تمثّل هذه السمة تاريخ ووقت إرسال الحدث إلى منصة "خدمات الاتصالات التفاعلية (RCS) للمؤسسات" بتنسيق التوقيت العالمي المنسّق. اطّلِع على الطوابع الزمنية.	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) للأنشطة التجارية". بالنسبة إلى الأحداث التي تقدّم محتوًى إلى مستخدم، لن يتم تسجيل الحدث في سجلّ الأنشطة إلى أن يتم تسليم الرسالة.

على سبيل المثال، إذا تم إرسال رسالة RCS for Business إلى مستخدم يوم الأربعاء الساعة 13:00، وكان المستلِم غير متصل بالإنترنت حتى يوم الأحد الساعة 9:00، سيظهر الحدث في سجلّ الأنشطة الذي تم إنشاؤه ليوم الأحد، ولكن سيكون الطابع الزمني هو الأربعاء الساعة 13:00.