דוחות ויומנים

ב-RBM יוצרים קובצי נתונים שמדווחים על פעילות של משתמשים וסוכנים ברמת הסיכום וברמת העסקאות. הנתונים מופרדים למספר קבצים:

קובץ	התיאור	למי יש גישה
דוח אירועי חיוב	רשומה של אירועים לחיוב בין נציגים שהופעלו למשתמשים	כל הספקים שיש להם תנועת RBM ברשתות שלהם
יומן פעילות	נתוני פעילות גולמיים של פלטפורמת RBM	ספקים סלולריים שיש להם תעבורת RBM ברשתות שלהם ומאפשרים פעילות RCS ב-Jibe Cloud בכפוף לתנאים ולהגבלות (ToS) שלהם.

דור

היצירה בדוחות של אירועי חיוב וביומני הפעילות נמשכת יומיים.

Google מדווחת על אירוע פעילות רק כשביקור החיוב שאליו היא שייכת הושלם. ההפעלה יכולה להימשך עד 24 שעות. צינור עיבוד החיובים שלנו מתבצע פעם ביום ומדווח רק על הפעלות חיוב שבטוח הושלמו (כך שהן לפחות 24 שעות).

לדוגמה:

• הודעה נשלחת ביום ה-d ומתחיל פעילות חיוב, אבל הביצוע של צינור עיבוד הנתונים פספס שעה אחת לפני כן. לכן לא מדווח אף אירוע פעילות.

• כאשר צינור עיבוד הנתונים פועל שוב ב-d+1, הסשן שנשלח בהודעה נוצר לפני 23 שעות בלבד. לכן לא ידווח כל אירוע פעילות בהודעה הזו ב-d+1.

• כשצינור עיבוד הנתונים פועל שוב ב-d+2, הסשן הושלם ואירוע הפעילות מדווח יחד עם הסשן בנושאי חיוב.

אחסון וגישה

קובצי הנתונים מוצפנים כשהם מאוחסנים וכשהם מועברים.

