בדף הזה מתוארים קובצי הנתונים שנוצרים ב-RCS לעסקים כדי לסייע לספקי סלולר בחיוב ובביקורת. אפשר לעיין בשאלות הנפוצות בנושא חיוב כדי לקבל תשובות לשאלות נפוצות על מודל החיוב של RCS לעסקים.
| קובץ | תיאור | למי יש גישה |
|---|---|---|
| דוח אירועי חיוב | דוח נצבר של אירועים שניתנים לחיוב בין סוכנים שהופעלו לבין משתמשים. | כל ספקי הסלולר שמפעילים באופן פעיל את RCS לעסקים. |
| יומן פעילות | יומן נתונים גולמיים של פעילות ב-RCS Business Messaging, כולל אירועים לחיוב. | ספקי סלולר שמפעילים באופן פעיל את RCS לעסקים ומפעילים את שירות RCS של Google בכפוף לתנאים ולהגבלות שלהם. |
יצירת קבצים
כל קובץ נתונים מייצג יום אחד של שימוש ב-RCS לעסקים לפי זמן אוניברסלי מתואם (UTC). הקבצים נוצרים מדי יום. תהליך היצירה יכול להימשך כמה שעות, וזמן ההשלמה עשוי להשתנות.
בסוכנים שלא מנהלים שיחות, הקבצים מכילים נתונים מהתקופה של 24 שעות שקדמה לזמן יצירת הקובץ. לדוגמה, אם דוח אירועי חיוב נוצר ב-5 במאי בשעה 11:00 (שעון UTC), הוא יכיל נתונים מ-4 במאי בשעה 11:00 (שעון UTC) עד 5 במאי בשעה 11:00 (שעון UTC).
בסוכני שיחה, הקבצים מכילים נתונים מהתקופה של 24 שעות, יום עד יומיים לפני מועד יצירת הקובץ. לדוגמה, אם דוח על אירועי חיוב נוצר ב-5 במאי בשעה 11:00 (שעון UTC), יכול להיות שהוא יכיל נתונים מ-3 במאי בשעה 11:00 (שעון UTC) עד 4 במאי בשעה 11:00 (שעון UTC).
הסיבה לעיכוב היא שפעילות RCS for Business של נציגי שירות מבוססי-צ'אט מקושרת לשיחות, והתהליך הזה יכול להימשך עד 48 שעות. העיכוב הזה מאפשר ל-RCS for Business לתעד את כל ההודעות בשיחה לפני חישוב אירוע החיוב. מידע נוסף על סוכנים בממשק שיחה זמין במאמר קטגוריות חיוב של סוכנים.
נקודות עיקריות:
אין פעילות: אם לא הייתה פעילות בפלטפורמה ביום מסוים, לא נוצר קובץ.
שם הקובץ: התאריך בשם הקובץ הוא התאריך שבו הקובץ נוצר, ולא התאריך של הנתונים שבקובץ.
שמירה: הקבצים מאוחסנים למשך 63 ימים לכל היותר לפני שהם נמחקים.
אתם יכולים להשתמש בקבצים האלה כדי לעדכן את מחסן הנתונים (data warehouse) שלכם עם מדדי השימוש העדכניים בפלטפורמה.
אחסון קבצים וגישה אליהם
קבצי הנתונים מוצפנים כשהם מאוחסנים וכשהם מועברים.
כדי לאחזר קובצי נתונים באמצעות פרוטוקול מאובטח להעברת קבצים (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 לעסקים לדיווח, לא ייווצר קובץ. כלומר, יכול להיות שבימים מסוימים לא ייווצרו קבצים. אם אתם צריכים קבצים ריקים כדי לייעל את התהליך, אפשר לפנות אלינו בכתובת rbm-support@google.com.
דוחות על אירועי חיוב
דוחות על אירועי חיוב הם רשומות של אירועי חיוב, שמחושבים על סמך קטגוריית החיוב של הסוכן וסוג ההודעות שהוא שולח. דוחות על אירועי חיוב זמינים לכל הספקים שמפעילים באופן פעיל RCS לעסקים.
דוחות על אירועים שקשורים לחיוב מכילים מידע סודי, אבל לא פרטים אישיים מזהים (PII) של משתמשים, כמו מספר MSISDN, מספר MSISDN מגובב או כל מזהה ייחודי של משתמש.
קטגוריות חיוב של נציגים
כשיוצרים סוכן, הבעלים מגדיר את קטגוריית החיוב שלו על סמך אופן האינטראקציה של הסוכן עם המשתמשים. קטגוריית החיוב לא מגבילה את מספר ההודעות שהסוכן יכול לשלוח או את סוג ההודעות. אבל הוא קובע איך יחויב הנציג על ההודעות. בטבלה הבאה מפורטות שתי קטגוריות החיוב העיקריות.
| קטגוריית חיוב | סוג הנציג | תרחישים לדוגמה | שיטת החיוב |
|---|---|---|---|
לא שיחתי (כולל את הקטגוריות Basic Message ו-Single Message הערה: אין יותר הבדל בין שתי הקטגוריות האלה. נציג בכל אחת מהקטגוריות יחויב כנציג שאינו מנהל שיחה). |
סוכנים ששולחים בעיקר הודעות חד-כיווניות. |
|
החיוב הוא על כל הודעה שנמסרת למשתמש. |
| שיחה | נציגים שנועדו לנהל שיחות עם משתמשים. |
|
חיוב לפי שיחה: אם אחד מהצדדים (הנציג או המשתמש) משיב להודעה מהצד השני תוך 24 שעות, מתחילה שיחה. במהלך חלון השיחה (24 שעות אחרי התגובה הראשונה), הנציג והמשתמש יכולים להחליף ביניהם כל מספר של הודעות, והנציג יחויב בתעריף קבוע על השיחה. חיוב לפי הודעה: אם הסוכן שולח הודעה והמשתמש לא משיב לה בתוך 24 שעות, הסוכן יחויב על ההודעה הספציפית, בדומה לסוכן שאינו מנהל שיחה. |
בתרשים הבא מוצגת דוגמה לסשן לחיוב של A2P עבור סוכנים וירטואליים:
סוכנים בממשק שיחה לעומת סוכנים שאינם בממשק שיחה
יש שתי קטגוריות חיוב עיקריות: שיחות ואינטראקציות שאינן שיחות. הקטגוריה 'לא שיחה' כוללת את הקטגוריות 'הודעה בסיסית' ו'הודעה יחידה', שהן זהות מבחינת הפונקציונליות. סוכן בכל אחת מהקטגוריות האלה מחויב כסוכן שאינו סוכן בממשק שיחה.
ההבדל העיקרי בין קטגוריות החיוב הוא בין סוכנים לשיחה לבין סוכנים שלא מנהלים שיחה:
סוכנים שאינם שיחתיים מחויבים על כל הודעה שהם שולחים למשתמש.
- הקטגוריה הזו מתאימה במיוחד לנציגים שלא מצפים לתשובות תכופות.
סוכנים וירטואליים לשיחות מחויבים בתעריף קבוע עבור שיחות, שכוללות את כל ההודעות שהוחלפו במהלך 24 שעות.
- הקטגוריה הזו מתאימה במיוחד לנציגים שמנהלים שיחות מרובות עם משתמשים.
אירועים לחיוב
חמישה סוגים שונים של אירועי חיוב נרשמים בדוחות של אירועי החיוב. האירועים האלה כוללים הודעות A2P ו-P2A.
- A2P (Application-to-Person): נשלחת על ידי העסק.
- P2A (Person-to-Application): נשלחת על ידי המשתמש.
בטבלה הבאה מתואר כל אירוע חיוב בהקשר של סוכנים לא שיחתיים וסוכנים שיחתיים.
| אירוע | תיאור | סוכנים שאינם בממשק שיחה | צ'אט בוטים |
|---|---|---|---|
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 שעות. |
אירועי חיוב לעומת קטגוריות חיוב
חשוב לא להתבלבל בין אירועי החיוב basic_message ו-single_message לבין קטגוריות החיוב 'הודעה בסיסית' ו'הודעה בודדת'.
כל נציג (לא משנה קטגוריית החיוב שלו) יכול ליצור אירועי חיוב של
basic_messageושלsingle_message.קטגוריות החיוב 'הודעה בסיסית' ו'הודעה יחידה' משמשות לסיווג של סוכנים לא שיחתיים. סוכנים בקטגוריות החיוב האלה לא יוצרים אירועי חיוב של שיחות (
a2p_conversationsאוp2a_conversations). במקום זאת, הם יוצרים אירועי חיוב נפרדים שלbasic_message,single_messageו-p2a_message.
יצירת דוח חיוב
רק סוכנים עם תנועה שאינה תנועת בדיקה יוצרים אירועי חיוב. פעילות ממספרי טלפון לבדיקה לא מופיעה בדוחות של אירועי חיוב.
בדוחות האלה מניחים שהחיוב על האירועים מתבצע כשההודעות נמסרות, ולא כשהן נשלחות. הודעה שלא נמסרה או הודעה שבוטלה לפני המסירה לא מפעילות אירוע חיוב.
פורמט דוח החיוב
דוחות אירועי חיוב משתמשים בפורמט שם הקובץ rbm_billable_events_YYYY-MM-DD.csv. התאריך בשם הקובץ הוא תאריך יצירת הקובץ.
כל שורה בדוח היא רשומה שמייצגת אירוע חיוב יחיד. השדות ברשומה מופרדים באמצעות Tab. לדוגמה, שתי שיחות A2P עם אותו נציג ייצרו שני אירועים לחיוב ושתי רשומות בדוח האירועים לחיוב.
כל רשומה בדוח מכילה את הפרטים הבאים לגבי כל אירוע שקשור לחיוב:
| שדה | פורמט | תיאור | דוגמה |
|---|---|---|---|
billing_event_id
|
מחרוזת | מזהה UUID. מספר אקראי שנוצר לכל אירוע חדש בזמן היצירה שלו. | 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 | משך האירוע, מעוגל לדקה הקרובה ביותר.
כאשר סוג האירוע הוא |
45
|
mt_messages
|
number | מספר ההודעות מסוג A2P (אפליקציה לטלפון) באירוע. | 11
|
mo_messages
|
number | מספר ההודעות שהמשתמשים שלחו לעסקים (P2A) באירוע. | 9
|
size_kilobytes
|
number | גודל כל הקבצים שמצורפים להודעות באירוע, מעוגל לקילובייט הקרוב ביותר (1KB = 1024 בייט). | 912
|
agent_name
|
מחרוזת |
שם הנציג שהשתתף באירוע. |
XYZ Mobile USA
|
owner_name
|
מחרוזת | השם של הבעלים הנוכחי של חשבון השותף שבו נוצר הנציג. | XYZ Mobile
|
דוגמה לדוח אירועי חיוב
אפשר להוריד קובץ לדוגמה של דוח חיוב.
גודל קובץ אופייני
הגודל של דוח יומי משותף פעיל של RCS לעסקים תלוי בכמות הפעילות שהוא יצר ברשת של הספק. לדוגמה, אם יש 53,000 רשומות בדוח, גודל הקובץ יהיה בערך 8MB.
יומני פעילות
יומני הפעילות מספקים נתונים גולמיים על הפעילות בפלטפורמת RCS לעסקים. אפשר להשתמש ביומנים האלה כדי לבדוק אירועים שקשורים לחיוב וליצור אירועים בהתאמה אישית.
הערה: רק תנועה ממספרי טלפון שלא משמשים לבדיקות נכללת ביומני הפעילות.
יומני הפעילות מכילים פרטים אישיים מזהים (PII), כמו פרטי עסקאות מפורטים ומספרי MSISDN של מנויים, ולכן הם זמינים רק כשספק סלולר מפעיל RCS בהתאם לתנאים ולהגבלות שלו. אם יש לכם תנועה של RCS לעסקים ברשתות שלכם והפעלתם פעילות RCS באמצעות Google RCS בהתאם לתנאים ולהגבלות של Google, לא תהיה לכם גישה ליומני הפעילות.
הפורמט של יומן הפעילות
יומני הפעילות משתמשים בפורמט שם הקובץ rbm_activity_YYYY-MM-DD.csv. התאריך בשם הקובץ הוא התאריך שבו הקובץ נוצר.
השדות ברשומה מופרדים בטאבים, ויש רשומה אחת בכל שורה.
כל רשומה ביומן הפעילות מכילה את השדות הבאים לכל פעילות:
| שדה | פורמט | תיאור | דוגמה |
|---|---|---|---|
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 לעסקים בפורמט UTC. מידע נוסף מופיע בקטע חותמות זמן. | 2019-07-25T00:29:07.033Z
|
type
|
מחרוזת | סוג הפעילות:
|
text_message
|
size_bytes
|
מחרוזת | גודל הקבצים שצורפו לפעילות, בבייטים. | 912
|
חותמות זמן
חותמות הזמן ביומני הפעילות מתעדות את המועד שבו אירוע נשלח לפלטפורמת RCS לעסקים. באירועים שבהם התוכן מועבר למשתמש, האירוע לא יתועד ביומן הפעילות עד שההודעה תועבר.
לדוגמה, אם הודעה ב-RCS לעסקים נשלחת למשתמש ביום רביעי בשעה 13:00, והנמען לא מחובר לאינטרנט עד יום ראשון בשעה 9:00, האירוע יופיע ביומן הפעילות שנוצר ליום ראשון, אבל חותמת הזמן תהיה יום רביעי, 13:00.