דוחות חיוב בארה"ב

בדף הזה מתוארים קובצי הנתונים שנוצרים ב-RCS for Business כדי לעזור לספקי סלולר בארה"ב בחיוב ובביקורת במסגרת RBM בארה"ב. מידע נוסף על מסגרת RBM בארה"ב זמין גם באתר usrbm.org.

דוח החיוב הוא דוח נצבר של אירועים שניתן לחייב עליהם בין סוכנים פעילים לבין משתמשים. המונח 'לחיוב' פשוט מציין שאפשר לחייב על אירוע מסוים. ספקי הסלולר קובעים אם לחייב על אירועים שניתנים לחיוב ואיך לחייב עליהם. לכל ספקי הסלולר בארה"ב שמפעילים באופן פעיל את RCS for Business יש גישה לדוחות חיוב.

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

פרטים על מודל סיווג החיובים בארה"ב זמינים בשאלות הנפוצות בנושא חיובים בארה"ב.

יצירת קבצים

מידע נוסף זמין במאמר בנושא יצירת קבצים.

אחסון קבצים וגישה אליהם

מידע נוסף זמין במאמר בנושא אחסון קבצים וגישה אליהם.

זמינות הקובץ

מידע נוסף מופיע בקטע זמינות הקבצים.

דוחות חיוב

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

דוחות החיוב מכילים מידע סודי, אבל לא פרטים אישיים מזהים (PII) של משתמשים, כמו מספר MSISDN, מספר MSISDN מגובב או מזהה ייחודי של משתמש.

הערה: השותפים מקבלים גם דוחות סיכום יומיים מצטברים כדי לעזור להם לנהל את התנועה, וכך הם מקבלים ניתוחים חשובים ושקיפות נדרשת לגבי נתוני התנועה שלהם. מידע נוסף על דוחות חיוב לשותפים

קטגוריות חיוב לעומת אירועים לחיוב

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

• קטגוריית החיוב היא סיווג קבוע שבוחרים כשיוצרים את הסוכן. ההגדרה הזו קובעת את השיטה שלפיה הסוכן יחויב: לפי הודעה (סוכנים לא שיחתיים) או לפי סשן (סוכנים שיחתיים).
• אירועים לחיוב הם אינטראקציות בין סוכן של RCS for Business לבין משתמש, שמתבצע אחריהן מעקב לצורכי חיוב (לדוגמה, rich_message).

קטגוריות חיוב של סוכנים בארה"ב

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

קטגוריית חיוב	סוג הנציג	תרחישים לדוגמה	שיטת החיוב
לא בממשק לשיחה	סוכנים ששולחים בעיקר הודעות חד-כיווניות.	סיסמאות חד-פעמיות התראות שוברי פרסום	החיוב הוא על כל הודעה שנמסרת למשתמש.
שיחה	נציגים שנועדו לנהל שיחות עם משתמשים, בלי קשר למי התחיל את השיחה.	איך מוצאים את המוצר המתאים הזמנת כרטיס פתרון בעיה	חיוב לפי סשן: אם הקריטריונים לסשן מתקיימים, כל ההודעות עם תוכן עשיר והודעות המדיה העשירה שנשלחות במהלך חלון הסשן של 24 שעות יחויבו בתשלום קבוע, ללא קשר לאורך או לפלחים. חיוב לפי הודעה: אם הקריטריונים לסשן לא מתקיימים או שההודעה נשלחת מחוץ לחלון הסשן של 24 שעות, ההודעה תחויב בנפרד לפי תעריף להודעה עם תוכן עשיר או מדיה עשירה, בהתאם למחירון של כל ספק.

סוכנים בממשק שיחה לעומת סוכנים שלא בממשק שיחה

יש שתי קטגוריות לחיוב על סוכנים: קשור לשיחה ולא קשור לשיחה.

• נציגים לא שיחתיים מחויבים על כל הודעה שהם שולחים למשתמש.

  • הקטגוריה הזו מתאימה במיוחד לנציגים שלא צפויים לקבל תשובות בתדירות גבוהה.

• סוכנים שיחתיים מחויבים בתעריף קבוע עבור סשנים, בתנאי שסשן מופעל. התעריף כולל את כל ההודעות שהוחלפו במהלך תקופה של 24 שעות, כולל ההודעות שהפעילו את הסשן. יכול להיות שעדיין תחויבו על הודעות של סוכנים שיכולים לנהל שיחות שלא נשלחו במסגרת סשן של 24 שעות.

  • קטגוריה זו מתאימה במיוחד לסוכנים שמנהלים שיחות רב-שלביות עם משתמשים.

לוגיקה לחיוב על סשנים

