사용자 여정 | Appbox SDK 가이드
사용자 여정
이벤트 키 등록
이벤트 보내기
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와 차이
| 웹 journey.track | 서버 API | |
|---|---|---|
| 인증 | 없음(앱 안 기기 식별값으로 판단) | 인증키와 서버 공인 IP |
| 누구의 이벤트인지 | SDK 가 기기 식별값을 자동으로 붙임 | deviceUserId 나 userId 를 직접 넣음 |
| 한 번에 | 1건 | 1~100건 |
| 등록 안 된 키 | 서버가 버리고 ok: false, UNKNOWN_EVENT_KEY | 응답 rejected, unknownKeys 로 알려 줌 |
| 다시 보낼 때 중복 | 거르지 않음. 다시 부르면 이벤트가 하나 더 들어감 | 요청에 eventId 를 넣으면 24시간 안의 같은 값은 거르고 duplicates 로 알려 줌 |
- 한 이벤트는 웹과 서버 중 한 곳에서만 보내세요. 양쪽에서 보내면 두 번 처리됩니다.
- 결제 완료처럼 꼭 한 번만 세어야 하는 이벤트는 서버 API 에 eventId 를 넣어 보내는 쪽을 권장합니다.
- 웹에서 NETWORK 가 나왔을 때 다시 부르면, 앞선 전송이 실제로는 도착했던 경우 이벤트가 두 번 들어갈 수 있습니다.