כדי לאחזר קובצי נתונים באמצעות SFTP, עליכם לספק את המפתח הציבורי של ה-SFTP. במאמר יצירת זוג מפתחות Secure Shell (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 לדיווח, לא יווצר קובץ. המשמעות היא שיכול להיות שבימים מסוימים לא ייווצרו קבצים. אם רוצים ליצור קבצים ריקים במצב כזה, אפשר לפנות אלינו לכתובת [e-mail] כדי לפשט את העיבוד.

רענון ושמירה

כל קובץ נתונים מייצג יום אחד של שימוש בפלטפורמה, לפי שעון UTC. רשומות של יום מסוים נוצרות פעם אחת ומסופקות בתוך יומיים (48 שעות) לאחר סיום היום. אם טוענים את הקבצים האלה למחסן נתונים (data warehouse), אפשר לעדכן את המדדים של החודש הנוכחי.

קובץ לא נוצר אם אין פעילות בחשבון.

התאריך בשם של כל קובץ הוא התאריך שבו הקובץ נוצר. הרשומות בקובץ מתייחסות ליום UTC שמגיע יומיים לפני תאריך הקובץ.

תהליך הייצוא יצירת הקבצים מתבצע בין השעות 02:00 ל-4:00 לפי שעון החוף המערבי.

קובצי נתונים נשמרים עד 30 יום לפני שהם נמחקים.

דוחות אירועי חיוב

דוחות של אירועי חיוב הם רשומות של אירועים לחיוב, שמחושבים על סמך ההודעות הבסיסיות, על סמך יחידות החיוב המוצעות. אירועים לחיוב מכילים מידע סודי, אבל לא כוללים פרטים אישיים מזהים של המשתמשים (למשל: לא מדובר ב-MSSDN, ב-MSISDN מגובב או בכל מזהה ייחודי של המשתמש).

רק נציגים שהופעלו יוצרים אירועי חיוב. פעילות שטרם הושקה או נציגים שלא הושקו לא מופיעה בדוחות החיוב.

בדוחות החיוב ההנחה היא שאירועים מחויבים בזמן המסירה של ההודעות ולא במועד שליחת ההודעות. הודעה שלא נמסרה או בוטלה לפני המסירה לא מפעילה אירוע חיוב.

לכל נציג ב-RBM יש קטגוריית חיוב, שהוגדרה על ידי המפתח שלו לפני שליחת הנציג להשקה. קטגוריית החיוב קובעת אם ההודעות שהנציג שולח הן נפרדות או אם ניתן לשלב אותן באירועי חיוב בשיחות.

יש חמישה סוגים של אירועים לחיוב:

אירוע	הגדרה
הודעה בסיסית	הודעת אפליקציה לאדם (A2P) באורך של עד 160 תווים מכיל רק טקסט לנציגי שיחה בלבד: אם הודעת P2A נמסרת כתגובה להודעת A2P ב-24 השעות הקרובות, ההודעה Basic Message הופכת לחלק משיחה עם A2P. אחרת, הסשן מסתיים. הודעה בסיסית תמיד נמסרת מנציג למשתמש.
הודעה בודדת	הודעת אפליקציה לאדם (A2P) מכיל מולטימדיה או טקסט המכילים יותר מ-160 תווים לנציגי שיחה בלבד: אם הודעת 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	מחרוזת	סוג האירוע: basic_message single_message a2p_conversation p2a_conversation p2a_message	single_message
agent_id	מחרוזת	המזהה של הנציג שהשתתף באירוע.	[e-mail]
agent_owner	מחרוזת	כתובת האימייל של הבעלים של הנציג שהשתתף באירוע. זהו הגורם שרשם את הסוכן של RBM. ברוב המקרים, אתר האגרגטור, אבל במקרים נדירים הוא עשוי להיות המותג. הערך הזה נלקח מהשדה 'חשבון Google ב-RBM' שסופק כשהמפתח נרשם לשימוש ב-RBM.	[e-mail]
billing_party	מחרוזת	הגורם שמחייב בתשלום על אירועים. google ספק	carrier
max_duration_single_message	מספר	משך הזמן, (בשעות), שבו הודעה לנציג התמיכה יכולה להימשך מבלי לקבל תגובה לזיהוי הודעת SMS אחת.	24
max_duration_a2p_conversation	מספר	משך הזמן המקסימלי של סשן A2P, בשעות. הנתון נמדד מהתגובה הראשונה של המשתמש להודעה הראשונית של הנציג.	24
max_duration_p2a_conversation	מספר	משך הזמן המקסימלי של סשן P2A, בשעות. הנתון הזה נמדד לפי ההודעה הראשונה של המשתמש בשיחה.	24
start_time	YYYY-mm-ddTHH:00:00Z	התאריך/השעה (לפי שעון UTC) שבו האירוע התחיל בפורמט ISO 8601, מעוגל לשעה הקרובה. עבור האירועים a2p_conversation ו-p2a_conversation, זוהי השעה שבה הסשן התחיל. באירועים single_message ו-basic_message, זוהי השעה שבה האירוע התרחש.	2019-07-25T08:00:00Z
duration	מספר	משך האירוע, מעוגל לדקה הקרובה ביותר. כשסוג האירוע הוא single_message או basic_message, הערך יהיה 0.	45
mt_messages	מספר	מספר ההודעות שהסתיימו בנייד באירוע.	11
mo_messages	מספר	מספר ההודעות ממקור נייד באירוע.	9
size_kilobytes	מספר	הגודל של כל הקבצים המצורפים להודעות באירוע, מעוגלים לקילובייט הקרוב ביותר (1kB = 1,024 בייט).	912
agent_name	מחרוזת	הנציג שהשתתף באירוע.	XYZ Mobile USA
owner_name	מחרוזת	הבעלים של הנציג שהשתתף באירוע. זהו הגורם שרשם את הנציג ב-RBM. ברוב המקרים זהו אתר האגרגטור, אבל במקרים נדירים הוא עשוי להיות המותג. הערך הזה נלקח מתוך 'השם המוצג המועדף לחשבון השותף שלך' שסופק כשהמפתח נרשם לשימוש ב-RBM.	XYZ Mobile

קובץ לדוגמה

קובץ של דוח חיוב לדוגמה זמין להורדה.

גודל קובץ אופייני

קובץ דוח יומי משותף פעיל יכול להכיל כ-53,000 רשומות, ובגודל של כ-8MB.

יומני פעילות

יומני פעילות הם יומן הנתונים הגולמיים של הפעילות בפלטפורמת RBM, למטרות בקרה על אירועים שניתנים לחיוב ויצירת אירועים בהתאמה אישית.

זמינות

יומני הפעילות זמינים רק לספקים שיש להם תעבורת RBM ברשתות שלהם ולהפעיל את פעילות RCS ב-Jibe Cloud בכפוף לתנאים ולהגבלות (ToS) שלהם. אם אתם משתמשים ב-Jibe Cloud בכפוף לתנאים ולהגבלות של Jibe, לא תהיה לכם גישה ליומני הפעילות.

הערה: יומני הפעילות מכילים מידע מפורט על טרנזקציות ומספרי MSISDN של מנויים. יומני הפעילות מכילים פרטים אישיים מזהים (PII), ולכן הם זמינים רק כשהספק מפעיל את RCS בכפוף לתנאים ולהגבלות שלו.

פורמט

יומני הפעילות משתמשים בפורמט של שם הקובץ YYYY/MM/DD/rbm_activity_YYYY-MM-DD.csv.

התאריך בשם הקובץ הוא התאריך שבו נוצר הקובץ. בדרך כלל, הרשומות בקובץ מתייחסות לפעילות של היום שהיה יומיים לפני התאריך הזה.

השדות ברשומה מופרדים בטאבים, ויש רשומה אחת בכל שורה.

כל רשומה ביומן הפעילות מכילה את השדות הבאים לכל אירוע פעילות.

שדה	פורמט	התיאור	דוגמה
activity_id	מחרוזת	המזהה של הפעילות.
billing_event_id	מחרוזת	המזהה של אירוע החיוב שבו התרחשה הפעילות. הערך יכול להיות ריק אם הפעילות לא משויכת לסשן, למשל text_message בלי delivery_receipt_event תואם.
agent_id	מחרוזת	המזהה של הנציג.	[e-mail]
user_id	מחרוזת	ה-MSSDN של המשתמש.	918369110173
direction	מחרוזת	הכיוון שבו נשלחה ההודעה: MT (סיום פעילות בנייד) לפעילויות של סוכן-למשתמש MO (מקור בנייד) לפעילויות ממשתמש למשתמש	MT
time	YYYY-mm-ddTHH:MM:SS.SSSZ	התאריך והשעה (לפי שעון UTC) שבהם האירוע נשלח לפלטפורמת RBM. יש לעיין בהערה שבהמשך.	2019-07-25T00:29:07.033Z
type	מחרוזת	סוג הפעילות: text_message file_transfer rich_card/carousel suggestion_tap delivery_receipt_event read_receipt_event spam_report	text_message
size_bytes	מחרוזת	גודל הקבצים המצורפים לפעילות, בבייטים.	912

הערה לגבי חותמות זמן

חותמות הזמן ביומני Activity מתעדות את השעה שבה האירוע נשלח לפלטפורמת RBM. לגבי אירועים שמעבירים תוכן למשתמש, האירוע ייכתב ביומן הפעילות רק אחרי שההודעה נמסרה.

לדוגמה, אם הודעה ב-RBM נשלחת למשתמש ביום רביעי בשעה 13:00 והנמען לא מחובר עד יום ראשון בשעה 09:00, האירוע יופיע ביומן הפעילות שנוצר עבור יום ראשון. חותמת הזמן של האירוע ביומן הפעילות תהיה יום רביעי בשעה 13:00.