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

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

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

RCS for Business ใช้รูปแบบการเรียกเก็บเงิน 2 รูปแบบ ได้แก่ รูปแบบการเรียกเก็บเงินมาตรฐานสำหรับการเข้าชมจากนอกสหรัฐอเมริกา และรูปแบบการเรียกเก็บเงินของสหรัฐอเมริกาสำหรับการเข้าชมจากสหรัฐอเมริกา เราจะระบุข้อมูลเฉพาะของโมเดลมาตรฐานหรือโมเดลสหรัฐอเมริกา (เช่น การจัดประเภทเหตุการณ์ที่เรียกเก็บเงินได้หรือฟิลด์รายงานที่แตกต่างกัน) อย่างชัดเจน

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

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

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

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

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

ข้อมูลสำคัญ

  • ไม่มีกิจกรรม: หากไม่มีกิจกรรมในแพลตฟอร์มในวันใดวันหนึ่ง ระบบจะไม่สร้างไฟล์

  • การตั้งชื่อ: วันที่ในชื่อไฟล์คือวันที่สร้างไฟล์ ไม่ใช่วันที่ ของข้อมูลภายใน

  • การเก็บรักษา: ระบบจะจัดเก็บไฟล์ไว้สูงสุด 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 สำหรับธุรกิจที่จะรายงาน ซึ่งหมายความว่าอาจมีบางวันที่ไม่มีการสร้างไฟล์ หากต้องการไฟล์เปล่า เพื่อเพิ่มประสิทธิภาพกระบวนการ โปรดติดต่อ rbm-support@google.com

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

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

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

หมวดหมู่การเรียกเก็บเงินของตัวแทน

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

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

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

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

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

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

เอเจนต์แบบสนทนากับเอเจนต์แบบไม่สนทนา

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

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

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

    • หมวดหมู่นี้เหมาะที่สุดสำหรับตัวแทนที่ไม่คาดหวังว่าจะได้รับการตอบกลับบ่อยๆ

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

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

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

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

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

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

กิจกรรม คำอธิบาย เอเจนต์ที่ไม่ใช่การสนทนา เอเจนต์เชิงสนทนา
basic_message ข้อความ A2P ที่มีข้อความเท่านั้นและมีอักขระไม่เกิน 160 ตัว หากข้อความมี URL ของเว็บไซต์ที่มีแท็ก Open Graph ข้อความอาจแสดงตัวอย่างรูปภาพโดยไม่มีค่าใช้จ่ายเพิ่มเติมสำหรับพาร์ทเนอร์ ถือเป็นเหตุการณ์ที่เรียกเก็บเงินได้แต่ละรายการเสมอ ไม่ว่าผู้ใช้จะตอบกลับหรือไม่ก็ตาม ถือเป็นเหตุการณ์ที่เรียกเก็บเงินได้แต่ละรายการ เว้นแต่ผู้ใช้จะตอบกลับภายใน 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 2 รายการกับตัวแทนคนเดียวกันจะสร้างเหตุการณ์ที่เรียกเก็บเงินแยกกัน 2 รายการและบันทึก 2 รายการในรายงานการเรียกเก็บเงิน

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

ช่อง รูปแบบ คำอธิบาย ตัวอย่าง
billing_event_id สตริง ตัวระบุ UUID หมายเลขสุ่มที่สร้างขึ้นสำหรับเหตุการณ์ใหม่แต่ละรายการในเวลาที่สร้าง 242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff
type สตริง ประเภทกิจกรรม

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

  • basic_message
  • single_message
  • a2p_conversation
  • p2a_conversation
  • p2a_message

    • รูปแบบการเรียกเก็บเงินในสหรัฐอเมริกา

  • a2P_rich_message
  • a2p_rich_media_message
  • p2a_rich_message
  • p2a_rich_media_message
  • suggested_action_click
 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 ตัวเลข ระยะเวลาสูงสุดของการสนทนาแบบ P2A เป็นชั่วโมง วัดจากข้อความแรกของผู้ใช้ในการสนทนา 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 ตัวเลข ระยะเวลากิจกรรม ปัดเศษเป็นนาทีที่ใกล้ที่สุด

เมื่อประเภทเหตุการณ์เป็น single_message หรือ basic_message ค่าจะเป็น 0

 45
mt_messages ตัวเลข จำนวนข้อความที่สิ้นสุดที่อุปกรณ์เคลื่อนที่ (A2P) ในเหตุการณ์ 11
mo_messages ตัวเลข จำนวนข้อความที่ส่งจากอุปกรณ์เคลื่อนที่ (P2A) ในเหตุการณ์ 9
size_kilobytes ตัวเลข ขนาดของไฟล์ทั้งหมดที่แนบมากับข้อความในเหตุการณ์ โดยปัดเศษเป็น กิโลไบต์ที่ใกล้ที่สุด (1 KB = 1024 ไบต์) 912
agent_name สตริง

ชื่อของตัวแทนที่เข้าร่วมในเหตุการณ์

 XYZ Mobile USA
owner_name สตริง ชื่อเจ้าของปัจจุบันของบัญชีพาร์ทเนอร์ที่สร้างเอเจนต์ XYZ Mobile
segment_count ตัวเลข รูปแบบการเรียกเก็บเงินของสหรัฐอเมริกาเท่านั้น

จํานวนกลุ่มที่คํานวณแล้วสําหรับRICH_MESSAGEเหตุการณ์

 5

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

คุณดาวน์โหลดรายงานตัวอย่างได้ที่

ขนาดไฟล์โดยทั่วไป

ขนาดของรายงานรายวันจากพาร์ทเนอร์ RCS สำหรับธุรกิจที่ใช้งานอยู่จะขึ้นอยู่กับ ปริมาณกิจกรรมที่พาร์ทเนอร์สร้างขึ้นในเครือข่ายของผู้ให้บริการ ตัวอย่างเช่น หากมีระเบียน 53,000 รายการในรายงาน ไฟล์จะมีขนาดประมาณ 8 MB

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

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

หมายเหตุ: ระบบจะรวมเฉพาะการเข้าชมจากหมายเลขโทรศัพท์ที่ไม่ใช่หมายเลขโทรศัพท์สำหรับทดสอบไว้ในบันทึกกิจกรรม

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

รูปแบบบันทึกกิจกรรม

บันทึกกิจกรรมใช้รูปแบบชื่อไฟล์ rbm_activity_YYYY-MM-DD.csv วันที่ใน ชื่อไฟล์คือวันที่สร้างไฟล์

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

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

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