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

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

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

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

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

ไฟล์ข้อมูลแต่ละไฟล์แสดงถึงการใช้งาน RCS for Business ในหนึ่งวันตามเวลามาตรฐานแปซิฟิก (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 วันก่อนที่จะถูกลบ

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

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

ไฟล์ข้อมูลจะถูกเข้ารหัสทั้งขณะจัดเก็บและขณะส่งผ่าน

ในการดึงไฟล์ข้อมูลโดยใช้โปรโตคอลการถ่ายโอนไฟล์ที่ปลอดภัย (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 for Business อยู่ในปัจจุบัน

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

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

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

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

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

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

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

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

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

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

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

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

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

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

กิจกรรมที่เรียกเก็บเงินได้

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

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

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

เหตุการณ์ คำอธิบาย ตัวแทนที่ไม่ใช่การสนทนา ตัวแทนการสนทนา
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 สตริง รหัสประจำตัวที่ไม่ซ้ำกันสำหรับตัวแทนที่เข้าร่วมกิจกรรม 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 ตัวเลข ระยะเวลาของกิจกรรม ปัดเศษให้ใกล้เคียงที่สุดเป็นนาที

ค่าจะเป็น 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 for Business ที่ใช้งานอยู่จะขึ้นอยู่กับปริมาณกิจกรรมที่พวกเขาสร้างขึ้นบนเครือข่ายของผู้ให้บริการ ตัวอย่างเช่น หากมีบันทึก 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 สตริง รหัสประจำตัวที่ไม่ซ้ำกันสำหรับตัวแทน welcome-bot@rbm.goog
user_id สตริง หมายเลข MSISDN ของผู้ใช้ 918369110173
direction สตริง ทิศทางที่ส่งข้อความ:
  • MT (อุปกรณ์รับส่งสัญญาณผ่านมือถือ) สำหรับกิจกรรมระหว่างตัวแทนกับผู้ใช้
  • MO (mobile originating) สำหรับกิจกรรมระหว่างผู้ใช้กับเอเจนต์
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 น. และผู้รับออฟไลน์จนถึงวันอาทิตย์ เวลา 9:00 น. เหตุการณ์นั้นจะปรากฏในบันทึกกิจกรรมที่สร้างขึ้นสำหรับวันอาทิตย์ แต่เวลาที่บันทึกจะเป็นวันพุธ เวลา 13:00 น.