1 of 5

고객반응 통계

이 문서는 고객 통계 데이터에 대한 API 정보를 안내합니다.

메시지 발송 통계

Request

Response

필드명

타입

길이

필수여부

기본값

설명

array<object>

메시지 발송 읽음 확인 통계 Data

code

string

20000000

status

integer

200

desc

string

result - array<object>

필드명

타입

길이

필수여부

기본값

설명

statDate

string

통계일자

corpId

string

RCS Biz Center에 등록된 기업ID

corpRegNum

string

기업사업자 등록 번호

brandId

string

브랜드 ID

chatbotId

string

대화방 ID

groupId

string

발송 캠페인 구분 ID

messagebaseId

string

발송 메시지의 messagebaseId(식별 불가시 NA)

deliveredCount

integer

발송 건수

displayedCount

integer

읽음확인 건수

❖ response body sample

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "statDate": "20240628",
            "corpId": "CO.NoI0czCZ64",
            "corpRegNum": "8632573324",
            "brandId": "BR.mp0Xf8sGBE",
            "chatbotId": "09044196572",
            "groupId": "6227",
            "messagebaseId": "SMwThT00",
            "deliveredCount": 116,
            "displayedCount": 56
        },
        {
            "statDate": "20240629",
            "corpId": "CO.NoI0czCZ64",
            "corpRegNum": "8632573324",
            "brandId": "BR.mp0Xf8sGBE",
            "chatbotId": "09044196572",
            "groupId": "6227",
            "messagebaseId": "SMwThT00",
            "deliveredCount": 0,
            "displayedCount": 9
        }
    ],
    "status": 200
}

{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}

{
    "error": {
        "code": "64203",
        "message": "query paramter required [groupId]"
    },
    "status": 400
}

{
    "error": {
        "code": "64203",
        "message": "query paramter required [endDate]"
    },
    "status": 400
}

{
    "error": {
        "code": "64338",
        "message": "invalid value: [endDate], endDate must be within 31 days"
    },
    "status": 400
}

{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}

{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}

error code는 RCS Biz Center - Response body error code 참조

메시지 버튼 클릭 통계

Request

Response

필드명

타입

길이

필수여부

기본값

설명

array<object>

메시지 버튼 클릭 카운트

code

string

20000000

status

integer

200

desc

string

result - array<object>

필드명

타입

길이

필수여부

기본값

설명

statDate

string

통계일자

corpId

string

RCS Biz Center에 등록된 기업ID

corpRegNum

string

기업사업자 등록 번호

brandId

string

브랜드 ID

chatbotId

string

대화방 ID

groupId

string

발송 캠페인 구분 ID

messagebaseId

string

발송 메시지의 messagebaseId

reactionType

string

고객이 클릭 반응한 대상(

cardNum

string

고객이 클릭 반응한 대상

array<object>

발송 캠페인 메시지에 포함된 RCS 액션 버튼 통계 Data

buttonList - array<object>

필드명

타입

길이

필수여부

기본값

설명

buttonNum

string

이미지, 칩리스트 또는 버튼 reactionType별 메시지 내 위치를 나타내는 번호(식별 불가시 0)

좌에서 우, 위에서 아래로 1부터 번호 부여하며 Carousel은 각 카드별로 1부터 부여

actionType

string

메시지 버튼에 할당된 RCS 액션 유형 이미지 영역에 동영상 스트리밍을 설정한 경우 iframeplayB로 별도 구분

title

string

버튼명, 이미지는 image_1, image_2, ..., image_# 형식으로 제공되며, 동영상 스트리밍의 경우는 iframeplayB_1, iframeplayB_2, ..., iframeplayB_# 형식으로 제공

clickCount

integer

버튼 클릭수 (1일 내 동일 고객의 버튼 클릭 수 제외)

❖ response body sample

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "statDate": "20240629",
            "corpId": "CO.NoI0czCZ64",
            "corpRegNum": "8632573324",
            "brandId": "BR.mp0Xf8sGBE",
            "chatbotId": "09044196572",
            "groupId": "6236",
            "messagebaseId": "IBR.mp0Xf8sGBE-iE8w82N11u45AHjEC3Oz8CB9A",
            "cardNum": 1,
            "reactionType": "button",
            "buttonList": [
                {
                    "actionType": "urlAction",
                    "title": "자세히 보기",
                    "clickCount": 272,
                    "buttonNum": 1
                },
                {
                    "actionType": "urlAction",
                    "title": "버닝러시",
                    "clickCount": 82,
                    "buttonNum": 2
                }
            ]
        },
        {
            "statDate": "20240629",
            "corpId": "CO.NoI0czCZ64",
            "corpRegNum": "8632573324",
            "brandId": "BR.mp0Xf8sGBE",
            "chatbotId": "09044196572",
            "groupId": "6236",
            "messagebaseId": "IBR.mp0Xf8sGBE-iE8w82N11u45AHjEC3Oz8CB9A",
            "cardNum": 1,
            "reactionType": "image",
            "buttonList": [
                {
                    "actionType": "urlAction",
                    "title": "image_1",
                    "clickCount": 32,
                    "buttonNum": 1
                }
            ]
        }
    ],
    "status": 200
}

