# AdBrix 연동 검증

디바이스 로그, SDK 이벤트 개요, Raw Data 추출, 리포트를 사용해 AdBrix 이벤트 수집 상태를 검증하는 절차.

- 카테고리: AdBrix
- 소요 시간: 약 5분
- 난이도: 쉬움
- 업데이트: 2026.05.21
- 원문: /wiki/playbook/adbrix/how-to-verify-adbrix-integration

## 목차

- [이 문서의 목적](#purpose)
- [1단계 · 디바이스 로그 확인](#step-1)
- [2단계 · SDK 이벤트 개요 확인](#step-2)
- [3단계 · Raw Data 추출](#step-3)
- [4단계 · 리포트 확인](#step-4)
- [문제 발생 시 순서](#troubleshooting)
- [참고 링크](#references)
- [자주 묻는 질문](#faq)

이 문서는 AdBrix SDK 적용 뒤 실제 이벤트가 수집되는지 확인하는 절차입니다. 검증은 디바이스 로그에서 SDK 호출 여부를 확인한 뒤, 콘솔의 SDK 이벤트 개요와 Raw Data로 수집 여부를 확인하는 순서로 진행합니다.

## 1단계. 디바이스 로그에서 SDK 호출 확인

Android는 logcat에서 AdBrix SDK 태그와 개발팀이 임시로 넣은 bridge 로그를 확인합니다. iOS는 Xcode console 또는 `NSLog`를 사용합니다.

**Android logcat**
```bash
adb logcat -v time DLTest:I abx.Adbrix:I '*:S'
```

WebView 이벤트 연동을 검증한다면 아래 두 로그가 같은 실행에서 보이면 bridge 경로는 정상입니다.

**성공 로그 예시**
```text
WebView console — [WebView] → webview_bridge_test
Native bridge logEvent — webview_bridge_test
```

## 2단계. 콘솔 SDK 이벤트 개요 확인

[AdBrix 콘솔](https://console.adbrix.ai/)에서앱 설정 → 앱 정보 → 관리 → SDK 이벤트 개요로 이동합니다. SDK에서 한 번이라도 호출된 이벤트는 이 화면에서 거의 실시간으로 확인할 수 있습니다.

![AdBrix 콘솔 SDK 이벤트 개요 화면에서 표준 이벤트 목록과 이벤트 연동 시간이 보이는 화면.](/wiki-assets/playbook/how-to-verify-adbrix-integration/01-sdk-event-list.png)

> **화면 1.** SDK 이벤트 개요에서 이벤트 연동 시간을 확인합니다.

> **완료**
>
> `webview_bridge_test` 같은 커스텀 이벤트를 호출했다면 커스텀 이벤트 탭에 해당 이름이 추가되는지 확인합니다.

## 3단계. Raw Data 추출로 속성 확인

이벤트 이름만이 아니라 속성 키와 값까지 확인해야 한다면 데이터 추출에서 App Event 템플릿으로 Raw Data를 생성합니다.

![AdBrix 콘솔 데이터 추출 메뉴 화면.](/wiki-assets/playbook/how-to-verify-adbrix-integration/02-data-extract.png)

> **화면 2.** 데이터 추출에서 App Event Raw Data를 생성합니다.

- 기간은 테스트를 수행한 날짜와 시간대로 좁힙니다.
- Group by에는 `Event Name`을 포함합니다.
- 필요하면 Device ID 또는 이벤트 이름 조건으로 테스트 이벤트만 필터링합니다.

## 4단계. 리포트에서 추이 확인

날짜별 또는 시간대별 호출 추이를 보려면 리포트 → 데이터 탐색에서 이벤트 추적 리포트를 생성합니다. 리포트는 즉시성보다 추이 확인에 적합합니다.

> **정보**
>
> 리포트는 정시 단위로 갱신될 수 있습니다. 방금 호출한 이벤트가 즉시 보이는지 확인하려면 SDK 이벤트 개요를 먼저 사용하세요.

## 문제 발생 시 순서

1. SDK 초기화 로그가 있는지 확인합니다.
2. 이벤트 호출 코드가 실제 사용자 행동 시점에 실행되는지 확인합니다.
3. WebView 앱이라면 `adbrixWebBridge` 이름이 Android/iOS 모두 정확한지 확인합니다.
4. AppKey가 콘솔에서 보고 있는 앱과 같은지 확인합니다.
5. 네트워크가 막혀 있지 않은지 확인합니다. SDK는 오프라인 상태에서 큐잉 후 재전송할 수 있습니다.

## 참고 링크

- [AdBrix 콘솔](https://console.adbrix.ai/)
- [AdBrix 공식 셀프 테스트 가이드](https://adbrix.gitbook.io/developer-guide/common/self-test)
- [SDK 설정 fetch endpoint 예시](https://static.adbrix.io/prod/sdk.config/{AppKey}/config.json)
- [이벤트 배치 전송 endpoint 예시](https://event.sdk.api.adbrix.ai/api/v6/event/bulk/{AppKey})

## 자주 묻는 질문

### SDK 이벤트 개요와 리포트 중 어디를 먼저 봐야 하나요?

방금 호출한 이벤트 확인은 SDK 이벤트 개요를 먼저 봅니다. 리포트는 집계 지연이 있을 수 있어 추이 확인에 더 적합합니다.

### 콘솔에 이벤트가 안 보이면 AppKey부터 봐야 하나요?

네. 디바이스 로그에서 SDK 호출이 보이는데 콘솔에 없다면, 앱에 넣은 AppKey가 현재 보고 있는 콘솔 앱의 AppKey와 같은지 먼저 확인합니다.

### Raw Data는 언제 확인하나요?

이벤트 이름 수집 여부만 볼 때는 SDK 이벤트 개요가 빠릅니다. 속성 키와 값까지 맞는지 검증해야 할 때 Raw Data를 추출합니다.

## Navigation

- [전체 플레이북 Markdown sitemap](/wiki/playbook/sitemap.md)

### AdBrix

- [AdBrix](/wiki/playbook/adbrix)
- [AdBrix SDK 초기화](/wiki/playbook/adbrix/how-to-initialize-adbrix-sdk)
- [AdBrix 딥링크 설정](/wiki/playbook/adbrix/how-to-set-up-adbrix-deeplinks)
- [AdBrix WebView 이벤트 연동](/wiki/playbook/adbrix/how-to-connect-adbrix-webview-events)
- [AdBrix 이벤트 전송](/wiki/playbook/adbrix/how-to-send-adbrix-events)
- [AdBrix 연동 검증](/wiki/playbook/adbrix/how-to-verify-adbrix-integration) (현재 문서)