דוחות חיוב ויומני פעילות

במאמר הזה מוסבר על קובצי הנתונים שנוצרים ב-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 לעסקים לתעד את כל ההודעות בשיחה לפני חישוב האירוע שניתן לחיוב. מידע נוסף על סוכנים בממשק שיחה זמין במאמר קטגוריות חיוב של סוכנים.

הערה: הדוחות עשויים לכלול גם נתונים מ-30 הימים הקודמים (גם לגבי סוכנים שיש להם יכולת ניהול שיחה וגם לגבי סוכנים שאין להם יכולת כזו). החיוב מבוסס על זמן המסירה, ולכן אם הודעה נשלחה ב-10 באפריל אבל נמסרה ב-4 במאי, היא תופיע בדוח שנוצר ב-5 במאי.

נקודות עיקריות:

• אין פעילות: כברירת מחדל, אם לא הייתה פעילות בפלטפורמה ביום מסוים, לא נוצר קובץ. עם זאת, אם צריך, אפשר להפעיל את האפשרות לקבל קבצים ריקים. כדי להצטרף, אפשר לשלוח אימייל לכתובת [e-mail].
• שם הקובץ: התאריך בשם הקובץ הוא התאריך שבו הקובץ נוצר, ולא התאריך של הנתונים שבקובץ.
• שמירה: הקבצים מאוחסנים למשך 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 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	מחרוזת	סוג האירוע: מודל חיוב רגיל basic_message single_message a2p_conversation p2a_conversation p2a_message מודל חיוב בארה"ב a2P_rich_message a2p_rich_media_message p2a_rich_message p2a_rich_media_message p2a_suggested_action	single_message p2a_rich_message
agent_id	מחרוזת	מזהה ייחודי של הסוכן שהשתתף באירוע.	[e-mail]
agent_owner	מחרוזת	כתובת האימייל של הבעלים הנוכחי של חשבון השותף שבו נוצר הנציג.	[e-mail]
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 באירועים single_message ו-basic_message, זהו הזמן שבו ההודעה נמסרה למשתמש. באירוע a2p_conversation, זהו הזמן שבו ההודעה הראשונה בשיחה מועברת למשתמש. הודעות מסוג P2A באירועים single_message ו-basic_message, זהו הזמן שבו המשתמש שולח את ההודעה. באירוע p2a_conversation, זה הזמן שבו המשתמש שולח את ההודעה הראשונה בשיחה.	2019-07-25T08:00:00Z
duration	number	משך האירוע, מעוגל לדקה הקרובה ביותר. הערך הוא 0 לכל אירוע שאינו אירוע שיחה.	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
segment_count	number	מודל החיוב בארה"ב בלבד מספר הפלחים המחושב עבור RICH_MESSAGE אירועים.	5

דוח חיוב לדוגמה

אפשר להוריד דוחות לדוגמה:

• דוח חיוב למודל חיוב רגיל
• דוח חיוב למודל חיוב בארה"ב

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

הגודל של דוח יומי משותף פעיל של 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	מחרוזת	מזהה ייחודי של הסוכן.	[e-mail]
user_id	מחרוזת	מספר ה-MSISDN של המשתמש.	918369110173
direction	מחרוזת	הכיוון שבו ההודעה נשלחת: ‫MT (mobile terminating) לפעילויות של סוכן מול משתמש ‫MO (mobile originating) לפעילויות של משתמשים עם סוכנים	MT
time	YYYY-mm-ddTHH:MM:SS.SSSZ	התאריך והשעה שבהם האירוע נשלח לפלטפורמת RCS for Business בפורמט UTC. מידע נוסף מופיע בקטע חותמות זמן.	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

חותמות זמן

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

לדוגמה, אם הודעה ב-RCS לעסקים נשלחת למשתמש ביום רביעי בשעה 13:00, והנמען לא מחובר לאינטרנט עד יום ראשון בשעה 9:00, האירוע יופיע ביומן הפעילות שנוצר ליום ראשון, אבל חותמת הזמן תהיה יום רביעי, 13:00.