تصف هذه الصفحة ملفات البيانات التي ينشئها RCS for Business لمساعدة مشغّلي شبكات الجوّال في الولايات المتحدة في الفوترة والتدقيق بموجب إطار عمل RBM في الولايات المتحدة. لمزيد من المعلومات عن إطار عمل RBM في الولايات المتحدة، يمكنك أيضًا الرجوع إلى usrbm.org.
تقرير الفوترة هو تقرير مجمّع للأحداث القابلة للفوترة بين الوكلاء الذين تم إطلاقهم والمستخدمين. يعني مصطلح "قابل للفوترة" ببساطة أنّ الحدث مؤهّل للرسوم. يحدّد مشغّلو شبكات الجوّال ما إذا كانت الأحداث القابلة للفوترة ستُفرض عليها رسوم وكيفية ذلك. يمكن لجميع مشغّلي شبكات الجوّال في الولايات المتحدة الذين يستخدمون RCS for Business بشكل نشط الوصول إلى تقارير الفوترة.
لمعرفة تفاصيل عن نموذج تصنيفات الفوترة في الولايات المتحدة، يُرجى الرجوع إلى الـ أسئلة الشائعة حول الفوترة في الولايات المتحدة.
إنشاء الملفات
لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء الملفات.
تخزين الملفات والوصول إليها
لمزيد من المعلومات، يُرجى الاطّلاع على تخزين الملفات والوصول إليها.
توفُّر الملفات
لمزيد من المعلومات، يُرجى الاطّلاع على توفُّر الملفات.
تقارير الفوترة
تقارير الفوترة هي سجلّات لـ الأحداث القابلة للفوترة، ويتم احتسابها استنادًا إلى فئة الفوترة للوكيل ونوع الرسائل التي يرسلها. تتوفّر تقارير الفوترة لجميع مشغّلي شبكات الجوّال الذين يستخدمون RCS for Business بشكل نشط.
تحتوي تقارير الفوترة على معلومات سرية، ولكن لا تحتوي على معلومات تحديد الهوية الشخصية (PII) الخاصة بالمستخدم، مثل رقم MSISDN أو رقم MSISDN الذي تم تشفيره أو أي معرّف فريد للمستخدم.
فئات الفوترة مقابل الأحداث القابلة للفوترة
إنّ التمييز بين فئات فوترة الوكلاء والأحداث القابلة للفوترة أمر أساسي لفهم كيفية فوترة وكيلك.
- فئة الفوترة هي تصنيف ثابت تختاره عند إنشاء وكيلك. ويحدّد هذا التصنيف الطريقة التي يتم بها فوترة وكيلك: لكل رسالة (الوكلاء غير الحواريين) أو لكل جلسة (الوكلاء الحواريون).
- الأحداث القابلة للفوترة هي التفاعلات بين وكيل RCS for Business والمستخدم التي يتم تتبُّعها لأغراض الفوترة (على سبيل المثال،
rich_message).
فئات فوترة الوكلاء في الولايات المتحدة
عند إنشاء وكيل، يحدّد مالكه فئة الفوترة استنادًا إلى طريقة تفاعل الوكيل مع المستخدمين. لا تقيّد فئة الفوترة عدد الرسائل أو نوعها التي يمكن للوكيل إرسالها. ولكنها تحدّد كيفية فوترة الوكيل للرسائل. يوضّح الجدول التالي فئتَي الفوترة الرئيسيتَين.
| فئة الفوترة | نوع الوكيل | أمثلة على حالات الاستخدام | طريقة الفوترة |
|---|---|---|---|
| غير حوارية | الوكلاء الذين يرسلون في المقام الأول رسائل أحادية الاتجاه |
|
يتم فرض رسوم على كل رسالة يتم تسليمها إلى المستخدم. |
| حوارية | الوكلاء المصمّمون لتبادل الرسائل مع المستخدمين بغض النظر عن الجهة التي تبدأ المحادثة |
|
يتم فرض رسوم لكل جلسة: إذا استوفت الجلسة المعايير، يتم فرض رسوم ثابتة على جميع الرسائل التفاعلية ورسائل الوسائط التفاعلية المتقدّمة خلال فترة الجلسة التي تبلغ 24 ساعة، بغض النظر عن طولها أو أجزائها. يتم فرض رسوم لكل رسالة: إذا لم تستوفِ الجلسة المعايير أو إذا كانت الرسالة خارج فترة الجلسة التي تبلغ 24 ساعة، يتم فرض رسوم على الرسالة بشكل فردي بسعر لكل رسالة للرسائل التفاعلية أو رسائل الوسائط التفاعلية المتقدّمة وفقًا لبطاقة الأسعار الخاصة بمشغّل شبكة الجوّال الفردي. |
الوكلاء الحواريون مقابل الوكلاء غير الحواريين
هناك فئتان لفوترة الوكلاء: حواري وغير حواري.
يتم فرض رسوم على الوكلاء غير الحواريين لكل رسالة يتم تسليمها إلى المستخدم.
- هذه الفئة هي الأفضل للوكلاء الذين لا يتوقّعون تلقّي ردود متكررة.
يتم فرض رسوم ثابتة على الوكلاءالحواريين مقابل الجلسات ، شرط أن يتم تشغيل الجلسة، ثم ستتضمّن جميع الرسائل المتبادلة خلال فترة 24 ساعة، بما في ذلك الرسائل التي شغّلت الجلسة. يمكن أن يظلّ الوكلاء الحواريون يتحمّلون رسومًا مقابل الرسائل التي لا تشكّل جزءًا من جلسة مدتها 24 ساعة.
- هذه الفئة هي الأفضل للوكلاء الذين يشاركون في محادثات مترابطة مع المستخدمين.
منطق فوترة الجلسات
بموجب نموذج الفوترة في الولايات المتحدة، يتم تشغيل الجلسة من خلال تسلسل من 4 رسائل تفاعلية أو رسائل تتضمّن وسائط تفاعلية متقدّمة (بما في ذلك رسالتان على الأقل من الجهاز الجوّال إلى الجهاز الجوّال ورسالة واحدة على الأقل من الجهاز الجوّال إلى الجهاز الجوّال) يتم تبادلها خلال فترة 24 ساعة من أول رسالة في تسلسل التشغيل. عند استيفاء هذا الحدّ، يتم فرض رسوم على جميع الرسائل خلال فترة الـ 24 ساعة هذه باعتبارها جلسة واحدة. يتم فرض رسوم على أي رسائل خارج هذه الفترة أو لا تؤدي إلى تشغيل جلسة بالسعر العادي لكل رسالة للرسائل التفاعلية أو وسائط تفاعلية متقدّمة وفقًا لبطاقة الأسعار الخاصة بمشغّل شبكة الجوّال الفردي.
يوضّح المخطّط البياني التالي مثالاً على جلسة فوترة من تطبيق إلى شخص للوكلاء الحواريين.
- الرسالة من الجهاز الجوّال إلى الجهاز الجوّال (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 ساعة تبدأ عند تشغيل مشغّل الجلسة وتكون أول رسالة هي الرسالة من الجهاز الجوّال إلى الجهاز الجوّال. لمزيد من المعلومات، يُرجى الاطّلاع على ما هي الجلسة وكيف تعمل؟. | لا ينطبق. لا تنطبق الجلسات على الوكلاء غير الحواريين. | بعد تشغيل الجلسة، يتم تغطية جميع الرسائل في فترة الـ 24 ساعة برسوم جلسة واحدة. سيتم إسناد أي حدث قابل للفوترة في الجلسة التي تبلغ 24 ساعة إلى رقم تعريف الحدث القابل للفوترة للجلسة. |
p2a_session |
فترة تفاعل مدتها 24 ساعة تبدأ عند تشغيل مشغّل الجلسة وتكون أول رسالة هي الرسالة من الجهاز الجوّال إلى الجهاز الجوّال. لمزيد من المعلومات، يُرجى الاطّلاع على ما هي الجلسة وكيف تعمل؟ | لا ينطبق. لا تنطبق الجلسات على الوكلاء غير الحواريين. | بعد تشغيل الجلسة، يتم تغطية جميع الرسائل في فترة الـ 24 ساعة برسوم جلسة واحدة. سيتم إسناد أي حدث قابل للفوترة في الجلسة التي تبلغ 24 ساعة إلى رقم تعريف الحدث القابل للفوترة للجلسة. |
إنشاء تقرير الفوترة
لا ينشئ الأحداث القابلة للفوترة سوى الوكلاء الذين يتلقّون زيارات من مستخدمين غير مختبِرين. لا يظهر النشاط من أرقام الهواتف التجريبية في تقارير الفوترة.
تفترض هذه التقارير أنّ الأحداث قابلة للفوترة عند تسليم الرسائل من التطبيق إلى الشخص، وليس عند إرسالها. لا تؤدي الرسالة التي لم يتم تسليمها أو الرسالة التي تم إلغاؤها قبل التسليم إلى تشغيل حدث قابل للفوترة.
تنسيق تقرير الفوترة
تستخدم تقارير الفوترة تنسيق اسم الملف rbm_billable_events_YYYY-MM-DD.csv.
التاريخ في اسم الملف هو تاريخ إنشاء الملف.
كل سطر في التقرير هو سجلّ يمثّل حدثًا واحدًا قابلاً للفوترة.
يتم تمثيل جلسات الرسائل من التطبيق إلى الشخص/من الشخص إلى التطبيق بعدة صفوف، واحد لكل رسالة يتم تبادلها. سيعرض كل صف مرتبط بجلسة (يشترك في billing_event_id نفسه) إجمالي عدد الرسائل من الجهاز الجوّال إلى الجهاز الجوّال والرسائل من الجهاز الجوّال إلى الجهاز الجوّال لفترة الجلسة الكاملة التي تبلغ 24 ساعة في العمودَين mt_messages وmo_messages.
يحتوي كل سجلّ في التقرير على المعلومات التالية لكل حدث قابل للفوترة.
| الحقل | التنسيق | الوصف | مثال |
|---|---|---|---|
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_rich_message وa2p_rich_media_message، يكون هذا هو الوقت الذي يتم فيه تسليم الرسالة إلى المستخدم.a2p_session، يكون هذا هو الوقت الذي يتم فيه تسليم أول رسالة في المحادثة إلى المستخدم.الرسالة من الشخص إلى التطبيق 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 |
الرقم | عدد الرسائل من الجهاز الجوّال إلى الجهاز الجوّال (من الشخص إلى التطبيق) في الحدث بالنسبة إلى الجلسات، يعرض كل صف يشترك في billing_event_id نفسه إجمالي عدد الرسائل من الجهاز الجوّال إلى الجهاز الجوّال في الجلسة بأكملها. |
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 for Business على مقدار النشاط الذي أنشأه على شبكة مشغّل شبكة الجوّال.