รายงานการเรียกเก็บเงินมาตรฐานและบันทึกกิจกรรม

หน้านี้อธิบายไฟล์ข้อมูลที่ RCS for Business สร้างขึ้นเพื่อช่วย ผู้ให้บริการในการเรียกเก็บเงินและการตรวจสอบ

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

RCS for Business ใช้รูปแบบการเรียกเก็บเงินมาตรฐานสำหรับการเข้าชมจากนอกสหรัฐอเมริกา ดูรายละเอียดได้ที่คำถามที่พบบ่อยเกี่ยวกับการเรียกเก็บเงิน

การสร้างไฟล์

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

  • สำหรับเอเจนต์ที่ไม่ใช่การสนทนา ไฟล์จะมีข้อมูลจากช่วง 24 ชั่วโมง ก่อนหน้าวันที่สร้างไฟล์ทันที ตัวอย่างเช่น รายงานที่สร้างขึ้นในวันที่ 5 พฤษภาคมจะครอบคลุมข้อมูลตั้งแต่เวลา 00:00 น. ของวันที่ 4 พฤษภาคมจนถึงเวลา 00:00 น. ของวันที่ 5 พฤษภาคม เวลาที่ระบุอยู่ในเขตเวลา PST
  • สำหรับเอเจนต์สนทนา ไฟล์จะมีข้อมูลจากช่วง 24 ชั่วโมง 1-2 วันก่อนเวลาการสร้างไฟล์ ตัวอย่างเช่น รายงานที่สร้างขึ้นในวันที่ 5 พฤษภาคมจะครอบคลุมข้อมูลจากช่วง 24 ชั่วโมงของวันที่ 2 หรือ 3 พฤษภาคม เวลาที่ระบุ อยู่ในเขตเวลา PST

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

ข้อมูลสำคัญ

  • ไม่มีกิจกรรม: โดยค่าเริ่มต้น ระบบจะไม่สร้างไฟล์หากไม่มีกิจกรรมในแพลตฟอร์ม ในวันนั้นๆ อย่างไรก็ตาม คุณเลือกรับไฟล์เปล่าได้หากต้องการ หากต้องการเลือกใช้ โปรดติดต่อ rbm-support@google.com
  • การตั้งชื่อ: วันที่ในชื่อไฟล์คือวันที่สร้างไฟล์ ไม่ใช่วันที่ของข้อมูลภายใน
  • การเก็บรักษา: ระบบจะจัดเก็บไฟล์ไว้นานสูงสุด 63 วันก่อนที่จะลบ

คุณใช้ไฟล์เหล่านี้เพื่ออัปเดตคลังข้อมูลด้วยเมตริกการใช้งานแพลตฟอร์มล่าสุดได้

การจัดเก็บและการเข้าถึงไฟล์

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

