# Context 활용하기

예측값과 설치 유입 정보로 화면과 메시지를 개인화하는 예시를 확인할 수 있습니다.

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

에어브릿지 CUE의 구매 및 이탈 예측값과 설치 유입 정보를 활용하면 앱 사용자에게 보여줄 상품이나 보낼 메시지를 다르게 구성할 수 있습니다.

의류와 생활용품을 판매하는 쇼핑 앱을 예로 들어 보겠습니다. 사용자는 앱 홈에서 인기 상품과 기획전을 둘러보고, 상품을 장바구니에 담아 주문합니다. 이 앱은 홈에서 상품을 소개하고, CRM에서 기획전과 신상품을 안내하는 푸시 메시지를 보냅니다.

이 서비스에서 CUE를 활용해 상품 구성과 메시지를 어떻게 바꿀 수 있는지 살펴보겠습니다.

## 활용할 정보와 동작 정하기

같은 쇼핑 앱에서도 개인화를 적용할 위치와 목적에 따라 사용할 정보가 달라집니다.

| 활용할 정보             | 적용할 대상                                                 | 활용 예시                                                   |
| ----------------------- | ----------------------------------------------------------- | ----------------------------------------------------------- |
| 구매 예측값             | 구매 등급이 `high`인 사용자                                 | 진행 중인 기획전의 상품을 홈 상단에 배치합니다.             |
| 이탈 예측값             | 푸시 발송 대상 중 이탈 등급이 `high`인 사용자               | 신상품을 소개하는 메시지로 재방문을 유도합니다.             |
| 설치 유입 정보          | 생활용품 기획전 광고를 통해 앱을 설치한 사용자              | 광고에서 본 기획전 배너를 홈에 표시합니다.                  |
| 설치 유입 정보와 예측값 | 생활용품 기획전 광고로 설치했고 구매 등급이 `high`인 사용자 | 해당 기획전의 배너와 대표 상품을 홈 상단에 함께 보여줍니다. |

구매 예측값은 상품을 안내할 대상을 정할 때, 이탈 예측값은 재방문 메시지를 보낼 대상을 정할 때 활용할 수 있습니다. 설치 유입 정보를 함께 사용하면 광고에서 본 상품군이나 기획전을 앱 안의 경험으로 연결할 수 있습니다.

CUE의 정보로 구성하는 쇼핑 경험

생활용품 캠페인 + 구매 등급 high

광고에서 본 기획전을 홈으로

앱 홈에 생활용품 기획전과 대표 상품을 함께 보여줍니다.

이탈 등급 high

신상품 안내로 재방문 유도

푸시 발송 대상에게 신상품을 소개하는 메시지를 보냅니다.

각 조건에서 보여줄 상품과 메시지 문구는 서비스에 맞게 정해야 합니다. 예를 들어 홈에서 기획전 상품을 강조하거나, 신상품 안내 대신 할인 행사 소식을 보낼 수 있습니다.

예측 대상 행동과 기간은 [예측값 활용하기](/docs/ko/guides/reading-predictions)에서, 광고 정보의 의미는 [설치 유입 정보 활용하기](/docs/ko/guides/install-touchpoint)에서 확인할 수 있습니다.

## 개인화 조건 정하기

개인화를 적용하려면 사용할 정보와 조건에 따른 동작을 구체적으로 정해야 합니다. 대상 조건과 상품 구성, 메시지 문구를 정한 뒤 앱이나 CRM에 규칙을 구현합니다. CRM에서 메시지를 보낼 때는 대상 조건과 발송 설정도 함께 준비해야 합니다.

각 규칙에는 **사용할 정보, 조건에 맞을 때의 동작, 기본 동작**을 포함해야 합니다.

### 응답에서 사용할 정보 확인하기

아래는 개인화 규칙에 사용할 응답 부분입니다. `context.lastTouchpoint`에서 광고 기여 정보를, `predictions`에서 구매와 이탈 예측값을 확인할 수 있습니다.

```json lineNumbers
{
  "context": {
    "lastTouchpoint": {
      "channel": "media_A",
      "campaign": "living_sale",
      "adGroup": "kitchen_storage",
      "adCreative": "storage_video",
      "term": null
    }
  },
  "predictions": {
    "d3_purchase": {
      "probability": 0.723,
      "tier": "high"
    },
    "d3_churn": {
      "probability": 0.812,
      "tier": "high"
    }
  }
}
```

위 응답 예시는 생활용품 기획전 캠페인인 `living_sale`을 통해 앱을 설치한 사용자를 기준으로 합니다. 구매와 이탈 등급은 모두 `high`입니다.

아래 2가지 예시에서는 이탈 등급으로 메시지 대상을 정하고, 캠페인과 구매 등급을 함께 사용해 홈 화면을 구성합니다. 전체 응답 규격은 [Context API](/docs/ko/reference/context-api)에서 확인할 수 있습니다.

### 예시 1. 이탈 등급으로 재방문 메시지 대상 정하기

이 쇼핑 앱은 푸시 메시지로 신상품을 안내하고 있습니다. 이탈 등급을 활용하면 기존 푸시 발송 대상 중 재방문을 유도할 대상을 골라 별도의 메시지를 보낼 수 있습니다.

