용어집
CUE의 사용자 ID, 예측값과 API 응답에 쓰이는 용어를 설명합니다.
Context API
Context API는 앱 사용자 ID를 받아 해당 사용자의 예측 결과와 설치에 기여한 광고 정보를 반환하는 API입니다. 서버나 CRM에서 API를 호출하고, 받은 결과를 화면이나 메시지를 선택하는 조건에 사용할 수 있습니다.
API 요청과 응답
API 요청은 서버나 CRM이 앱 사용자의 정보를 조회하려고 CUE에 해당 사용자의 ID를 보내는 동작입니다. 응답은 요청을 받은 CUE가 돌려주는 처리 결과와 데이터입니다. 예를 들어 서버에서 앱 사용자 ID를 보내면 CUE는 해당 사용자의 예측 결과를 반환합니다.
JSON
JSON은 API에서 데이터를 주고받는 형식으로, 이름과 값을 짝지어 표현합니다. 예를 들어 "probability": 0.723은 probability라는 항목의 값이 0.723이라는 뜻입니다.
사용자 ID와 식별자 연결
사용자 ID는 조회할 앱 사용자를 구분하는 값입니다. Context API 요청에는 아래 3개 필드 중 정확히 1개만 사용해야 합니다.
| 요청 필드 | 보내야 할 ID |
|---|---|
userId | 에어브릿지가 앱 사용자에게 부여한 Airbridge Generated UUID입니다. |
brazeDeviceId | 브레이즈 SDK의 Device ID입니다. |
airbridgeExternalUserId | 서비스에서 에어브릿지에 전송한 외부 사용자 ID입니다. |
식별자 연결 정보는 Braze Device ID나 외부 사용자 ID가 어느 에어브릿지 사용자에 해당하는지 나타냅니다. brazeDeviceId는 브레이즈의 external_id와 다른 값입니다.
앱 SDK 토큰과 웹 SDK 토큰
앱 SDK 토큰과 웹 SDK 토큰은 Context API 요청을 인증할 때 사용하는 값입니다. CUE에 연동된 앱의 토큰을 사용하고, 서버나 CRM의 안전한 설정에 보관해야 합니다. 토큰은 에어브릿지 대시보드 [설정]>[토큰 관리]에서 확인할 수 있습니다.
예측 확률: probability
예측 확률(probability)은 모델이 특정 사건의 발생 가능성을 0부터 1 사이의 값으로 나타낸 결과입니다. 0.723은 해당 사건이 발생할 확률을 72.3%로 예측했다는 뜻입니다. 확률을 해석할 때는 어떤 사건과 기간을 예측하는지 함께 확인해 주세요.
예측 등급: tier
예측 등급(tier)은 모델의 예측 확률 분포를 기준으로 나눈 등급입니다. CUE는 low, medium, high 중 1개를 반환합니다. 구매 모델의 high는 구매 가능성이 높은 등급이고, 이탈 모델의 high는 이탈 가능성이 높은 등급입니다. 자세한 해석은 예측값 활용하기에서 확인할 수 있습니다.
예측 기간
예측 기간은 모델이 사건의 발생 여부를 예측하는 기간입니다. d3_purchase는 앱 설치 후 3일 이내에 표준 주문 완료 이벤트가 발생할 가능성을 예측합니다. d3_churn은 앱 설치 후 3일이 지난 뒤부터 30일까지 활동 이벤트가 관측되지 않을 가능성을 예측합니다. 두 모델 모두 앱 설치 시점을 기준으로 합니다.
설치에 기여한 터치포인트
설치에 기여한 터치포인트(Touchpoint)는 앱 설치 이벤트에 기여한 광고 접점입니다. CUE는 context.lastTouchpoint에 채널, 캠페인, 광고 그룹, 광고 소재와 광고 키워드를 담아 반환합니다. 최근 광고 접점이나 앱 사용자가 본 모든 광고를 뜻하지 않습니다. 이 정보를 운영 중인 광고와 연결해 해석하는 방법은 설치 유입 정보 활용하기에서 확인할 수 있습니다.
null
null은 JSON에서 값이 없음을 나타내는 표현입니다. 예측 확률 0이나 등급 low와는 다른 의미입니다.
설치 기여 결과가 없으면 context.lastTouchpoint 전체가 null입니다. 일부 값만 없으면 해당 필드가 null입니다. unattributed와 restricted는 null과 다른 반환값입니다. 특히 unattributed라는 값만으로 자연 유입 여부를 판단할 수 없습니다.
기본 동작
기본 동작은 API 결과를 활용할 수 없을 때 실행하도록 미리 정한 동작입니다. 예를 들어 기존 안내를 보여주거나 기본 메시지를 사용할 수 있습니다. API 오류나 시간 초과가 발생했을 때도 기본 동작을 실행하도록 구현해야 합니다.
HTTP 상태 코드와 requestId
HTTP 상태 코드는 API 요청의 처리 결과를 나타냅니다. Context API가 요청을 정상적으로 처리하면 200을 반환합니다. 오류가 발생하면 상태 코드와 응답 본문을 함께 확인해야 합니다.
requestId는 API 요청을 구분하는 값입니다. 오류를 확인하거나 에어브릿지 담당자에게 문의할 때 사용합니다. 자세한 처리 방법은 오류 처리에서 확인할 수 있습니다.