이벤트 보내기 | 사용자 여정 | 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 로 알려 줍니다. 오타가 있으면 이 결과로 바로 알 수 있습니다.
  • 페이지를 떠나는 순간에 불러도 전송이 끝까지 가도록 처리돼 있습니다.
www.naver.com
QR 코드를 촬영하면 입력하신 주소의
앱 예시 화면을 테스트할 수 있습니다.
* 스캔 후 바로 앱 다운로드 이동합니다.