RCS Biz Center

메시지 버튼 클릭 통계

Request

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

get

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

  • 동일 Group ID에 발송일 기준 3일간 (D+3) 집계됩니다. 단, 이통사별 발송 성공건수 100건 이상인 경우에 한해 집계됩니다.

  • 통계 조회 기간은 데이터 존재 시 최근 1년 6개월 이내 기간 중 최대 31일까지 검색 가능합니다.

  • 계정 권한: 마스터, 매니저, 대행사

  • 브랜드 권한: 브랜드 대표운영자, 운영자

Authorizations
Path parameters
brandIdstring · max: 13Required

maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.

Query parameters
startDatestringRequired

통계 조회 기간 시작일자(yyyymmdd) 입니다.

endDatestringRequired

통계 조회 기간 종료일자(yyyymmdd) 입니다.

groupIdstringRequired

발송 캠페인 구분 ID 입니다.

chatbotIdstringOptional

대화방ID Query Parameter 입니다.

Header parameters
X-RCS-Brandkeystring · max: 18Optional

maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.

대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다. 따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.

get
GET /api/1.1/statQuery/messageButton/{brandId} HTTP/1.1
Host: api-qa.rcsbizcenter.com
Authorization: Bearer JWT
Accept: */*

Response

필드명
타입
길이
필수여부
기본값
설명

result

array<object>

O

메시지 버튼 클릭 카운트

code

string

5

O

20000000

status

integer

3

O

200

desc

string

O

result - array<object>

필드명
타입
길이
필수여부
기본값
설명

statDate

string

8

통계일자

corpId

string

13

RCS Biz Center에 등록된 기업ID

corpRegNum

string

10

기업사업자 등록 번호

brandId

string

13

브랜드 ID

chatbotId

string

15

대화방 ID

groupId

string

20

발송 캠페인 구분 ID

messagebaseId

string

40

NA

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

reactionType

string

20

NA

고객이 클릭 반응한 대상(messagebaseId 식별 불가 시 NA)

  • NA: 식별불가

  • button: 메시지 내 버튼

  • chipList: 메시지 하단 칩리스트

  • image: 메시지 내 이미지

cardNum

string

reactionType 해당 card 의 위치 (식별 불가시 0)

ex1) Standalone 인 경우 1

ex2) Card 4장 Carousel 1, 2, 3, 4 중 버튼이 위치한 카드 번호

ex3) 칩리스트인 경우 1

buttonList

array<object>

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

buttonList - array<object>

필드명
타입
길이
필수여부
기본값
설명

buttonNum

string

0

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

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

actionType

string

메시지 버튼에 할당된 RCS 액션 유형

이미지 영역에 동영상 스트리밍을 설정한 경우 iframeplayB로 별도 구분

  • urlAction

  • dialerAction

  • mapAction

  • calendarAction

  • composeAction

  • clipboardAction

  • iframeplayB

title

string

40

버튼명, 이미지는 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는 RCS Biz Center - Response body error code 참조

Previous메시지 발송 통계Next대화방 메뉴 클릭 통계

Last updated

Was this helpful?