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

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

הקבצים מקודדים ב-UTF-8 בלי סימן סדר בתים, ונעשה בהם שימוש במעברי שורה לסיום השורות. השורה הראשונה בכל קובץ היא שורת כותרת עם שמות השדות.

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

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