{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}

{
    "error": {
        "code": "64203",
        "message": "query paramter required [groupId]"
    },
    "status": 400
}

{
    "error": {
        "code": "64203",
        "message": "query paramter required [endDate]"
    },
    "status": 400
}

{
    "error": {
        "code": "64338",
        "message": "invalid value: [endDate], endDate must be within 31 days"
    },
    "status": 400
}

{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}

{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}

error code는 RCS Biz Center - Response body error code 참조

대화방 메뉴 클릭 통계

Request

Response

result - array<object>

menuList - array<object>

subList - array<object>

subActionList - array<object>

❖ response body sample

브랜드 프로필 노출 통계

Request

Response

result - array<object>

❖ response body sample

메시지 발송 통계

Request

Response

필드명

타입

길이

필수여부

기본값

설명

array<object>

메시지 발송 읽음 확인 통계 Data

code

string

20000000

status

integer

200

desc

string

result - array<object>

필드명

타입

길이

필수여부

기본값

설명

statDate

string

통계일자

corpId

string

RCS Biz Center에 등록된 기업ID

corpRegNum

string

기업사업자 등록 번호

brandId

string

브랜드 ID

chatbotId

string

대화방 ID

groupId

string

발송 캠페인 구분 ID

messagebaseId

string

발송 메시지의 messagebaseId(식별 불가시 NA)

deliveredCount

integer

발송 건수

displayedCount

integer

읽음확인 건수

❖ response body sample

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "statDate": "20240628",
            "corpId": "CO.NoI0czCZ64",
            "corpRegNum": "8632573324",
            "brandId": "BR.mp0Xf8sGBE",
            "chatbotId": "09044196572",
            "groupId": "6227",
            "messagebaseId": "SMwThT00",
            "deliveredCount": 116,
            "displayedCount": 56
        },
        {
            "statDate": "20240629",
            "corpId": "CO.NoI0czCZ64",
            "corpRegNum": "8632573324",
            "brandId": "BR.mp0Xf8sGBE",
            "chatbotId": "09044196572",
            "groupId": "6227",
            "messagebaseId": "SMwThT00",
            "deliveredCount": 0,
            "displayedCount": 9
        }
    ],
    "status": 200
}

{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}

{
    "error": {
        "code": "64203",
        "message": "query paramter required [groupId]"
    },
    "status": 400
}

{
    "error": {
        "code": "64203",
        "message": "query paramter required [endDate]"
    },
    "status": 400
}

{
    "error": {
        "code": "64338",
        "message": "invalid value: [endDate], endDate must be within 31 days"
    },
    "status": 400
}

{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}

{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}

error code는 RCS Biz Center - Response body error code 참조

메시지 버튼 클릭 통계

Request

Response

필드명

타입

길이

필수여부

기본값

설명

array<object>

메시지 버튼 클릭 카운트

code

string

20000000

status

integer

200

desc

string

result - array<object>

필드명

타입

길이

필수여부

기본값

설명

statDate

string

통계일자

corpId

string

RCS Biz Center에 등록된 기업ID

corpRegNum

string

기업사업자 등록 번호

brandId

string

브랜드 ID

chatbotId

string

대화방 ID

groupId

string

발송 캠페인 구분 ID

messagebaseId

string

발송 메시지의 messagebaseId

