توضّح هذه الصفحة ملفات البيانات التي تنشئها خدمة "خدمات RCS للأنشطة التجارية" لمساعدة مشغّلي شبكات الجوّال في الولايات المتحدة في إعداد الفواتير والتدقيق بموجب إطار عمل RBM في الولايات المتحدة. لمزيد من المعلومات حول إطار عمل RBM في الولايات المتحدة، يمكنك أيضًا الرجوع إلى usrbm.org.
تقرير الفوترة هو تقرير مجمّع للأحداث الخاضعة للفوترة بين البرامج والوكلاء والمستخدمين. يعني الحدث القابل للفوترة ببساطة أنّ الحدث مؤهَّل لفرض رسوم عليه. تحدّد شركات النقل ما إذا كان سيتم تحصيل رسوم مقابل الأحداث القابلة للفوترة وكيفية تحصيلها. يمكن لجميع مشغّلي شبكات الجوّال في الولايات المتحدة الذين يقدّمون خدمة RCS for Business الوصول إلى تقارير الفوترة.
لمعرفة تفاصيل حول نموذج تصنيفات الفوترة في الولايات المتحدة، يُرجى الاطّلاع على الأسئلة الشائعة حول الفوترة في الولايات المتحدة.
إنشاء الملفات
لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء الملفات.
تخزين الملفات والوصول إليها
لمزيد من المعلومات، يُرجى الاطّلاع على تخزين الملفات والوصول إليها.
توفُّر الملف
لمزيد من المعلومات، يُرجى الاطّلاع على توفُّر الملفات.
تقارير الفوترة
تقارير الفوترة هي سجلّات الأحداث القابلة للفوترة، ويتم احتسابها استنادًا إلى فئة الفوترة الخاصة بالوكيل ونوع الرسائل التي يرسلها. تتوفّر تقارير الفوترة لجميع مشغّلي شبكات الجوّال الذين يوفّرون خدمة RCS for Business.
تحتوي تقارير الفوترة على معلومات سرية، ولكنها لا تتضمّن أي معلومات تكشف الهوية الشخصية للمستخدم، مثل رقم MSISDN أو رقم MSISDN المجزّأ أو أي معرّف فريد للمستخدم.
فئات الفوترة مقارنةً بالأحداث القابلة للفوترة
يُعدّ التمييز بين فئات الفوترة الخاصة بالوكيل والأحداث القابلة للفوترة أمرًا أساسيًا لفهم كيفية احتساب تكلفة الوكيل.
- فئة الفوترة هي تصنيف ثابت تختاره عند إنشاء وكيلك. يحدّد هذا الحقل الطريقة التي يتم بها تحصيل الرسوم من وكيلك: لكل رسالة (الوكلاء غير الحواريين) أو لكل جلسة (الوكلاء الحواريون).
- الأحداث القابلة للفوترة هي تفاعلات بين وكيل RCS for Business ومستخدم يتم تتبُّعها لأغراض الفوترة (على سبيل المثال،
rich_message).
فئات الفوترة الخاصة بالوكلاء في الولايات المتحدة
عند إنشاء وكيل، يحدّد المالك فئة الفوترة استنادًا إلى طريقة تفاعل الوكيل مع المستخدمين. لا تفرض فئة الفوترة أي قيود على عدد الرسائل التي يمكن للوكيل إرسالها أو نوعها. ولكنّه يحدّد طريقة احتساب تكلفة الرسائل التي يرسلها الوكيل. تم وصف فئتَي الفوترة الرئيسيتَين في الجدول التالي.
| فئة الفوترة | نوع الوكيل | أمثلة على حالات الاستخدام | طريقة الفوترة |
|---|---|---|---|
| غير حوارية | البرامج التي ترسل بشكل أساسي رسائل أحادية الاتجاه |
|
يتم تحصيل رسوم مقابل كل رسالة يتم تسليمها إلى المستخدم. |
| الحوارية | الوكلاء المصمَّمون لإجراء محادثات ذهابًا وإيابًا مع المستخدمين بغض النظر عمّن يبدأ المحادثة |
|
الفوترة حسب الجلسة: في حال استيفاء معايير الجلسة، يمكن فوترة جميع الرسائل الغنية بصريًا ورسائل الوسائط التفاعلية المتقدّمة ضمن فترة الجلسة البالغة 24 ساعة بسعر ثابت، بغض النظر عن طول الرسالة أو عدد مقاطعها. الفوترة حسب الرسالة: في حال عدم استيفاء معايير الجلسة أو إذا كانت الرسالة خارج فترة الجلسة البالغة 24 ساعة، يمكن فوترة الرسالة بشكل فردي بسعر الرسالة الغنية بصريًا أو رسالة الوسائط التفاعلية المتقدّمة وفقًا لقائمة الأسعار الخاصة بكل مشغّل شبكة جوّال. |
الوكلاء الحواريون مقابل الوكلاء غير الحواريين
هناك فئتان لفوترة الوكلاء: حوارية وغير حوارية.
يتم تحصيل رسوم من الوكلاء غير الحواريين مقابل كل رسالة يرسلونها إلى المستخدم.
- هذه الفئة هي الأنسب للوكلاء الذين لا يتوقّعون تلقّي ردود متكرّرة.
يتم تحصيل رسوم ثابتة من وكلاء المحادثات مقابل الجلسات، شرط أن يتم بدء جلسة، ثم سيتم تضمين جميع الرسائل المتبادلة خلال فترة 24 ساعة، بما في ذلك الرسائل التي بدأت الجلسة. سيظل بإمكان وكلاء المحادثات فرض رسوم على الرسائل التي لا تشكّل جزءًا من جلسة مدتها 24 ساعة.
- هذه الفئة هي الأنسب للوكلاء الذين يشاركون في محادثات متعدّدة الأدوار مع المستخدمين.
منطق الفوترة للجلسة
بموجب نموذج الفوترة في الولايات المتحدة، يتم بدء جلسة من خلال تسلسل 4 رسائل وسائط تفاعلية متقدّمة أو رسائل وسائط تفاعلية متقدّمة (بما في ذلك رسالتان على الأقل من الجهاز الجوّال ورسالة واحدة على الأقل من المحطة الأساسية) يتم تبادلها خلال فترة 24 ساعة من الرسالة الأولى في التسلسل الذي يؤدي إلى بدء الجلسة. وبعد استيفاء هذا الحدّ، تصبح جميع الرسائل ضمن فترة الـ 24 ساعة هذه قابلة للفوترة باعتبارها جلسة واحدة. أي رسائل لا تندرج ضمن جلسة أو لا تؤدي إلى بدء جلسة تكون قابلة للفوترة بالسعر العادي لكل رسالة للرسائل التفاعلية أو وسائط تفاعلية متقدّمة وفقًا لقائمة الأسعار الخاصة بمشغل شبكة الجوّال.
يوضّح الرسم البياني التالي مثالاً على جلسة فوترة من التطبيق إلى الشخص (A2P) لبرامج المحادثة.
- الرسالة الواردة من النشاط التجاري (MT) هي رسالة يرسلها النشاط التجاري.
- الرسالة أو الإجراء الذي يبدأه المستخدم على الجهاز الجوّال (MO).
الأحداث القابلة للفوترة
يتم تصنيف تدفّقات المراسلة حسب مصدرها واتجاهها. لوصف اتجاه حركة بيانات المراسلة، تستخدم شركات الاتصالات الأمريكية عادةً مصطلح MT/MO. تتوافق هذه المصطلحات مع مصطلح A2P/P2A المستخدَم في جميع مستندات RCS for Business. في ما يلي شرح سريع لكيفية توافق هذه المصطلحات:
- رسائل A2P (من التطبيق إلى الشخص) هي رسائل MT (إنهاء المكالمة على الجهاز الجوّال): وهي رسالة يرسلها النشاط التجاري.
- P2A (من شخص إلى تطبيق) هي رسالة صادرة من الجهاز الجوّال (MO): رسالة أو إجراء يبدأه المستخدم.
| الحدث | الوصف | الوكلاء غير الحواريين | الوكلاء الحواريون |
|---|---|---|---|
a2p_rich_message |
رسالة يرسلها الوكيل تحتوي على نص فقط أو ردود مقترَحة أو إجراءات مقترَحة محدّدة (الاتصال برقم هاتف أو فتح عنوان URL في المتصفّح). | يتم التعامل معه دائمًا كحدث فردي قابل للفوترة. يتم تحصيل الرسوم لكل رسالة استنادًا إلى الشرائح (تساوي شريحة واحدة 160 بايت UTF-8). |
يتم التعامل معه كحدث فردي قابل للفوترة ما لم يصبح جزءًا من جلسة. |
p2a_rich_message |
رسالة يرسلها المستخدم تحتوي فقط على نص حر أو نص من خلال النقر على ردّ مقترَح | يتم التعامل معه دائمًا كحدث فردي قابل للفوترة. يتم تحصيل رسوم مقابل كل رسالة استنادًا إلى شرائح الجمهور. |
يتم التعامل معه كحدث فردي قابل للفوترة ما لم يصبح جزءًا من جلسة. |
a2p_rich_media_message |
رسالة يرسلها وكيل تحتوي على وسائط (صورة أو فيديو أو صوت) أو بطاقات تفاعلية متقدّمة أو لوحات دائرية أو إجراءات معقّدة مثل "عرض الموقع الجغرافي". | يتم التعامل معه دائمًا كحدث فردي قابل للفوترة. يتم تحصيل الرسوم منه كحدث واحد بسعر ثابت بغض النظر عن حجمه أو محتواه. |
يتم التعامل معه كحدث فردي قابل للفوترة ما لم يصبح جزءًا من جلسة. |
p2a_rich_media_message |
رسالة أرسلها مستخدم وتحتوي على ملف وسائط تم تحميله (صورة أو فيديو أو صوت) | يتم التعامل معه دائمًا كحدث فردي قابل للفوترة. يتم تحصيل رسوم ثابتة مقابل الحدث الواحد. |
يتم التعامل معه كحدث فردي قابل للفوترة ما لم يصبح جزءًا من جلسة. |
p2a_suggested_action |
ينقر المستخدم على أي إجراء مقترَح (مثل "عرض الموقع الجغرافي") ليس ردًا مقترَحًا. | يتم التعامل معه دائمًا كحدث فردي قابل للفوترة. يتم إنشاء حدث واحد قابل للفوترة لكل نقرة. |
يتم التعامل معه كحدث فردي قابل للفوترة ويتم إنشاء حدث واحد قابل للفوترة لكل نقرة ما لم يصبح جزءًا من جلسة. |
a2p_session |
فترة تفاعل مدتها 24 ساعة تبدأ عند بدء مشغّل جلسة وإرسال الرسالة الأولى إلى MT. لمزيد من المعلومات، اطّلِع على ما هي الجلسة وكيف تعمل. | لا ينطبق. لا تنطبق الجلسات على برامج الوكلاء غير الحوارية. | وبعد تفعيلها، يتم تحصيل رسوم جلسة واحدة مقابل جميع الرسائل المُرسَلة خلال فترة 24 ساعة. سيتمّ تعيين أيّ حدث خاضع للفوترة في الجلسة التي تستغرق 24 ساعة إلى معرّف الحدث الخاضع للفوترة في الجلسة. |
p2a_session |
فترة تفاعل مدتها 24 ساعة تبدأ عند بدء مشغّل جلسة وإرسال الرسالة الأولى (رسالة صادرة من المشترك). لمزيد من المعلومات، اطّلِع على مقالة ما هي الجلسة وكيف تعمل؟. | لا ينطبق. لا تنطبق الجلسات على برامج الوكلاء غير الحوارية. | وبعد تفعيلها، يتم تحصيل رسوم جلسة واحدة مقابل جميع الرسائل المُرسَلة خلال فترة 24 ساعة. سيتمّ تعيين أيّ حدث خاضع للفوترة في الجلسة التي تستغرق 24 ساعة إلى معرّف الحدث الخاضع للفوترة في الجلسة. |
إنشاء تقرير الفوترة
لا تنشئ الأحداث القابلة للفوترة إلا الوكلاء الذين لديهم زيارات غير اختبارية. لا يظهر النشاط من أرقام الهواتف التجريبية في تقارير الفوترة.
تفترض هذه التقارير أنّ الأحداث قابلة للفوترة عند تسليم رسائل من التطبيقات إلى الأشخاص، وليس عند إرسال الرسائل. لا تؤدي الرسالة التي لم يتم تسليمها أو الرسالة التي تم إلغاؤها قبل التسليم إلى إنشاء حدث قابل للفوترة.
تنسيق تقرير الفوترة
تستخدِم تقارير الفوترة تنسيق اسم الملف rbm_billable_events_YYYY-MM-DD.csv.
التاريخ الوارد في اسم الملف هو تاريخ إنشاء الملف.
كل سطر في التقرير هو سجلّ يمثّل حدثًا واحدًا قابلاً للفوترة.
يتم تمثيل جلسات A2P/P2A بعدة صفوف، صف واحد لكل رسالة تم تبادلها. سيعرض كل صف مرتبط بجلسة (يتضمّن billing_event_id نفسه) إجمالي عدد رسائل MT وMO لفترة الجلسة الكاملة البالغة 24 ساعة في العمودَين mt_messages وmo_messages.
يتم ترميز الملفات باستخدام ترميز UTF-8 بدون علامة ترتيب وحدات البايت، ويتم استخدام أسطر جديدة لنهايات الأسطر. السطر الأول من كل ملف هو صف عناوين يتضمّن أسماء الحقول.
يحتوي كل سجلّ في التقرير على المعلومات التالية لكل حدث قابل للفوترة.
| الحقل | التنسيق | الوصف | مثال |
|---|---|---|---|
billing_event_id |
سلسلة | معرّف تم إنشاؤه يميز الحدث القابل للفوترة. ستتضمّن جميع الرسائل التي تشكّل جزءًا من جلسة المعرّف |
63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e |
type |
سلسلة | نوع الحدث:a2p_rich_messagea2p_rich_media_messagep2a_rich_messagep2a_rich_media_messagep2a_suggested_action |
p2a_rich_message |
agent_id |
سلسلة | معرّف فريد للعامل الذي شارك في الحدث. | acme_342h23_agent@rbm.goog |
agent_owner |
سلسلة | عنوان البريد الإلكتروني لمالك حساب الشريك الحالي الذي تم إنشاء الوكيل فيه | marketing@xyzaggregator.com |
billing_party |
سلسلة | الجهة التي تُصدر فواتير الأحداث. | مشغّل شبكة الجوّال |
max_duration_single_message |
الرقم | الحدّ الأقصى للوقت (بالساعات) المسموح به للمستخدم للردّ على رسالة من وكيل الدعم قبل إغلاق نافذة بدء المحادثة وتصنيف الرسالة كحدث single_message لا ينطبق ذلك على النموذج الأمريكي للرسائل التفاعلية الفردية. |
24 |
max_duration_a2p_conversation |
الرقم | بالنسبة إلى البرنامج التجريبي للجلسات، يشير ذلك إلى فترة الجلسة البالغة 24 ساعة والتي يتم قياسها من الرسالة الأولى في تسلسل المشغّل. يتم قياس المدة بالساعات. | 24 |
max_duration_p2a_conversation |
الرقم | بالنسبة إلى البرنامج التجريبي للجلسات، يشير ذلك إلى فترة الجلسة البالغة 24 ساعة والتي يتم قياسها من الرسالة الأولى في تسلسل المشغّل. | 24 |
start_time |
YYYY-mm-ddTHH:00:00Z | تمثّل هذه السمة تاريخ/وقت بدء الحدث بالتوقيت العالمي المنسّق (ISO 8601). بالنسبة إلى الجلسات، هذا هو الطابع الزمني لأول رسالة في تسلسل المشغِّل. A2P a2p_rich_message وa2p_rich_media_message، هذا هو الوقت الذي يتم فيه تسليم الرسالة إلى المستخدِم.a2p_session، هذا هو الوقت الذي يتم فيه تسليم أول رسالة في المحادثة إلى المستخدم.P2A p2a_rich_message وp2a_rich_media_message، هذا هو الوقت الذي يرسل فيه المستخدم الرسالة.p2a_session، هذا هو الوقت الذي يرسل فيه المستخدم أول رسالة في المحادثة. |
2025-05-20T08:00:00Z |
duration |
الرقم | تشير المدة إلى الجلسات فقط ويتم قياسها بالدقائق. عندما يكون الحدث غير مرتبط بجلسة، تكون القيمة 0. | 45 |
mt_messages |
الرقم | عدد الرسائل التي تم إنهاؤها على الأجهزة الجوّالة (من التطبيق إلى الشخص) في الحدث بالنسبة إلى الجلسات، يعرض كل صف يتضمّن billing_event_id نفسه إجمالي عدد رسائل الترجمة الآلية في الجلسة بأكملها. |
5 |
mo_messages |
الرقم | عدد الرسائل المرسَلة من شخص إلى تطبيق (P2A) في الحدث. بالنسبة إلى الجلسات، يعرض كل صف يتضمّن billing_event_id نفسه إجمالي عدد رسائل MO في الجلسة بأكملها. |
3 |
size_kilobytes |
الرقم | حجم جميع الملفات المرفقة بالرسائل في الحدث، ويتم تقريبه إلى أقرب كيلوبايت (1 كيلوبايت يساوي 1024 بايت). | 912 |
agent_name |
سلسلة | اسم الوكيل الذي شارك في الحدث. | ACME Brand |
owner_name |
سلسلة | اسم المالك الحالي لحساب الشريك الذي تم إنشاء موظّف الدعم فيه | XYZ Aggregator |
segment_count |
الرقم | عدد الأقسام المحسوب للأحداث a2p_rich_message events وp2a_rich_message (يساوي قسم واحد 160 بايت UTF-8). عندما لا يكون الحدث أحد الأحداث المذكورة، تكون القيمة 0. |
5 |
session_type |
سلسلة | نوع الجلسة:a2p_sessionp2a_session |
a2p_session |
نموذج تقرير الفوترة
يتوفّر نموذج تقرير للتنزيل:
حجم الملف النموذجي
يعتمد حجم التقرير اليومي من شريك نشط في برنامج "خدمات الاتصالات التفاعلية (RCS) للأنشطة التجارية" على مقدار النشاط الذي حقّقه على شبكة مشغّل شبكة الجوّال.