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

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

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

يستخدم RCS للأعمال نموذج فوترة قياسي لحركة البيانات من خارج الولايات المتحدة. لمزيد من التفاصيل، راجع الأسئلة الشائعة حول الفوترة .

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

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

  • بالنسبة للوكلاء غير التفاعليين ، تحتوي الملفات على بيانات من فترة الـ ٢٤ ساعة التي سبقت مباشرةً يوم إنشاء الملف. على سبيل المثال، يغطي تقرير تم إنشاؤه في ٥ مايو بيانات من الساعة ١٢:٠٠ صباحًا يوم ٤ مايو إلى الساعة ١٢:٠٠ صباحًا يوم ٥ مايو. التوقيت المذكور هو بتوقيت المحيط الهادئ (PST).

  • بالنسبة لوكلاء المحادثة ، تحتوي الملفات على بيانات من فترة الـ ٢٤ ساعة التي تسبق يوم أو يومين من وقت إنشاء الملف. على سبيل المثال، يغطي التقرير المُنشأ في ٥ مايو بيانات من فترة الـ ٢٤ ساعة التي تبدأ في ٢ أو ٣ مايو. التوقيت المذكور هو بتوقيت المحيط الهادئ (PST).

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

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

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

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

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

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

لاسترداد ملفات البيانات عبر بروتوكول نقل الملفات الآمن (SFTP)، أدخل مفتاح SFTP العام الخاص بك. لإنشاء المفاتيح، راجع قسم "إنشاء زوج مفاتيح Secure Shell (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>

تحدد جوجل <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 ساعة.

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

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

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

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

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

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

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

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

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

إعداد تقارير الفواتير

لا تُحتسب الأحداث القابلة للفوترة إلا للوكلاء الذين لديهم حركة مرور غير مخصصة للاختبار. ولا تظهر الأنشطة من أرقام الهواتف التجريبية في تقارير الفوترة.

تفترض هذه التقارير أن الفواتير تُحتسب عند تسليم الرسائل، وليس عند إرسالها. ولا تُحتسب الفواتير في حالة عدم تسليم الرسالة أو إلغائها قبل التسليم.

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

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

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

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

مجال شكل وصف مثال
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 رقم أقصى مدة لمحادثة من تطبيق إلى شخص، بالساعات. تُقاس من أول رد للمستخدم على الرسالة الأولية للوكيل. 24
max_duration_p2a_conversation رقم أقصى مدة لمحادثة P2A، بالساعات. تُقاس من أول رسالة مستخدم في المحادثة. 24
start_time YYYY-mm-ddTHH:00:00Z تاريخ/وقت بدء الحدث بتوقيت UTC بتنسيق ISO 8601 مقربًا إلى أقرب ساعة.

رسائل A2P

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

رسائل P2A

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

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

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

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

 XYZ Mobile USA
owner_name خيط اسم المالك الحالي لحساب الشريك الذي تم إنشاء الوكيل فيه. XYZ Mobile

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

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

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

يعتمد حجم التقرير اليومي الصادر من شريك نشط في خدمة RCS للأعمال على حجم النشاط الذي قام به على شبكة مزود الخدمة. على سبيل المثال، إذا احتوى التقرير على 53000 سجل، فسيكون حجم الملف حوالي 8 ميجابايت.

سجلات النشاط

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

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

الطوابع الزمنية

تسجل الطوابع الزمنية في سجلات النشاط وقت إرسال الحدث إلى منصة RCS للأعمال. أما بالنسبة للأحداث التي تُرسل محتوى إلى المستخدم، فلن يُسجل الحدث في سجل النشاط إلا بعد تسليم الرسالة.

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