รายงานและบันทึก

RBM สร้างไฟล์ข้อมูลที่รายงานกิจกรรมของผู้ใช้และตัวแทนในระดับสรุปและระดับการทำธุรกรรม ข้อมูลจะแบ่งออกเป็นหลายไฟล์ ดังนี้

ไฟล์	คำอธิบาย	ผู้ที่มีสิทธิ์เข้าถึง
รายงานเหตุการณ์การเรียกเก็บเงิน	บันทึกเหตุการณ์ที่เรียกเก็บเงินได้ระหว่างตัวแทนและผู้ใช้ที่เปิดแล้ว	ผู้ให้บริการทั้งหมดที่มีการเข้าชม RBM ในเครือข่ายของตน
บันทึกกิจกรรม	ข้อมูลกิจกรรมแพลตฟอร์ม RBM แบบข้อมูลดิบ	ผู้ให้บริการที่มีการรับส่งข้อมูลของ RBM ในเครือข่ายและเปิดใช้กิจกรรม RCS ด้วย Jibe Cloud ภายใต้ข้อกำหนดในการให้บริการของตน

รุ่น

รายงานเหตุการณ์การเรียกเก็บเงินและบันทึกกิจกรรมจะมีความล่าช้า 2 วันในการสร้าง

Google จะรายงานเหตุการณ์กิจกรรมเมื่อเซสชันการเรียกเก็บเงินของเหตุการณ์นั้นสมบูรณ์แล้วเท่านั้น เซสชันอาจใช้เวลานานถึง 24 ชั่วโมงจึงจะเสร็จสมบูรณ์ และไปป์ไลน์การเรียกเก็บเงินของเราจะทำงานวันละครั้ง และรายงานเฉพาะเซสชันการเรียกเก็บเงินที่เสร็จสิ้น (ดังนั้นต้องมีอายุอย่างน้อย 24 ชั่วโมง)

เช่น

• ระบบส่งข้อความในวันที่ d และเริ่มเซสชันการเรียกเก็บเงิน แต่กลับดำเนินการไปป์ไลน์เร็วกว่านั้น 1 ชั่วโมง ดังนั้นจะไม่มีการรายงาน เหตุการณ์กิจกรรม

• เมื่อไปป์ไลน์ทำงานอีกครั้งใน d+1 เซสชันที่เริ่มต้นข้อความจะมีอายุเพียง 23 ชั่วโมง ดังนั้น จะไม่มีการรายงานเหตุการณ์กิจกรรมของข้อความนี้ใน d+1

• เมื่อไปป์ไลน์ทำงานอีกครั้งในวันที่ d+2 เซสชันดังกล่าวก็เสร็จสมบูรณ์และมีการรายงานเหตุการณ์กิจกรรมไปพร้อมกับเซสชันการเรียกเก็บเงิน

พื้นที่เก็บข้อมูลและการเข้าถึง

ระบบจะเข้ารหัสไฟล์ข้อมูลที่ไม่มีการเคลื่อนไหวและในระหว่างการโอน

หากต้องการเรียกไฟล์ข้อมูลด้วย 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 กรณีนี้เป็นสิ่งที่คาดว่าจะเกิดอยู่แล้ว

ระบบจะไม่สร้างไฟล์หากไม่มีการเข้าชม RBM ที่จะรายงาน ซึ่งหมายความว่าอาจมีบางวันที่ไม่มีการสร้างไฟล์ โปรดติดต่อ [e-mail] หากคุณต้องการให้สร้างไฟล์เปล่าในกรณีนี้เพื่อให้การประมวลผลง่ายขึ้น

รีเฟรชและเก็บรักษา

ไฟล์ข้อมูลแต่ละไฟล์แสดงถึงการใช้งานแพลตฟอร์ม 1 วันในเวลา UTC ระบบจะสร้างบันทึกสำหรับวันหนึ่งๆ เพียงครั้งเดียว และจะมีการสรุปข้อมูลภายใน 2 วัน (48 ชั่วโมง) หลังสิ้นสุดวัน หากโหลดไฟล์เหล่านี้ลงในคลังข้อมูล คุณจะอัปเดตเมตริกของเดือนปัจจุบันได้