หากต้องการดึงไฟล์ข้อมูลโดยใช้ Secure File Transfer Protocol (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 ซึ่งเป็นเรื่องปกติ

ระบบจะไม่สร้างไฟล์หากไม่มีการเข้าชม RCS for Business ที่ต้องรายงาน ซึ่งหมายความว่าอาจมีบางวันที่ไม่มีการสร้างไฟล์ หากต้องการไฟล์เปล่าเพื่อปรับปรุงกระบวนการ โปรดติดต่อทีมสนับสนุน RCS for Business

รายงานการเรียกเก็บเงิน

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

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

หมวดหมู่การเรียกเก็บเงินของ Agent

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

หมวดหมู่การเรียกเก็บเงิน ประเภทตัวแทน ตัวอย่าง Use Case วิธีการเรียกเก็บเงิน
ไม่ใช่การสนทนา เอเจนต์ที่ส่งข้อความทางเดียวเป็นหลัก
  • OTP
  • การแจ้งเตือน
  • ข้อเสนอโปรโมชัน
ระบบจะเรียกเก็บเงินสำหรับแต่ละข้อความที่ส่งถึงผู้ใช้
การสนทนา Agent ที่ออกแบบมาเพื่อการแลกเปลี่ยนข้อมูลไปมากับผู้ใช้
  • การค้นหาสินค้าที่เหมาะสม
  • การจองตั๋ว
  • การแก้ปัญหา

เรียกเก็บเงินต่อการสนทนา: หากฝ่ายใดฝ่ายหนึ่ง (ตัวแทนหรือผู้ใช้) ตอบกลับข้อความจากอีกฝ่ายภายใน 24 ชั่วโมง การสนทนาจะเริ่มขึ้น ในระหว่างกรอบเวลาการสนทนา (24 ชั่วโมงหลังจากตอบกลับครั้งแรก) ตัวแทนและผู้ใช้สามารถแลกเปลี่ยนข้อความได้ไม่จำกัดจำนวน และระบบจะเรียกเก็บเงินจากตัวแทน ในอัตราคงที่สำหรับการสนทนา

เรียกเก็บเงินต่อข้อความ หากตัวแทนส่งข้อความที่ผู้ใช้ไม่ตอบกลับภายใน 24 ชั่วโมง ระบบจะเรียกเก็บเงินจากตัวแทนสำหรับข้อความแต่ละรายการ เช่นเดียวกับ ตัวแทนที่ไม่ใช่แบบสนทนา

แผนภาพต่อไปนี้แสดงตัวอย่างเซสชันการเรียกเก็บเงิน A2P สำหรับ เอเจนต์สนทนา

แผนภาพการเรียกเก็บเงิน

Agent แบบสนทนาเทียบกับ Agent ที่ไม่ใช่แบบสนทนา

การเรียกเก็บเงินแบ่งออกเป็น 2 หมวดหมู่หลัก ได้แก่ การสนทนาและไม่ใช่การสนทนา

ความแตกต่างที่สำคัญในหมวดหมู่การเรียกเก็บเงินคือเอเจนต์แบบสนทนาและ เอเจนต์แบบไม่สนทนา

  • ระบบจะเรียกเก็บเงินจากเอเจนต์ที่ไม่ใช่การสนทนาสำหรับแต่ละข้อความที่ส่งถึงผู้ใช้

    • หมวดหมู่นี้เหมาะสำหรับตัวแทนที่ไม่คาดหวังว่าจะได้รับการตอบกลับบ่อยๆ
  • ระบบจะเรียกเก็บเงินจากเอเจนต์สนทนาในอัตราคงที่สำหรับการสนทนา ซึ่งรวมถึงข้อความทั้งหมดที่แลกเปลี่ยนภายในระยะเวลา 24 ชั่วโมง

    • หมวดหมู่นี้เหมาะสำหรับเอเจนต์ที่สนทนากับผู้ใช้หลายรอบ

เหตุการณ์ที่เรียกเก็บเงินได้

ระบบจะบันทึกเหตุการณ์ที่เรียกเก็บเงินได้ 5 ประเภทในรายงานการเรียกเก็บเงิน เหตุการณ์เหล่านี้ รวมถึงเหตุการณ์ MT และ MO ซึ่งเรียกว่าเหตุการณ์ A2P และ P2A

  • A2P (Application-to-Person) คือ MT (Mobile Terminated): ข้อความที่ธุรกิจส่ง
  • P2A (Person-to-Application) คือ MO (Mobile Originated): ข้อความหรือการดำเนินการ ที่ผู้ใช้เริ่มต้น

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

กิจกรรม คำอธิบาย Agent ที่ไม่ใช่แบบสนทนา เอเจนต์แบบสนทนา
basic_message ข้อความ A2P ที่มีข้อความเท่านั้นและมีอักขระไม่เกิน 160 ตัว หากข้อความมี URL ของเว็บไซต์ที่มีแท็ก Open Graph ข้อความอาจแสดงตัวอย่างรูปภาพโดยไม่มีค่าใช้จ่ายเพิ่มเติมสำหรับพาร์ทเนอร์ ถือเป็นเหตุการณ์ที่เรียกเก็บเงินได้แต่ละรายการเสมอ ไม่ว่าผู้ใช้จะตอบกลับหรือไม่ก็ตาม ถือเป็นการเรียกเก็บเงินแยกต่างหาก เว้นแต่ผู้ใช้จะตอบกลับภายใน 24 ชั่วโมง ในกรณีนี้ ข้อความจะกลายเป็นส่วนหนึ่งของ a2p_conversation
single_message ข้อความ A2P ที่มีเนื้อหาข้อมูลอย่างละเอียดหรือเป็นข้อความแบบข้อความเท่านั้นที่มีความยาวเกิน 160 อักขระ ถือเป็นเหตุการณ์ที่เรียกเก็บเงินได้แต่ละรายการเสมอ ไม่ว่าผู้ใช้จะตอบกลับหรือไม่ก็ตาม ถือเป็นการเรียกเก็บเงินแยกต่างหาก เว้นแต่ผู้ใช้จะตอบกลับภายใน 24 ชั่วโมง ในกรณีนี้ ข้อความจะกลายเป็นส่วนหนึ่งของ a2p_conversation
a2p_conversation (ธุรกิจเป็นผู้เริ่ม) เริ่มเมื่อผู้ใช้ตอบกลับข้อความ A2P ภายใน 24 ชั่วโมงหลังจากได้รับข้อความดังกล่าว นอกการสนทนาที่มีอยู่ ไม่มี Agent ที่ไม่ใช่แบบสนทนาจะไม่สร้างเหตุการณ์ประเภทนี้ หากมีการนำส่งข้อความ P2A ภายใน 24 ชั่วโมงหลังจากข้อความ A2P หลายข้อความ ระบบจะใช้เฉพาะข้อความ A2P ที่อยู่ก่อนหน้าข้อความ P2A ทันทีเพื่อเริ่มการสนทนา ข้อความ A2P นี้และข้อความใดก็ตามที่นำส่งภายใน 24 ชั่วโมงถัดไปเป็นส่วนหนึ่งของa2p_conversation
p2a_conversation (ผู้ใช้เริ่ม) เริ่มเมื่อตัวแทนตอบกลับข้อความ P2A ภายใน 24 ชั่วโมงหลังจากได้รับข้อความ นอกการสนทนาที่มีอยู่ ไม่มี Agent ที่ไม่ใช่แบบสนทนาจะไม่สร้างเหตุการณ์ประเภทนี้ หากมีการนำส่งข้อความ A2P ภายใน 24 ชั่วโมงหลังจากข้อความ P2A หลายข้อความ ระบบจะใช้เฉพาะข้อความ P2A ที่อยู่ก่อนหน้าข้อความ A2P ทันทีเพื่อเริ่มการสนทนา ข้อความ P2A นี้และข้อความใดก็ตามที่ส่งภายใน 24 ชั่วโมงถัดไปเป็นส่วนหนึ่งของp2a_conversation
p2a_message ข้อความ P2A ประเภทใดก็ได้ ถือเป็นเหตุการณ์ที่เรียกเก็บเงินได้แต่ละรายการเสมอ ไม่ว่า Agent จะตอบกลับหรือไม่ก็ตาม ถือเป็นการเรียกเก็บเงินเหตุการณ์เดียว เว้นแต่ตัวแทนจะตอบกลับภายใน 24 ชั่วโมง

หมวดหมู่การเรียกเก็บเงินเทียบกับเหตุการณ์ที่เรียกเก็บเงินได้

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

  • หมวดหมู่การเรียกเก็บเงินคือการจัดประเภทแบบคงที่ที่คุณเลือกเมื่อสร้าง เอเจนต์ โดยจะกำหนดวิธีการที่ใช้เรียกเก็บเงินจาก Agent ของคุณ ซึ่งอาจเป็นต่อข้อความ (Agent ที่ไม่ใช่แบบสนทนา) หรือต่อการสนทนา (Agent แบบสนทนา)
  • เหตุการณ์ที่เรียกเก็บเงินได้คือการโต้ตอบระหว่างตัวแทน RCS for Business กับผู้ใช้ ซึ่งมีการติดตามเพื่อวัตถุประสงค์ในการเรียกเก็บเงิน (เช่น basic_message, single_message, a2p_conversation)

การสร้างรายงานการเรียกเก็บเงิน

เฉพาะเอเจนต์ที่มีการเข้าชมที่ไม่ใช่การทดสอบเท่านั้นที่จะสร้างเหตุการณ์ที่เรียกเก็บเงินได้ กิจกรรมจากหมายเลขโทรศัพท์ทดสอบจะไม่ปรากฏในรายงานการเรียกเก็บเงิน

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

รูปแบบรายงานการเรียกเก็บเงิน

รายงานการเรียกเก็บเงินใช้รูปแบบชื่อไฟล์ rbm_billable_events_YYYY-MM-DD.csv วันที่ในชื่อไฟล์คือวันที่สร้างไฟล์

แต่ละบรรทัดในรายงานคือบันทึกที่แสดงเหตุการณ์ที่เรียกเก็บเงินได้รายการเดียว ฟิลด์ ภายในระเบียนจะคั่นด้วยแท็บ เช่น การสนทนา A2P 2 รายการกับตัวแทนคนเดียวกันจะสร้างเหตุการณ์ที่เรียกเก็บเงินแยกกัน 2 รายการและบันทึก 2 รายการในรายงานการเรียกเก็บเงิน

ไฟล์ได้รับการเข้ารหัส UTF-8 โดยไม่มีเครื่องหมายลำดับไบต์ และใช้ตัวขึ้นบรรทัดใหม่สำหรับ การสิ้นสุดบรรทัด บรรทัดแรกของแต่ละไฟล์คือแถวส่วนหัวที่มีชื่อฟิลด์

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

ช่อง รูปแบบ คำอธิบาย ตัวอย่าง
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 สตริง ตัวระบุที่ไม่ซ้ำกันสำหรับตัวแทนที่เข้าร่วมในเหตุการณ์ rbm-welcome-bot@rbm.goog
agent_owner สตริง อีเมลของเจ้าของบัญชีพาร์ทเนอร์ปัจจุบันที่สร้างเอเจนต์ name@aggregator.com
billing_party สตริง บุคคลที่เรียกเก็บเงินสำหรับกิจกรรม
  • ผู้ให้บริการ
carrier
max_duration_single_message ตัวเลข เวลาสูงสุด (เป็นชั่วโมง) ที่อนุญาตให้ผู้ใช้ตอบกลับข้อความของตัวแทน ก่อนที่กรอบเวลาการเริ่มการสนทนาจะปิดลงและระบบจะจัดประเภทข้อความ เป็นเหตุการณ์ single_message 24
max_duration_a2p_conversation ตัวเลข ระยะเวลาสูงสุดของการสนทนา A2P เป็นชั่วโมง วัดจากคำตอบแรกของผู้ใช้ต่อข้อความเริ่มต้นของตัวแทน 24
max_duration_p2a_conversation ตัวเลข ระยะเวลาสูงสุดของการสนทนาระหว่างบุคคลกับ AI เป็นชั่วโมง วัดจากข้อความแรกของผู้ใช้ในการสนทนา 24
start_time YYYY-mm-ddTHH: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 ตัวเลข ขนาดของไฟล์ทั้งหมดที่แนบมากับข้อความในเหตุการณ์ โดยปัดเศษเป็น กิโลไบต์ที่ใกล้ที่สุด (1 กิโลไบต์เท่ากับ 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 วันที่ในชื่อไฟล์คือวันที่สร้างไฟล์

ฟิลด์ในระเบียนจะคั่นด้วยแท็บ และมีระเบียน 1 รายการต่อบรรทัด

ไฟล์ได้รับการเข้ารหัส UTF-8 โดยไม่มีเครื่องหมายลำดับไบต์ และใช้ตัวขึ้นบรรทัดใหม่สำหรับ การสิ้นสุดบรรทัด บรรทัดแรกของแต่ละไฟล์คือแถวส่วนหัวที่มีชื่อฟิลด์

แต่ละระเบียนในบันทึกกิจกรรมจะมีฟิลด์ต่อไปนี้สำหรับแต่ละกิจกรรม

ช่อง รูปแบบ คำอธิบาย ตัวอย่าง
activity_id สตริง ตัวระบุที่ไม่ซ้ำกันสำหรับกิจกรรม b422e1d3-ac99-442a-853d-a875d5e61762
billing_event_id สตริง ตัวระบุที่ไม่ซ้ำกันสำหรับเหตุการณ์ที่เรียกเก็บเงินได้ที่เชื่อมโยง อาจว่างเปล่าได้หากกิจกรรมไม่ได้เชื่อมโยงกับเหตุการณ์ที่เรียกเก็บเงินได้ เช่น text_message ที่ไม่มี delivery_receipt_event ที่สอดคล้องกัน 91yeb201-7c3b-412b-98d2-b0a0f7abe536
agent_id สตริง ตัวระบุที่ไม่ซ้ำกันสำหรับตัวแทน welcome-bot@rbm.goog
user_id สตริง MSISDN ของผู้ใช้ 918369110173
direction สตริง ทิศทางที่ส่งข้อความ
  • MT (การสิ้นสุดบนอุปกรณ์เคลื่อนที่) สำหรับกิจกรรมจากเอเจนต์ถึงผู้ใช้
  • MO (ต้นทางเป็นอุปกรณ์เคลื่อนที่) สำหรับกิจกรรมจากผู้ใช้ไปยังตัวแทน
MT
time YYYY-mm-ddTHH:MM:SS.SSSZ วันที่และเวลาที่ส่งเหตุการณ์ไปยังแพลตฟอร์ม 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 น. และผู้รับออฟไลน์จนถึงวันอาทิตย์เวลา 09:00 น. เหตุการณ์จะปรากฏในบันทึกกิจกรรมที่สร้างขึ้นสำหรับวันอาทิตย์ แต่การประทับเวลาจะเป็นวันพุธ เวลา 13:00 น.