בדף הזה מוסבר על קובצי הנתונים שנוצרים ב-RCS for Business כדי לעזור לספקי סלולר בחיוב ובביקורת.
| קובץ | תיאור | למי יש גישה |
|---|---|---|
| דוח חיוב | דוח מצטבר של אירועים שחויבו בין סוכנים שהופעלו לבין משתמשים. | כל ספקי הסלולר שמפעילים באופן פעיל את RCS for Business. |
| יומן פעילות | יומן נתונים גולמיים של פעילות ב-RCS for Business, כולל אירועים לחיוב. | ספקי סלולר שמפעילים באופן פעיל את RCS for Business ומפעילים את שירות ה-RCS של Google בכפוף לתנאים ולהגבלות שלהם. |
ב-RCS for Business נעשה שימוש במודל חיוב רגיל לתנועת גולשים שלא נמצאים בארה"ב. מידע נוסף זמין בשאלות הנפוצות בנושא חיוב.
יצירת קבצים
כל קובץ נתונים מייצג יום אחד של שימוש ב-RCS לעסקים לפי שעון החוף המערבי של ארה"ב (PST). הקבצים נוצרים מדי יום ומשקפים את הפעילות מ-24 השעות הקודמות (מחצות עד חצות). תהליך היצירה יכול להימשך כמה שעות, וזמן הסיום עשוי להשתנות.
- בסוכנים שלא מנהלים שיחות, הקבצים מכילים נתונים מהתקופה של 24 שעות שקדמה ליום שבו הקובץ נוצר. לדוגמה, דוח שנוצר ב-5 במאי כולל נתונים מ-4 במאי בשעה 00:00 עד 5 במאי בשעה 00:00. השעה שצוינה היא לפי אזור הזמן PST.
בסוכנים שיכולים לנהל שיחה, הקבצים מכילים נתונים מתקופה של 24 שעות, יום או יומיים לפני מועד יצירת הקובץ. לדוגמה, דוח שנוצר ב-5 במאי כולל נתונים מחלון של 24 שעות ב-2 או ב-3 במאי. השעה שצוינה היא לפי אזור הזמן PST.
הסיבה לעיכוב היא שפעילות של סוכנים בממשק שיחה ב-RCS for Business מקושרת לסשנים, והסשנים יכולים להימשך עד 24 שעות. העיכוב הזה מאפשר ל-RCS for Business לתעד את כל ההודעות בשיחה לפני חישוב האירוע שחייבים עליו. מידע נוסף על סוכנים בממשק שיחה זמין במאמר קטגוריות של חיובים על סוכנים.
נקודות עיקריות:
- אין פעילות: כברירת מחדל, אם לא הייתה פעילות בפלטפורמה ביום מסוים, לא נוצר קובץ. עם זאת, אם צריך, אפשר להפעיל את האפשרות לקבל קבצים ריקים. כדי להצטרף, אפשר לשלוח אימייל ל-rbm-support@google.com.
- בחירת שם: התאריך בשם הקובץ הוא התאריך שבו הקובץ נוצר, ולא התאריך של הנתונים שבקובץ.
- שמירה: הקבצים נשמרים למשך 63 ימים לכל היותר לפני שהם נמחקים.
אתם יכולים להשתמש בקבצים האלה כדי לעדכן את מחסן הנתונים שלכם עם מדדי השימוש העדכניים בפלטפורמה.
אחסון קבצים וגישה אליהם
קבצי הנתונים מוצפנים בזמן האחסון ובזמן ההעברה.
כדי לאחזר קובצי נתונים באמצעות פרוטוקול מאובטח להעברת קבצים (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, וזה צפוי.
אם אין תנועה ב-RCS for Business לדיווח, לא ייווצר קובץ. המשמעות היא שיכול להיות שבימים מסוימים לא ייווצרו קבצים. אם אתם צריכים קבצים ריקים כדי לייעל את התהליך, אתם יכולים לפנות לצוות התמיכה של RCS for Business.
דוחות חיוב
דוחות החיוב הם רשומות של אירועים שניתנים לחיוב, שמחושבים על סמך קטגוריית החיוב של הסוכן וסוג ההודעות שהוא שולח. דוחות חיוב זמינים לכל הספקים שמפעילים באופן פעיל את RCS for Business.
דוחות החיוב מכילים מידע סודי, אבל לא פרטים אישיים מזהים (PII) של משתמשים, כמו MSISDN, MSISDN מגובב או מזהה ייחודי של משתמש.
קטגוריות חיוב של סוכנים
כשיוצרים סוכן, הבעלים שלו מגדיר את קטגוריית החיוב על סמך האינטראקציה של הסוכן עם המשתמשים. קטגוריית החיוב לא מגבילה את מספר ההודעות או את סוג ההודעות שהסוכן יכול לשלוח. אבל הוא קובע איך הסוכן יחויב על ההודעות. בטבלה הבאה מפורטות שתי קטגוריות החיוב העיקריות.
| קטגוריית חיוב | סוג הנציג | תרחישים לדוגמה | שיטת החיוב |
|---|---|---|---|
| לא בממשק לשיחה | סוכנים ששולחים בעיקר הודעות חד-כיווניות. |
|
החיוב הוא על כל הודעה שנמסרת למשתמש. |
| בממשק שיחה | סוכנים שנועדו לנהל שיחות עם משתמשים. |
|
חיוב לפי שיחה: אם אחד מהצדדים (הנציג או המשתמש) משיב להודעה מהצד השני תוך 24 שעות, מתחילה שיחה. במהלך חלון השיחה (24 שעות אחרי התגובה הראשונה), הנציג והמשתמש יכולים להחליף ביניהם כל מספר של הודעות, והנציג יחויב בתעריף קבוע על השיחה. חיוב לפי הודעה: אם הסוכן שולח הודעה והמשתמש לא משיב לה תוך 24 שעות, הסוכן יחויב על ההודעה הספציפית, בדומה לסוכן שאינו מנהל שיחה. |
בתרשים הבא מוצגת דוגמה לסשן חיוב של A2P לסוכנים בממשק שיחה:
סוכנים בממשק שיחה לעומת סוכנים שלא בממשק שיחה
יש שתי קטגוריות עיקריות לחיוב: שיחות ופעולות שלא קשורות לשיחות.
ההבדל העיקרי בין קטגוריות החיוב הוא בין סוכנים בממשק שיחה לבין סוכנים שלא מנהלים שיחות:
סוכנים שאינם שיחתיים מחויבים על כל הודעה שהם שולחים למשתמש.
- הקטגוריה הזו מתאימה במיוחד לסוכנים שלא מצפים לתשובות תכופות.
סוכנים בממשק שיחה מחויבים בתעריף קבוע עבור שיחות, שכוללות את כל ההודעות שהועברו במהלך תקופה של 24 שעות.
- הקטגוריה הזו מתאימה לנציגים שמנהלים שיחות מרובות תגובות עם משתמשים.
אירועים לחיוב
חמישה סוגים של אירועים שניתנים לחיוב נרשמים בדוחות החיוב. האירועים האלה כוללים אירועי MT ו-MO, שנקראים אירועי A2P ו-P2A.
- A2P (Application-to-Person) הוא MT (Mobile Terminated): הודעה שנשלחת על ידי העסק.
- P2A (Person-to-Application) הוא MO (Mobile Originated): הודעה או פעולה שהמשתמש יזם.
בטבלה הבאה מתואר כל אירוע שניתן לחיוב, בהתאם לסוג הסוכן: סוכן לא שיחתי וסוכן בממשק שיחה.
| אירוע | תיאור | סוכנים שלא פועלים בממשק שיחה | סוכנים בממשק שיחה |
|---|---|---|---|
basic_message
|
הודעת A2P שכוללת רק טקסט באורך של 160 תווים או פחות. אם הטקסט כולל כתובת URL של אתר עם תגי openGraph, יכול להיות שתוצג תצוגה מקדימה של תמונה בהודעה, ללא תשלום נוסף לשותף. | תמיד נספר כאירוע נפרד לחיוב, בלי קשר לשאלה אם המשתמש ענה. | היא נחשבת לאירוע נפרד לחיוב, אלא אם המשתמש משיב תוך 24 שעות. במקרה כזה, ההודעה הופכת לחלק מa2p_conversation.
|
single_message
|
הודעת A2P שמכילה תוכן עשיר או הודעה עם טקסט בלבד שאורכה מעל 160 תווים. | תמיד נספר כאירוע נפרד לחיוב, בלי קשר לשאלה אם המשתמש ענה. | היא נחשבת לאירוע נפרד לחיוב, אלא אם המשתמש משיב תוך 24 שעות. במקרה כזה, ההודעה הופכת לחלק מa2p_conversation.
|
a2p_conversation (התחלת שיחה על ידי העסק)
|
השיחה מתחילה כשמשתמש משיב להודעת A2P תוך 24 שעות מקבלת ההודעה, מחוץ לשיחה קיימת. | לא רלוונטית. סוכנים לא שיחתיים אף פעם לא יוצרים אירוע מהסוג הזה. | אם הודעת P2A נמסרת תוך 24 שעות ממספר הודעות A2P, רק הודעת ה-A2P שקדמה להודעת ה-P2A תשמש להתחלת השיחה. ההודעה הזו מסוג A2P, וכל ההודעות שיישלחו ב-24 השעות הבאות, הן חלק מa2p_conversation.
|
p2a_conversation (בהפעלת המשתמש)
|
השיחה מתחילה כשנציג משיב להודעה מלקוח תוך 24 שעות מקבלת ההודעה, מחוץ לשיחה קיימת. | לא רלוונטית. סוכנים לא שיחתיים אף פעם לא יוצרים אירוע מהסוג הזה. | אם הודעת A2P נמסרת תוך 24 שעות מכמה הודעות P2A, רק הודעת ה-P2A שקדמה להודעת ה-A2P תשמש להתחלת השיחה. ההודעה הזו מסוג P2A, וכל ההודעות שיישלחו ב-24 השעות הבאות, הן חלק מp2a_conversation.
|
p2a_message
|
הודעה מסוג P2A מכל סוג. | תמיד נחשב כאירוע נפרד לחיוב, ללא קשר לשאלה אם הסוכן עונה. | היא נחשבת לאירוע נפרד לחיוב, אלא אם הנציג משיב תוך 24 שעות. |
קטגוריות חיוב לעומת אירועים לחיוב
ההבדל בין קטגוריות חיוב של סוכנים לבין אירועים שניתנים לחיוב הוא קריטי להבנת החיוב על הסוכן.
- קטגוריית החיוב היא סיווג קבוע שבוחרים כשיוצרים את הסוכן. הוא קובע את השיטה שלפיה יחויב הסוכן: לפי הודעה (סוכנים שאינם בממשק שיחה) או לפי שיחה (סוכנים בממשק שיחה).
- אירועים לחיוב הם אינטראקציות בין סוכן של RCS for Business לבין משתמש, שמנוהל מעקב אחריהן למטרות חיוב (לדוגמה,
basic_message,single_message,a2p_conversation).
יצירת דוח חיוב
רק סוכנים עם תנועה שאינה תנועת בדיקה יוצרים אירועים שניתנים לחיוב. הפעילות ממספרי טלפון לבדיקה לא מופיעה בדוחות החיוב.
בדוחות האלה מניחים שהחיוב על אירועים מתבצע כשההודעות נמסרות, ולא כשהן נשלחות. הודעה שלא נמסרה או הודעה שבוטלה לפני המסירה לא מפעילה אירוע שניתן לחיוב.
פורמט דוח החיוב
דוחות החיוב משתמשים בפורמט שם הקובץ rbm_billable_events_YYYY-MM-DD.csv.
התאריך בשם הקובץ הוא תאריך יצירת הקובץ.
כל שורה בדוח היא רשומה שמייצגת אירוע אחד שניתן לחיוב. השדות ברשומה מופרדים באמצעות טאבים. לדוגמה, שתי שיחות A2P עם אותו נציג ייצרו שני אירועים נפרדים לחיוב ושני רשומות בדוח החיוב.
הקבצים מקודדים ב-UTF-8 בלי סימן סדר בתים, ונעשה בהם שימוש במעברי שורה לסיום השורות. השורה הראשונה בכל קובץ היא שורת כותרת עם שמות השדות.
כל רשומה בדוח מכילה את הפרטים הבאים לגבי כל אירוע שניתן לחיוב.
| שדה | פורמט | תיאור | דוגמה |
|---|---|---|---|
billing_event_id
|
מחרוזת | מזהה שנוצר כדי להבחין בין אירועים שניתנים לחיוב. | 242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff
|
type
|
מחרוזת | סוג האירוע:
|
single_message
|
agent_id
|
מחרוזת | מזהה ייחודי של הסוכן שהשתתף באירוע. | rbm-welcome-bot@rbm.goog
|
agent_owner
|
מחרוזת | כתובת האימייל של הבעלים הנוכחי של חשבון השותף שבו נוצר הסוכן. | name@aggregator.com
|
billing_party
|
מחרוזת | הגורם שמחייב על אירועים.
|
carrier
|
max_duration_single_message
|
number | משך הזמן המקסימלי (בשעות) שבו המשתמש יכול להשיב להודעה של נציג לפני שחלון התחלת השיחה נסגר וההודעה מסווגת כאירוע single_message.
|
24
|
max_duration_a2p_conversation
|
number | משך השיחה המקסימלי בין אפליקציה לאדם, בשעות. הזמן נמדד מנקודת הצירוף של המשתמש להודעה הראשונית של הנציג. | 24
|
max_duration_p2a_conversation
|
number | משך הזמן המקסימלי של שיחה בין אנשים, בשעות. הזמן נמדד מההודעה הראשונה של המשתמש בשיחה. | 24
|
start_time
|
YYYY-mm-ddTHH:00:00Z | התאריך והשעה שבהם האירוע התחיל לפי שעון UTC, בפורמט ISO 8601, מעוגלים לשעה הקרובה.
הודעות מסוג A2P
הודעות מסוג P2A
|
2019-07-25T08:00:00Z
|
duration
|
number | משך האירוע, מעוגל לדקה הקרובה ביותר.
הערך הוא 0 לכל אירוע שאינו אירוע שיחה. |
45
|
mt_messages
|
number | מספר ההודעות שהתקבלו בנייד (A2P) באירוע. | 11
|
mo_messages
|
number | מספר ההודעות שהמשתמשים שלחו (P2A) באירוע. | 9
|
size_kilobytes
|
number | גודל כל הקבצים שמצורפים להודעות באירוע, מעוגל לקילובייט הקרוב ביותר (1KB שווה ל-1,024 בייטים). | 912
|
agent_name
|
מחרוזת |
שם הסוכן שהשתתף באירוע. |
XYZ Mobile USA
|
owner_name
|
מחרוזת | השם של הבעלים הנוכחי של חשבון השותף שבו נוצר הסוכן. | XYZ Mobile
|
דוגמה לדוח חיוב
אפשר להוריד דוחות לדוגמה:
גודל קובץ אופייני
הגודל של דוח יומי משותף פעיל של RCS לעסקים תלוי בכמות הפעילות שהוא יצר ברשת של הספק. לדוגמה, אם יש 53,000 רשומות בדוח, גודל הקובץ יהיה בערך 8MB.
יומני פעילות
יומני הפעילות מספקים נתונים גולמיים על הפעילות בפלטפורמת RCS for Business. אפשר להשתמש ביומנים האלה כדי לבדוק אירועים שניתנים לחיוב וליצור אירועים בהתאמה אישית.
יומני הפעילות מכילים פרטים אישיים מזהים (PII), כמו מידע מפורט על עסקאות ומספרי טלפון של מנויים, ולכן הם זמינים רק כשספק סלולר מפעיל RCS בהתאם לתנאים ולהגבלות שלו. אם יש לכם תנועה של RCS for Business ברשתות שלכם והפעלתם את פעילות ה-RCS באמצעות Google RCS בהתאם לתנאים ולהגבלות של Google, לא תהיה לכם גישה ליומני הפעילות.
הפורמט של יומן הפעילות
יומני הפעילות משתמשים בפורמט שם הקובץ rbm_activity_YYYY-MM-DD.csv. התאריך בשם הקובץ הוא התאריך שבו הקובץ נוצר.
השדות ברשומה מופרדים באמצעות Tab, ויש רשומה אחת בכל שורה.
הקבצים מקודדים ב-UTF-8 בלי סימן סדר בתים, ונעשה בהם שימוש במעברי שורה לסיום השורות. השורה הראשונה בכל קובץ היא שורת כותרת עם שמות השדות.
כל רשומה ביומן הפעילות מכילה את השדות הבאים לכל פעילות:
| שדה | פורמט | תיאור | דוגמה |
|---|---|---|---|
activity_id
|
מחרוזת | מזהה ייחודי של הפעילות. | b422e1d3-ac99-442a-853d-a875d5e61762
|
billing_event_id
|
מחרוזת | מזהה ייחודי של האירוע המשויך שניתן לחיוב. יכול להיות ריק אם הפעילות לא משויכת לאירוע שניתן לחיוב, כמו text_message ללא delivery_receipt_event תואם.
|
91yeb201-7c3b-412b-98d2-b0a0f7abe536
|
agent_id
|
מחרוזת | מזהה ייחודי של הסוכן. | welcome-bot@rbm.goog
|
user_id
|
מחרוזת | מספר MSISDN של המשתמש. | 918369110173
|
direction
|
מחרוזת | הכיוון שבו ההודעה נשלחת:
|
MT
|
time
|
YYYY-mm-ddTHH:MM:SS.SSSZ | התאריך והשעה שבהם האירוע נשלח לפלטפורמת RCS for Business בפורמט UTC. מידע נוסף על חותמות זמן | 2019-07-25T00:29:07.033Z
|
type
|
מחרוזת | סוג הפעילות:
|
text_message
|
size_bytes
|
מחרוזת | גודל הקבצים שצורפו לפעילות, בבייטים. | 912
|
חותמות זמן
חותמות הזמן ביומני הפעילות מתעדות מתי אירוע נשלח לפלטפורמת RCS לעסקים. במקרה של אירועים שמעבירים תוכן למשתמש, האירוע לא יתועד ביומן הפעילות עד שההודעה תועבר.
לדוגמה, אם הודעת RCS for Business נשלחת למשתמש ביום רביעי בשעה 13:00, והנמען לא מחובר לאינטרנט עד יום ראשון בשעה 9:00, האירוע יופיע ביומן הפעילות שנוצר ליום ראשון, אבל חותמת הזמן תהיה יום רביעי, 13:00.