RBM은 요약 및 트랜잭션 수준에서 사용자 및 에이전트 활동을 보고하는 데이터 파일을 만듭니다. 데이터는 다음과 같이 여러 파일로 분리됩니다.
| 파일 | 설명 | 액세스 권한이 있는 사용자 |
|---|---|---|
| 결제 이벤트 보고서 | 출시된 에이전트와 사용자 간의 청구 가능한 이벤트 기록 | 네트워크에 RBM 트래픽이 있는 모든 이동통신사 |
| 활동 로그 | 원시 RBM 플랫폼 활동 데이터 | 네트워크에 RBM 트래픽이 있고 자체 서비스 약관 (ToS)에 따라 Jibe Cloud를 통한 RCS 활동을 사용 설정하는 이동통신사 |
생성
결제 이벤트 보고서와 활동 로그의 생성은 2일 지연됩니다.
Google에서는 활동 이벤트가 속한 결제 세션이 완료된 경우에만 활동 이벤트를 보고합니다. 세션은 완료되는 데 최대 24시간이 걸릴 수 있고, 결제 파이프라인은 하루에 한 번 실행되며, 적어도 24시간 이상 경과한 세션이 완료되었어야 하는 결제 세션만 보고합니다.
예를 들면 다음과 같습니다.
메시지가 d일 차에 전송되고 결제 세션이 시작되었지만 1시간 전에 파이프라인 실행이 누락되었습니다. 따라서 활동 이벤트가 보고되지 않습니다.
파이프라인이 d+1에서 다시 실행되면 메시지가 시작한 세션이 겨우 23시간 후에 생성됩니다. 따라서 d+1에서 이 메시지의 활동 이벤트가 보고되지 않습니다.
파이프라인이 d+2에서 다시 실행되면 세션이 완료되었으므로 활동 이벤트가 결제 세션과 함께 보고됩니다.
저장용량 및 액세스
데이터 파일은 저장 및 전송 중에 암호화됩니다.
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으로 문의하세요.
새로고침 및 보관
각 데이터 파일은 UTC 시간의 1일 플랫폼 사용을 나타냅니다. 특정 날짜의 레코드는 한 번 생성되고 하루가 끝나고 2일 (48시간) 내에 완료됩니다. 이러한 파일을 데이터 웨어하우스에 로드하면 이번 달의 측정항목을 업데이트할 수 있습니다.
고려할 활동이 없으면 파일이 생성되지 않습니다.
각 파일 이름에 표시된 날짜는 파일이 생성된 날짜입니다. 파일의 레코드는 파일 날짜 2일 전부터 오는 UTC 날짜를 포함합니다.
파일을 생성하는 내보내기 프로세스는 오전 2시에서 4시(PST) 사이에 실행됩니다.
데이터 파일은 최대 30일 동안 보관된 후 삭제됩니다.
결제 이벤트 보고서
결제 이벤트 보고서는 추천 결제 단위를 사용하여 기본 메시지에서 계산된 청구 가능 이벤트 레코드입니다. 청구 가능한 이벤트에는 기밀 정보가 포함되지만 사용자 PII (예: MSISDN, 해싱된 MSISDN 또는 사용자 고유 식별자 없음)가 포함되지 않습니다.
출시된 에이전트만 결제 이벤트를 생성합니다. 아직 실행되지 않았거나 출시되지 않은 에이전트의 활동은 결제 보고서에 표시되지 않습니다.
결제 보고서에서는 이벤트가 메시지가 전송될 때가 아니라 메시지를 전송할 때 요금이 청구된다고 가정합니다. 전송 전에 전송되지 않았거나 취소된 메시지는 결제 이벤트를 트리거하지 않습니다.
각 RBM 에이전트에는 출시를 위해 에이전트를 제출하기 전에 에이전트 개발자가 설정한 결제 카테고리가 있습니다. 결제 카테고리는 에이전트가 전송하는 메시지가 개별인지 아니면 대화 결제 이벤트로 결합할 수 있는지 여부를 결정합니다.
청구 대상 이벤트에는 5가지 유형이 있습니다.
| 이벤트 | 정의 |
|---|---|
| 기본 메시지 | 애플리케이션 간 (A2P) 메시지로
대화형 에이전트만 해당: P2A 메시지가 다음 24시간 이내에 A2P 메시지에 대한 응답으로 전송되면 기본 메시지는 A2P 대화의 일부가 됩니다. 그렇지 않으면 세션이 종료됩니다. 기본 메시지는 항상 에이전트에서 사용자에게 전달됩니다. |
| 단일 메시지 | 애플리케이션 간 (A2P) 메시지로
대화형 에이전트만 해당: P2A 메시지가 다음 24시간 이내에 전송되면 단일 메시지가 A2P 대화의 일부가 되고 그러지 않으면 세션이 종료됩니다. 단일 메시지는 항상 에이전트에서 사용자에게 전달됩니다. |
| A2P 대화 | 대화형 에이전트에만 적용: P2A 메시지가 A2P 단일 메시지 또는 A2P 기본 메시지로부터 24시간 이내에 전송되면 A2P 대화가 시작됩니다. P2A 메시지가 여러 A2P 메시지로 24시간 이내에 전송되는 경우 P2A 메시지 바로 앞에 있는 A2P 메시지만 대화 세션을 만드는 데 사용됩니다. 이 A2P 메시지는 앞으로 24시간 이내에 전송되는 모든 메시지와 함께 새로운 A2P 대화에 포함됩니다. |
| P2A 대화 | 대화형 에이전트에만 적용: P2A 대화는 활성 세션 (A2P 단일 메시지, A2P 대화 또는 P2A 대화)이 없고 P2A 메시지가 전송되고 비즈니스에서 24시간 이내에 응답할 때 시작됩니다. |
| P2A 메시지 | 비대화 에이전트: 사용자가 단일 메시지 또는 기본 메시지의 결제 카테고리를 사용하여 에이전트에게 보낸 P2A 메시지입니다.
대화형 에이전트: 기존 대화가 없고 에이전트가 응답을 반환하지 않는 경우 사용자가 에이전트에게 보내는 P2A 메시지입니다. |
지원 대상
결제 이벤트 보고서는 네트워크에 RBM 트래픽이 있는 모든 이동통신사에서 사용할 수 있습니다.
형식
결제 이벤트 보고서는 파일 이름 형식 YYYY/MM/DD/rbm_billable_events_YYYY-MM-DD.csv을 사용합니다.
파일 이름의 날짜는 파일이 생성된 날짜입니다. 파일의 레코드에는 일반적으로 이 날짜 2일 전의 활동이 포함됩니다.
레코드의 필드는 탭으로 구분되며 한 줄에 하나의 레코드가 있습니다.
결제 이벤트마다 레코드가 하나씩 있습니다. 즉, 동일한 에이전트가 있는 두 개의 A2P 대화가 결제 보고서에 2개의 결제 이벤트와 2개의 레코드를 생성합니다.
청구 가능 이벤트 보고서의 각 레코드에는 다음과 같은 각 이벤트 정보가 포함됩니다.
| 필드 | 형식 | 설명 | 예 |
|---|---|---|---|
billing_event_id
|
string | 새 이벤트가 생성될 때마다 생성되는 UUID 식별자(임의의 숫자). | |
type
|
string | 이벤트 유형:
|
single_message
|
agent_id
|
string | 이벤트에 참여한 상담사의 식별자입니다. | rbm-welcome-bot@rbm.goog
|
agent_owner
|
string | 이벤트에 참여한 상담사 소유자의 이메일입니다. RBM 에이전트를 등록한 당사자이며 대부분의 경우 애그리게이터이지만 드물게 브랜드일 수도 있습니다. 이 값은 개발자가 RBM을 사용하도록 등록했을 때 제공된 'RBM Google 계정' 입력란에서 가져옵니다. | name@aggregator.com
|
billing_party
|
string | 이벤트 비용을 청구하는 당사자입니다.
|
carrier
|
max_duration_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 형식으로 표시되며 가장 가까운 시간으로 반올림됩니다.
|
2019-07-25T08:00:00Z
|
duration
|
숫자 | 이벤트의 기간이며, 분 단위로 반올림됩니다.
이벤트 유형이 |
45
|
mt_messages
|
숫자 | 이벤트의 모바일에서 종료된 메시지 수입니다. | 11
|
mo_messages
|
숫자 | 이벤트의 모바일에서 시작된 메시지 수입니다. | 9
|
size_kilobytes
|
숫자 | 이벤트의 메시지에 첨부된 모든 파일의 크기로, KB (1KB = 1,024바이트)로 반올림됩니다. | 912
|
agent_name
|
string |
이벤트에 참여한 상담사입니다. |
XYZ Mobile USA
|
owner_name
|
string | 이벤트에 참여한 상담사의 소유자입니다. RBM 에이전트를 등록한 당사자입니다. 대부분의 경우 애그리게이터이지만 드물게 브랜드일 수도 있습니다. 이 값은 개발자가 RBM을 사용하도록 등록할 때 제공된 '파트너 계정의 기본 표시 이름'에서 가져옵니다. | XYZ Mobile
|
샘플 파일
샘플 결제 보고서 파일은 다운로드할 수 있습니다.
일반적인 파일 크기
활성 파트너의 일일 보고서 파일은 약 53,000개의 레코드와 약 8MB의 크기일 수 있습니다.
활동 로그
활동 로그는 청구 가능한 이벤트를 감사하고 맞춤 이벤트를 구성하기 위한 RBM 플랫폼 활동의 원시 데이터 로그입니다.
지원 대상
활동 로그는 네트워크에 RBM 트래픽이 있고 자체 서비스 약관 (ToS)에 따라 Jibe Cloud를 통한 RCS 활동을 사용 설정한 이동통신사만 사용할 수 있습니다. Jibe의 서비스 약관에 따라 Jibe Cloud를 사용하는 경우 활동 로그에 액세스할 수 없습니다.
형식
활동 로그는 파일 이름 형식 YYYY/MM/DD/rbm_activity_YYYY-MM-DD.csv을 사용합니다.
파일 이름의 날짜는 파일이 생성된 날짜입니다. 파일의 레코드에는 일반적으로 이 날짜 2일 전의 활동이 포함됩니다.
레코드의 필드는 탭으로 구분되며 한 줄에 하나의 레코드가 있습니다.
활동 로그의 각 레코드에는 각 활동 이벤트에 관한 다음 필드가 포함됩니다.
| 필드 | 형식 | 설명 | 예 |
|---|---|---|---|
activity_id
|
string | 활동의 식별자입니다. | |
billing_event_id
|
string | 활동이 발생한 결제 이벤트의 식별자입니다. 활동이 세션과 연결되지 않은 경우(예: 상응하는 delivery_receipt_event가 없는 text_message) 비워 둘 수 있습니다.
| |
agent_id
|
string | 상담사의 식별자입니다. | welcome-bot@rbm.goog
|
user_id
|
string | 사용자의 MSISDN입니다. | 918369110173
|
direction
|
string | 메일이 전송된 방향:
|
MT
|
time
|
YYYY-mm-ddTHH:MM:SS.SSSZ | 이벤트가 RBM 플랫폼에 제출된 UTC 날짜/시간입니다. 아래 참고를 참고하세요. | 2019-07-25T00:29:07.033Z
|
type
|
string | 활동 유형:
|
text_message
|
size_bytes
|
string | 활동에 첨부된 파일의 크기(바이트)입니다. | 912
|
타임스탬프 관련 참고사항
활동 로그의 타임스탬프는 이벤트가 RBM 플랫폼에 제출된 시간을 기록합니다. 사용자에게 콘텐츠를 전송하는 이벤트의 경우, 메시지가 전송될 때까지 활동 로그에 이벤트가 기록되지 않습니다.
예를 들어 RBM 메시지가 수요일 13:00에 사용자에게 전송되고 수신자가 일요일 09:00까지 오프라인 상태인 경우 해당 이벤트는 일요일에 대해 생성된 활동 로그에 표시됩니다. 활동 로그의 이벤트 타임스탬프는 수요일 13:00입니다.