이벤트 보내기 | 사용자 여정 | 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 로 알려 줍니다. 오타가 있으면 이 결과로 바로 알 수 있습니다.
- 페이지를 떠나는 순간에 불러도 전송이 끝까지 가도록 처리돼 있습니다.