ไฟล์จะไม่สร้างขึ้นหากไม่มีกิจกรรมใดๆ ที่นำมาพิจารณา

วันที่ในชื่อของแต่ละไฟล์คือวันที่ที่สร้างไฟล์ ระเบียนในไฟล์จะครอบคลุมวัน UTC ที่มาถึง 2 วันก่อนถึงวันที่ไฟล์

โดยกระบวนการส่งออกที่สร้างไฟล์จะดำเนินการตั้งแต่เวลา 02:00 น. - 4:00 น. (PST)

ระบบจะเก็บไฟล์ข้อมูลไว้ไม่เกิน 30 วันก่อนที่จะลบ

รายงานเหตุการณ์การเรียกเก็บเงิน

รายงานเหตุการณ์การเรียกเก็บเงินคือบันทึกเหตุการณ์ที่เรียกเก็บเงินได้ซึ่งคำนวณจากข้อความที่สำคัญโดยใช้หน่วยการเรียกเก็บเงินที่แนะนำ เหตุการณ์ที่เรียกเก็บเงินได้มีข้อมูลที่เป็นความลับ แต่จะไม่มี PII ของผู้ใช้ (เช่น ไม่มี MSISDN, MSISDN ที่แฮช หรือตัวระบุที่ไม่ซ้ำกันของผู้ใช้)

เฉพาะตัวแทนที่เปิดใช้แล้วจะสร้างกิจกรรมการเรียกเก็บเงิน กิจกรรมจากตัวแทนที่ยังไม่ได้เปิดใช้ หรือที่ยังไม่ได้เปิดใช้จะไม่ปรากฏในรายงานการเรียกเก็บเงิน

รายงานการเรียกเก็บเงินจะถือว่ากิจกรรมนั้นถูกเรียกเก็บเงินเมื่อมีการส่งข้อความ ไม่ใช่เมื่อมีการส่งข้อความ ข้อความที่ไม่ได้ส่งหรือเพิกถอนก่อนการนำส่งจะไม่ทริกเกอร์เหตุการณ์การเรียกเก็บเงิน

ตัวแทน RBM แต่ละรายมีหมวดหมู่การเรียกเก็บเงิน ซึ่งกำหนดโดยนักพัฒนาแอปของตัวแทนก่อนที่จะส่งตัวแทนสำหรับการเปิดใช้ หมวดหมู่การเรียกเก็บเงินจะกำหนดว่าข้อความที่ตัวแทนส่งจะแยกกันหรือไม่ หรือรวมกันเป็นเหตุการณ์การเรียกเก็บเงินแบบการสนทนาหรือไม่

เหตุการณ์ที่เรียกเก็บเงินได้มี 5 ประเภทดังนี้

