MMP SDK 설치·인앱 이벤트 테스트 4단계
- 테스트 앱과 기기, 검증할 이벤트를 먼저 정리합니다.
- 테스트 링크 클릭부터 설치와 첫 실행까지 같은 기기에서 확인합니다.
- 이벤트명·매개변수·수신 기록과 중복 여부를 대조합니다.
MMP SDK(모바일 측정 파트너의 앱 측정 도구)를 연동한 뒤에는 SDK 연결, 테스트 링크, 앱 설치와 첫 실행, 인앱 이벤트, MMP 수신 기록을 차례로 확인합니다. 앱 설치만으로 광고 기여까지 검증되는 것은 아닙니다. 링크 유입과 이벤트 기록을 각각 살펴보세요. 메뉴 이름과 데이터 반영 시점은 MMP와 앱 환경에 따라 달라질 수 있습니다.
테스트 전에 준비할 항목
테스트 앱과 기기를 정합니다
개발 빌드나 테스트용 앱을 사용할지 정하고, 앱 패키지명(Android) 또는 번들 ID(iOS)와 MMP 대시보드의 앱 정보가 맞는지 확인합니다. 사용하는 MMP가 테스트 기기 등록이나 디버그 설정을 요구하면 먼저 준비하세요. 예를 들어 AppsFlyer 테스트 기기 등록 안내는 기기를 등록하면 반복 테스트 설치가 재설치로 기록되는 것을 방지할 수 있다고 설명합니다. 별도 테스트 앱을 쓰면 운영 데이터와 테스트 기록을 구분하기 쉽습니다.
검증할 이벤트와 조건을 기록합니다
회원가입, 핵심 기능 사용, 구매처럼 이번에 확인할 이벤트를 정하고 이벤트명, 필수 매개변수, 발생 조건을 기록해 둡니다. 앱 로그와 MMP 수신 기록을 같은 기준으로 비교할 수 있습니다. 이벤트 정의부터 정리해야 한다면 MMP 이벤트 택소노미 설계를 참고하세요.
설치와 인앱 이벤트 테스트 4단계
1단계: SDK 초기화와 전송 상태를 확인합니다
앱을 실행해 SDK가 초기화되는지 확인하고, 개발자 로그에서 앱 ID 오류, 인증 실패, 네트워크 오류, 이벤트 전송 오류가 있는지 살펴봅니다. SDK 로그가 정상이어도 MMP 수신이나 광고 어트리뷰션까지 확인된 것은 아니므로 다음 단계도 진행하세요.
2단계: 테스트 링크로 설치 흐름을 재현합니다
MMP의 테스트 절차에 따라 어트리뷰션 링크를 준비하고 등록한 기기에서 링크 클릭, 스토어 이동, 설치, 첫 실행 순으로 테스트합니다. 설치 전에 앱이 이미 설치되어 있었는지, 링크를 누른 기기와 앱을 실행한 기기가 같은지 기록하세요. 예를 들어 AppsFlyer 통합 테스트 안내는 어트리뷰션 링크로 광고 클릭을 재현하고, 등록된 테스트 기기에 앱을 설치한 뒤 전환 데이터를 확인하는 절차를 설명합니다. 다른 MMP를 쓴다면 그 제품의 테스트 기기 및 링크 지침을 따르세요.
3단계: 인앱 이벤트를 발생시키고 로그를 확인합니다
회원가입이나 핵심 기능 사용 등 실제 이벤트 조건을 수행한 뒤 앱 로그에서 이벤트명과 전달 매개변수를 확인합니다. 결제 이벤트는 실결제 또는 샌드박스 거래 중 어떤 방식이 지원되는지 결제 및 MMP 문서에서 먼저 확인하세요. 테스트 목적으로 운영 데이터에 허위 구매를 보내면 매출 지표에 섞일 수 있습니다.
4단계: MMP 수신 기록과 어트리뷰션을 대조합니다
MMP의 이벤트 또는 원시 데이터 화면에서 기록이 도착했는지 확인합니다. 이벤트명뿐 아니라 수신 시각, 앱 버전, 매개변수, 미디어 소스와 캠페인 정보도 예상한 값과 비교하세요. 로그, 대시보드, 집계 보고서는 표시 시점과 필드가 다를 수 있으므로 해당 MMP의 설명을 기준으로 결과를 판정합니다.
결과 판정 기준과 플랫폼 차이
| 검증 항목 | 확인 기준 | 이상이 있을 때 볼 항목 |
|---|---|---|
| SDK 연결 | 초기화 및 전송 오류 여부 | 앱 식별 정보, 인증 설정, 네트워크, SDK 설정 |
| 설치 | 테스트 링크와 설치 기록의 연결 | 기존 설치 상태, 테스트 기기 등록, 링크 조건 |
| 인앱 이벤트 | 정한 이벤트명과 매개변수의 수신 | 호출 조건, 이벤트 매핑, 필수 값 |
| 광고 기여 | 링크의 미디어·캠페인 값과 결과의 일치 여부 | 링크 설정, 플랫폼의 측정 방식, 테스트 절차 |
Android 앱에서 Google Play Install Referrer API를 사용하는 구성이라면, 이 API는 기기에 설치된 Google Play 스토어 앱을 통해 제공됩니다. 따라서 APK를 직접 설치한 결과와 Google Play를 통해 설치한 결과를 같은 조건으로 해석하지 마세요. 자세한 조건은 Android Developers의 Google Play Install Referrer 문서를 확인하세요.
iOS에서는 MMP SDK 이벤트 수신과 개인정보 보호 기반 광고 어트리뷰션을 별도로 확인해야 합니다. SKAdNetwork와 AdAttributionKit은 각각의 설정 및 보고 흐름이 있으며, 두 프레임워크 간 연동 방식도 고려해야 합니다. ATT 동의 상태만으로 SKAdNetwork 동작 여부를 판단하지 말고 사용하는 광고 네트워크와 MMP의 최신 설정 안내를 확인하세요. Apple의 AdAttributionKit과 SKAdNetwork의 상호 운용성 문서는 두 프레임워크가 광고 기여를 처리하는 관계를 설명합니다.
앱 설치 신호와 광고 기여 결과, 인앱 이벤트 수신은 각각 확인하세요. 한 화면에 설치 기록이 보인다는 사실만으로 캠페인 기여와 이벤트 전송까지 검증된 것은 아닙니다.
누락·중복 기록이 생길 때
- 이벤트가 보이지 않음: 앱에서 이벤트 호출 경로가 실행됐는지, 필수 매개변수 오류나 네트워크 문제가 있는지 확인합니다. 로그가 호출 시도만 보여주는지 실제 전송 성공까지 나타내는지도 구분하세요.
- 이벤트가 두 번 보임: 앱 코드, 다른 분석 SDK, 채널 SDK가 같은 이벤트를 각각 보내는지 확인합니다. 자동 수집 이벤트와 수동 호출이 겹치는지도 살펴봅니다.
- 설치가 자연 유입으로 표시됨: 링크를 클릭한 기기, 앱 설치 상태, 테스트 기기 등록, 링크 설정이 테스트 절차와 일치하는지 확인합니다.
- 대시보드에 늦게 표시됨: 실시간 로그와 집계 보고서의 처리 시점이 다를 수 있습니다. 모든 MMP에 공통인 대기 시간을 가정하지 말고 해당 제품의 안내를 따릅니다.
- iOS 어트리뷰션 결과가 예상과 다름: SDK 이벤트 로그와 개인정보 보호 기반 어트리뷰션 결과를 구분하고, 사용 중인 프레임워크와 MMP 보고 방식에 맞게 확인합니다. 관련 주제는 iOS SKAN 포스트백 해석법을 참고하세요.
운영 앱에서 테스트한다면 테스트 기록이 실제 캠페인·매출 데이터에 섞이지 않도록 구분 방법을 먼저 확인하세요. 테스트 데이터의 제외·삭제 기능과 적용 범위는 제품마다 다를 수 있습니다.
마무리 체크리스트
- 테스트 앱 식별 정보와 MMP 대시보드의 앱 정보가 일치합니다.
- SDK 초기화와 이벤트 전송 로그를 확인했습니다.
- 같은 기기에서 테스트 링크 클릭부터 설치와 첫 실행까지 재현했습니다.
- 정한 인앱 이벤트가 예상한 이름과 매개변수로 수신됐습니다.
- 중복 기록과 운영 데이터 혼입 가능성을 점검했습니다.
실패한 항목이 있으면 링크 조건, 앱 로그, MMP 수신 기록 순으로 재현 조건을 확인하세요.
자주 묻는 질문
앱을 설치하면 MMP 설치 테스트가 끝난 건가요?
아닙니다. SDK 초기화와 첫 실행 수신을 확인하고, 광고 기여까지 검증하려면 테스트 링크 정보와 설치 결과도 대조해야 합니다.
테스트할 때 앱을 삭제하고 다시 설치해야 하나요?
새 설치를 재현할 때 기존 설치 상태가 결과에 영향을 줄 수 있습니다. 다만 삭제만으로 모든 MMP의 재설치 판정이나 테스트 조건이 같아지지는 않으므로 제품의 테스트 기기 안내를 확인하세요.
이벤트가 앱 로그에는 있는데 MMP에 없습니다. 무엇을 확인하나요?
로그가 실제 전송 성공을 나타내는지 확인한 다음 앱 식별 정보, 이벤트 매핑, 필수 매개변수, 네트워크 상태를 점검하세요.
Android APK 직접 설치로 광고 기여도 테스트할 수 있나요?
SDK 이벤트 수신과 광고 기여 검증은 다를 수 있습니다. Google Play Install Referrer API를 확인하는 테스트라면 Google Play 스토어 앱을 통한 설치 조건을 고려하고, 직접 설치 결과를 동일하게 해석하지 마세요.
테스트 이벤트가 실제 캠페인 보고서에 포함될 수 있나요?
테스트 환경과 제품 설정에 따라 달라질 수 있습니다. 가능하면 테스트 앱을 사용하고, 운영 앱에서 테스트한다면 테스트 기기 표시와 데이터 구분 방법을 먼저 확인하세요.
