결제 이벤트 보고서 및 활동 로그

이 페이지에서는 이동통신사의 청구 및 감사에 도움이 되도록 비즈니스용 RCS에서 생성하는 데이터 파일을 설명합니다. 비즈니스용 RCS 결제 모델에 관한 일반적인 질문에 대한 답변은 결제 FAQ를 참고하세요.

파일	설명	액세스 권한이 있는 사용자
결제 이벤트 보고서	실행된 상담사와 사용자 간 청구 가능한 이벤트의 집계 보고서입니다.	비즈니스용 RCS를 활발하게 운영하는 모든 이동통신사
활동 로그	청구 가능한 이벤트를 포함한 비즈니스용 RCS 활동의 원시 데이터 로그입니다.	RCS for Business를 적극적으로 운영하고 자체 서비스 약관 (ToS)에 따라 Google 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:00 UTC에 청구 이벤트 보고서가 생성되면 5월 3일 11:00 UTC부터 5월 4일 11:00 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 트래픽이 없으면 파일이 생성되지 않습니다. 즉, 파일이 생성되지 않는 날도 있을 수 있습니다. 프로세스를 간소화하기 위해 빈 파일이 필요한 경우 [e-mail]으로 문의하세요.

결제 이벤트 보고서

청구 이벤트 보고서는 청구 이벤트의 기록으로, 상담사의 청구 카테고리와 전송하는 메시지 유형을 기반으로 계산됩니다. 결제 이벤트 보고서는 비즈니스용 RCS를 활발하게 운영하는 모든 이동통신사에서 사용할 수 있습니다.

결제 이벤트 보고서에는 기밀 정보가 포함되지만 MSISDN, 해시된 MSISDN 또는 사용자 고유 식별자와 같은 사용자 개인 식별 정보 (PII)는 포함되지 않습니다.

상담사 청구 카테고리

에이전트를 만들 때 소유자는 에이전트가 사용자와 상호작용하는 방식에 따라 청구 카테고리를 설정합니다. 청구 카테고리는 상담사가 보낼 수 있는 메시지의 수나 유형을 제한하지 않습니다. 하지만 에이전트에게 메시지에 대한 요금이 청구되는 방식은 결정합니다. 두 가지 주요 청구 카테고리는 다음 표에 설명되어 있습니다.

결제 카테고리	에이전트 유형	사용 사례	결제 방법
비대화형 (기본 메시지 및 단일 메시지 카테고리 포함) 참고: 이 두 카테고리 간에 더 이상 차이가 없습니다. 두 카테고리 중 하나의 에이전트는 비대화형 에이전트로 청구됩니다.)	주로 일방향 메시지를 보내는 상담사	OTP 알림 프로모션 코드	사용자에게 전송된 메시지마다 요금이 청구됩니다.
대화형	사용자와의 양방향 교환을 위해 설계된 에이전트	적합한 제품 찾기 티켓 예약 문제 해결	대화당 청구: 한쪽 (상담사 또는 사용자)이 24시간 이내에 다른 쪽의 메시지에 답장하면 대화가 시작됩니다. 대화 창 (첫 번째 답장 후 24시간) 동안 상담사와 사용자는 원하는 만큼 메시지를 주고받을 수 있으며 상담사에게는 대화에 대한 고정 요금이 청구됩니다. 메시지당 청구: 상담사가 사용자가 24시간 이내에 답장하지 않는 메시지를 전송하는 경우 상담사에게 개별 메시지에 대한 요금이 청구됩니다(비대화형 상담사와 유사).

다음 다이어그램은 대화형 에이전트의 A2P 청구 세션의 예를 보여줍니다.

대화형 에이전트와 비대화형 에이전트 비교

청구 카테고리에는 대화형과 비대화형이라는 두 가지 주요 카테고리가 있습니다. 대화형이 아닌 카테고리에는 기능적으로 동일한 기본 메시지 및 단일 메시지 카테고리가 포함됩니다. 이러한 카테고리에 속하는 에이전트는 비대화형 에이전트로 청구됩니다.

청구 카테고리의 주요 차이점은 대화형 에이전트와 비대화형 에이전트 간에 있습니다.

• 대화형이 아닌 에이전트는 사용자에게 전송하는 각 메시지에 대해 요금이 청구됩니다.

  • 이 카테고리는 자주 회신을 받지 않는 상담사에게 가장 적합합니다.