เหตุการณ์	คำจำกัดความ
ข้อความพื้นฐาน	ข้อความแบบ Application-to-person (A2P) ที่ มีอักขระได้สูงสุด 160 ตัว มีเฉพาะข้อความ เอเจนต์การสนทนาเท่านั้น: หากมีการส่งข้อความ P2A เป็นการตอบกลับข้อความ A2P ภายใน 24 ชั่วโมงถัดไป ข้อความพื้นฐานจะกลายเป็นส่วนหนึ่งของการสนทนา A2P มิฉะนั้นเซสชันจะยุติลง ระบบจะส่งข้อความพื้นฐานจากตัวแทนไปยังผู้ใช้เสมอ
ข้อความเดียว	ข้อความแบบ Application-to-person (A2P) ที่ มีเนื้อหามัลติมีเดียหรือข้อความที่ยาวเกิน 160 อักขระ เอเจนต์การสนทนาเท่านั้น: หากมีการส่งข้อความ P2A ภายใน 24 ชั่วโมง ข้อความเดียวจะกลายเป็นส่วนหนึ่งของการสนทนา A2P มิฉะนั้นเซสชันจะสิ้นสุดลง ข้อความเดียวจะส่งจากตัวแทนถึงผู้ใช้เสมอ
การสนทนาผ่าน A2P	มีผลกับตัวแทนการสนทนาเท่านั้น: การสนทนา A2P จะเริ่มต้นเมื่อมีการส่งข้อความ P2A ภายใน 24 ชั่วโมงหลังจากที่ข้อความเดียวของ A2P หรือข้อความพื้นฐานของ A2P โปรดทราบว่าหากมีการส่งข้อความ P2A ภายใน 24 ชั่วโมงของข้อความ A2P หลายข้อความ ระบบจะใช้เฉพาะข้อความ A2P ที่อยู่ก่อนข้อความ P2A ทันทีเพื่อสร้างเซสชันการสนทนา ข้อความ A2P นี้รวมถึงข้อความที่ส่งภายใน 24 ชั่วโมงถัดไปจะรวมอยู่ในการสนทนา A2P ใหม่
การสนทนาแบบ P2A	มีผลกับตัวแทนการสนทนาเท่านั้น: การสนทนาแบบ P2A จะเริ่มต้นเมื่อไม่มีเซสชันที่ใช้งานอยู่ (ข้อความเดียวแบบ A2P, การสนทนา A2P หรือการสนทนาแบบ P2A) และมีการส่งข้อความ P2A และธุรกิจตอบกลับภายใน 24 ชั่วโมง
ข้อความ P2A	ตัวแทนที่ไม่ใช่การสนทนา: ข้อความ P2A ที่ผู้ใช้ส่งถึงตัวแทนที่มีหมวดหมู่การเรียกเก็บเงินเป็นข้อความเดียวหรือข้อความพื้นฐาน ตัวแทนแบบสนทนา: ข้อความ P2A ที่ผู้ใช้ส่งถึงตัวแทนที่ไม่มีการสนทนาอยู่และตัวแทนไม่ได้ตอบกลับ

ความพร้อมใช้งาน

รายงานเหตุการณ์การเรียกเก็บเงินใช้ได้กับผู้ให้บริการทั้งหมดที่มีการรับส่งข้อมูล RBM ในเครือข่ายของตน

รูปแบบ

รายงานเหตุการณ์การเรียกเก็บเงินจะใช้รูปแบบชื่อไฟล์ YYYY/MM/DD/rbm_billable_events_YYYY-MM-DD.csv

วันที่ในชื่อไฟล์คือวันที่ที่สร้างไฟล์ โดยทั่วไป ระเบียนในไฟล์จะครอบคลุมกิจกรรมสำหรับวันที่ 2 วันก่อนวันดังกล่าว

ช่องในระเบียนจะคั่นด้วยแท็บ และมี 1 ระเบียนต่อบรรทัด

จะมีระเบียน 1 รายการสำหรับกิจกรรมการเรียกเก็บเงินแต่ละรายการ นั่นคือ การสนทนา A2P 2 รายการกับตัวแทนคนเดียวกันจะทำให้เกิดการเรียกเก็บเงิน 2 รายการ และ 2 รายการในรายงานการเรียกเก็บเงิน

ระเบียนแต่ละรายการในรายงานเหตุการณ์ที่เรียกเก็บเงินได้จะมีข้อมูลต่อไปนี้สำหรับแต่ละเหตุการณ์

