تنشئ ميزة "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية" (RBM) ملفات بيانات تسجّل نشاط المستخدم والوكيل على مستوى الملخص ومستويات المعاملات. يتم فصل البيانات إلى ملفات متعددة:
| ملف | الوصف | المستخدمون الذين يمكنهم الوصول للتسجيل |
|---|---|---|
| تقرير حدث الفوترة | سجلّ الأحداث القابلة للفوترة بين الوكلاء الذين تم إطلاقهم والمستخدمين | جميع شركات النقل التي لديها زيارات RBM على شبكاتها |
| سجلّ الأنشطة | البيانات الأولية للنشاط على منصّة RBM | مشغّلو شبكات الجوّال الذين يفعّلون الزيارات من خلال ميزة "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS)" على شبكاتهم، ويفعّلون نشاط خدمات الاتصالات التفاعلية (RCS) مع Jibe Cloud بموجب بنود الخدمة الخاصة بها |
الإنشاء
يحدث تأخير لمدة يومين في إنشاء تقارير أحداث الفوترة وسجلّات الأنشطة.
لا تُبلِّغ Google عن حدث نشاط إلا عند اكتمال جلسة الفوترة التي تنتمي إليها. يمكن أن يستغرق اكتمال أي جلسة ما يصل إلى 24 ساعة، ويتم تنفيذ مسار الفوترة مرة واحدة في اليوم، ويتم الإبلاغ فقط عن جلسات الفوترة التي تأكد من اكتمالها (وكذلك قد تم إنشاؤها منذ 24 ساعة على الأقل).
مثال:
يتم إرسال رسالة في اليوم د وتبدأ جلسة فوترة، ولكن لم يتم تنفيذ مسار الإجراءات قبل ساعة واحدة من ذلك. لذلك، لا يتم الإبلاغ عن أي حدث من أحداث النشاط.
وعند تشغيل مسار الإحالة الناجحة مرة أخرى في d+1، لا يتجاوز عمر الجلسة التي بدأتها الرسالة 23 ساعة. لذلك، لا يتم الإبلاغ عن أي حدث نشاط لهذه الرسالة في d+1.
وعند تشغيل مسار العملية مرة أخرى في d+2، تكون الجلسة قد اكتملت بحيث يتم الإبلاغ عن حدث النشاط إلى جانب جلسة الفوترة.
التخزين والوصول
يتم تشفير ملفات البيانات عندما تكون غير نشِطة وفي أثناء نقلها.
لاسترداد ملفات البيانات من خلال بروتوكول النقل الآمن للملفات (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. هذا مُتوقع.
لن يتم إنشاء ملف إذا لم تكن هناك حركة بيانات RBM للإبلاغ عنها. وهذا يعني أنه قد تكون هناك بعض الأيام التي لا يتم فيها إنشاء الملفات. يمكنك التواصل معنا على عنوان البريد الإلكتروني rbm-support@google.com إذا كنت تطلب إنشاء ملفات فارغة في هذه الحالة لتبسيط عملية المعالجة.
إعادة التحميل والاحتفاظ بالبيانات
يمثل كل ملف بيانات يومًا واحدًا من استخدام النظام الأساسي بالتوقيت العالمي المنسق. يتم إنشاء السجلات ليوم معين مرة واحدة ويتم إنهاؤها في غضون يومين (48 ساعة) من انتهاء اليوم. إذا قمت بتحميل هذه الملفات في مستودع البيانات، يمكنك تعديل مقاييس الشهر الحالي.
لا يتم إنشاء ملف في حال عدم وجود نشاط لحسابه.
التاريخ في اسم كل ملف هو تاريخ إنشاء الملف. وستغطي السجلات في الملف يوم التوقيت العالمي المنسق (UTC) الذي يأتي قبل يومين من تاريخ الملف.
يتم تنفيذ عملية التصدير لإنشاء الملفات بين 2 و4 صباحًا بتوقيت المحيط الهادئ.
ويتم الاحتفاظ بملفات البيانات لمدة 30 يومًا كحد أقصى قبل حذفها.
تقارير أحداث الفوترة
تقارير أحداث الفوترة هي سجلات للأحداث القابلة للفوترة التي يتم احتسابها من الرسائل الأساسية باستخدام وحدات الفوترة المقترَحة. تحتوي الأحداث القابلة للفوترة على معلومات سرية، ولكن لا تحتوي على معلومات تحديد الهوية الشخصية للمستخدم (على سبيل المثال، لا رقم MSISDN أو رقم MSISDN مجزأ أو أي معرّف فريد للمستخدم).
إنّ الوكلاء الذين تم إطلاقهم فقط ينشئون أحداث الفوترة. لا يظهر في تقارير الفوترة النشاط الذي لم يتم إطلاقه بعد أو الوكلاء الذين لم يتم إطلاقه بعد.
تفترض تقارير الفوترة أنّه تتم فوترة الأحداث عند تسليم الرسائل، وليس عند إرسال الرسائل. لا تؤدي الرسالة التي لم يتم تسليمها أو تم إبطالها قبل التسليم إلى تشغيل حدث فوترة.
يتضمّن كل وكيل RBM فئة الفوترة، يحدّدها مطوِّر الوكيل قبل إرسال الوكيل للإطلاق. تحدِّد "فئة الفوترة" ما إذا كانت الرسائل التي يرسلها الوكيل منفصلة أو ما إذا كان يمكن دمجها في أحداث فوترة تحادثية.
هناك خمسة أنواع من الأحداث القابلة للفوترة:
| حدث | التعريف |
|---|---|
| الرسالة الأساسية | يشير هذا المصطلح إلى رسالة يتم إرسالها من وإلى شخص (A2P)
وكلاء المحادثة فقط: إذا تم تسليم رسالة P2A كردّ على رسالة A2P في غضون 24 ساعة التالية، ستصبح الرسالة الأساسية جزءًا من محادثة A2P، وإلا، ستنتهي الجلسة. الرسالة الأساسية يتم تسليمها دائمًا من وكيل إلى مستخدم. |
| رسالة واحدة | يشير هذا المصطلح إلى رسالة يتم إرسالها من وإلى شخص (A2P)
وكلاء المحادثة فقط: إذا تم تسليم رسالة P2A خلال 24 ساعة تالية، ستصبح الرسالة الفردية جزءًا من محادثة A2P، وإلا، تنتهي الجلسة. يتم دائمًا تسليم رسالة واحدة من وكيل إلى مستخدم. |
| محادثة A2P | ينطبق هذا على وكلاء المحادثة فقط: تبدأ محادثة A2P عندما يتم تسليم رسالة P2A خلال 24 ساعة من رسالة A2P فردية أو رسالة A2P أساسية. يُرجى العلم أنّه في حال تسليم رسالة P2A خلال 24 ساعة من عدة رسائل A2P، يتم استخدام رسالة A2P التي سبقت رسالة P2A فقط لإنشاء جلسة المحادثة. تشكّل رسالة A2P هذه، بالإضافة إلى أي رسائل يتم تسليمها خلال الـ 24 ساعة القادمة، جزءًا من محادثة A2P الجديدة. |
| محادثة P2A | ينطبق هذا على وكلاء المحادثة فقط: تبدأ محادثة P2A عندما لا تكون هناك جلسة نشطة (رسالة واحدة بين A2P أو محادثة A2P أو محادثة بين P2A) ويتم تسليم رسالة P2A، ويرد النشاط التجاري في غضون 24 ساعة. |
| رسالة P2A | الوكلاء غير المحادثين: رسالة P2A يتم إرسالها من مستخدم نحو
وكيل استنادًا إلى فئة الفوترة
من "رسالة واحدة" أو "رسالة أساسية".
وكلاء المحادثة: رسالة P2A يتم إرسالها من مستخدم إلى موظّف دعم لا يقدّم أي محادثة حاليًا ولا يرد الوكيل عليه. |
مدى التوفّر
تتوفّر تقارير أحداث الفوترة لجميع مشغّلي شبكات الجوّال الذين لديهم زيارات RBM على شبكاتهم.
التنسيق
تستخدِم تقارير أحداث الفوترة تنسيق اسم الملف
YYYY/MM/DD/rbm_billable_events_YYYY-MM-DD.csv.
التاريخ الوارد في اسم الملف هو تاريخ إنشاء الملف. ستغطي السجلات في الملف بشكل عام النشاط لليوم الذي كان قبل يومين من هذا التاريخ.
تكون الحقول في السجلّ مفصولة بعلامات جدولة، وهناك سجلّ واحد في كل سطر.
سيكون هناك سجلّ واحد لكل حدث فوترة، أي محادثتَين A2P مع الوكيل نفسه ستؤدي إلى إنشاء حدثَين للفوترة وسجلَّين في تقرير الفوترة.
يحتوي كل سجلّ في تقرير الأحداث القابلة للفوترة على المعلومات التالية لكل حدث:
| الحقل | التنسيق | الوصف | مثال |
|---|---|---|---|
billing_event_id
|
سلسلة | معرّف UUID، وهو رقم عشوائي يتم إنشاؤه لكل حدث جديد عند إنشائه. | |
type
|
سلسلة | نوع الحدث:
|
single_message
|
agent_id
|
سلسلة | معرّف الوكيل الذي شارك في الحدث | rbm-welcome-bot@rbm.goog
|
agent_owner
|
سلسلة | البريد الإلكتروني لمالك الوكيل الذي شارك في الفعالية. وهي الجهة التي سجّلت وكيل RBM، وهي في معظم الحالات جهة تجميع المراجعات، ولكن قد تكون العلامة التجارية في بعض الحالات النادرة. هذه القيمة مأخوذة من حقل "حساب Google RBM" المقدَّم عند تسجيل المطوّر لاستخدام ميزة RBM. | name@aggregator.com
|
billing_party
|
سلسلة | الحزب الذي يتحمل فواتير الأحداث.
|
carrier
|
max_duration_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
|
سلسلة | مالك موظّف الدعم الذي شارك في الحدث هذه هي الجهة التي سجّلت وكيل RBM. وفي معظم الحالات، تكون هو مجمِّع السلع، ولكن في بعض الحالات النادرة قد تكون العلامة التجارية. يتم الحصول على هذه القيمة من "الاسم المعروض المفضّل لحساب الشريك" الذي يتم تقديمه عندما يكون المطوّر مسجّلاً لاستخدام ميزة RBM. | XYZ Mobile
|
نموذج الملف
يتوفّر ملف نموذج لتقرير الفوترة للتنزيل.
الحجم العادي للملف
قد يبلغ حجم ملف التقرير اليومي المقدَّم من شريك نشط حوالى 53,000 سجلّ، ويصل حجمه إلى 8 ميغابايت تقريبًا.
سجلّات الأنشطة
سجلات الأنشطة هي سجل البيانات الأوليّ للنشاط على منصة RBM لأغراض تدقيق الأحداث القابلة للفوترة وإنشاء أحداث مخصّصة.
مدى التوفّر
لا تتوفّر سجلّات الأنشطة إلا لمشغّلي شبكة الجوّال الذين لديهم عدد زيارات من خلال ميزة "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS)" على شبكاتهم، وتفعّل نشاط خدمات الاتصالات التفاعلية (RCS) مع Jibe Cloud بموجب "بنود الخدمة" الخاصة بها. إذا كنت تستخدم Jibe Cloud ضمن بنود خدمة Jibe، لن تتمكّن من الوصول إلى سجلّات الأنشطة.
التنسيق
تستخدم سجلات الأنشطة تنسيق اسم الملف YYYY/MM/DD/rbm_activity_YYYY-MM-DD.csv.
التاريخ الوارد في اسم الملف هو تاريخ إنشاء الملف. ستغطي السجلات في الملف بشكل عام النشاط لليوم الذي كان قبل يومين من هذا التاريخ.
تكون الحقول في السجلّ مفصولة بعلامات جدولة، وهناك سجلّ واحد في كل سطر.
يحتوي كل سجل في سجل الأنشطة على الحقول التالية لكل حدث نشاط.
| الحقل | التنسيق | الوصف | مثال |
|---|---|---|---|
activity_id
|
سلسلة | معرّف النشاط. | |
billing_event_id
|
سلسلة | معرّف حدث الفوترة الذي حدث فيه النشاط. يمكن أن يكون هذا الحقل فارغًا إذا لم يكن النشاط مرتبطًا بأيّ جلسة، مثل text_message بدون قيمة delivery_receipt_event مقابلة.
| |
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
|
ملاحظة حول الطوابع الزمنية
تسجل الطوابع الزمنية في سجلات النشاط وقت إرسال الحدث إلى منصة RBM. بالنسبة إلى الأحداث التي تقدم محتوى إلى المستخدم، لن تتم كتابة الحدث في سجل الأنشطة حتى يتم تسليم الرسالة.
على سبيل المثال، إذا تم إرسال رسالة RBM إلى مستخدم يوم الأربعاء عند الساعة 13:00 وكان المُستلِم غير متصل حتى يوم الأحد الساعة 09:00، سيظهر الحدث في سجلّ الأنشطة الذي تم إنشاؤه ليوم الأحد. سيكون الطابع الزمني للحدث في سجل الأنشطة هو الأربعاء 13:00.