דוחות חיוב רגילים ויומני פעילות

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

קוֹבֶץ	תֵאוּר	למי יש גישה
דוח חיוב	דוח מצטבר של אירועים לחיוב בין סוכנים שהושקו למשתמשים.	כל הספקים המפעילים באופן פעיל RCS לעסקים.
יומן פעילות	יומן נתונים גולמיים של פעילות RCS לעסקים, כולל אירועים לחיוב.	ספקים המפעילים באופן פעיל RCS לעסקים ומפעילים את שירות RCS של גוגל במסגרת תנאי השירות שלהם.

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

יצירת קבצים

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

• עבור סוכנים שאינם מנהלים שיחה , הקבצים מכילים נתונים מתקופת 24 השעות שקדמה מיד ליום שבו נוצר הקובץ. לדוגמה, דוח שנוצר ב-5 במאי מכסה נתונים משעה 00:00 ב-4 במאי עד 00:00 ב-5 במאי. השעה שצוינה היא באזור הזמן PST.

• עבור סוכני שיחות , הקבצים מכילים נתונים מתקופת 24 השעות, יום-יומיים לפני זמן יצירת הקובץ. לדוגמה, דוח שנוצר ב-5 במאי מכסה נתונים מחלון 24 השעות של ה-2 או ה-3 במאי. הזמן שצוין הוא באזור הזמן PST.

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

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

נקודות מפתח:

• אין פעילות : כברירת מחדל, לא נוצר קובץ אם אין פעילות בפלטפורמה ביום נתון. עם זאת, ניתן להצטרף לקבלת קבצים ריקים במידת הצורך. כדי להצטרף, צרו קשר עם [e-mail].
• מתן שמות : התאריך בשם הקובץ הוא תאריך יצירת הקובץ, לא תאריך הנתונים שבתוכו.
• שמירה : קבצים נשמרים למשך 63 ימים לכל היותר לפני מחיקתם.

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

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

קבצי נתונים מוצפנים במנוחה ובזמן העברה.

כדי לאחזר קבצי נתונים באמצעות פרוטוקול העברת קבצים מאובטח (SFTP), ספק את המפתח הציבורי של SFTP. כדי ליצור מפתחות, ראה יצירת זוג מפתחות Secure Shell (SSH) עבור תיבת דואר SFTP .

שרת ה-SFTP הוא partnerupload.google.com , והחיבור הוא על מספר פורט גבוה (19321) לאבטחה נוספת.

ניתן להשתמש בפקודה הבאה כדי לגשת לקבצי הנתונים שלך:

sftp -i <path_to_private_key> -P 19321 <username>@partnerupload.google.com

גוגל מספקת שמות משתמש לחשבונות בפורמטים הבאים:

• rbmreports-billableevents-<carrier name>
• rbmreports-activity-<carrier name>

גוגל מציינת <carrier name> ומספקת חשבון נפרד לכל סוג דוח.

חשבונות נפרדים ניתנים לגישה לסוגי הדוחות השונים.

זמינות הקבצים

אם עדיין לא נוצרו קבצי נתונים, תראה שגיאת SFTP בדומה ל- remote readdir("/"): No such file or directory , כצפוי.

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

דוחות חיוב

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

דוחות חיוב מכילים מידע סודי, אך אינם מכילים מידע אישי מזהה (PII) של המשתמש, כגון MSISDN, MSISDN מגובב או כל מזהה ייחודי של המשתמש.

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

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

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

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

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

ישנן שתי קטגוריות חיוב עיקריות: חיוב שיחה וחיוב שאינו שיחה.

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

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

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

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

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

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

חמישה סוגים של אירועים לחיוב נרשמים בדוחות החיוב. אירועים אלה כוללים אירועי MT ו-MO, המכונים אירועי A2P ו-P2A.

• A2P (אפליקציה לאדם) הוא MT (סיום נייד) : הודעה שנשלחת על ידי העסק.
• P2A (אדם לאפליקציה) הוא MO (מקור נייד) : הודעה או פעולה שיזום המשתמש.