• 대화형 에이전트에는 24시간 이내에 주고받은 모든 메시지를 포함하는 대화에 대해 고정 요금이 청구됩니다.

  • 이 카테고리는 사용자와 멀티턴 대화를 나누는 상담사에게 가장 적합합니다.

결제 이벤트

결제 이벤트 보고서에는 5가지 유형의 결제 이벤트가 기록됩니다. 이러한 이벤트에는 A2P 및 P2A 메시지가 포함됩니다.

• A2P (Application-to-Person): 비즈니스에서 전송합니다.
• P2A (Person-to-Application): 사용자가 보낸 메시지입니다.

다음 표에서는 비대화형 및 대화형 상담사에 적용되는 각 청구 이벤트를 설명합니다.

이벤트	설명	비대화형 에이전트	대화형 에이전트
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시간 이내에 응답하지 않으면 개별 청구 이벤트로 처리됩니다.

결제 이벤트와 결제 카테고리의 차이

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개가 생성됩니다.

보고서의 각 레코드에는 각 결제 이벤트에 대한 다음 정보가 포함됩니다.

필드	형식	설명	예
billing_event_id	문자열	UUID 식별자입니다. 새 이벤트가 생성될 때 각 이벤트에 대해 생성되는 난수입니다.	242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff
type	문자열	이벤트 유형: basic_message single_message a2p_conversation p2a_conversation p2a_message	single_message
agent_id	문자열	이벤트에 참여한 상담사의 고유 식별자입니다.	[e-mail]
agent_owner	문자열	에이전트가 생성된 파트너 계정의 현재 소유자의 이메일 주소입니다.	[e-mail]
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 메시지 single_message 및 basic_message 이벤트의 경우 메시지가 사용자에게 전송된 시간입니다. a2p_conversation 이벤트의 경우 대화의 첫 번째 메시지가 사용자에게 전송된 시간입니다. P2A 메시지 single_message 및 basic_message 이벤트의 경우 사용자가 메시지를 보낸 시간입니다. p2a_conversation 이벤트의 경우 대화의 첫 번째 메시지가 사용자에 의해 전송된 시간입니다.	2019-07-25T08:00:00Z
duration	숫자	가장 가까운 분으로 반올림된 이벤트 기간입니다. 이벤트 유형이 single_message 또는 basic_message인 경우 값은 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 비즈니스 플랫폼의 활동에 관한 원시 데이터를 제공합니다. 이러한 로그를 사용하여 결제 이벤트를 감사하고 맞춤 이벤트를 만들 수 있습니다.

참고: 테스터가 아닌 전화번호에서 발생한 트래픽만 활동 로그에 포함됩니다.

활동 로그에는 자세한 거래 정보 및 구독자 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	문자열	상담사의 고유 식별자입니다.	[e-mail]
user_id	문자열	사용자의 MSISDN입니다.	918369110173
direction	문자열	메시지가 전송되는 방향입니다. MT (모바일 종료) 에이전트-사용자 활동 사용자-상담사 활동의 경우 MO (모바일 발신)	MT
time	YYYY-mm-ddTHH:MM:SS.SSSZ	이벤트가 비즈니스용 RCS 플랫폼에 제출된 날짜와 시간입니다(UTC 형식). 타임스탬프를 참고하세요.	2019-07-25T00:29:07.033Z
type	문자열	활동 유형: text_message file_transfer rich_card/carousel suggestion_tap delivery_receipt_event read_receipt_event spam_report	text_message
size_bytes	문자열	활동에 첨부된 파일의 크기(바이트)입니다.	912

타임스탬프

활동 로그의 타임스탬프는 이벤트가 비즈니스용 RCS 플랫폼에 제출된 시간을 기록합니다. 사용자에게 콘텐츠를 제공하는 이벤트의 경우 메시지가 전송될 때까지 이벤트가 활동 로그에 기록되지 않습니다.

예를 들어 비즈니스용 RCS 메시지가 수요일 13:00에 사용자에게 전송되고 수신자가 일요일 9:00까지 오프라인 상태인 경우 이벤트는 일요일에 생성된 활동 로그에 표시되지만 타임스탬프는 수요일 13:00입니다.