במסגרת מודל החיוב בארה"ב, סשן מופעל על ידי רצף של 4 הודעות עשירות או הודעות מולטימדיה עשירות (כולל לפחות 2 הודעות MO ולפחות הודעה אחת MT) שהוחלפו תוך חלון של 24 שעות מההודעה הראשונה ברצף ההודעות להפעלת הסשן. אם הסף הזה מתמלא, כל ההודעות בחלון של 24 שעות יחויבו כסשן אחד. הודעות שלא נכללות בסשן או שלא מפעילות סשן יחויבו לפי התעריף הרגיל להודעה עבור הודעות עשירות או הודעות עם מדיה עשירה, בהתאם למחירון של כל ספק.

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

• הודעה מסוג MT (Mobile Terminated) היא הודעה שנשלחת מהעסק.
• MO (Mobile Originated)‎ היא הודעה או פעולה שהמשתמש יזם.

אירועים לחיוב

זרימות ההודעות מסווגות לפי המקור והכיוון שלהן. כדי לתאר את כיוון תעבורת ההודעות, ספקי סלולר בארה"ב בדרך כלל משתמשים במונחים MT/MO. המונחים האלה תואמים למינוח A2P/P2A שבו נעשה שימוש במסמכי RCS for Business. הנה פירוט קצר של הקשר בין המונחים האלה:

• A2P (Application-to-Person)‎ הוא MT (Mobile Terminated): הודעה שנשלחת על ידי העסק.
• P2A (Person-to-Application) is MO (Mobile Originated): A message or action initiated by the user.

אירוע	תיאור	סוכנים שלא בממשק שיחה	סוכנים בממשק שיחה
a2p_rich_message	הודעה שנשלחה על ידי נציג ומכילה רק טקסט, הצעות לתשובות או הצעות ספציפיות לפעולות (חיוג למספר, פתיחת כתובת URL בדפדפן).	תמיד נחשב כאירוע נפרד לחיוב. החיוב הוא לכל הודעה על סמך פלחים (פלח אחד שווה ל-160 בייטים בקידוד UTF-8).	האירוע נחשב כאירוע נפרד לחיוב, אלא אם הוא הופך לחלק מסשן.
p2a_rich_message	הודעה שהמשתמש שלח ומכילה רק טקסט חופשי או טקסט שהתקבל אחרי הקשה על תשובה מוצעת.	תמיד נחשב כאירוע נפרד לחיוב. החיוב הוא לכל הודעה על סמך פלחים.	האירוע נחשב כאירוע נפרד לחיוב, אלא אם הוא הופך לחלק מסשן.
a2p_rich_media_message	הודעה שנשלחה על ידי נציג ומכילה מדיה (תמונה, סרטון, אודיו), כרטיסים עשירים, קרוסלות או פעולות מורכבות כמו 'הצגת מיקום'.	תמיד נחשב כאירוע נפרד לחיוב. החיוב הוא על אירוע יחיד בתעריף קבוע, ללא קשר לגודל או לתוכן.	האירוע נחשב כאירוע נפרד לחיוב, אלא אם הוא הופך לחלק מסשן.
p2a_rich_media_message	הודעה שנשלחה על ידי משתמש ומכילה קובץ מדיה שהועלה (תמונה, סרטון, אודיו).	תמיד נחשב כאירוע נפרד לחיוב. החיוב הוא על אירוע יחיד בתעריף קבוע.	האירוע נחשב כאירוע נפרד לחיוב, אלא אם הוא הופך לחלק מסשן.
p2a_suggested_action	משתמש מקיש על הצעה לפעולה כלשהי (למשל, 'הצגת המיקום') שאינה הצעה לתשובה.	תמיד נחשב כאירוע נפרד לחיוב. מערכת Google Ads יוצרת אירוע אחד לחיוב על כל קליק.	הקליק נחשב לאירוע לחיוב בפני עצמו, ומייצר אירוע לחיוב אחד לכל קליק, אלא אם הוא הופך לחלק מסשן.
a2p_session	חלון אינטראקציה של 24 שעות שמתחיל כשמופעל טריגר לסשן וההודעה הראשונה היא MT. מידע נוסף זמין במאמר מהו סשן ואיך הוא פועל.	לא רלוונטית. המושג 'סשנים' לא רלוונטי לסוכנים שאינם סוכני צ'אט.	אחרי ההפעלה, כל ההודעות בחלון של 24 שעות מכוסות על ידי עמלה אחת על סשן. כל אירוע שמחייב בתשלום בסשן של 24 שעות ישויך למזהה האירוע שמחייב בתשלום של הסשן.
p2a_session	חלון אינטראקציה של 24 שעות שמתחיל כשמופעל טריגר לסשן וההודעה הראשונה היא MO. מידע נוסף זמין במאמר מהו סשן ואיך הוא פועל.	לא רלוונטית. המושג 'סשנים' לא רלוונטי לסוכנים שאינם סוכני צ'אט.	אחרי ההפעלה, כל ההודעות בחלון של 24 שעות מכוסות על ידי עמלה אחת על סשן. כל אירוע שמחייב בתשלום בסשן של 24 שעות ישויך למזהה האירוע שמחייב בתשלום של הסשן.

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

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

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

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

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

