이 페이지에서는 이동통신사의 청구 및 감사에 도움이 되도록 비즈니스용 RCS에서 생성하는 데이터 파일을 설명합니다.
| 파일 | 설명 | 액세스 권한이 있는 사용자 |
|---|---|---|
| 결제 보고서 | 실행된 상담사와 사용자 간의 청구 가능한 이벤트의 집계 보고서입니다. | 비즈니스용 RCS를 활발하게 운영하는 모든 이동통신사 |
| 활동 로그 | 청구 가능한 이벤트를 포함한 비즈니스용 RCS 활동의 원시 데이터 로그입니다. | RCS for Business를 적극적으로 운영하고 자체 서비스 약관 (ToS)에 따라 Google RCS 서비스를 운영하는 이동통신사 |
비즈니스용 RCS는 미국 외 트래픽에 표준 청구 모델을 사용하고 미국 트래픽에 미국 청구 모델을 사용하는 두 가지 청구 모델을 사용합니다. 표준 모델 또는 미국 모델에만 해당하는 정보 (예: 청구 가능한 이벤트 분류 또는 보고서 필드)는 명시적으로 표시됩니다.
파일 생성
각 데이터 파일은 협정 세계시 (UTC)의 비즈니스용 RCS 사용량을 하루 동안 나타냅니다. 파일은 매일 생성됩니다. 생성 프로세스에 몇 시간이 걸릴 수 있으며 완료 시간은 다를 수 있습니다.
비대화형 에이전트의 경우 파일에는 파일 생성 시간 바로 전 24시간 동안의 데이터가 포함됩니다. 예를 들어 5월 5일 11:00 UTC에 청구 보고서가 생성되면 5월 4일 11:00 UTC부터 5월 5일 11:00 UTC까지의 데이터가 포함됩니다.
대화형 에이전트의 경우 파일에는 파일 생성 시간 1~2일 전의 24시간 동안의 데이터가 포함됩니다. 예를 들어 5월 5일 11시(UTC)에 청구 보고서가 생성되면 5월 3일 11시(UTC)부터 5월 4일 11시(UTC)까지의 데이터가 포함될 수 있습니다.
지연되는 이유는 대화형 에이전트의 비즈니스용 RCS 활동이 대화에 연결되어 있기 때문이며, 이 작업은 완료하는 데 최대 48시간이 걸릴 수 있습니다. 이 지연을 통해 RCS for Business는 청구 가능한 이벤트를 계산하기 전에 대화 내 모든 메시지를 캡처할 수 있습니다. 대화형 에이전트에 대한 자세한 내용은 에이전트 청구 카테고리를 참고하세요.
핵심 사항:
활동 없음: 특정 날짜에 플랫폼 활동이 없으면 파일이 생성되지 않습니다.
이름 지정: 파일 이름의 날짜는 파일 생성 날짜이며 데이터의 날짜가 아닙니다.
보관: 파일은 삭제되기 전 최대 63일 동안 저장됩니다.
이 파일을 사용하여 최신 플랫폼 사용량 측정항목으로 데이터 웨어하우스를 업데이트할 수 있습니다.
파일 저장 및 액세스
데이터 파일은 저장 시와 전송 시 암호화됩니다.
보안 파일 전송 프로토콜 (SFTP)로 데이터 파일을 검색하려면 SFTP 공개 키를 제공하세요. 키를 생성하려면 SFTP 보관용 계정의 SSH (Secure Shell) 키 쌍 생성을 참고하세요.
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>를 지정하고 보고서 유형별로 별도의 계정을 제공합니다.
다양한 보고서 유형에 액세스할 수 있는 별도의 계정이 제공됩니다.
파일 사용 가능 여부
아직 데이터 파일이 생성되지 않은 경우 remote readdir("/"): No such file or directory와 유사한 SFTP 오류가 표시되는데 이는 정상입니다.
보고할 비즈니스용 RCS 트래픽이 없으면 파일이 생성되지 않습니다. 즉, 파일이 생성되지 않는 날도 있을 수 있습니다. 프로세스를 간소화하기 위해 빈 파일이 필요한 경우 rbm-support@google.com으로 문의하세요.
결제 보고서
청구 보고서는 청구 가능한 이벤트의 기록이며, 이는 상담사의 청구 카테고리와 전송하는 메시지 유형을 기반으로 계산됩니다. 결제 보고서는 비즈니스용 RCS를 활발하게 운영하는 모든 이동통신사에서 사용할 수 있습니다.
결제 보고서에는 기밀 정보가 포함되지만 MSISDN, 해시된 MSISDN 또는 사용자 고유 식별자와 같은 사용자 개인 식별 정보 (PII)는 포함되지 않습니다.
상담사 청구 카테고리
에이전트를 만들 때 소유자는 에이전트가 사용자와 상호작용하는 방식에 따라 청구 카테고리를 설정합니다. 청구 카테고리는 상담사가 보낼 수 있는 메시지의 수나 유형을 제한하지 않습니다. 하지만 메시지에 대한 에이전트 요금 청구 방식을 결정합니다. 두 가지 주요 청구 카테고리는 다음 표에 설명되어 있습니다.
| 결제 카테고리 | 에이전트 유형 | 사용 사례 | 결제 방법 |
|---|---|---|---|
| 비대화형 | 주로 일방향 메시지를 보내는 상담사 |
|
사용자에게 전송된 메시지마다 요금이 청구됩니다. |
| 대화형 | 사용자와의 양방향 교환을 위해 설계된 에이전트 |
|
대화당 청구: 한쪽 (상담사 또는 사용자)이 24시간 이내에 상대방의 메시지에 답장하면 대화가 시작됩니다. 대화 창 (첫 번째 답장 후 24시간) 동안 상담사와 사용자는 원하는 만큼 메시지를 주고받을 수 있으며 상담사에게는 대화에 대한 고정 요금이 청구됩니다. 메시지당 청구: 상담사가 사용자가 24시간 이내에 답장하지 않는 메시지를 전송하는 경우 상담사에게 개별 메시지에 대한 요금이 청구됩니다(비대화형 상담사와 유사). |
다음 다이어그램은 대화형 에이전트의 A2P 청구 세션의 예를 보여줍니다.
대화형 에이전트와 비대화형 에이전트 비교
청구 카테고리에는 대화형과 비대화형의 두 가지 주요 카테고리가 있습니다.
청구 카테고리의 주요 차이점은 대화형 에이전트와 비대화형 에이전트 간에 있습니다.
비대화형 상담사는 사용자에게 전송하는 각 메시지에 대해 요금이 청구됩니다.
- 이 카테고리는 자주 회신을 받지 않는 상담사에게 가장 적합합니다.
대화형 상담사에게는 24시간 이내에 주고받은 모든 메시지를 포함하는 대화에 대해 고정 요금이 청구됩니다.
- 이 카테고리는 사용자와 멀티턴 대화를 하는 상담사에게 가장 적합합니다.
청구 가능한 이벤트
결제 보고서에는 5가지 유형의 청구 가능한 이벤트가 기록됩니다. 이러한 이벤트에는 A2P 및 P2A 이벤트라고 하는 MT 및 MO 이벤트가 포함됩니다.
- A2P (Application-to-Person)는 MT (Mobile Terminated): 비즈니스에서 보낸 메시지입니다.
- P2A (Person-to-Application)는 MO (Mobile Originated)입니다. 사용자가 시작한 메시지 또는 작업입니다.
다음 표에서는 비대화형 및 대화형 에이전트에 적용되는 각 청구 가능 이벤트를 설명합니다.
| 이벤트 | 설명 | 비대화형 에이전트 | 대화형 에이전트 |
|---|---|---|---|
basic_message
|
160자(영문 기준) 이하의 텍스트만 포함된 A2P 메시지입니다. 텍스트에 openGraph 태그가 있는 웹사이트의 URL이 포함된 경우 파트너에게 추가 비용이 청구되지 않고 메시지에 이미지 미리보기가 표시될 수 있습니다. | 사용자의 응답 여부와 관계없이 항상 개별 청구 가능 이벤트로 처리됩니다. | 사용자가 24시간 이내에 답장하지 않으면 개별 청구 가능 이벤트로 처리됩니다. 이 경우 메시지는 a2p_conversation의 일부가 됩니다.
|
single_message
|
리치 콘텐츠가 있거나 160자를 초과하는 텍스트 전용 메시지인 A2P 메시지 | 사용자의 응답 여부와 관계없이 항상 개별 청구 가능 이벤트로 처리됩니다. | 사용자가 24시간 이내에 답장하지 않으면 개별 청구 가능 이벤트로 처리됩니다. 이 경우 메시지는 a2p_conversation의 일부가 됩니다.
|
a2p_conversation (비즈니스 시작)
|
사용자가 기존 대화 외부에서 A2P 메시지를 수신한 후 24시간 이내에 응답할 때 시작됩니다. | 해당 사항 없음. 비대화형 에이전트는 이러한 유형의 이벤트를 생성하지 않습니다. | 여러 A2P 메시지로부터 24시간 이내에 P2A 메시지가 전송된 경우 P2A 메시지 바로 앞에 있는 A2P 메시지만 사용하여 대화를 시작합니다. 이 A2P 메시지와 향후 24시간 이내에 전송되는 메시지는 a2p_conversation에 포함됩니다.
|
p2a_conversation (사용자 요청)
|
상담사가 기존 대화 외부에서 P2A 메시지를 받은 후 24시간 이내에 응답하는 경우 시작됩니다. | 해당 사항 없음. 비대화형 에이전트는 이러한 유형의 이벤트를 생성하지 않습니다. | A2P 메시지가 여러 P2A 메시지로부터 24시간 이내에 전송되는 경우 A2P 메시지 바로 앞에 있는 P2A 메시지만 대화를 시작하는 데 사용됩니다. 이 P2A 메시지와 향후 24시간 이내에 전송되는 메시지는 p2a_conversation에 포함됩니다.
|
p2a_message
|
모든 유형의 P2A 메시지 | 에이전트의 응답 여부와 관계없이 항상 개별 청구 가능 이벤트로 처리됩니다. | 상담사가 24시간 이내에 응답하지 않으면 개별 청구 가능 이벤트로 처리됩니다. |
결제 카테고리와 청구 가능한 이벤트 비교
상담사 청구 카테고리와 청구 가능한 이벤트의 차이점을 이해하는 것이 상담사 요금 청구 방식을 파악하는 데 중요합니다.
- 결제 카테고리는 에이전트를 만들 때 선택하는 고정 분류입니다. 에이전트 요금 청구 방식(메시지당(비대화형 에이전트) 또는 대화당(대화형 에이전트))을 결정합니다.
- 청구 가능한 이벤트는 청구 목적으로 추적되는 비즈니스용 RCS 에이전트와 사용자 간의 상호작용입니다 (예:
basic_message,single_message,a2p_conversation).
결제 보고서 생성
테스터가 아닌 트래픽이 있는 에이전트만 청구 가능한 이벤트를 생성합니다. 테스트 전화번호의 활동은 청구 보고서에 표시되지 않습니다.
이러한 보고서는 메시지가 전송될 때가 아니라 메시지가 전송될 때 이벤트에 요금이 청구된다고 가정합니다. 전달되지 않은 메시지 또는 전달 전에 취소된 메시지는 청구 가능한 이벤트를 트리거하지 않습니다.
결제 보고서 형식
결제 보고서는 rbm_billable_events_YYYY-MM-DD.csv 파일 이름 형식을 사용합니다.
파일 이름의 날짜는 파일 생성 날짜입니다.
보고서의 각 행은 단일 청구 가능 이벤트를 나타내는 레코드입니다. 레코드 내 필드는 탭으로 구분됩니다. 예를 들어 동일한 상담사와 두 번의 A2P 대화를 나누면 청구 가능한 이벤트 2개와 청구 보고서의 레코드 2개가 생성됩니다.
보고서의 각 레코드에는 청구 가능한 각 이벤트에 대한 다음 정보가 포함됩니다.
| 필드 | 형식 | 설명 | 예 |
|---|---|---|---|
billing_event_id
|
문자열 | UUID 식별자입니다. 새 이벤트가 생성될 때마다 생성되는 난수입니다. | 242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff
|
type
|
문자열 | 이벤트 유형:
표준 결제 모델 미국 결제 모델 |
single_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 메시지
P2A 메시지
|
2019-07-25T08:00:00Z
|
duration
|
숫자 | 가장 가까운 분으로 반올림된 이벤트 지속 시간입니다.
이벤트 유형이 |
45
|
mt_messages
|
숫자 | 이벤트의 모바일 종료 (A2P) 메시지 수입니다. | 11
|
mo_messages
|
숫자 | 이벤트의 모바일 발신 (P2A) 메시지 수입니다. | 9
|
size_kilobytes
|
숫자 | 이벤트의 메일에 첨부된 모든 파일의 크기입니다. 가장 가까운 킬로바이트 (1KB = 1024바이트)로 반올림됩니다. | 912
|
agent_name
|
문자열 |
이벤트에 참여한 상담사의 이름입니다. |
XYZ Mobile USA
|
owner_name
|
문자열 | 상담사가 생성된 파트너 계정의 현재 소유자 이름입니다. | XYZ Mobile
|
segment_count
|
숫자 | 미국 결제 모델만 해당
|
5
|
샘플 결제 이벤트 보고서
샘플 보고서를 다운로드할 수 있습니다.
일반적인 파일 크기
활성 RCS for Business 파트너의 일일 보고서 크기는 이동통신사 네트워크에서 생성한 활동량에 따라 다릅니다. 예를 들어 보고서에 53,000개의 레코드가 있는 경우 파일 크기는 약 8MB입니다.
활동 로그
활동 로그는 비즈니스용 RCS 플랫폼의 활동에 관한 원시 데이터를 제공합니다. 이 로그를 사용하여 결제 이벤트를 감사하고 맞춤 이벤트를 만들 수 있습니다.
참고: 테스터가 아닌 전화번호에서 발생한 트래픽만 활동 로그에 포함됩니다.
활동 로그에는 자세한 거래 정보와 구독자 MSISDN과 같은 개인 식별 정보 (PII)가 포함되어 있으므로 이동통신사가 자체 서비스 약관에 따라 RCS를 운영하는 경우에만 사용할 수 있습니다. 네트워크에 비즈니스용 RCS 트래픽이 있고 Google 서비스 약관에 따라 Google RCS로 RCS 활동을 사용 설정한 경우 활동 로그에 액세스할 수 없습니다.
활동 로그 형식
활동 로그는 rbm_activity_YYYY-MM-DD.csv 파일 이름 형식을 사용합니다. 파일 이름의 날짜는 파일 생성 날짜입니다.
레코드의 필드는 탭으로 구분되며 각 줄에 하나의 레코드가 있습니다.
활동 로그의 각 레코드에는 각 활동에 대한 다음 필드가 포함됩니다.
| 필드 | 형식 | 설명 | 예 |
|---|---|---|---|
activity_id
|
문자열 | 활동의 고유 식별자입니다. | b422e1d3-ac99-442a-853d-a875d5e61762
|
billing_event_id
|
문자열 | 연결된 결제 이벤트의 고유 식별자입니다. 활동이 결제 이벤트와 연결되지 않은 경우(예: 해당 delivery_receipt_event이 없는 text_message) 비어 있을 수 있습니다.
|
91yeb201-7c3b-412b-98d2-b0a0f7abe536
|
agent_id
|
문자열 | 상담사의 고유 식별자입니다. | welcome-bot@rbm.goog
|
user_id
|
문자열 | 사용자의 MSISDN입니다. | 918369110173
|
direction
|
문자열 | 메시지가 전송되는 방향입니다.
|
MT
|
time
|
YYYY-mm-ddTHH:MM:SS.SSSZ | 이벤트가 비즈니스용 RCS 플랫폼에 제출된 날짜와 시간입니다(UTC 형식). 타임스탬프를 참고하세요. | 2019-07-25T00:29:07.033Z
|
type
|
문자열 | 활동 유형:
|
text_message
|
size_bytes
|
문자열 | 활동에 첨부된 파일의 크기(바이트)입니다. | 912
|
타임스탬프
활동 로그의 타임스탬프는 이벤트가 비즈니스용 RCS 플랫폼에 제출된 시간을 기록합니다. 사용자에게 콘텐츠를 제공하는 이벤트의 경우 메시지가 전송될 때까지 활동 로그에 이벤트가 기록되지 않습니다.
예를 들어 비즈니스용 RCS 메시지가 수요일 13:00에 사용자에게 전송되고 수신자가 일요일 9:00까지 오프라인 상태인 경우 이벤트는 일요일에 생성된 활동 로그에 표시되지만 타임스탬프는 수요일 13:00입니다.