שותפים מקבלים דוחות סיכום על חיוב שמספקים ספירות יומיות מצטברות של אירועים שניתנים לחיוב, מקובצים לפי סוכן, סוג אירוע וספק. הדוח הזה משמש כסיכום ברמה גבוהה של כל התנועה שחויבה, ומספק לכם ניתוח חשוב ושקיפות נדרשת לגבי נתוני התנועה.
יצירה וגישה לקבצים
הדוחות נוצרים מדי יום בפורמט CSV ונשלחים באמצעות שירות ה-SFTP של Google.
גישת SFTP
הגישה לדוחות מוגנת באמצעות זוגות של מפתחות ציבוריים/פרטיים. האישורים של SFTP מבטיחים גישה מאובטחת ומבודדת.
איך מקבלים גישת SFTP
כדי לקבל דוחות חיוב, קודם צריך להגדיר את פרטי הכניסה ל-SFTP:
- יוצרים זוג מפתחות SSH: פועלים לפי ההוראות ליצירת זוג מפתחות Secure Shell (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 |
number | מספר האירועים המצטברים לכל סוג (SUM) | 150 |
segment_count* |
number | מספר הפלחים המחושב לאירועים של מודל החיוב בארה"ב (SUM) *ארה"ב בלבד |
5 |