כל שורה בדוח היא רשומה שמייצגת אירוע יחיד שניתן לחיוב. סשנים של A2P/P2A מיוצגים על ידי כמה שורות – שורה אחת לכל הודעה שהועברה. בכל שורה שמשויכת לסשן (עם אותו billing_event_id), ידווח המספר הכולל של הודעות MT ו-MO עבור חלון הסשן של 24 שעות בעמודות mt_messages ו-mo_messages.

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

שדה	פורמט	תיאור	דוגמה
billing_event_id	מחרוזת	מזהה שנוצר כדי להבחין בין אירועים שניתנים לחיוב. לכל ההודעות ששייכות לאותו סשן יהיה אותו billing_event_id.	63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e
type	מחרוזת	סוג האירוע: a2p_rich_message a2p_rich_media_message p2a_rich_message p2a_rich_media_message p2a_suggested_action	p2a_rich_message
agent_id	מחרוזת	מזהה ייחודי של הסוכן שהשתתף באירוע.	[e-mail]
agent_owner	מחרוזת	כתובת האימייל של הבעלים הנוכחי של חשבון השותף שבו נוצר הסוכן.	[e-mail]
billing_party	מחרוזת	הגורם שמחייב על אירועים.	ספק
max_duration_single_message	number	הזמן המקסימלי (בשעות) שמוקצב למשתמש להגיב להודעה מסוכן לפני שחלון פתיחת השיחה נסגר וההודעה מסווגת כאירוע single_message. לא רלוונטי למודל בארה"ב לגבי הודעות עשירות נפרדות.	24
max_duration_a2p_conversation	number	בפיילוט של סשנים, הערך הזה משקף את חלון הסשן של 24 שעות שנמדד מההודעה הראשונה ברצף ההודעות של הטריגר. המשך נמדד בשעות.	24
max_duration_p2a_conversation	number	בפיילוט של סשנים, הערך הזה משקף את חלון הסשן של 24 שעות שנמדד מההודעה הראשונה ברצף ההודעות של הטריגר.	24
start_time	YYYY-mm-ddTHH:00:00Z	התאריך והשעה שבהם האירוע התחיל לפי שעון UTC (פורמט ISO 8601). במקרה של סשנים, זו חותמת הזמן של ההודעה הראשונה ברצף ההפעלה. A2P באירועים שלא משויכים לסשן, כמו a2p_rich_message ו-a2p_rich_media_message, זה הזמן שבו ההודעה נמסרה למשתמש. באירוע a2p_session, זהו הזמן שבו ההודעה הראשונה בשיחה מועברת למשתמש. P2A עבור אירועים שלא קשורים לסשן, כמו p2a_rich_message ו-p2a_rich_media_message, זהו הזמן שבו המשתמש שולח את ההודעה. באירוע p2a_session, זהו הזמן שבו המשתמש שולח את ההודעה הראשונה בשיחה.	2025-05-20T08:00:00Z
duration	number	המשך מתייחס רק לסשנים ונמדד בדקות. אם האירוע הוא לא אירוע ברמת הסשן, הערך הוא 0.	45
mt_messages	number	מספר ההודעות שהתקבלו בנייד (A2P) באירוע. בסשנים, כל שורה עם אותו billing_event_id מציגה את המספר הכולל של הודעות MT בסשן כולו.	5
mo_messages	number	מספר ההודעות שהמשתמשים שלחו (P2A) באירוע. בסשנים, כל שורה עם אותו billing_event_id מציגה את המספר הכולל של הודעות MO בסשן כולו.	3
size_kilobytes	number	גודל כל הקבצים שמצורפים להודעות באירוע, מעוגל לקילובייט הקרוב (1KB שווה ל-1,024 בייטים).	912
agent_name	מחרוזת	שם הנציג שהשתתף באירוע.	ACME Brand
owner_name	מחרוזת	השם של הבעלים הנוכחי של חשבון השותף שבו נוצר הנציג.	XYZ Aggregator
segment_count	number	מספר הפלחים המחושב לאירועים a2p_rich_message events ו-p2a_rich_message (פלח אחד שווה ל-160 בייטים בקידוד UTF-8). אם האירוע לא נכלל ברשימה, הערך הוא 0.	5
session_type	מחרוזת	סוג הסשן: a2p_session p2a_session הערך יהיה ריק אם הפעילות לא עומדת בדרישות להגדרה כסשן.	a2p_session

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

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

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

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

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