이 페이지에서는 RCS for Business가 통신 사업자의 청구 및 감사 업무를 지원하기 위해 생성하는 데이터 파일에 대해 설명합니다.
| 파일 | 설명 | 누가 접근 권한을 가지고 있나요? |
|---|---|---|
| 청구 보고서 | 실행된 상담원과 사용자 간의 청구 가능 이벤트에 대한 종합 보고서입니다. | RCS for Business를 적극적으로 운영하는 모든 통신 사업자. |
| 활동 로그 | 청구 가능한 이벤트를 포함한 RCS for Business 활동의 원시 데이터 로그입니다. | RCS for Business를 적극적으로 운영하고 있으며 자체 서비스 약관(ToS)에 따라 Google RCS 서비스를 운영하는 통신 사업자. |
RCS for Business는 미국 이외 지역 트래픽에 대해 표준 청구 모델을 사용합니다. 자세한 내용은 청구 FAQ를 참조하십시오.
파일 생성
각 데이터 파일은 태평양 표준시(PST) 기준으로 RCS for Business의 하루 사용량을 나타냅니다. 파일은 매일 생성되며 이전 24시간(자정부터 자정까지) 동안의 활동을 반영합니다. 생성 과정은 몇 시간이 소요될 수 있으며 완료 시간은 변동될 수 있습니다.
- 대화형 상담원이 아닌 경우, 파일에는 파일이 생성된 날짜 바로 전 24시간 동안의 데이터가 포함됩니다. 예를 들어, 5월 5일에 생성된 보고서는 5월 4일 자정부터 5월 5일 자정까지의 데이터를 포함합니다. 여기서 시간은 태평양 표준시(PST)를 기준으로 합니다.
대화 형 에이전트의 경우, 파일에는 파일 생성 시점으로부터 1~2일 전 24시간 동안의 데이터가 포함됩니다. 예를 들어, 5월 5일에 생성된 보고서는 5월 2일 또는 5월 3일의 24시간 동안의 데이터를 포함합니다. 지정된 시간은 태평양 표준시(PST) 기준입니다.
지연 사유는 대화형 에이전트의 RCS for Business 활동이 세션과 연결되어 있기 때문이며, 세션 완료에는 최대 24시간이 소요될 수 있습니다. 이 지연 시간은 RCS for Business가 청구 가능한 이벤트를 계산하기 전에 대화 내의 모든 메시지를 캡처할 수 있도록 합니다. 대화형 에이전트에 대한 자세한 내용은 에이전트 청구 범주를 참조하십시오.
핵심 사항:
- 활동 없음 : 기본적으로 특정일에 플랫폼 활동이 없으면 파일이 생성되지 않습니다. 하지만 필요한 경우 빈 파일 수신을 선택할 수 있습니다. 빈 파일 수신을 선택하려면 rbm-support@google.com으로 문의하세요.
- 명명 규칙 : 파일 이름에 있는 날짜는 파일 생성 날짜이며, 파일 내 데이터의 날짜가 아닙니다.
- 보존 기간 : 파일은 최대 63일 동안 보관된 후 삭제됩니다.
이 파일들을 사용하여 최신 플랫폼 사용량 지표로 데이터 웨어하우스를 업데이트할 수 있습니다.
파일 저장 및 접근
데이터 파일은 저장 시와 전송 시 모두 암호화됩니다.
SFTP(보안 파일 전송 프로토콜)를 사용하여 데이터 파일을 검색하려면 SFTP 공개 키를 제공해야 합니다. 키를 생성하려면 SFTP 드롭박스용 SSH(보안 셸) 키 쌍 생성하기를 참조하십시오.
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 for Business 트래픽 보고가 없을 경우 파일이 생성되지 않습니다. 따라서 파일이 생성되지 않는 날이 있을 수 있습니다. 프로세스 효율화를 위해 빈 파일이 필요한 경우 RCS for Business 지원팀에 문의하십시오 .
청구 보고서
청구 보고서는 청구 가능한 이벤트 기록으로, 상담원의 청구 범주 와 전송하는 메시지 유형을 기준으로 계산됩니다. 청구 보고서는 RCS for Business를 활발하게 운영하는 모든 통신사에서 이용할 수 있습니다.
청구 보고서에는 기밀 정보가 포함되어 있지만 MSISDN, 해시 처리된 MSISDN 또는 사용자 고유 식별자와 같은 사용자 개인 식별 정보(PII)는 포함되어 있지 않습니다.
에이전트 청구 카테고리
에이전트를 생성할 때 소유자는 에이전트가 사용자와 상호 작용하는 방식에 따라 청구 범주를 설정합니다. 청구 범주는 에이전트가 보낼 수 있는 메시지의 수나 유형을 제한하지는 않지만, 메시지에 대한 요금 청구 방식을 결정합니다. 주요 청구 범주 두 가지는 다음 표에 설명되어 있습니다.
| 청구 카테고리 | 에이전트 유형 | 예시 사용 사례 | 청구 방식 |
|---|---|---|---|
| 비대화적 | 주로 단방향 메시지를 보내는 에이전트. |
| 사용자에게 전달되는 메시지당 요금이 부과됩니다. |
| 이야기 잘하는 | 사용자 간의 양방향 소통을 위해 설계된 에이전트입니다. |
| 대화 건당 요금 부과 : 상담원 또는 사용자가 상대방의 메시지에 24시간 이내에 답장하면 대화가 시작됩니다. 대화 기간(첫 답장 후 24시간) 동안 상담원과 사용자는 제한 없이 메시지를 주고받을 수 있으며, 상담원은 해당 대화에 대해 고정 요금으로 요금을 지불합니다. 메시지당 요금 부과 : 상담원이 메시지를 전달했는데 사용자가 24시간 이내에 답장하지 않으면, 일반 상담원과 마찬가지로 해당 메시지에 대한 요금이 부과됩니다. |
다음 다이어그램은 대화형 에이전트에 대한 A2P 청구 세션의 예를 보여줍니다.
대화형 에이전트와 비대화형 에이전트
요금 청구 방식에는 크게 대화형과 비대화형 두 가지 유형이 있습니다.
청구 방식의 주요 차이점은 대화형 상담원과 비대화형 상담원 간의 차이입니다.
대화형이 아닌 상담원은 사용자에게 전달하는 메시지마다 비용이 청구됩니다.
- 이 카테고리는 잦은 답변을 기대하지 않는 상담원에게 가장 적합합니다.
대화형 상담원은 24시간 동안 주고받은 모든 메시지를 포함하여 대화 당 고정 요금으로 청구됩니다.
- 이 카테고리는 사용자와 여러 차례 대화를 주고받는 상담원에게 가장 적합합니다.
청구 가능한 이벤트
청구 보고서에는 5가지 유형의 청구 가능 이벤트가 기록됩니다. 이러한 이벤트에는 MT 및 MO 이벤트가 포함되며, 이는 각각 A2P 및 P2A 이벤트로 불립니다.
- A2P(Application-to-Person)는 MT(Mobile Terminated)입니다. 즉, 기업에서 보내는 메시지입니다.
- P2A(Person-to-Application)는 MO(Mobile Originated)의 약자로 , 사용자가 시작한 메시지 또는 작업을 의미합니다.
다음 표는 비대화형 상담원과 대화형 상담원에게 적용되는 각 유료 이벤트를 설명합니다.
| 이벤트 | 설명 | 비대화형 에이전트 | 대화형 에이전트 |
|---|---|---|---|
basic_message | A2P 메시지는 160자 이하의 텍스트만 포함할 수 있습니다. 텍스트에 openGraph 태그가 포함된 웹사이트 URL이 있는 경우, 파트너에게 추가 비용 없이 이미지 미리보기가 표시될 수 있습니다. | 사용자의 응답 여부와 관계없이 항상 개별 유료 이벤트로 처리됩니다. | 사용자가 24시간 이내에 회신하지 않으면 개별 유료 이벤트로 처리됩니다. 사용자가 24시간 이내에 회신하는 경우 해당 메시지는 a2p_conversation 의 일부가 됩니다. |
single_message | 풍부한 콘텐츠를 포함하거나 160자 이상의 텍스트 전용 메시지인 A2P 메시지입니다. | 사용자의 응답 여부와 관계없이 항상 개별 유료 이벤트로 처리됩니다. | 사용자가 24시간 이내에 회신하지 않으면 개별 유료 이벤트로 처리됩니다. 사용자가 24시간 이내에 회신하는 경우 해당 메시지는 a2p_conversation 의 일부가 됩니다. |
a2p_conversation (비즈니스 주도) | 사용자가 기존 대화와 무관하게 A2P 메시지를 수신한 후 24시간 이내에 응답할 경우 발생합니다. | 해당 없음. 비대화형 에이전트는 이러한 유형의 이벤트를 생성하지 않습니다. | 여러 개의 A2P 메시지가 24시간 이내에 전달된 경우, P2A 메시지 바로 직전에 전달된 A2P 메시지만 대화를 시작하는 데 사용됩니다. 이 A2P 메시지와 이후 24시간 이내에 전달된 모든 메시지는 a2p_conversation 의 일부가 됩니다. |
p2a_conversation (사용자 시작) | 기존 대화와 관계없이 상담원이 P2A 메시지를 수신한 후 24시간 이내에 응답할 경우 발생합니다. | 해당 없음. 비대화형 에이전트는 이러한 유형의 이벤트를 생성하지 않습니다. | 여러 개의 P2A 메시지가 24시간 이내에 전달된 경우, A2P 메시지 바로 직전에 전달된 P2A 메시지만 대화를 시작하는 데 사용됩니다. 이 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 | 끈 | 청구 대상 이벤트를 구분하는 생성된 ID입니다. | 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 | 숫자 | 이벤트 지속 시간은 가장 가까운 분 단위로 반올림됩니다. 대화와 관련 없는 이벤트의 경우 값은 0입니다. | 45 |
mt_messages | 숫자 | 이벤트 내 모바일 수신(A2P) 메시지 수. | 11 |
mo_messages | 숫자 | 이벤트 내 모바일 발신(P2A) 메시지 수. | 9 |
size_kilobytes | 숫자 | 이벤트 메시지에 첨부된 모든 파일의 크기를 킬로바이트 단위로 반올림한 값입니다(1kB는 1024바이트). | 912 |
agent_name | 끈 | 이벤트에 참여한 담당자의 이름. | XYZ Mobile USA |
owner_name | 끈 | 에이전트가 생성된 파트너 계정의 현재 소유자 이름입니다. | XYZ Mobile |
샘플 청구서
샘플 보고서는 다운로드할 수 있습니다.
일반적인 파일 크기
활성 RCS for Business 파트너의 일일 보고서 크기는 해당 파트너가 통신 사업자 네트워크에서 발생시킨 활동량에 따라 달라집니다. 예를 들어 보고서에 53,000개의 레코드가 포함된 경우 파일 크기는 약 8MB가 됩니다.
활동 로그
활동 로그는 RCS for Business 플랫폼에서의 활동에 대한 원시 데이터를 제공합니다. 이러한 로그를 사용하여 청구 가능한 이벤트를 감사하고 사용자 지정 이벤트를 생성할 수 있습니다.
활동 로그에는 상세한 거래 정보 및 가입자 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 for Business 플랫폼에 제출된 날짜 및 시간(UTC 형식). 타임스탬프를 참조하세요. | 2019-07-25T00:29:07.033Z |
type | 끈 | 활동 유형:
| text_message |
size_bytes | 끈 | 활동에 첨부된 파일의 크기(바이트). | 912 |
타임스탬프
활동 로그의 타임스탬프는 이벤트가 RCS for Business 플랫폼에 제출된 시점을 기록합니다. 사용자에게 콘텐츠를 전달하는 이벤트의 경우, 메시지가 전달될 때까지 활동 로그에 기록되지 않습니다.
예를 들어, 수요일 13시에 사용자에게 RCS for Business 메시지를 보냈는데 수신자가 일요일 9시까지 오프라인 상태인 경우, 해당 이벤트는 일요일에 생성된 활동 로그에 나타나지만 타임스탬프는 수요일 13시로 표시됩니다.