reactionType

string

고객이 클릭 반응한 대상(

cardNum

string

고객이 클릭 반응한 대상

array<object>

발송 캠페인 메시지에 포함된 RCS 액션 버튼 통계 Data

buttonList - array<object>

필드명

타입

길이

필수여부

기본값

설명

buttonNum

string

이미지, 칩리스트 또는 버튼 reactionType별 메시지 내 위치를 나타내는 번호(식별 불가시 0)

좌에서 우, 위에서 아래로 1부터 번호 부여하며 Carousel은 각 카드별로 1부터 부여

actionType

string

메시지 버튼에 할당된 RCS 액션 유형 이미지 영역에 동영상 스트리밍을 설정한 경우 iframeplayB로 별도 구분

title

string

버튼명, 이미지는 image_1, image_2, ..., image_# 형식으로 제공되며, 동영상 스트리밍의 경우는 iframeplayB_1, iframeplayB_2, ..., iframeplayB_# 형식으로 제공

clickCount

integer

버튼 클릭수 (1일 내 동일 고객의 버튼 클릭 수 제외)

❖ response body sample

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "statDate": "20240629",
            "corpId": "CO.NoI0czCZ64",
            "corpRegNum": "8632573324",
            "brandId": "BR.mp0Xf8sGBE",
            "chatbotId": "09044196572",
            "groupId": "6236",
            "messagebaseId": "IBR.mp0Xf8sGBE-iE8w82N11u45AHjEC3Oz8CB9A",
            "cardNum": 1,
            "reactionType": "button",
            "buttonList": [
                {
                    "actionType": "urlAction",
                    "title": "자세히 보기",
                    "clickCount": 272,
                    "buttonNum": 1
                },
                {
                    "actionType": "urlAction",
                    "title": "버닝러시",
                    "clickCount": 82,
                    "buttonNum": 2
                }
            ]
        },
        {
            "statDate": "20240629",
            "corpId": "CO.NoI0czCZ64",
            "corpRegNum": "8632573324",
            "brandId": "BR.mp0Xf8sGBE",
            "chatbotId": "09044196572",
            "groupId": "6236",
            "messagebaseId": "IBR.mp0Xf8sGBE-iE8w82N11u45AHjEC3Oz8CB9A",
            "cardNum": 1,
            "reactionType": "image",
            "buttonList": [
                {
                    "actionType": "urlAction",
                    "title": "image_1",
                    "clickCount": 32,
                    "buttonNum": 1
                }
            ]
        }
    ],
    "status": 200
}

{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}

{
    "error": {
        "code": "64203",
        "message": "query paramter required [groupId]"
    },
    "status": 400
}

{
    "error": {
        "code": "64203",
        "message": "query paramter required [endDate]"
    },
    "status": 400
}

{
    "error": {
        "code": "64338",
        "message": "invalid value: [endDate], endDate must be within 31 days"
    },
    "status": 400
}

{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}

{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}

error code는 RCS Biz Center - Response body error code 참조

고객반응 통계

메시지 발송 통계

Request

Response

result - array<object>

❖ response body sample

메시지 버튼 클릭 통계

Request

Response

result - array<object>

buttonList - array<object>

❖ response body sample

대화방 메뉴 클릭 통계

Request

Response

result - array<object>

menuList - array<object>

subList - array<object>

subActionList - array<object>

❖ response body sample

브랜드 프로필 노출 통계

Request

Response

result - array<object>

❖ response body sample

고객반응 통계

메시지 발송 통계

Request

Response

result - array<object>

❖ response body sample

메시지 버튼 클릭 통계

Request

Response

result - array<object>

buttonList - array<object>

❖ response body sample

브랜드 프로필 노출 통계

Request

Response

result - array<object>

❖ response body sample

대화방 메뉴 클릭 통계

Request

Response

result - array<object>

menuList - array<object>

subList - array<object>

subActionList - array<object>

❖ response body sample

고객반응 통계 - 대화방 메뉴 클릭 통계를 조회합니다.

고객반응 통계 - 캠페인 메시지 버튼 클릭 통계를 조회합니다.

브랜드프로필 노출 통계를 조회합니다.

고객반응 통계 - 캠페인 메시지 발송/읽음확인 통계를 조회합니다.