ฟิลด์	รูปแบบ	คำอธิบาย	ตัวอย่าง
billing_event_id	สตริง	ตัวระบุ UUID ซึ่งเป็นหมายเลขสุ่มที่สร้างขึ้นสำหรับเหตุการณ์ใหม่แต่ละรายการ ณ เวลาที่สร้าง
type	สตริง	ประเภทของกิจกรรม basic_message single_message a2p_conversation p2a_conversation p2a_message	single_message
agent_id	สตริง	ตัวระบุของตัวแทนที่เข้าร่วมกิจกรรม	[e-mail]
agent_owner	สตริง	อีเมลของเจ้าของตัวแทนที่เข้าร่วมกิจกรรม ผู้รวบรวมข้อมูลรายนี้คือผู้ที่ลงทะเบียนตัวแทน RBM ซึ่งในกรณีส่วนใหญ่เป็นผู้รวบรวมข้อมูล แต่ในบางกรณีอาจเป็นแบรนด์ ค่านี้มาจากช่อง "บัญชี Google ของ RBM" ที่ให้ไว้เมื่อนักพัฒนาแอป ลงทะเบียนเพื่อใช้ RBM	[e-mail]
billing_party	สตริง	ผู้ที่เรียกเก็บเงินสำหรับกิจกรรม google ผู้ให้บริการ	carrier
max_duration_single_message	ตัวเลข	ระยะเวลาเป็นชั่วโมงสำหรับข้อความของตัวแทนที่จะส่งข้อความไปโดยไม่ได้รับการตอบกลับเพื่อระบุเซสชันข้อความเดียว	24
max_duration_a2p_conversation	ตัวเลข	ระยะเวลาสูงสุดของเซสชัน A2P ในหน่วยชั่วโมง วัดจากการตอบกลับของผู้ใช้ครั้งแรกต่อข้อความเริ่มต้นของตัวแทน	24
max_duration_p2a_conversation	ตัวเลข	ระยะเวลาสูงสุดของเซสชัน P2A ในหน่วยชั่วโมง วัดจากข้อความแรกของผู้ใช้ในการสนทนา	24
start_time	YYYY-mm-ddTHH:00:00Z	วันที่/เวลา UTC ที่เหตุการณ์เริ่มต้นในรูปแบบ ISO 8601 ปัดเศษเป็นชั่วโมงที่ใกล้ที่สุด สำหรับเหตุการณ์ a2p_conversation และ p2a_conversation นี่คือเวลาที่เซสชันเริ่มต้น สำหรับเหตุการณ์ single_message และ basic_message นี่คือเวลาที่เหตุการณ์เกิดขึ้น	2019-07-25T08:00:00Z
duration	ตัวเลข	ระยะเวลาของเหตุการณ์โดยปัดเศษเป็นนาทีที่ใกล้ที่สุด เมื่อประเภทเหตุการณ์คือ single_message หรือ basic_message ค่าจะเป็น 0	45
mt_messages	ตัวเลข	จำนวนข้อความสิ้นสุดการใช้งานบนอุปกรณ์เคลื่อนที่ในกิจกรรม	11
mo_messages	ตัวเลข	จํานวนข้อความที่มาจากอุปกรณ์เคลื่อนที่ในเหตุการณ์	9
size_kilobytes	ตัวเลข	ขนาดของไฟล์ทั้งหมดที่แนบมากับข้อความในเหตุการณ์ โดยปัดเศษให้เป็นกิโลไบต์ที่ใกล้เคียงที่สุด (1kB = 1024 ไบต์)	912
agent_name	สตริง	ตัวแทนที่เข้าร่วมกิจกรรม	XYZ Mobile USA
owner_name	สตริง	เจ้าของตัวแทนที่เข้าร่วมกิจกรรม บุคคลดังกล่าวคือผู้ที่ลงทะเบียนตัวแทน RBM ในกรณีส่วนใหญ่ก็คือผู้รวบรวมข้อมูล แต่ในบางกรณีที่ไม่ค่อยเกิดขึ้นอาจเป็นแบรนด์ ค่านี้มาจาก "ชื่อที่แสดงที่ต้องการใช้สำหรับบัญชีพาร์ทเนอร์" ซึ่งระบุไว้เมื่อนักพัฒนาแอป ลงทะเบียนเพื่อใช้ RBM	XYZ Mobile

ไฟล์ตัวอย่าง

ตัวอย่างไฟล์รายงานการเรียกเก็บเงินพร้อมให้ดาวน์โหลด

ขนาดไฟล์ปกติ

ไฟล์รายงานรายวันจากพาร์ทเนอร์ที่ใช้งานอยู่อาจมีบันทึกประมาณ 53,000 รายการและมีขนาดประมาณ 8 MB

บันทึกกิจกรรม

บันทึกกิจกรรมคือบันทึกข้อมูลดิบของกิจกรรมบนแพลตฟอร์ม RBM เพื่อวัตถุประสงค์ในการตรวจสอบกิจกรรมที่เรียกเก็บเงินได้และการสร้างเหตุการณ์ที่กำหนดเอง

