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

בדף הזה מתוארים קובצי הנתונים שנוצרים ב-RCS לעסקים כדי לסייע לחברות הסלולר בחיוב ובביקורת.

קובץ תיאור למי יש גישה
דוח חיוב דוח נצבר של אירועים שניתנים לחיוב בין סוכנים שהופעלו לבין משתמשים. כל ספקי הסלולר שמפעילים באופן פעיל את שירותי RCS לעסקים.
יומן פעילות יומן נתונים גולמיים של פעילות ב-RCS לעסקים, כולל אירועים לחיוב. ספקי סלולר שמפעילים באופן פעיל את RCS לעסקים ומפעילים את שירות RCS של Google בכפוף לתנאים ולהגבלות שלהם.

ב-RCS לעסקים יש שני מודלים לחיוב: מודל החיוב הרגיל לתנועה שאינה בארה"ב ומודל החיוב בארה"ב לתנועה בארה"ב. מידע שייחודי למודל הרגיל או למודל בארה"ב (לדוגמה, סיווגים שונים של אירועים לחיוב או שדות דוח שונים) מצוין באופן מפורש.

יצירת קבצים

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

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

  • אין פעילות: אם לא הייתה פעילות בפלטפורמה ביום מסוים, לא נוצר קובץ.

  • שם הקובץ: התאריך בשם הקובץ הוא התאריך שבו הקובץ נוצר, ולא התאריך של הנתונים שבקובץ.

  • שמירה: הקבצים מאוחסנים למשך 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 לעסקים לדיווח, לא ייווצר קובץ. המשמעות היא שיכול להיות שבימים מסוימים לא ייווצרו קבצים. אם אתם צריכים קבצים ריקים כדי לייעל את התהליך, אתם יכולים לפנות לכתובת rbm-support@google.com.

דוחות חיוב

דוחות חיוב הם רשומות של אירועים שניתנים לחיוב, שמחושבים על סמך קטגוריית החיוב של הסוכן וסוג ההודעות שהוא שולח. דוחות חיוב זמינים לכל הספקים שמפעילים באופן פעיל 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 לעסקים לבין משתמש, שמערכת החיוב עוקבת אחריהן (לדוגמה, basic_message,‏ single_message,‏ a2p_conversation).

יצירת דוח חיוב

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

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

פורמט דוח החיוב

דוחות החיוב משתמשים בפורמט שם הקובץ rbm_billable_events_YYYY-MM-DD.csv. התאריך בשם הקובץ הוא תאריך יצירת הקובץ.

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

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

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

p2a_rich_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

  • באירועים single_message ו-basic_message, זהו הזמן שבו ההודעה נמסרה למשתמש.
  • באירוע a2p_conversation, זהו הזמן שבו ההודעה הראשונה בשיחה מועברת למשתמש.

הודעות מסוג P2A

  • באירועים single_message ו-basic_message, זהו הזמן שבו המשתמש שולח את ההודעה.
  • באירוע p2a_conversation, זה הזמן שבו המשתמש שולח את ההודעה הראשונה בשיחה.
 2019-07-25T08:00:00Z
duration number משך האירוע, מעוגל לדקה הקרובה ביותר.

כשסוג האירוע הוא single_message או basic_message, הערך הוא 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 לעסקים. אפשר להשתמש ביומנים האלה כדי לבדוק אירועים שקשורים לחיוב וליצור אירועים בהתאמה אישית.

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

יומני הפעילות מכילים פרטים אישיים מזהים (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 (סיום שיחה בנייד) לפעילויות של סוכן מול משתמש
  • ‫MO (mobile originating) לפעילויות של משתמשים עם סוכנים
 MT
time YYYY-mm-ddTHH:MM:SS.SSSZ התאריך והשעה שבהם האירוע נשלח לפלטפורמת RCS לעסקים בפורמט 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.