דף זה מתאר את קבצי הנתונים ש-RCS for Business יוצר כדי לסייע לספקי שירותים אמריקאים בחיוב וביקורת במסגרת מסגרת RBM האמריקאית. למידע נוסף על מסגרת RBM האמריקאית, ניתן גם לעיין באתר usrbm.org .
דוח חיוב הוא דוח מצטבר של אירועים לחיוב בין סוכנים שהושקו ומשתמשים. לחיוב פירושו פשוט שאירוע זכאי לחיוב. הספקים קובעים האם וכיצד יחויבו אירועים לחיוב. לכל הספקים בארה"ב המפעילים באופן פעיל RCS לעסקים יש גישה לדוחות חיוב.
לפרטים על מודל סיווגי חיוב בארה"ב, עיינו בשאלות הנפוצות בנושא חיוב בארה"ב .
יצירת קבצים
למידע נוסף, ראה יצירת קבצים .
אחסון קבצים וגישה אליהם
למידע נוסף, ראה אחסון קבצים וגישה אליהם .
זמינות הקבצים
למידע נוסף, ראה זמינות קבצים .
דוחות חיוב
דוחות חיוב הם רישומים של אירועים לחיוב , המחושבים על סמך קטגוריית החיוב של הסוכן וסוג ההודעות שהוא שולח. דוחות חיוב זמינים לכל הספקים המפעילים באופן פעיל RCS לעסקים.
דוחות חיוב מכילים מידע סודי, אך אינם מכילים מידע אישי מזהה (PII) של המשתמש, כגון MSISDN, MSISDN מגובב או כל מזהה ייחודי של המשתמש.
קטגוריות חיוב לעומת אירועים לחיוב
ההבחנה בין קטגוריות חיוב של סוכנים לבין אירועים לחיוב היא המפתח להבנת האופן שבו הסוכן שלך לחיוב.
- קטגוריית חיוב היא סיווג קבוע שתבחרו בעת יצירת הסוכן שלכם. היא קובעת את השיטה שבה הסוכן שלכם מחויב: לפי הודעה (סוכנים שאינם מנהלים שיחה) או לפי סשן (סוכני שיחה).
- אירועים לחיוב הם אינטראקציות בין סוכן RCS for Business למשתמש שעוקבים אחריהן למטרות חיוב (לדוגמה,
rich_message).
קטגוריות חיוב של סוכנים בארה"ב
בעת יצירת סוכן, הבעלים קובע את קטגוריית החיוב שלו בהתבסס על האופן שבו הסוכן יתקשר עם משתמשים. קטגוריית החיוב אינה מגבילה את מספר ההודעות או את סוגן שסוכן יכול לשלוח. אך היא כן קובעת כיצד הסוכן יחויב עבור הודעות. שתי קטגוריות החיוב העיקריות מתוארות בטבלה הבאה.
| קטגוריית חיוב | סוג הסוכן | מקרי שימוש לדוגמה | שיטת חיוב |
|---|---|---|---|
| לא שיחה | סוכנים ששולחים בעיקר הודעות חד כיווניות. |
| ניתן לחיוב עבור כל הודעה שנשלחה למשתמש. |
| שיחה | סוכנים שנועדו לחילופי דברים הלוך ושוב עם משתמשים ללא קשר למי שמתחיל את השיחה. |
| לחיוב לפי סשן : אם קריטריוני הסשן מתקיימים, כל הודעות המדיה העשירה והודעות המדיה העשירה בחלון הסשן של 24 שעות יהיו ניתנות לחיוב בתעריף קבוע, ללא קשר לאורך או לקטעים. לחיוב לפי הודעה : אם קריטריוני הסשן אינם עומדים או שהודעה נמצאת מחוץ לחלון הסשן של 24 שעות, ההודעה מחויבת בנפרד בתעריף לפי הודעה עבור מדיה עשירה או מדיה עשירה בהתאם לטבלת התעריפים של הספק. |
סוכנים שיחתיים לעומת סוכנים לא שיחתיים
ישנן שתי קטגוריות חיוב של סוכנים: חיוב שיחה וחיוב שאינו שיחה.
סוכנים שאינם מנהלים שיחה חייבים בתשלום עבור כל הודעה שהם מספקים למשתמש.
- קטגוריה זו מתאימה ביותר לסוכנים שאינם מצפים לתשובות תכופות.
סוכני שיחה מחויבים בתעריף קבוע עבור סשן/ות , בתנאי שהסשן הופעל. התעריף יכלול את כל ההודעות שהוחלפו במהלך פרק זמן של 24 שעות, כולל ההודעות שהפעילו את הסשן. סוכני שיחה עדיין עשויים לגבות חיובים עבור הודעות שאינן חלק מסשן של 24 שעות.
- קטגוריה זו מתאימה ביותר לסוכנים שמנהלים שיחות מרובות תורות עם משתמשים.
לוגיקת חיוב של סשן
במסגרת מודל החיוב בארה"ב, סשן מופעל על ידי רצף של 4 הודעות מדיה עשירה או עשירה (כולל לפחות 2 הודעות MO ולפחות הודעה אחת MT) המוחלפות בחלון של 24 שעות מההודעה הראשונה ברצף ההפעלה. לאחר עמידה בסף זה, כל ההודעות בחלון של 24 שעות זה מחויבות כסשן יחיד . כל הודעה שנופלת מחוץ לסשן או לא מצליחה להפעילו מחויבת בתעריף הסטנדרטי להודעה עבור מדיה עשירה או עשירה, בהתאם למחירון של הספק.
התרשים הבא מציג דוגמה לסשן חיוב A2P עבור סוכני שיחה.
- MT (Mobile Terminated) היא הודעה שנשלחת על ידי העסק.
- MO (מובייל מקורו) היא הודעה או פעולה שיזמה המשתמש.
אירועים לחיוב
זרימת הודעות מסווגת לפי מקורה וכיוונה. כדי לתאר את כיוון תעבורת ההודעות, ספקי שירותי תקשורת בארה"ב משתמשים בדרך כלל בטרמינולוגיה של MT/MO . מונחים אלה תואמים לטרמינולוגיה של A2P/P2A המשמשת בכל תיעוד RCS for Business. להלן פירוט קצר של האופן שבו מונחים אלה מתחברים:
- A2P (אפליקציה לאדם) הוא MT (סיום נייד) : הודעה שנשלחת על ידי העסק.
- P2A (אדם לאפליקציה) הוא MO (מקור נייד) : הודעה או פעולה שיזום המשתמש.
| מִקרֶה | תֵאוּר | סוכנים שאינם מנהלים שיחה | סוכני שיחה |
|---|---|---|---|
a2p_rich_message | הודעה שנשלחה על ידי סוכן המכילה רק טקסט, תשובות מוצעות או פעולות מוצעות ספציפיות (חייג למספר, פתיחת כתובת URL בדפדפן). | תמיד מטופל כאירוע לחיוב בודד. ניתן לחיוב לפי הודעה בהתבסס על מקטעים (מקטע אחד שווה ל-160 בתים של UTF-8). | נחשב לאירוע בודד לחיוב אלא אם כן הוא הופך לחלק מפגישה. |
p2a_rich_message | הודעה שנשלחה על ידי משתמש המכילה טקסט חופשי בלבד או טקסט שנוצר כתוצאה מהקשה על הצעה לתשובה. | תמיד מטופל כאירוע לחיוב בודד. לחיוב לפי הודעה בהתבסס על פלחים. | נחשב לאירוע בודד לחיוב אלא אם כן הוא הופך לחלק מפגישה. |
a2p_rich_media_message | הודעה שנשלחה על ידי סוכן המכילה מדיה (תמונה, וידאו, אודיו), כרטיסי מדיה עשירים, קרוסלות או פעולות מורכבות כמו "הצג מיקום". | תמיד מטופל כאירוע לחיוב בודד. לחיוב כאירוע בודד בתעריף קבוע, ללא קשר לגודל או לתוכן. | נחשב לאירוע בודד לחיוב אלא אם כן הוא הופך לחלק מפגישה. |
p2a_rich_media_message | הודעה שנשלחה על ידי משתמש המכילה קובץ מדיה שהועלה (תמונה, וידאו, אודיו). | תמיד מטופל כאירוע לחיוב בודד. לחיוב כאירוע בודד בתעריף קבוע. | נחשב לאירוע בודד לחיוב אלא אם כן הוא הופך לחלק מפגישה. |
p2a_suggested_action | משתמש מקיש על כל פעולה מוצעת (למשל, "הצג מיקום") שאינה תגובה מוצעת. | תמיד מטופל כאירוע לחיוב בודד. מייצר אירוע לחיוב אחד לכל קליק. | מטופל כאירוע לחיוב בודד ויוצר אירוע לחיוב אחד לכל קליק אלא אם כן הוא הופך לחלק מפעילות באתר. |
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 | חוּט | מזהה שנוצר שמבדיל את האירוע החייב לחיוב. כל ההודעות שהן חלק מסשן יהיו בעלות אותו | 63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e |
type | חוּט | סוג האירוע:a2p_rich_messagea2p_rich_media_messagep2a_rich_messagep2a_rich_media_messagep2a_suggested_action | p2a_rich_message |
agent_id | חוּט | מזהה ייחודי עבור הסוכן שהשתתף באירוע. | acme_342h23_agent@rbm.goog |
agent_owner | חוּט | כתובת הדוא"ל של הבעלים הנוכחי של חשבון השותף שבו נוצר הסוכן. | marketing@xyzaggregator.com |
billing_party | חוּט | צד שמחייב עבור אירועים. | מוֹבִיל |
max_duration_single_message | מִספָּר | הזמן המרבי (בשעות) המותר למשתמש להגיב להודעת סוכן לפני שחלון התחלת השיחה נסגר וההודעה מסווגת כאירוע single_message . לא רלוונטי למודל האמריקאי עבור הודעות עשירות בודדות. | 24 |
max_duration_a2p_conversation | מִספָּר | עבור פיילוט הסשנים, זה משקף את חלון הסשנים של 24 שעות שנמדד מההודעה הראשונה ברצף הטריגרים. משך הזמן נמדד בשעות. | 24 |
max_duration_p2a_conversation | מִספָּר | עבור ניסוי ההפעלות, זה משקף את חלון ההפעלות של 24 שעות שנמדד מההודעה הראשונה ברצף הטריגרים. | 24 |
start_time | שנה-חודש-יום-ה':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 | מִספָּר | משך הזמן מתייחס רק לסשנים ונמדד בדקות. כאשר האירוע אינו אירוע סשן, הערך הוא 0. | 45 |
mt_messages | מִספָּר | מספר הודעות הסתיימו בנייד (A2P) באירוע. עבור סשנים, כל שורה שחולקת את אותו billing_event_id מציגה את המספר הכולל של הודעות MT בכל הסשן. | 5 |
mo_messages | מִספָּר | מספר הודעות שמקורן בנייד (P2A) באירוע. עבור סשנים, כל שורה שחולקת את אותו billing_event_id מציגה את המספר הכולל של הודעות MO בכל הסשן. | 3 |
size_kilobytes | מִספָּר | גודל כל הקבצים המצורפים להודעות באירוע, מעוגל לקילובייט הקרוב ביותר (1kB שווה ל-1024 בתים). | 912 |
agent_name | חוּט | שם הסוכן שהשתתף באירוע. | ACME Brand |
owner_name | חוּט | שם הבעלים הנוכחי של חשבון השותף שבו נוצר הסוכן. | XYZ Aggregator |
segment_count | מִספָּר | ספירת הקטעים המחושבת עבור a2p_rich_message events ואירועי p2a_rich_message (קטע אחד שווה ל-160 בתים של UTF-8). כאשר האירוע אינו אחד מהנזכרים, הערך הוא 0. | 5 |
session_type | חוּט | סוג הפגישה:a2p_sessionp2a_session | a2p_session |
דוח חיוב לדוגמה
דוח לדוגמה זמין להורדה:
גודל קובץ טיפוסי
גודל הדוח היומי משותף RCS לעסקים פעיל תלוי בכמות הפעילות שהוא יצר ברשת של הספק.