ความพร้อมใช้งาน

บันทึกกิจกรรมพร้อมให้บริการแก่ผู้ให้บริการที่มีการรับส่งข้อมูล RBM ในเครือข่ายและเปิดใช้กิจกรรม RCS กับ Jibe Cloud เท่านั้นภายใต้ข้อกำหนดในการให้บริการ (ToS) ของผู้ให้บริการแต่ละราย หากคุณใช้ Jibe Cloud ภายใต้ข้อกำหนดในการให้บริการของ Jibe คุณจะไม่มีสิทธิ์เข้าถึงบันทึกกิจกรรม

หมายเหตุ: บันทึกกิจกรรมมีข้อมูลธุรกรรมโดยละเอียดและ MSISDN ของผู้สมัครใช้บริการ เนื่องจากบันทึกกิจกรรมมีข้อมูลส่วนบุคคลที่ระบุตัวบุคคลนั้นได้ (PII) จึงมีให้ใช้เฉพาะเมื่อผู้ให้บริการใช้ RCS ตามข้อกำหนดในการให้บริการของผู้ให้บริการรายนั้นๆ

รูปแบบ

บันทึกกิจกรรมจะใช้รูปแบบชื่อไฟล์ YYYY/MM/DD/rbm_activity_YYYY-MM-DD.csv

วันที่ในชื่อไฟล์คือวันที่ที่สร้างไฟล์ โดยทั่วไป ระเบียนในไฟล์จะครอบคลุมกิจกรรมสำหรับวันที่ 2 วันก่อนวันดังกล่าว

ช่องในระเบียนจะคั่นด้วยแท็บ และมี 1 ระเบียนต่อบรรทัด

แต่ละระเบียนในบันทึกกิจกรรมจะมีช่องต่อไปนี้สำหรับเหตุการณ์กิจกรรมแต่ละรายการ

ฟิลด์	รูปแบบ	คำอธิบาย	ตัวอย่าง
activity_id	สตริง	ตัวระบุของกิจกรรม
billing_event_id	สตริง	ตัวระบุกิจกรรมการเรียกเก็บเงินที่เกิดขึ้น อาจว่างเปล่าหากกิจกรรมไม่ได้เชื่อมโยงกับเซสชันใดๆ เช่น text_message โดยไม่มี delivery_receipt_event ที่สอดคล้องกัน
agent_id	สตริง	ตัวระบุของตัวแทน	[e-mail]
user_id	สตริง	MSISDN ของผู้ใช้	918369110173
direction	สตริง	ทิศทางการส่งข้อความ: MT (การสิ้นสุดการใช้งานบนอุปกรณ์เคลื่อนที่) สำหรับกิจกรรมจากตัวแทนไปยังผู้ใช้ MO (เริ่มต้นในอุปกรณ์เคลื่อนที่) สำหรับกิจกรรม User-to-agent	MT
time	YYYY-mm-ddTHH:MM:SS.SSSZ	วันที่/เวลา UTC ที่ส่งกิจกรรมไปยังแพลตฟอร์ม RBM โปรดดูหมายเหตุด้านล่าง	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

หมายเหตุเกี่ยวกับการประทับเวลา

การประทับเวลาในบันทึกกิจกรรมจะบันทึกเวลาที่มีการส่งเหตุการณ์ไปยังแพลตฟอร์ม RBM สำหรับกิจกรรมที่ส่งเนื้อหาไปยังผู้ใช้ จะไม่มีการเขียนกิจกรรมลงในบันทึกกิจกรรมจนกว่าจะมีการส่งข้อความ

เช่น หากส่งข้อความ RBM ให้ผู้ใช้ในวันพุธเวลา 13:00 น. และผู้รับออฟไลน์จนถึงวันอาทิตย์เวลา 09:00 น. กิจกรรมนั้นจะปรากฏในบันทึกกิจกรรมที่สร้างขึ้นสำหรับวันอาทิตย์ การประทับเวลาของเหตุการณ์ในบันทึกกิจกรรม จะเป็นวันพุธเวลา 13:00 น.