* **사용할 정보:** `predictions.d3_churn.tier`에서 이탈 등급을 확인합니다.
* **조건에 맞을 때:** 푸시 발송 대상 중 이탈 등급이 `high`인 사용자에게 신상품 안내 메시지를 보냅니다.
* **기본 동작:** 등급 조건에 맞지 않거나 예측값을 얻지 못하면 기존 메시지 운영 방식을 유지합니다.

예를 들어 “이번 주 새로 들어온 상품을 만나보세요”라는 문구와 함께 신상품 목록으로 이동하는 링크를 넣을 수 있습니다. 메시지를 보낼 때는 수신 동의와 발송 간격 등 기존 발송 정책을 적용해야 합니다.

### 예시 2. 설치 유입 정보와 구매 등급으로 홈 화면 정하기

이 쇼핑 앱은 생활용품 기획전 광고도 운영하고 있습니다. 광고를 통해 앱을 설치한 사용자가 기획전을 바로 찾을 수 있도록 홈 화면을 구성할 수 있습니다.

캠페인은 어떤 기획전을 보여줄지 정하는 데, 구매 등급은 상품을 먼저 보여줄지 정하는 데 활용할 수 있습니다. 두 조건을 각각 적용하면 하나의 조건만 충족한 사용자에게도 다른 홈 화면을 제공할 수 있습니다.

* **사용할 정보:** `context.lastTouchpoint.campaign`에서 캠페인을, `predictions.d3_purchase.tier`에서 구매 등급을 확인합니다.
* **캠페인 조건:** 캠페인이 `living_sale`이면 생활용품 기획전 배너를 보여줍니다.
* **구매 등급 조건:** 구매 등급이 `high`이면 상품을 홈 상단에 배치합니다. 캠페인도 일치하면 해당 기획전의 대표 상품을, 그 밖에는 앱 전체의 인기 상품을 보여줍니다.
* **기본 동작:** 두 조건 중 어느 것도 충족하지 못하면 기존 홈 화면을 유지합니다.

기획전의 대표 상품과 앱 전체의 인기 상품은 서비스에서 미리 정합니다. 아래 예시에서는 `brand_campaign`을 `living_sale`과 다른 캠페인 값으로 사용합니다.

캠페인을 조건으로 사용하려면 `lastTouchpoint` 객체와 그 안의 `campaign`에 값이 있어야 합니다. 예측 등급을 기준으로 하는 규칙에서는 응답의 `tier`를 그대로 사용합니다.

캠페인과 구매 등급에 따라 달라지는 홈

각 조건의 충족 여부를 선택하면 배너와 상품 구성이 어떻게 달라지는지 확인할 수 있습니다.

두 조건 모두 충족

1. **CUE의 응답**
   캠페인이 `living_sale`이고 구매 등급이 `high`입니다.
2. **앱의 조건 판단**
   생활용품 기획전 캠페인과 구매 등급 조건을 모두 충족합니다.
3. **홈에 표시할 내용**
   앱이 생활용품 기획전 배너와 대표 상품을 홈 상단에 보여줍니다.

캠페인만 충족

1. **CUE의 응답**
   캠페인이 `living_sale`이고 구매 등급이 `medium`입니다.
2. **앱의 조건 판단**
   캠페인은 일치하지만 구매 등급 조건을 충족하지 않습니다.
3. **홈에 표시할 내용**
   앱이 생활용품 기획전 배너를 보여주고 기존 상품 목록을 유지합니다.

구매 등급만 충족

1. **CUE의 응답**
   캠페인이 `brand_campaign`이고 구매 등급이 `high`입니다.
2. **앱의 조건 판단**
   캠페인은 일치하지 않지만 구매 등급 조건을 충족합니다.
3. **홈에 표시할 내용**
   앱이 생활용품 기획전 배너 대신 기존 배너를 유지하고 앱 전체의 인기 상품을 홈 상단에 보여줍니다.

조건 미충족

1. **CUE의 응답**
   캠페인이 `brand_campaign`이고 구매 등급이 `medium`입니다.
2. **앱의 조건 판단**
   캠페인과 구매 등급 중 어느 조건도 충족하지 않습니다.
3. **홈에 표시할 내용**
   앱이 기존 홈 화면을 보여줍니다.

## 기본 동작과 오류 처리 준비하기

개인화 규칙에는 조건을 충족하지 않거나 필요한 정보를 얻지 못했을 때 제공할 기본 화면이나 메시지도 필요합니다. 이 쇼핑 앱에서는 기본 동작을 아래와 같이 구성할 수 있습니다.

| 상황                         | 처리 방법                                                                                               |
| ---------------------------- | ------------------------------------------------------------------------------------------------------- |
| 적용할 개인화 규칙이 없음   | 기존 홈 화면과 메시지 운영 방식을 유지합니다.                                                           |
| 필요한 설치 유입 정보가 없음 | 기존 배너를 유지합니다. 구매 등급을 받았다면 해당 등급의 규칙은 적용할 수 있습니다.                               |
| API 오류나 시간 초과         | 기본 화면을 표시하고 기존 메시지 운영 방식을 유지합니다. 실패 원인을 기록하고 재시도 여부를 확인합니다. |

오류별 처리 방법과 재시도 조건은 [오류 처리](/docs/ko/reference/errors)에서 확인할 수 있습니다.