앱 MVP 설치 유입 기록: 링크 값·설치 시점·첫 실행을 나누는 5가지 기준
앱 MVP 설치 유입 기록: 링크 값·설치 시점·첫 실행을 나누는 5가지 기준
앱 설치가 한 번 일어났다는 사실만으로 “어느 캠페인이 설치를 만들었다”거나 “사용자가 가입할 것이다”라고 결론 내리기 쉽습니다. 하지만 Google Play에서 읽는 Install Referrer는 설치 뒤 앱이 받을 수 있는 한 종류의 기술 정보일 뿐입니다. 이 글은 광고 성과나 귀속 정확도를 약속하지 않습니다. 대신 초기 팀이 설치 전 링크, Play가 돌려준 referrer 값, 설치 시점, 첫 실행 처리, 서버 전송 결과를 한 사건으로 섞지 않고 기록하는 기준을 정리합니다.
먼저 구분할 것: 링크 클릭, 설치 시작, 첫 실행은 다른 사건입니다
사용자가 웹 링크를 탭한 시점과 Google Play 설치가 시작된 시점, 설치가 끝난 뒤 앱을 처음 연 시점은 서로 다를 수 있습니다. Android Developers의 Install Referrer 문서는 설치 패키지와 연결된 referrer URL, 클릭 시각, 설치 시작 시각, 첫 설치 당시 앱 버전 등을 API 반환 항목으로 안내합니다. 이 값들은 “앱 안에서 받은 값”으로 기록할 수 있지만, 각 값이 고객의 의도나 매출 기여를 확정하지는 않습니다.
MVP에서 가장 먼저 정할 것은 분석 도구 이름이 아니라 사건표입니다. 링크를 만든 채널의 정보, Play 응답, 앱의 첫 실행, 내부 서버 수신, 회원가입·결제 같은 후속 행동을 서로 다른 행으로 남깁니다. 그래야 한 구간의 누락을 다른 구간의 성공으로 착각하지 않습니다.
기준 1: referrer 문자열은 원문과 해석값을 분리합니다
Install Referrer는 설치 패키지에 대한 referrer URL을 반환할 수 있습니다. 이때 utm_source처럼 팀이 정한 파라미터가 들어 있다고 해도, 원문 문자열과 내부에서 해석한 채널 이름은 같은 데이터가 아닙니다. 원문은 수신 사실이고, 내부 분류는 운영 규칙입니다.
예를 들어 원문이 비어 있거나 예상하지 않은 값이어도 “직접 유입”으로 자동 확정하기보다 UNKNOWN 또는 UNPARSED 같은 상태를 남기는 편이 안전합니다. 동일 문자열을 어떤 채널로 묶을지는 버전이 있는 매핑 규칙으로 관리하고, 매핑을 바꾼 날에는 과거 데이터를 조용히 덮어쓰지 않습니다. URL에 개인식별 정보나 비밀값을 넣지 않는 원칙도 별도로 둡니다.
기준 2: 시점 값은 순서 점검용으로만 사용합니다
Android Developers는 referrer 클릭과 설치 시작에 대한 클라이언트·서버 시각 필드를 안내합니다. 이 시각은 설치 경로의 순서를 점검하는 단서가 될 수 있지만, 앱이 화면에 표시된 순간·로그인 완료·결제 완료와 같은 의미는 아닙니다.
따라서 사건표에는 시간의 이름과 출처를 함께 둡니다. 예를 들어 referrer_click_time_from_play, install_begin_time_from_play, first_open_time_from_app, server_received_at처럼요. 시간대·단위 변환 규칙을 문서화하고, 각 시스템의 시계를 억지로 같은 정밀도로 맞춘 것처럼 표현하지 않습니다. 순서가 뒤집힌 값이나 누락은 데이터 오류가 아니라 조사할 상태로 남깁니다.
앱 MVP의 유입 기록과 다음 검증 범위를 함께 점검하기
기준 3: 첫 실행에서 한 번 읽는 일과 저장 성공을 분리합니다
Android Developers는 불필요한 호출을 줄이기 위해 설치 뒤 첫 실행에서 Install Referrer API를 한 번 호출하도록 안내합니다. 이것은 “첫 화면이 보였으니 기록까지 끝났다”는 뜻이 아닙니다. API 연결, 응답 수신, 유효성 확인, 로컬 임시 저장, 서버 전달, 전달 확인은 각각 실패할 수 있습니다.
처음부터 완료 상태를 하나만 만들지 말고 최소한 아래처럼 나눕니다.
상태 | 확인 질문 | 완료로 보지 말아야 할 것 |
|---|---|---|
API 연결 시작 | Play Store 연결을 시도했는가? | 버튼·앱 실행만으로 연결 성공 |
응답 수신 | 반환 코드와 응답을 받았는가? | 연결 시도만으로 값 수신 |
원문 검증 | 문자열 형식과 허용 키를 확인했는가? | 값이 있다는 사실만으로 채널 확정 |
내부 저장 | 중복 없이 원문·해석·출처를 남겼는가? | 메모리 변수에만 있는 상태 |
서버 확인 | 서버가 수신·처리 결과를 돌려줬는가? | 네트워크 요청 발송만으로 저장 완료 |
앱이 오프라인이거나 서버가 느릴 때도 첫 실행 자체를 막지 않도록, 실패를 재시도 대상으로 둘지 보류 대상으로 둘지 정합니다. 다만 이 설계가 실제 전달률이나 성능을 보장한다는 의미는 아닙니다. 앱에서 재현 가능한 QA로 확인해야 합니다.
기준 4: 비동기 응답 코드와 사용자 흐름을 한 화면에 섞지 않습니다
Client Library 가이드는 startConnection()이 비동기로 동작하고 리스너의 응답 코드를 처리하도록 안내합니다. 기술 응답은 앱의 사용자 화면과 별도입니다. 설치 유입 값을 못 읽었다고 회원가입·진단·결제 같은 핵심 작업을 실패로 처리할 근거가 생기는 것은 아닙니다.
그래서 제품 문서에는 “유입 기록 실패 시 사용자에게 무엇을 보일지”보다 먼저 “무엇을 내부 관찰 상태로 남길지”를 씁니다. 예컨대 Play 응답 없음, 서비스 연결 불가, 잘못된 문자열, 서버 수신 실패, 중복 수신은 서로 다른 원인입니다. 이 상태들을 하나의 attribution_failed로 뭉치면 복구와 분석 모두 어려워집니다.
기존 공개 글인 앱 MVP Android App Links는 웹 링크가 앱 또는 웹으로 어떻게 열리는지 다룹니다. 이번 글의 범위는 그 다음 단계인 Google Play 설치 뒤의 기록 처리입니다. 링크가 앱을 열었다는 사실과 Play referrer를 받았다는 사실도 같은 사건이 아닙니다.
기준 5: 보관 가능 기간과 재설치 조건은 관찰 범위로 기록합니다
Android Developers는 Install Referrer 정보가 90일 동안 제공되고, 앱을 재설치하지 않으면 바뀌지 않는다고 안내합니다. 이는 해당 API가 제공하는 정보의 조건입니다. 팀의 개인정보 보관 기간, 고객 동의, 내부 삭제 절차를 대신 결정해 주지는 않습니다.
따라서 문서에는 API 특성과 자체 정책을 나눠 씁니다. “Play 응답은 어떤 조건에서 다시 달라질 수 있는가”, “앱 내부에 어떤 최소 필드를 얼마 동안 두는가”, “서버 전송 뒤 원문을 유지할지 축약할지”, “삭제·철회 요청이 들어오면 어떤 레코드가 영향을 받는가”처럼요. 특정 앱이 법적 요건을 충족한다고 이 글만으로 판단하면 안 됩니다.
출시 전 10분 점검표
링크 원문, 내부 채널 분류, 분류 규칙 버전을 별도로 저장하는가?
클릭·설치 시작·첫 실행·서버 수신 시점의 이름과 출처를 구분하는가?
API 연결·응답 수신·검증·저장·서버 확인을 하나의 성공 상태로 합치지 않았는가?
비동기 응답 실패가 사용자 핵심 작업을 불필요하게 막지 않는가?
재설치·오프라인·중복 수신·예상 밖 문자열을 테스트 시나리오에 넣었는가?
API의 90일 제공 조건과 팀의 자체 보관·삭제 정책을 구분했는가?
Install Referrer는 설치 경로를 관찰하기 위한 입력 중 하나입니다. 링크 값, Play가 제공한 시점, 앱 첫 실행, 내부 전달 결과를 나누어 두면 한 번의 API 응답을 과도한 성과 결론으로 읽지 않고, 이후 실험과 데이터 점검의 기준을 더 명확히 만들 수 있습니다.
자주 묻는 질문
Install Referrer 값이 있으면 광고 성과를 확정할 수 있나요?
아닙니다. Install Referrer는 Google Play가 앱에 반환할 수 있는 설치 관련 정보입니다. 어떤 캠페인의 전환·매출 기여로 해석할지는 별도의 측정 정의, 동의·보관 정책, 다른 데이터의 검증이 필요합니다.
앱이 처음 열릴 때마다 다시 호출하면 안 되나요?
Android Developers는 불필요한 API 호출을 피하기 위해 설치 뒤 첫 실행에서 한 번 호출하도록 안내합니다. 실패·재시도 정책은 앱의 설계와 QA 결과에 맞춰 별도로 정해야 합니다.
클릭 시각과 설치 시각이 있으면 첫 실행 시각도 알 수 있나요?
아닙니다. 공식 API가 안내하는 클릭·설치 시작 시각과 앱이 자체적으로 기록하는 첫 실행은 출처가 다른 사건입니다. 첫 실행은 앱의 관찰 기준으로 별도 기록해야 합니다.
재설치하면 값이 달라질 수 있나요?
Android Developers는 referrer 정보가 앱을 재설치하지 않으면 바뀌지 않는다고 안내합니다. 재설치를 포함한 실제 앱 동작은 기기·배포 조건에서 테스트해 확인해야 합니다.
출처
Android Developers, Google Play Install Referrer (2026-09-20 확인)
Android Developers, Play Install Referrer Library (2026-09-20 확인)
발행일: 2026-09-20 · 작성: 유인어스 정책자금·정부지원사업 인사이트