Reference
Context API 연동 순서와 준비 사항, 상황별로 참고할 문서를 안내합니다.
서버나 CRM에서 Context API를 호출하면 앱 사용자별 설치 유입 정보와 구매 및 이탈 예측값을 받아 서비스에 활용할 수 있습니다. 연동에는 대상 앱의 CUE 사용 설정과 예측 데이터, 해당 앱의 토큰과 테스트 사용자 ID가 필요합니다.
Context API 연동하기
아래 순서로 요청과 응답 처리를 구현할 수 있습니다.
- 시작하기에 따라 앱 설정을 확인하고 토큰과 테스트 사용자 ID를 준비합니다.
- Context API의 Endpoint → Headers → Request body → Payload 예시 순서로 요청을 작성합니다.
- 정상 응답에서
appId,user,context.lastTouchpoint와 구매 및 이탈 예측값을 확인합니다. - 오류 처리에 따라 오류나 시간 초과가 발생했을 때 실행할 기본 동작을 구현합니다.
- 정상 응답, 서비스에서 정한 조건에 맞지 않는 응답과 조회 실패를 각각 테스트합니다. 각 상황에서 의도한 화면이나 메시지가 제공되는지도 확인합니다.
확인할 문서
연동 중 필요한 내용은 아래 문서에서 확인할 수 있습니다.
| 문서 | 확인할 내용 |
|---|---|
| Context API | 식별자 3개 중 1개를 선택하는 방법, 전체 요청과 응답 예시, 필드 규격을 설명합니다. |
| 오류 처리 | 오류 코드 12개의 원인과 처리 방법, 재시도 여부, 기본 동작과 문의에 필요한 정보를 설명합니다. |
| 예측값 활용하기 | 구매와 이탈의 예측 기간, 확률과 등급의 의미를 설명합니다. |
| 용어집 | 토큰, 식별자 연결, JSON과 기본 동작의 뜻을 설명합니다. |
문서와 명세의 기준
Context API의 정상 응답에는 requestId, appId, user, context, predictions가 포함됩니다. 전체 응답과 필드 규격은 Context API와 OpenAPI 명세에서 확인할 수 있습니다.
context.lastTouchpoint는 설치에 기여한 광고 정보입니다. 반환된 광고 정보를 개인화에 활용하는 방법은 설치 유입 정보 활용하기에서 설명합니다. predictions의 구매 및 이탈 예측 기간, 확률과 등급의 의미는 예측값 활용하기에서 확인할 수 있습니다.
이 문서를 읽는 에이전트는 llms.txt에서 작업에 맞는 문서와 연동 시 주의점을 찾을 수 있습니다. 본문은 각 문서의 Markdown 원문으로, 요청과 응답 규격은 OpenAPI 명세로 제공됩니다.