รายงานการเรียกเก็บเงินของพาร์ทเนอร์

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

การสร้างและการเข้าถึงไฟล์

ระบบจะสร้างรายงานทุกวันในรูปแบบ CSV และส่งโดยใช้บริการ SFTP ของ Google

การเข้าถึง SFTP

ระบบจะปกป้องการเข้าถึงรายงานด้วยคู่คีย์สาธารณะ/ส่วนตัว ข้อมูลเข้าสู่ระบบ SFTP ช่วยให้มั่นใจได้ถึงการเข้าถึงที่ปลอดภัยและแยกกัน

วิธีรับสิทธิ์เข้าถึง SFTP

หากต้องการรับรายงานการเรียกเก็บเงิน คุณต้องตั้งค่าข้อมูลเข้าสู่ระบบ SFTP ก่อน โดยทำดังนี้

  1. สร้างคู่คีย์ SSH: ทำตามวิธีการเพื่อ สร้างคู่คีย์ Secure Shell (SSH) สำหรับดรอปบ็อกซ์ SFTP
  2. เริ่มการเริ่มต้นใช้งาน: หากสนใจรับรายงานพาร์ทเนอร์ โปรดติดต่อตัวแทนธุรกิจของ Google หรือผู้ติดต่อหลักของ Google ตัวแทนจะแนะนำคุณตลอดการตั้งค่าและการลงทะเบียนบัญชีพาร์ทเนอร์เบื้องต้นสำหรับการรายงานการเรียกเก็บเงิน
  3. ส่งคีย์สาธารณะ: ส่งคีย์สาธารณะ (ไฟล์ PUB) ให้ผู้ติดต่อของ Google จากนั้น Google จะจัดเตรียมบัญชีของคุณ กำหนด <partner_id>ที่ไม่ซ้ำกัน และแจ้งให้คุณทราบเมื่อบัญชีพร้อมใช้งาน
  4. เข้าถึงเซิร์ฟเวอร์: เมื่อได้รับการแจ้งเตือนแล้ว คุณสามารถเข้าถึงรายงานในเซิร์ฟเวอร์ SFTP ที่ partnerupload.google.com โดยใช้พอร์ต 19321 ใช้คำสั่งต่อไปนี้เพื่อเชื่อมต่อ

    sftp -i <path_to_private_key> -P 19321 rbmreports-partner-<partner_id>@partnerupload.google.com
    

รูปแบบการตั้งชื่อไฟล์

ระบบจะแยกรายงานของผู้ให้บริการทั้งหมดตามผู้ให้บริการ

โครงสร้างการตั้งชื่อไดเรกทอรีและไฟล์มีดังนี้


rbmreports-partner-<partner_id>/
  <YYYY>/<MM>/<DD>/
     summary_<short_carrier_id>/
        summary_<short_carrier_id>_<YYYY-MM-DD>.csv
     ...
     <prefix>_<short_carrier_id>/
        <prefix>_<short_carrier_id>_<YYYY-MM-DD>.csv

<prefix> ระบุประเภทรายงานที่เฉพาะเจาะจงที่จะส่ง

คำนำหน้ามาตรฐาน ได้แก่

ประเภทรายงาน คำนำหน้าชื่อไฟล์
รายงานสรุป summary

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

โครงสร้างรายงาน CSV

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

หากมีคำถามเพิ่มเติม โปรดติดต่อผู้ให้บริการ

รูปแบบรายงานสรุป

ฟิลด์ รูปแบบ คำอธิบาย ตัวอย่าง
type สตริง ประเภทเหตุการณ์การเรียกเก็บเงิน a2p_session
agent_id สตริง รหัสที่ไม่ซ้ำกันสำหรับตัวแทน acme_342h23_agent@rbm.goog
agent_name สตริง ชื่อตัวแทนที่เข้าร่วมในเหตุการณ์ ACME Brand
carrier_id สตริง รหัสผู้ให้บริการสำหรับการรับส่งข้อมูล super-carrier
carrier_name สตริง ชื่อผู้ให้บริการขนส่ง Super Carrier
carrier_country สตริง รหัสประเทศในรูปแบบ ISO 3166-1 Alpha-2 US
start_date สตริง วันที่เริ่มเหตุการณ์ (รูปแบบ ปปปป-ดด-วว) 2026-05-07
billing_date สตริง วันที่สร้างรายงานการเรียกเก็บเงิน 2026-05-08
event_count ตัวเลข จำนวนเหตุการณ์รวมต่อประเภท (SUM) 150
segment_count* ตัวเลข จำนวนเซกเมนต์ที่คำนวณสำหรับเหตุการณ์โมเดลการเรียกเก็บเงินของสหรัฐอเมริกา (SUM)
*สหรัฐอเมริกาเท่านั้น
5