파트너는 에이전트, 이벤트 유형, 이동통신사별로 집계된 청구 가능한 이벤트의 일일 개수를 제공하는 요약 청구 보고서 를 받습니다. 이는 모든 청구 가능한 트래픽의 대략적인 요약으로, 유용한 분석과 트래픽 데이터에 대한 필요한 가시성을 제공합니다.
파일 생성 및 액세스
보고서는 CSV 형식으로 매일 생성되며 Google SFTP 서비스를 사용하여 제공됩니다.
SFTP 액세스
보고서에 대한 액세스는 공개 키/비공개 키 쌍으로 보호됩니다. SFTP 사용자 인증 정보는 안전하고 격리된 액세스를 보장합니다.
SFTP 액세스 권한을 얻는 방법
청구 보고서를 받으려면 먼저 SFTP 사용자 인증 정보를 설정해야 합니다.
- SSH 키 쌍 생성: 안내에 따라 SFTP 보관용 계정의 SSH (Secure Shell) 키 쌍을 생성합니다.
- 온보딩 시작: 파트너 보고서를 받는 데 관심이 있다면 Google 비즈니스 담당자 또는 기본 Google 담당자에게 문의하세요. 이들은 청구 보고를 위한 파트너 계정의 초기 설정 및 등록을 안내해 드립니다.
- 공개 키 제출: Google 담당자에게 공개 키 (PUB 파일)를 제공합니다. 그러면 Google에서 계정을 프로비저닝하고 고유한
<partner_id>를 할당하며 액세스 준비가 완료되면 알림을 보냅니다. 서버 액세스: 알림을 받으면 포트 19321을 사용하여
partnerupload.google.com의 SFTP 서버에서 보고서에 액세스할 수 있습니다. 다음 명령어를 사용하여 연결합니다.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 |
문자열 | 에이전트의 고유 ID | acme_342h23_agent@rbm.goog |
agent_name |
문자열 | 이벤트에 참여한 에이전트의 이름 | ACME Brand |
carrier_id |
문자열 | 트래픽의 이동통신사 ID | super-carrier |
carrier_name |
문자열 | 이동통신사 이름 | Super Carrier |
carrier_country |
문자열 | ISO 3166-1 alpha-2 국가 코드 | US |
start_date |
문자열 | 이벤트가 시작된 날짜 (YYYY-MM-DD 형식) | 2026-05-07 |
billing_date |
문자열 | 결제 보고서가 생성된 날짜 | 2026-05-08 |
event_count |
숫자 | 유형별 집계된 이벤트 수 (SUM) | 150 |
segment_count* |
숫자 | 미국 청구 모델 이벤트의 계산된 세그먼트 수 (SUM) *미국만 해당 |
5 |