במאמר הזה מוסבר על קובצי הנתונים שנוצרים ב-RCS for Business כדי לסייע לחברות סלולר בחיוב ובביקורת.
| קובץ | תיאור | למי יש גישה |
|---|---|---|
| דוח חיוב | דוח נצבר של אירועים לחיוב בין סוכנים למשתמשים שהפעילו את הסוכנים. | כל ספקי הסלולר שמפעילים באופן פעיל את RCS for Business. |
| יומן פעילות | יומן נתונים גולמיים של פעילות ב-RCS for Business, כולל אירועים לחיוב. | ספקי סלולר שמפעילים באופן פעיל את RCS לעסקים ומפעילים את שירות 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 לעסקים לתעד את כל ההודעות בשיחה לפני חישוב האירוע שניתן לחיוב. מידע נוסף על סוכנים בממשק שיחה זמין במאמר קטגוריות של חיובים על סוכנים.
נקודות עיקריות:
- אין פעילות: כברירת מחדל, לא נוצר קובץ אם לא הייתה פעילות בפלטפורמה ביום מסוים. עם זאת, אפשר להפעיל את האפשרות לקבל קבצים ריקים אם צריך. כדי להצטרף, אפשר לשלוח אימייל לכתובת 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 לעסקים.
דוחות החיוב מכילים מידע סודי, אבל לא פרטים אישיים מזהים (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 עם אותו סוכן ייצרו שני אירועים נפרדים לחיוב ושני רשומות בדוח החיוב.
כל רשומה בדוח מכילה את הפרטים הבאים לגבי כל אירוע שניתן לחיוב.
| שדה | פורמט | תיאור | דוגמה |
|---|---|---|---|
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 | משך הזמן המקסימלי של שיחה מטלפון ל-Alexa, בשעות. הזמן נמדד מההודעה הראשונה של המשתמש בשיחה. | 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), כמו פרטי עסקאות מפורטים ומספרי MSISDN של מנויים, ולכן הם זמינים רק כשספק סלולר מפעיל את RCS בהתאם לתנאים ולהגבלות שלו. אם יש לכם תנועה של RCS for Business ברשתות שלכם והפעלתם פעילות 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 for Business בפורמט UTC. מידע נוסף מופיע בקטע חותמות זמן. | 2019-07-25T00:29:07.033Z
|
type
|
מחרוזת | סוג הפעילות:
|
text_message
|
size_bytes
|
מחרוזת | גודל הקבצים שצורפו לפעילות, בבייטים. | 912
|
חותמות זמן
חותמות הזמן ביומני הפעילות מתעדות את המועד שבו אירוע נשלח לפלטפורמת RCS לעסקים. באירועים שבהם התוכן מועבר למשתמש, האירוע לא יתועד ביומן הפעילות עד שההודעה תועבר.
לדוגמה, אם הודעה ב-RCS לעסקים נשלחת למשתמש ביום רביעי בשעה 13:00, והנמען לא מחובר לאינטרנט עד יום ראשון בשעה 9:00, האירוע יופיע ביומן הפעילות שנוצר ליום ראשון, אבל חותמת הזמן תהיה יום רביעי, 13:00.