# 용어집

CUE의 사용자 ID, 예측값과 API 응답에 쓰이는 용어를 설명합니다.

Source: https://cue.airbridge.io/docs/ko/glossary
Language: ko
Updated: 2026-10-15

## 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`는 이탈 가능성이 높은 등급입니다. 자세한 해석은 [예측값 활용하기](/docs/ko/guides/reading-predictions)에서 확인할 수 있습니다.

## 예측 기간

예측 기간은 모델이 사건의 발생 여부를 예측하는 기간입니다. `d3_purchase`는 앱 설치 후 3일 이내에 표준 주문 완료 이벤트가 발생할 가능성을 예측합니다. `d3_churn`은 앱 설치 후 3일이 지난 뒤부터 30일까지 활동 이벤트가 관측되지 않을 가능성을 예측합니다. 두 모델 모두 앱 설치 시점을 기준으로 합니다.

## 설치에 기여한 터치포인트

설치에 기여한 터치포인트(Touchpoint)는 앱 설치 이벤트에 기여한 광고 접점입니다. CUE는 `context.lastTouchpoint`에 채널, 캠페인, 광고 그룹, 광고 소재와 광고 키워드를 담아 반환합니다. 최근 광고 접점이나 앱 사용자가 본 모든 광고를 뜻하지 않습니다. 이 정보를 운영 중인 광고와 연결해 해석하는 방법은 [설치 유입 정보 활용하기](/docs/ko/guides/install-touchpoint)에서 확인할 수 있습니다.

## null

`null`은 JSON에서 값이 없음을 나타내는 표현입니다. 예측 확률 `0`이나 등급 `low`와는 다른 의미입니다.

설치 기여 결과가 없으면 `context.lastTouchpoint` 전체가 `null`입니다. 일부 값만 없으면 해당 필드가 `null`입니다. `unattributed`와 `restricted`는 `null`과 다른 반환값입니다. 특히 `unattributed`라는 값만으로 자연 유입 여부를 판단할 수 없습니다.

## 기본 동작

기본 동작은 API 결과를 활용할 수 없을 때 실행하도록 미리 정한 동작입니다. 예를 들어 기존 안내를 보여주거나 기본 메시지를 사용할 수 있습니다. API 오류나 시간 초과가 발생했을 때도 기본 동작을 실행하도록 구현해야 합니다.

## HTTP 상태 코드와 requestId

HTTP 상태 코드는 API 요청의 처리 결과를 나타냅니다. Context API가 요청을 정상적으로 처리하면 `200`을 반환합니다. 오류가 발생하면 상태 코드와 응답 본문을 함께 확인해야 합니다.

`requestId`는 API 요청을 구분하는 값입니다. 오류를 확인하거나 에어브릿지 담당자에게 문의할 때 사용합니다. 자세한 처리 방법은 [오류 처리](/docs/ko/reference/errors)에서 확인할 수 있습니다.