يتلقّى الشركاء تقارير فواتير ملخّصة تقدّم إحصاءات مجمّعة يومية للأحداث القابلة للفوترة، ويتم تجميعها حسب الوكيل ونوع الحدث ومشغّل شبكة الجوّال. ويقدّم هذا التقرير ملخّصًا عامًا لكل الزيارات التي يتم تحصيل رسوم مقابلها، ما يوفّر لك تحليلات قيّمة وإمكانية الاطّلاع اللازمة على بيانات الزيارات.
إنشاء الملفات والوصول إليها
يتم إنشاء التقارير يوميًا بتنسيق CSV وتسليمها باستخدام خدمة SFTP من Google.
إذن الوصول إلى بروتوكول النقل الآمن للملفات (SFTP)
تتم حماية إمكانية الوصول إلى التقارير من خلال أزواج المفاتيح العامة/الخاصة. تضمن بيانات اعتماد SFTP الوصول الآمن والمعزول.
كيفية الحصول على إذن الوصول إلى بروتوكول النقل الآمن للملفات (SFTP)
لتلقّي تقارير الفوترة، عليك أولاً إعداد بيانات اعتماد بروتوكول SFTP باتّباع الخطوات التالية:
- إنشاء مفتاحَي تشفير SSH: اتّبِع التعليمات الواردة في المقالة إنشاء مفتاحَي تشفير بروتوكول النقل الآمن (SSH) لصندوق تحميل SFTP.
- بدء عملية الإعداد: إذا كنت مهتمًا بتلقّي تقارير الشركاء، يُرجى التواصل مع الممثل عن نشاطك التجاري في Google أو جهة الاتصال الأساسية في Google. وسيرشدونك خلال عملية الإعداد والتسجيل الأوّلية لحساب الشريك من أجل إعداد تقارير الفوترة.
- إرسال المفتاح العام: قدِّم المفتاح العام (ملف PUB) إلى جهة الاتصال في Google. ستوفّر Google حسابك بعد ذلك، وتعيّن لك
<partner_id>الفريد، وتُعلمك عندما يصبح بإمكانك الوصول إلى الحساب. الوصول إلى الخادم: بعد تلقّي الإشعار، يمكنك الوصول إلى تقاريرك على خادم بروتوكول SFTP على
partnerupload.google.comباستخدام المنفذ 19321. استخدِم الأمر التالي للاتصال:sftp -i <path_to_private_key> -P 19321 rbmreports-partner-<partner_id>@partnerupload.google.com
اصطلاح تسمية الملفات
يتم تقسيم جميع تقارير مشغّلي شبكات الجوّال حسب مشغّل شبكة الجوّال.
في ما يلي بنية تسمية الدليل والملف:
rbmreports-partner-<partner_id>/
<YYYY>/<MM>/<DD>/
summary_<short_carrier_id>/
summary_<short_carrier_id>_<YYYY-MM-DD>.csv
...
<prefix>_<short_carrier_id>/
<prefix>_<short_carrier_id>_<YYYY-MM-DD>.csv
تحدّد السمة <prefix> النوع المحدّد للتقرير الذي يتم تسليمه.
تشمل البادئات العادية ما يلي:
| نوع التقرير | بادئة اسم الملف |
|---|---|
| تقرير الملخّص | summary |
يمكن اختياريًا إضافة بادئة اسم ملف مخصّصة إضافية إذا كانت هناك تقارير متعدّدة لنفس مشغّل شبكة الجوّال والشريك (على سبيل المثال، أثناء عمليات نقل التنسيق). يجب دائمًا فحص جميع الملفات بشكل متكرر ضمن الدليل الذي يحمل التاريخ.
بنية تقرير ملف CSV
تحدِّد الأقسام التالية الحقول وتنسيقات البيانات وتعريفات الأعمدة المستخدَمة في تقارير الفوترة الخاصة بالشركاء.
إذا كانت لديك أسئلة أخرى، يُرجى التواصل مع مشغّل شبكة الجوّال.
تنسيق التقرير الموجز
| الحقل | التنسيق | الوصف | مثال |
|---|---|---|---|
type |
سلسلة | نوع حدث الفوترة | a2p_session |
agent_id |
سلسلة | المعرّف الفريد للوكيل | acme_342h23_agent@rbm.goog |
agent_name |
سلسلة | اسم الوكيل الذي شارك في الحدث | ACME Brand |
carrier_id |
سلسلة | معرّف مشغّل شبكة الجوّال للزيارات | super-carrier |
carrier_name |
سلسلة | اسم مشغِّل شبكة الجوّال | Super Carrier |
carrier_country |
سلسلة | رمز البلد المكوّن من حرفَين وفقًا لمعيار ISO 3166-1 alpha-2 | US |
start_date |
سلسلة | تاريخ بدء الحدث (بتنسيق YYYY-MM-DD) | 2026-05-07 |
billing_date |
سلسلة | تاريخ إنشاء تقرير الفوترة | 2026-05-08 |
event_count |
الرقم | عدد الأحداث المجمّعة لكل نوع (المجموع) | 150 |
segment_count* |
الرقم | عدد الشرائح المحسوب لأحداث نموذج الفوترة في الولايات المتحدة (المجموع) *الولايات المتحدة فقط |
5 |