이벤트

이벤트는 장바구니 추가, 구매 등 서비스 내에서 유저가 수행한 특수한 행동입니다. 이러한 이벤트에 기반하여 고객 여정 자동화 등 심화 마케팅이 가능합니다.

유저가 특정 행동을 수행할 때마다 이벤트를 트리거합니다.

이벤트가 트리거되는 시점에 아래 코드를 실행

• (권장) REST API: POST /v1/projects/PROJECT_ID/track
  • API를 통해 서버에서 이벤트 발생 시 앱 버전에 구애받지 않으면서도 보다 정확한 연동이 가능하여 권장합니다.
• Web SDK / Mobile SDK: FlareLane.trackEvent("test_event")

이벤트 API 연동 예시

curl --request POST \
     --url https://api.flarelane.com/v1/projects/PROJECT_ID/track \
     --header 'Authorization: Bearer API_KEY' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "events": [
    {
      "subjectType": "user",
      "subjectId": "userid1",
      "type": "purchase",
      "data": {
        "productId": "123",
        "productName": "상품명",
        "amount": 10000
      }
    }
  ]
}
'

이벤트와 함께 연동할 수 있는 데이터 value는 다음 타입이 지원됩니다.

• 문자열
• 숫자
• 시간 (둘 중에 하나, 정확한 포맷 준수)
  • ISO8601 타입의 문자열: ex. "2024-04-19T14:23:56+09:00"
  • millisecond 단위의 Unix Timestamp: ex. 1681721331085
• 참/거짓 (boolean)
• 배열 (타입 일치 필요: 모두 문자열 혹은 모두 숫자)
• null (태그 삭제)

플레어레인 고객 데이터 연동 페이지 중 최근 이벤트 목록에서 발생한 이벤트를 모두 확인할 수 있습니다. 특정 유저ID나 기기ID 기준으로 필터링도 가능합니다.

동일 페이지 하단의 연동된 이벤트 리스트에서도 사용 가능한 이벤트들을 확인하실 수 있습니다. 신규 이벤트 연동 시 일정 시간 뒤에는 자동으로 리스트에 추가되지만, 이를 기다리지 않고 직접 수동으로 리스트에 추가하여 바로 사용하는 것도 가능합니다. (리스트에 추가된 것이 데이터가 잘 연동되었다는 것을 의미하는 것은 아님)

세그먼트 필터 에서 이벤트 필터를 통해 다양한 형태의 자유로운 그룹을 만들 수 있습니다. 기간 내 발생 빈도 및 세부 이벤트 데이터 조건 등 다양한 설정이 가능합니다.

연동된 이벤트는 고객 여정 자동화 중 개인화 메시지 (Liquid) 문법을 통해 세부 데이터를 메시지 내용에 반영할 수 있습니다.

사용법: {{ entry_event.data.데이터명 | default: 기본값 }}

플레어레인이 자동으로 수집하는 이벤트로 이름 앞에 @이 들어가 구분을 짓습니다. 아래 5가지 이벤트들이 현재 자동 수집되고 있으며, 계속 추가될 예정입니다.

• @first_session: 기기 생성시 발생
• @clicked: 푸시 알림 클릭시 발생
• @iam_displayed: 인앱메시지 노출 시
• @iam_clicked: 인앱메시지 클릭 시
• @iam_closed: 인앱메시지 닫기 시