행동 데이터 연동하기

블럭스 서비스에 행동 데이터를 연동하는 방법을 소개합니다.

행동 데이터는 유저가 어떤 행동을 했는지를 나타내는 데이터입니다.

행동 데이터를 연동하면 행동 기반 캠페인을 만들 수 있어요. 예를 들어, 구매하지 않은 장바구니 유저에게 메시지를 보내거나, 최근에 상품을 본 유저에게 리마인드 메시지를 보낼 수 있습니다.

이벤트 타입 (Event Type)

유저가 어떤 행동을 했는지를 나타내는 분류입니다.
예를 들어 유저의 접속, 페이지 방문, 상품 클릭, 상품 장바구니 담기, 상품 구매가 이벤트 타입에 해당해요.

이벤트 프로퍼티 (Event Property)

이벤트에 추가로 붙는 정보입니다.
예를 들어 어떤 상품을 클릭했는지, 얼마에 구매했는지가 이벤트 프로퍼티에 해당해요.

이벤트 타입에 따라서 다음과 같이 나뉘어요:

이벤트 타입 구분	설명	예시
기본 이벤트	블럭스에서 미리 정의해둔 유저 행동	구매, 조회, 찜 등
커스텀 이벤트	고객님 서비스에서 정의한 유저 행동	예약, 구독, 주문 완료 페이지 조회 등

이벤트 프로퍼티에 따라서 다음과 같이 나뉘어요:

이벤트 프로퍼티 구분	설명	예시
기본 이벤트 프로퍼티 (event_properties)	이벤트마다 반드시 포함해야 하는 속성입니다.	item_id, price
커스텀 이벤트 프로퍼티 (custom_event_properties)	더 많은 정보를 담기 위해 자유롭게 추가할 수 있는 속성입니다.	coupon_no, plan_type, price

예시 데이터

user_id	이벤트 타입 (event_type)	기본 이벤트 정보 (event_properties)	커스텀 이벤트 정보 (custom_event_properties)
1234567890	product_detail_view	{ "item_id": "ITEM_ID" }	{ "category": "TOP" }
1234567891	purchase	{ "item_id": "ITEM_ID" }	{ used_coupon: "COUPON_NO" }

연동 방식

BluxClient SDK를 통해 sendEvent() 메서드를 호출해 이벤트를 전송합니다.

기본 이벤트 연동

// 유저가 상품을 클릭했을 때
bluxClient.sendEvent(
  new AddProductDetailViewEvent({
    itemId: "ITEM_ID",
    customEventProperties: {
      brandName: "Nike",
      categoryName: "Shoes",
    },
  }),
);

커스텀 이벤트 연동

// 유저의 쿠폰을 사용했을 때
bluxClient.sendEvent(
  new AddCustomEvent({
    eventType: "coupon_used",
    customEventProperties: {
      couponNo: "COUPON_NO",
    },
  }),
);

기본 이벤트 연동

기본 이벤트는 자주 쓰이는 유저 행동을 미리 정의해 둔 정보에요.

주요 CRM 캠페인에서 널리 사용되는 유저 행동이므로, 대부분의 커머스 서비스에서 바로 사용할 수 있어요.

기본 이벤트는 블럭스 SDK에서 전용 클래스로 제공됩니다. 예를 들어, 상품 상세페이지 조회의 경우 AddProductDetailViewEvent, 구매의 경우 AddOrderEvent를 사용합니다.

기본 이벤트 연동하기 를 참고하세요.

💡 서비스에 존재하는 행동만 연동하면 됩니다. 예를 들어 평점 기능이 없다면 AddRateEvent() 이벤트는 연동하지 않아도 됩니다.

행동	이벤트	호출 시점
상세페이지 진입하기	`AddProductDetailViewEvent()`	유저가 상품 상세페이지에 진입한 순간
장바구니 담기	`AddCartaddEvent()`	유저가 상품을 장바구니에 담은 순간
구매하기	`AddOrderEvent()`	유저가 상품을 구매하여 비용을 지불한 순간
좋아요 누르기	`AddLikeEvent()`	유저가 상품에 좋아요 버튼을 누른 순간
평점 남기기	`AddRateEvent()`	유저가 상품에 평점을 남긴 순간
회원 가입하기	`AddCustomEvent()`	유저가 회원 가입을 완료한 순간

기본적으로 캠페인의 전환 성과는 구매(purchase) 이벤트를 기준으로 측정됩니다. 이 외의 기본 이벤트는 서비스 특성에 맞게 선택적으로 연동하세요. 만약 캠페인의 전환 성과를 구매가 아닌 다른 이벤트를 기준으로 측정하고 싶다면, 캠페인 생성 시 다른 전환 성과 이벤트를 선택해주세요.
회원 가입하기 행동은 커스텀 이벤트로 연동해주세요. AddCustomEvent()의 eventType을 "signup"으로 설정해서 전송하면 됩니다.

(선택) 커스텀 이벤트 연동

커스텀 이벤트는 서비스별로 특화된 유저 행동을 정의할 수 있는 이벤트입니다.

기본 이벤트로는 표현하기 어려운 경우, 커스텀 이벤트를 생성해 연동할 수 있어요. 예를 들어 쿠폰 사용, 서비스 예약, 구독, 검색처럼 추가로 필요한 유저 행동이 있다면, 커스텀 이벤트로 수집하세요.

커스텀 이벤트는 블럭스 SDK의 AddCustomEvent() 메서드를 통해 연동하며, 이 메서드에 이벤트 타입과 이벤트 속성(customEventProperties)을 직접 입력해 정의합니다. 커스텀 이벤트 연동하기 를 참고하세요.

커스텀 이벤트 예시

이벤트 타입	설명	예시 이벤트 프로퍼티 (customEventProperties)
coupon_used	유저가 쿠폰을 사용했을 때	coupon_no
subscribe	유저가 서비스를 구독했을 때	plan_type, price
reservation	유저가 예약했을 때	reservation_id, location
search	유저가 검색했을 때	keyword, category

연동 가능한 타입은 String, Number, Boolean, Date, Array of String 타입이에요.

이외의 타입으로 연동하고자 하시는 경우 블럭스 담당자에게 문의해주세요.

연동 방식​

기본 이벤트 연동​

(선택) 커스텀 이벤트 연동​

연동 방식

기본 이벤트 연동

(선택) 커스텀 이벤트 연동