הטבלה הבאה מתארת ​​כל אירוע לחיוב כפי שהוא חל על סוכנים שאינם מנהלים שיחה ועל סוכנים מנהליים.

מִקרֶה	תֵאוּר	סוכנים שאינם מנהלים שיחה	סוכני שיחה
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 (יוזמת המשתמש)	מופעל כאשר סוכן מגיב להודעת P2A תוך 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	single_message p2a_rich_message
agent_id	חוּט	מזהה ייחודי עבור הסוכן שהשתתף באירוע.	[e-mail]
agent_owner	חוּט	כתובת הדוא"ל של הבעלים הנוכחי של חשבון השותף שבו נוצר הסוכן.	[e-mail]
billing_party	חוּט	צד שמחייב עבור אירועים. מוֹבִיל	carrier
max_duration_single_message	מִספָּר	הזמן המרבי (בשעות) המותר למשתמש להגיב להודעת סוכן לפני שחלון התחלת השיחה נסגר וההודעה מסווגת כאירוע single_message .	24
max_duration_a2p_conversation	מִספָּר	משך זמן מקסימלי של שיחת A2P, בשעות. נמדד מתגובת המשתמש הראשונה ועד להודעה הראשונית של הסוכן.	24
max_duration_p2a_conversation	מִספָּר	משך זמן מקסימלי של שיחת P2A, בשעות. נמדד מהודעת המשתמש הראשונה בשיחה.	24
start_time	שנה-חודש-יום-ה':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	מִספָּר	משך האירוע, מעוגל לדקה הקרובה ביותר. הערך הוא 0 עבור כל אירוע שאינו שיחה.	45
mt_messages	מִספָּר	מספר הודעות A2P (הסתיימות בנייד) באירוע.	11
mo_messages	מִספָּר	מספר הודעות שמקורן בנייד (P2A) באירוע.	9
size_kilobytes	מִספָּר	גודל כל הקבצים המצורפים להודעות באירוע, מעוגל לקילובייט הקרוב ביותר (1kB שווה ל-1024 בתים).	912
agent_name	חוּט	שם הסוכן שהשתתף באירוע.	XYZ Mobile USA
owner_name	חוּט	שם הבעלים הנוכחי של חשבון השותף שבו נוצר הסוכן.	XYZ Mobile

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

דוחות לדוגמה זמינים להורדה:

• דוח חיוב עבור מודל חיוב סטנדרטי

גודל קובץ טיפוסי

גודל הדוח היומי משותף RCS לעסקים פעיל תלוי בכמות הפעילות שהוא יצר ברשת של הספק. לדוגמה, אם יש 53,000 רשומות בדוח, גודל הקובץ יהיה כ-8 מגה-בייט.

יומני פעילות

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

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

מכיוון שיומני פעילות מכילים מידע אישי מזהה (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	חוּט	מזהה ייחודי עבור הסוכן.	[e-mail]
user_id	חוּט	MSISDN של המשתמש.	918369110173
direction	חוּט	הכיוון שאליו נשלחת ההודעה: MT (סיום נייד) עבור פעילויות בין סוכן למשתמש MO (מקור נייד) לפעילויות ממשתמש לסוכן	MT
time	שנה-חודש-יום-ה':חודש:שש.ששז	תאריך ושעה שבהם האירוע נשלח לפלטפורמת 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 for Business. עבור אירועים המספקים תוכן למשתמש, האירוע לא יתועד ביומן הפעילות עד למסירת ההודעה.

לדוגמה, אם הודעת RCS for Business נשלחת למשתמש ביום רביעי בשעה 13:00, והנמען אינו מחובר עד יום ראשון בשעה 9:00, האירוע יופיע ביומן הפעילות שנוצר עבור יום ראשון, אך חותמת הזמן תהיה יום רביעי, 13:00.