이 페이지에서는 이동통신사의 결제 및 감사를 지원하기 위해 RBM에서 생성하는 데이터 파일을 설명합니다. RBM 결제 모델에 관한 일반적인 질문에 대한 답변은 RBM 결제 FAQ를 참고하세요.
| 파일 | 설명 | 액세스 권한이 있는 사용자 |
|---|---|---|
| 결제 이벤트 보고서 | 실행된 상담사와 사용자 간의 청구 가능 이벤트에 관한 집계된 보고서입니다. | RBM (RCS 비즈니스 메시지)을 적극적으로 운영하는 모든 이동통신사 |
| 활동 로그 | 청구 가능 이벤트를 포함한 RBM 활동의 원시 데이터 로그입니다. | RBM (RCS 비즈니스 메시지)을 적극적으로 운영하고 자체 서비스 약관 (ToS)에 따라 Google RCS 서비스를 운영하는 이동통신사 |
파일 생성
각 데이터 파일은 협정 세계시(UTC)로 표시된 1일간의 RBM 사용량을 나타냅니다. 파일은 매일 10:00~12:00(UTC) 사이에 생성됩니다.
대화형이 아닌 상담사의 경우 파일에는 파일 생성 시간 바로 전 24시간 동안의 데이터가 포함됩니다. 예를 들어 결제 이벤트 보고서가 5월 5일 11:00(UTC)에 생성되면 5월 4일 11:00(UTC)부터 5월 5일 11:00(UTC)까지의 데이터가 포함됩니다.
대화형 상담사의 경우 파일에는 파일 생성 시간으로부터 1~2일 전 24시간 동안의 데이터가 포함됩니다. 예를 들어 5월 5일 11:00(UTC)에 결제 이벤트 보고서가 생성되면 5월 3일 11:00(UTC)부터 5월 4일 11:00(UTC)까지의 데이터가 포함될 수 있습니다.
지연되는 이유는 대화형 상담사의 RBM 활동이 대화에 연결되어 있고 완료하는 데 최대 48시간이 걸릴 수 있기 때문입니다. 이 지연을 통해 RBM은 결제 이벤트를 계산하기 전에 대화 내 모든 메시지를 캡처할 수 있습니다. 대화형 에이전트에 관한 자세한 내용은 에이전트 결제 카테고리를 참고하세요.
핵심 사항:
활동 없음: 특정 날짜에 플랫폼 활동이 없으면 파일이 생성되지 않습니다.
이름 지정: 파일 이름의 날짜는 파일 생성 날짜이지 내부 데이터의 날짜가 아닙니다.
보관: 파일은 최대 30일 동안 보관된 후 삭제됩니다.
이 파일을 사용하여 최신 플랫폼 사용량 측정항목으로 데이터 웨어하우스를 업데이트할 수 있습니다.
파일 저장소 및 액세스
데이터 파일은 저장 및 전송 시 암호화됩니다.
보안 파일 전송 프로토콜 (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 오류가 표시됩니다. 이는 정상적인 동작입니다.
보고할 RBM 트래픽이 없으면 파일이 생성되지 않습니다. 즉, 파일이 생성되지 않는 날도 있을 수 있습니다. 프로세스를 간소화하기 위해 빈 파일이 필요한 경우 rbm-support@google.com으로 문의하세요.
결제 이벤트 보고서
결제 이벤트 보고서는 상담사의 결제 카테고리 및 전송하는 메시지 유형을 기준으로 계산되는 결제 이벤트의 기록입니다. 결제 이벤트 보고서는 RBM (RCS 비즈니스 메시지)을 적극적으로 운영하는 모든 이동통신사에서 사용할 수 있습니다.
결제 이벤트 보고서에는 기밀 정보가 포함되지만 MSISDN, 해싱된 MSISDN 또는 사용자 고유 식별자와 같은 사용자 개인 식별 정보 (PII)는 포함되지 않습니다.
상담사 결제 카테고리
소유자는 에이전트를 만들 때 에이전트가 사용자와 상호작용하는 방식에 따라 결제 카테고리를 설정합니다. 결제 카테고리는 상담사가 보낼 수 있는 메시지의 수나 유형을 제한하지 않습니다. 하지만 에이전트에게 메시지 요금이 청구되는 방식은 결정합니다. 두 가지 주요 결제 카테고리는 다음 표에 설명되어 있습니다.
| 결제 카테고리 | 에이전트 유형 | 사용 사례 | 결제 방법 |
|---|---|---|---|
대화 외 (기본 메시지 및 단일 메시지 카테고리 포함) 참고: 더 이상 이 두 카테고리 간에 차이가 없습니다. 두 카테고리 중 하나에 속하는 상담사는 대화형 외 상담사로 청구됩니다.) |
주로 일방향 메시지를 보내는 상담사 |
|
사용자에게 전송된 메시지별로 요금이 청구됩니다. |
| 대화형 | 사용자와의 대화형 상호작용을 위해 설계된 상담사입니다. |
|
대화당 청구: 한쪽 (상담사 또는 사용자)이 다른 쪽의 메시지에 24시간 이내에 답장하면 대화가 시작됩니다. 대화 기간 (첫 번째 답장 후 24시간) 동안 상담사와 사용자는 메시지를 얼마든지 주고받을 수 있으며 상담사에게 대화에 대한 고정 요금이 청구됩니다. 메시지별 요금 청구: 상담사가 사용자가 24시간 이내에 답장하지 않는 메시지를 전송하는 경우 상담사에게 대화형이 아닌 상담사와 마찬가지로 개별 메시지에 대한 요금이 청구됩니다. |
대화형 에이전트와 비대화형 에이전트 비교
두 가지 주요 청구 카테고리(대화형 및 비대화형)가 있습니다. 대화 외 카테고리에는 기능적으로 동일한 기본 메시지 및 단일 메시지 카테고리가 포함됩니다. 이 두 카테고리 중 하나에 속하는 상담사는 비대화형 상담사로 청구됩니다.
청구 카테고리의 주요 차이점은 대화형 에이전트와 비대화형 에이전트 간에 있습니다.
대화형이 아닌 상담사에게는 사용자에게 전송하는 메시지별로 요금이 청구됩니다.
- 이 카테고리는 답장이 자주 오지 않을 것으로 예상되는 상담사에게 가장 적합합니다.
대화형 상담사에게는 24시간 이내에 주고받은 모든 메시지가 포함된 대화에 대해 고정 요금이 청구됩니다.
- 이 카테고리는 사용자와 여러 번의 대화를 나누는 상담사에게 가장 적합합니다.
결제 이벤트
결제 이벤트 보고서에는 5가지 유형의 결제 이벤트가 기록됩니다. 이러한 이벤트에는 A2P 및 P2A 메시지가 포함됩니다.
- A2P (Application-to-Person): 비즈니스에서 전송합니다.
- P2A (인간의 애플리케이션 간): 사용자가 전송합니다.
다음 표에서는 비대화형 상담사 및 대화형 상담사에게 적용되는 각 결제 이벤트를 설명합니다.
| 이벤트 | 설명 | 비대화형 에이전트 | 대화형 에이전트 |
|---|---|---|---|
basic_message
|
160자(영문 기준) 이하의 텍스트만 포함된 A2P 메시지입니다. 텍스트에 openGraph 태그가 있는 웹사이트의 URL이 포함된 경우 파트너에게 추가 비용 없이 메시지에 이미지 미리보기가 표시될 수 있습니다. | 사용자가 답장했는지와 관계없이 항상 개별 결제 이벤트로 처리됩니다. | 사용자가 24시간 이내에 답장하지 않는 한 개별 결제 이벤트로 처리됩니다. 이 경우 메시지는 a2p_conversation의 일부가 됩니다.
|
single_message
|
멀티미디어 또는 160자(영문 기준)를 초과하는 텍스트가 포함된 A2P 메시지 | 사용자가 답장했는지와 관계없이 항상 개별 결제 이벤트로 처리됩니다. | 사용자가 24시간 이내에 답장하지 않는 한 개별 결제 이벤트로 처리됩니다. 이 경우 메시지는 a2p_conversation의 일부가 됩니다.
|
a2p_conversation (비즈니스에서 시작함)
|
사용자가 기존 대화 외부에서 A2P 메시지를 수신한 후 24시간 이내에 메시지에 응답하면 시작됩니다. | 해당 사항 없음. 대화형이 아닌 에이전트는 이러한 유형의 이벤트를 생성하지 않습니다. | P2A 메시지가 여러 A2P 메시지 후 24시간 이내에 전송된 경우 P2A 메시지 바로 앞의 A2P 메시지만 대화 시작에 사용됩니다. 이 A2P 메시지와 향후 24시간 이내에 전송되는 모든 메시지는 a2p_conversation의 일부입니다.
|
p2a_conversation (사용자가 시작함)
|
상담사가 P2A 메시지를 받은 후 24시간 이내에 기존 대화 외부에서 메시지에 응답하면 시작됩니다. | 해당 사항 없음. 대화형이 아닌 에이전트는 이러한 유형의 이벤트를 생성하지 않습니다. | A2P 메시지가 여러 P2A 메시지 후 24시간 이내에 전송된 경우 A2P 메시지 바로 앞의 P2A 메시지만 대화 시작에 사용됩니다. 이 P2A 메시지와 향후 24시간 이내에 전송되는 모든 메시지는 p2a_conversation의 일부입니다.
|
p2a_message
|
모든 유형의 P2A 메시지 | 상담사가 답장하는지와 관계없이 항상 개별 결제 이벤트로 처리됩니다. | 상담사가 24시간 이내에 답장하지 않는 한 개별 결제 이벤트로 처리됩니다. |
결제 이벤트와 결제 카테고리 비교
basic_message 및 single_message 결제 이벤트는 기본 메시지 및 단일 메시지 결제 카테고리와 혼동해서는 안 됩니다.
모든 상담사 (결제 카테고리와 관계없음)는
basic_message및single_message결제 이벤트를 생성할 수 있습니다.기본 메시지 및 단일 메시지 결제 카테고리는 대화형이 아닌 상담사를 분류하는 데 사용됩니다. 이러한 결제 카테고리의 상담사는 대화형 결제 이벤트 (
a2p_conversations또는p2a_conversations)를 생성하지 않습니다. 대신 개별basic_message,single_message,p2a_message결제 이벤트를 생성합니다.
결제 보고서 생성
테스터가 아닌 트래픽이 있는 상담사만 결제 이벤트를 생성합니다. 테스트 전화번호의 활동은 결제 이벤트 보고서에 표시되지 않습니다.
이 보고서는 메시지가 전송될 때가 아니라 메시지가 전송될 때 이벤트가 청구된다고 가정합니다. 전송되지 않은 메시지 또는 전송 전에 취소된 메시지는 결제 이벤트를 트리거하지 않습니다.
결제 보고서 형식
결제 이벤트 보고서는 파일 이름 형식 rbm_billable_events_YYYY-MM-DD.csv을 사용합니다. 파일 이름의 날짜는 파일 생성 날짜입니다.
보고서의 각 행은 단일 결제 이벤트를 나타내는 레코드입니다. 레코드 내 필드는 탭으로 구분됩니다. 예를 들어 동일한 상담사와의 A2P 대화 2건은 결제 이벤트 보고서에 결제 이벤트 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 = 1, 024바이트)로 반올림됩니다. | 912
|
agent_name
|
문자열 |
이벤트에 참여한 상담사의 이름입니다. |
XYZ Mobile USA
|
owner_name
|
문자열 | 상담사가 생성된 파트너 계정의 현재 소유자 이름입니다. | XYZ Mobile
|
샘플 결제 이벤트 보고서
샘플 결제 보고서 파일은 다운로드할 수 있습니다.
일반적인 파일 크기
활성 RBM 파트너의 일일 보고서에는 약 53,000개의 레코드가 포함될 수 있으며 크기는 약 8MB입니다.
활동 로그
활동 로그는 RBM 플랫폼의 활동에 관한 원시 데이터를 제공합니다. 이러한 로그를 사용하여 결제 이벤트를 감사하고 맞춤 이벤트를 만들 수 있습니다.
활동 로그에는 세부적인 거래 정보 및 구독자 MSISDN과 같은 개인 식별 정보 (PII)가 포함되어 있으므로 이동통신사가 자체 서비스 약관에 따라 RCS를 운영하는 경우에만 사용할 수 있습니다. 네트워크에 RBM 트래픽이 있고 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 | 이벤트가 RBM 플랫폼에 제출된 날짜 및 시간(UTC 형식)입니다. 타임스탬프를 참고하세요. | 2019-07-25T00:29:07.033Z
|
type
|
문자열 | 활동 유형:
|
text_message
|
size_bytes
|
문자열 | 활동에 첨부된 파일의 크기(바이트)입니다. | 912
|
타임스탬프
활동 로그의 타임스탬프는 이벤트가 RBM 플랫폼에 제출된 시점을 기록합니다. 사용자에게 콘텐츠를 전송하는 이벤트의 경우 메시지가 전송될 때까지 활동 로그에 이벤트가 기록되지 않습니다.
예를 들어 수요일 13:00에 사용자에게 RBM 메시지가 전송되었는데 수신자가 일요일 9시까지 오프라인 상태였다면 일요일에 생성된 활동 로그에 이벤트가 표시되지만 타임스탬프는 수요일 13:00으로 표시됩니다.