사용자 여정 | Appbox SDK 가이드

사용자 여정

이벤트 키 등록

웹 페이지에서 사용자 여정 이벤트를 보내 자동 발송 조건과 분석에 쓸 수 있습니다.
이벤트는 콘솔 › 메시지 발송 › 자동 발송 › 사용자 여정 › 이벤트에 먼저 등록한 키만 받습니다. 등록하지 않은 키로 보내면 서버가 버립니다.

이벤트 보내기

AppboxSDK.journey.track(eventKey, properties) 로 보냅니다.
Javascript
1 async function trackPurchase(orderId, amount) {
2 const res = await AppboxSDK.journey.track("purchase_complete", {
3 orderId: orderId,
4 amount: amount,
5 });
6 if (!res.ok) {
7 console.warn("여정 이벤트 실패", res.error || res.status);
8 }
9 }
인자규칙
eventKey문자열, 빈 값 불가. 콘솔에 등록한 키와 정확히 같아야 함
properties선택. 객체(조건과 분석에 쓸 키-값)
결과뜻
{ ok: true, status: 200 }서버가 받음
{ ok: false, status: 200, error: "UNKNOWN_EVENT_KEY", unknownKeys: [...] }콘솔에 등록하지 않은 키라 서버가 버림. 콘솔에서 키를 먼저 등록하세요
{ ok: false, status: <숫자> }서버가 거절(HTTP 상태)
{ ok: false, error: "INVALID_EVENT_KEY" }eventKey 가 문자열이 아니거나 빈 값
{ ok: false, error: "INVALID_PROPERTIES" }properties 가 객체가 아님
{ ok: false, error: "NO_DEVICE_ID" }기기 식별값이 없음. 앱 밖(일반 브라우저)에서 부르면 늘 이 값
{ ok: false, error: "NO_APP_ID" }앱 코드를 찾지 못함
{ ok: false, error: "SERVER_REJECTED" }서버가 이벤트를 받지 못함(거절)
{ ok: false, error: "NETWORK" }네트워크 오류
  • Promise 는 reject 되지 않습니다. 늘 res.ok 로 확인하세요.
  • 앱 안에서만 동작합니다. 일반 브라우저에서는 보내지 않고 NO_DEVICE_ID 로 끝납니다.
  • 등록하지 않은 키는 UNKNOWN_EVENT_KEY 로 알려 줍니다. 오타가 있으면 이 결과로 바로 알 수 있습니다.
  • 페이지를 떠나는 순간에 불러도 전송이 끝까지 가도록 처리돼 있습니다.

서버 API와 차이

고객사 서버에서도 같은 이벤트를 보낼 수 있습니다(앱 설정 가이드 "서버 API"의 이벤트 호출, POST /api/v1/server/journey/event).
웹 journey.track서버 API
인증없음(앱 안 기기 식별값으로 판단)인증키와 서버 공인 IP
누구의 이벤트인지SDK 가 기기 식별값을 자동으로 붙임deviceUserId 나 userId 를 직접 넣음
한 번에1건1~100건
등록 안 된 키서버가 버리고 ok: false, UNKNOWN_EVENT_KEY응답 rejected, unknownKeys 로 알려 줌
다시 보낼 때 중복거르지 않음. 다시 부르면 이벤트가 하나 더 들어감요청에 eventId 를 넣으면 24시간 안의 같은 값은 거르고 duplicates 로 알려 줌
  • 한 이벤트는 웹과 서버 중 한 곳에서만 보내세요. 양쪽에서 보내면 두 번 처리됩니다.
  • 결제 완료처럼 꼭 한 번만 세어야 하는 이벤트는 서버 API 에 eventId 를 넣어 보내는 쪽을 권장합니다.
  • 웹에서 NETWORK 가 나왔을 때 다시 부르면, 앞선 전송이 실제로는 도착했던 경우 이벤트가 두 번 들어갈 수 있습니다.
www.naver.com
QR 코드를 촬영하면 입력하신 주소의
앱 예시 화면을 테스트할 수 있습니다.
* 스캔 후 바로 앱 다운로드 이동합니다.