이 문서에서는 채널톡 SDK (이하 SDK)의 이벤트에 대해 설명합니다.

Event는 무엇인가요?

이벤트(Event)는 웹사이트나 애플리케이션 내에서 발생하는 유저의 행동을 뜻하며, 비즈니스와 관련된 모든 이벤트를 정의할 수 있습니다.

이벤트 값 알아보기

SDK에서는 아래 이벤트를 기본적으로 제공합니다.

PageView : 고객이 특정 페이지를 조회했을 때의 이벤트
UserChatOpen : 고객이 유저챗을 새로 열었을 때의 이벤트
MarketingView : 고객이 마케팅 메시지를 조회했을 때의 이벤트
MarketingClick : 고객이 마케팅 메시지 안에 포함된 url 링크를 눌렀을 때 발생하는 이벤트
MarketingGoal : 마케팅 메시지에서 목표로 설정한 이벤트 값이 발생했을 때의 이벤트

프로퍼티는 무엇인가요?

프로퍼티(Property)는 이벤트를 설명해주는 하위 정보들입니다. 프로퍼티 데이터를 바탕으로 이벤트를 좀 더 자세하게 파악할 수 있고, 적합한 의사결정을 내리는 데 도움을 얻을 수 있습니다.

var properties = { 
  "userId": "1234", 
  "hasPurchaseA": true, 
  "lastVisitedAt": "2100-10-11"
}

let properties: [String: Any] = [
    "userId": "1234",
    "hasPurchaseA": true,
    "lastVisitedAt": "2100-10-11"
]

NSDictionary *properties = @{
    @"userId": @"1234",
    @"hasPurchaseA": @YES,
    @"lastVisitedAt": @"2100-10-11"
};

Map<String, Object> properties = new HashMap<>();
properties.put("userId", "1234");
properties.put("hasPurchaseA", true);
properties.put("lastVisitedAt", "2100-10-11");

프로퍼티 타입

프로퍼티는 다음과 같은 타입을 값으로 가질 수 있습니다.

String
Numeric
Boolean
Date / DateTime
Lists
List of Objects
- 1 Depth까지 파싱되며, 그 이상은 String으로 대체됩니다.
- 첫 5개 Object에 대해서만 파싱합니다. 이후 객체에 포함된 유형은 파싱하지 않습니다.
- Object 객체의 파싱 가능한 유형은 String, Numeric Type입니다.

각 SDK의 사용 예시는 아래와 같습니다.

번역

기본적으로 제공되는 이벤트 5개와, 커머스 연동을 통해 받아온 이벤트들은 번역을 제공하고 있습니다. 아래는 커머스 연동 이벤트가 명세되어 있는 페이지입니다.