이벤트 연동 확인하기
기존 에어브릿지 연동의 사용자 ID와 이벤트를 점검하고, 서비스에 맞는 수집 항목을 확인할 수 있습니다.
CUE를 활용하기 전에는 에어브릿지에서 수집 중인 이벤트가 실제 사용자 행동을 올바르게 기록하고 있는지 확인해야 합니다. 기존에 연동한 이벤트를 기준으로 아래 항목을 점검해 주세요.
확인할 항목
CUE에서 조회할 사용자 ID와 앱 설치 및 실행 이벤트를 확인해야 합니다. 구매 예측을 활용한다면 주문 완료 이벤트의 수집 상태도 확인해야 합니다.
사용자 ID 연결
Context API에서 사용할 ID가 조회하려는 사용자와 연결되어 있어야 합니다. 이벤트를 발생시킨 사용자와 API에서 조회하는 사용자가 일치하는지 확인해 주세요.
시작하기에서 선택한 ID에 따라 SDK에서 값을 조회하거나 연결 정보를 설정해야 합니다. Braze Device ID와 외부 사용자 ID는 에어브릿지 SDK로 전달해 에어브릿지 사용자와 연결해야 합니다.
userId를 사용하려면 에어브릿지 SDK를 초기화한 뒤Airbridge.fetchAirbridgeGeneratedUUID를 호출해야 합니다. 콜백으로 받은 Airbridge Generated UUID가 요청에 사용할 값입니다. SDK별 호출 방법은 안드로이드 데이터 패칭 가이드와 iOS 데이터 패칭 가이드의 ‘Airbridge Generated UUID’에서 확인할 수 있습니다.brazeDeviceId를 사용하려면 브레이즈 SDK의 Device ID를 에어브릿지 SDK의braze_device_id디바이스 별칭으로 전달해야 합니다. 요청에는 별칭으로 전달한 것과 같은 값을 사용해야 합니다. SDK별 설정 방법은 브레이즈 연동 가이드에서 확인할 수 있습니다.airbridgeExternalUserId를 사용하려면 서비스의 사용자 ID를 에어브릿지 SDK의Airbridge.setUserID로 설정해야 합니다. 요청에는 SDK에 설정한 것과 같은 값을 사용해야 합니다. 설정 방법은 안드로이드 SDK와 iOS SDK의 ‘유저 ID 설정하기’에서 확인할 수 있습니다.
테스트할 때는 위 설정을 적용한 앱을 실행하고, 해당 기기에서 조회한 ID나 테스트 계정에 설정한 ID를 요청에 사용해 주세요. brazeDeviceId는 브레이즈의 external_id와 다른 값입니다.
앱 설치와 실행 이벤트
앱 설치와 실행 이벤트가 정상적으로 수집되는지 확인해야 합니다. CUE의 예측 기간은 앱 설치 시점을 기준으로 하며, 이탈 예측은 이후 일정 기간에 활동 이벤트가 관측되지 않는 경우를 다룹니다.
앱 설치와 실행 이벤트는 에어브릿지 SDK가 자동으로 수집합니다. 기존 연동에서 실제 설치와 앱 사용 기록이 정상적으로 남는지 확인해 주세요. 자동 수집 이벤트에 대한 자세한 내용은 에어브릿지 이벤트 택소노미 가이드에서 확인할 수 있습니다.
구매 예측을 활용한다면 주문 완료 이벤트
구매 예측값을 활용하려면 표준 주문 완료(Order Complete) 이벤트인 airbridge.ecommerce.order.completed의 수집 상태를 확인해야 합니다. CUE의 구매 예측은 이 이벤트의 발생 가능성을 예측합니다.
기존에 수집하는 구매 이벤트에서 아래 내용을 확인해 주세요.
- 이벤트 카테고리가
airbridge.ecommerce.order.completed여야 합니다. - 사용자가 실제로 주문을 완료한 뒤에 이벤트가 전송되어야 합니다.
- 완료된 주문이 누락되거나 같은 주문이 중복으로 기록되지 않아야 합니다.
이벤트 속성과 전송 시점에 대한 상세한 설정은 에어브릿지 이벤트 가이드에서 확인할 수 있습니다.
서비스에 따라 권장하는 항목
서비스의 주요 행동과 분석 목적에 맞춰 추가로 수집할 이벤트와 속성을 정하는 것을 권장합니다. 아래 예시는 서비스를 사용하는 흐름을 파악하기 위한 항목이며, CUE를 사용하기 위해 모두 연동해야 하는 것은 아닙니다.
주요 행동 이벤트
서비스에서 중요하게 보는 행동이 정확하게 기록되는지 확인하는 것을 권장합니다. 서비스에 따라 아래와 같은 이벤트를 살펴볼 수 있습니다.
| 서비스에서 파악하려는 흐름 | 이벤트 예시 | 확인할 내용 |
|---|---|---|
| 쇼핑 앱에서 상품 탐색부터 결제까지의 흐름을 파악합니다. | 상품상세페이지 조회, 검색결과 조회, 장바구니 담기와 결제 시작 이벤트를 수집합니다. | 상품을 본 시점, 장바구니에 담은 시점과 결제를 시작한 시점을 구분해 기록하는지 확인합니다. |
| 회원가입과 로그인이 서비스 사용으로 이어지는지 파악합니다. | 회원가입과 로그인 이벤트를 수집합니다. | 가입 화면에 진입한 경우와 가입을 완료한 경우, 로그인에 실패한 경우와 성공한 경우를 구분해 기록하는지 확인합니다. |
| 구독 서비스에서 체험판 사용과 구독 전환을 파악합니다. | 체험판 시작, 구독과 구독 취소 이벤트를 수집합니다. | 체험판을 시작한 상태와 구독을 시작하거나 취소한 상태를 구분하는지 확인합니다. |
| 게임에서 초기 적응과 진행 상황을 파악합니다. | 튜토리얼 완료와 레벨 달성 이벤트를 수집합니다. | 튜토리얼을 실제로 완료했는지, 어떤 레벨이나 스테이지에 도달했는지 확인합니다. |
수집하려는 행동에 해당하는 에어브릿지 표준 이벤트가 있다면 해당 이벤트를 사용해야 합니다. 표준 이벤트가 없는 행동은 커스텀 이벤트로 정의할 수 있습니다. 이벤트 목록과 정의 방법은 에어브릿지 이벤트 가이드에서 확인할 수 있으며, 커머스와 게임 가이드에는 업종별 예시가 있습니다.
분석 목적에 필요한 이벤트 속성
이벤트의 발생 여부와 함께 어떤 상품이나 행동이었는지 분석하려면 관련 속성도 수집하는 것을 권장합니다. 분석 목적에 따라 아래 내용을 확인할 수 있습니다.
| 분석 목적 | 함께 수집할 정보 | 확인할 내용 |
|---|---|---|
| 주문별 매출을 확인합니다. | 구매 금액, 통화와 주문 ID를 수집합니다. | 구매 금액이 실제 결제 금액과 일치하고, 주문 ID로 실제 주문을 구분할 수 있는지 확인합니다. |
| 상품별로 조회와 구매를 비교합니다. | 상품 ID, 상품 카테고리, 가격과 수량을 수집합니다. | 같은 상품의 ID를 이벤트마다 일관되게 사용하고, 주문에 포함된 상품과 수량이 올바르게 기록되는지 확인합니다. |
| 검색결과 조회를 검색어별로 분석합니다. | 사용자가 입력한 검색어를 수집합니다. | 검색결과 조회 이벤트에 해당 검색어가 함께 기록되는지 확인합니다. |
| 게임의 진행 상황을 구간별로 분석합니다. | 달성한 레벨이나 스테이지 정보를 수집합니다. | 레벨 달성 이벤트에 도달한 레벨이나 스테이지가 함께 기록되는지 확인합니다. |
에어브릿지 리포트에서 이벤트를 세부 항목으로 나눠 보려면 액션이나 라벨을 사용하고, 상품 목록과 같은 추가 정보는 해당 시맨틱 어트리뷰트에 맞춰 설정해야 합니다. 속성별 용도와 형식은 이벤트 구성요소 가이드에서 확인할 수 있습니다.
주문 완료 이벤트의 통화처럼 에어브릿지가 필수로 정한 속성은 분석 목적과 관계없이 전송해야 합니다. 필수 속성과 설정 방법은 에어브릿지 이벤트 가이드에서 확인할 수 있습니다.
수집 상태 확인하기
에어브릿지에서 기존에 수집된 이벤트를 먼저 확인해 주세요. 수집 상태가 불분명하거나 최근에 앱의 주요 사용 흐름을 변경했다면 테스트 기기에서 해당 행동을 실행하고, 이벤트가 의도한 시점에 올바른 값으로 기록되는지 확인할 수 있습니다.
테스트 기기 등록과 수집 결과 확인 방법은 에어브릿지 SDK 테스트 가이드에서 확인할 수 있습니다.
이벤트 수집 상태를 확인한 다음에는 Context 활용하기에서 예측값과 광고 기여 정보를 화면이나 메시지에 적용하는 방법을 살펴볼 수 있습니다.