For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.
누락되거나 예기치 않은 데이터
이 페이지는 세 가지 일반적인 데이터 문제를 진단합니다. 예상보다 적은 수의 이벤트를 보여주는 차트, 과장되거나 너무 작아 보이는 사용자 수, 다른 플랫폼과 일치하지 않는 Amplitude 수치입니다. 아래의 각 섹션에서는 일반적인 원인과 이를 해결하는 방법을 설명합니다.
이벤트 또는 속성이 누락된 이유
데이터를 Amplitude로 성공적으로 전송한 경우에도 이벤트나 속성이 분석에 나타나지 않을 수 있습니다. 다음 섹션에서는 일반적인 원인을 설명합니다.
프로젝트가 계측 한계에 도달했습니다.
프로젝트가 계측 한계에 도달하면 Amplitude는 제한을 초과하는 전체 이벤트 유형과 이벤트 또는 사용자 속성에 대해 데이터를 쿼리할 수 없습니다. 이 데이터는 CSV 파일 또는 Amplitude의 내보내기 API를 통해 원시 데이터를 내보내는 경우에만 액세스할 수 있습니다.
한도 이하로 되돌리려면 Amplitude Data에서 불필요한 이벤트 유형을 삭제하십시오. 한도 이하로 내려간 후에는 새로운 이벤트 유형, 이벤트 속성 및 사용자 속성이 Amplitude에 나타나기까지 약 24시간이 걸립니다.
누군가가 데이터를 숨기거나, 차단하거나, 삭제했음
누군가가 예상했던 데이터를 숨기거나, 차단하거나, 삭제했을 수 있습니다. 브랜치에서 main이러한 작업 간의 차이점을 검토하여 Amplitude가 데이터를 올바르게 수집하도록 합니다.
숨겨지거나 차단된 이벤트와 속성은 여전히 프로젝트의 계측 제한에 수행 회수가 포함됩니다. 삭제된 이벤트와 속성은 그렇지 않습니다.
데이터는 예상치 못한 이름을 가질 수도 있고, 익숙하지 않은 표시 이름을 가질 수도 있습니다. 이름을 조정하려면 데이터를 소급하여 변경하는 방법에 대한 문서를 참조하십시오.
숨겨진 이벤트
이벤트는 이벤트 스트림에 나타날 수 있지만 차트에는 나타나지 않습니다. 원인은 일반적으로 필터(예: 드롭 필터) 또는 누군가가 Amplitude Data에서 이벤트를 숨겼기 때문입니다.
또한 드롭다운, 패스파인더 결과 및 페르소나 차트에서 이벤트와 속성을 숨길 수도 있습니다.
스키마에는 계획되지 않은 데이터가 포함되어 있지 않습니다.
누락된 데이터는 계획되지 않은 것으로 수행 회수가 간주될 수 있습니다. 계획되지 않은 데이터는 현재 스키마 설정과 충돌하기 때문에 Amplitude는 이를 처리하는 방법을 모릅니다. 프로젝트의 추적 계획에 계획되지 않은 이벤트나 속성이 허용되는지 확인하십시오. 그렇지 않은 경우 Amplitude는 이벤트나 해당 속성을 저장하지 않습니다.
데이터 수집 또는 액세스 지연
이벤트 또는 속성 데이터가 일부 사용자에게는 표시되지만 다른 사용자에게는 표시되지 않는 경우 데이터 수집이 지연될 수 있습니다. 예를 들어 모바일 SDK가 Amplitude에 데이터를 전송할 때 이벤트가 즉시 나타나지 않을 수 있습니다. 사용자가 인터넷에 연결되어 있지 않거나 SDK가 이벤트 업로드 임계값에 도달하지 않았을 수 있습니다.
기본적으로 Amplitude의 모바일 SDK에는 이벤트 업로드 임계값이 30초 또는 30개의 이벤트로 설정되어 있습니다. SDK는 이벤트 데이터가 임계값에 도달할 때까지 이벤트 데이터를 전송하지 않습니다.
Identity API를 통해 전송된 새 사용자 속성 또는 수정된 사용자 속성도 수집 지연이 발생할 수 있습니다.
사용자 수의 예기치 않은 값
이벤트 또는 사용자 속성별로 이벤트를 그룹화할 때 일부 결과가 (none)라는 그룹에 나타날 수 있습니다. Amplitude에서 (none)은 Null 값을 나타냅니다.
다음 섹션에서는 사용자에게 Null이거나 예기치 않은 속성 값이 있는 이유에 대해 설명합니다.
이벤트 속성이 (none)버킷에 표시되는 이유
Amplitude는 이벤트 기반 분석 플랫폼으로, 모든 차트와 코호트는 이벤트 수준에서 쿼리를 수행합니다. 차트는 이벤트 발생 시점의 이벤트 속성 값을 반환합니다.
이벤트 속성은 이벤트의 구성 요소이므로 이벤트 속성 값은 이벤트 수준에서 고유할 수 있습니다. 이벤트 발생 시 null 값을 사용하여 이벤트를 전송하는 경우 해당 이벤트 속성별로 그룹화하면 일부 이벤트나 사용자가 (none)버킷에 배치됩니다.
예를 들어, 사용자 A는 1월 1일에 한 번, 2월 1일에 한 번 트리거했습니다Send Message. 1월 15일에 Audience이벤트 속성을 계측했으므로 사용자 A가 1월 1일에 이벤트를 트리거했을 때 해당 속성을 사용할 수 없었습니다.Send Message 이 Audience 속성은 Default및 Mentioned_Contacts만 허용합니다. 사용자 A가 Send Message2월 1일에 이벤트를 전송했을 때 해당 이벤트에는 Audience = Default가 있었습니다.
Amplitude는 사용자 A를 (none)버킷에서 한 번, Default버킷에서 한 번 계산합니다. 사용자 A는 2월 1일 이벤트 당시에는 Audience = Default였고, 1월 1일 이벤트 당시에는 Audience = (none)였습니다.
Amplitude는 이벤트 발생 시에 전송된 속성 값에 따라 이벤트와 사용자를 정렬합니다.
사용자 속성이 예상한 값을 표시하지 않는 이유
이벤트 속성과 마찬가지로 차트도 이벤트 발생 시점의 사용자 속성 값을 반환합니다.
Amplitude는 사용자 속성을 별도의 테이블에 저장한 다음 이를 이벤트에 적용합니다. 사용자의 속성 값이 업데이트될 때에도 기록 이벤트에 연결된 사용자 속성 값은 변경되지 않습니다.
사용자 정의 속성에 Null 값이 표시되는 이유
이벤트에 첨부된 사용자 지정 속성은 이벤트 발생 당시에 존재했던 사용자 속성 값을 반영합니다.
예를 들어 1월 15일에 Account_Type라는 사용자 속성을 계측했습니다. 사용자 A는 계정 유형이 Shopper인 등록된 사용자입니다. 사용자 A는 1월 1일에 한 번, 2월 1일에 Add Item to Cart한 번 트리거했습니다.
1월 15일까지 계측을 하지 않았으므로 1월 15일 이전에 트리거된 모든 이벤트는 Account_Type에 대해 null 값을 갖습니다. Account_TypeAmplitude는 사용자 A를 Shopper버킷에서 한 번, (none)버킷에서 한 번 계산합니다.
고유 사용자를 측정할 때 Amplitude는 각 고유 버킷 내에서 사용자의 중복을 제거합니다. 사용자 A가 2월 1일과 2월 2일 Add Item to Cart모두에 자신의 Shopper계정 유형으로 트리거된 경우에도 Amplitude는 여전히 사용자 A를 Shopper버킷에 한 번만 계산합니다.
동일한 논리가 Null이 아닌 사용자 속성 값에도 적용됩니다. Amplitude는 이벤트 발생 시에 적용된 속성 값을 기준으로 이벤트와 사용자를 정렬합니다.
Amplitude는 사용자 속성이 시간별로 변경될 수 있기 때문에 이 논리를 사용합니다. City예를 들어 는 사용자가 이동하거나 다른 도시에서 이벤트를 전송함에 따라 시간별로 변경될 수 있습니다. 이벤트 발생 당시 사용자가 어디에 있었는지 아는 것은 사용자가 현재 어디에 있는지 아는 것보다 더 중요할 수 있습니다.
위치 속성은 (none)값을 표시합니다
Amplitude는 GeoIP에 따라 위치 사용자 속성(예: [Amplitude] City, [Amplitude] DMA, [Amplitude] Region, 및 [Amplitude] Country)을 결정합니다. Amplitude는 MaxMind 데이터베이스를 사용하여 사용자의 IP 주소로부터 위치 정보를 조회합니다.
클라이언트측 이벤트의 경우 MaxMind가 해당 IP 주소에 대해 null을 반환할 때 위치 속성에 (none)값이 있을 수 있습니다. 도시 및 지역 정보의 정확성과 가용성은 국가마다 다릅니다. 자세한 내용은 MaxMind의 정확도 비교를 참조하십시오.
서버측 이벤트의 경우, Amplitude는 GeoIP(사용할 수 없는 경우 location_lat 및 location_long 사용)를 기준으로 또는 API 호출에 명시적으로 정의된 값을 통해 위치 속성 값을 결정합니다. Amplitude의 HTTP API를 사용하면 사용자 지정 City, DMA, Region, 및 Country 값을 이벤트와 함께 전송할 수 있습니다. Amplitude는 GeoIP를 반영하기 위해 이러한 값을 수정하지 않습니다. 네 개의 필드를 모두 함께 업데이트하십시오. 이 필드 중 하나를 설정하면 다른 모든 필드가 자동으로 재설정됩니다.
디바이스 속성에 (none) 값이 표시되는 이유
Amplitude는 사용자의 기기에서 device_brand, device_manufacturer및 device_model 문자열을 읽은 다음 이러한 문자열을 Amplitude의 기기 유형 저장소에 매핑함으로써 [Amplitude] Device family 및 [Amplitude] Device type를 결정합니다.
새로운 휴대폰 모델이 출시될 때 Amplitude는 일부 장치 유형을 아직 매핑하지 않았을 수 있습니다. 이 경우 [Amplitude] Device type은 (none) 입니다.
또한 platform, os_name, os_version, device_brand, device_manufacturer, device_model, carrier, 및 user_agent 필드를 함께 업데이트하지 않을 경우 서버측 이벤트에 NULL 장치 정보가 있을 수 있습니다. 이러한 필드 중 전체를 설정하면 동일한 이벤트에 대해 명시적으로 설정하지 않는 한 다른 모든 속성 값이 null로 재설정됩니다.
과거 이벤트의 사용자 수
이전 날짜의 사용자 수행 회수가 시간별 변동될 수 있습니다. 다른 날짜에 데이터를 볼 경우 이전 날짜의 사용자 수가 증가하거나 감소할 수 있습니다.
Amplitude가 나중에 과거에 발생한 이벤트를 수집할 때 사용자 수행 회수가 증가할 수 있습니다. 일반적인 이유:
- Amplitude의 모바일 SDK는 임계값을 사용하여 이벤트를 일괄 처리합니다. 임계값은 30초 간격이거나 30개의 이벤트마다 처리합니다. 사용자가 임계값을 충족하지 못할 경우 SDK는 사용자가 제품으로 돌아와서 더 많은 이벤트를 트리거할 때까지 해당 이벤트를 전송하지 않을 수 있습니다.
- 이 문제를 해결하려면 이벤트 업로드 빈도를 조정하십시오. Android Kotlin SDK의 경우
flushIntervalMillis또는flushQueueSize을 구성합니다. iOS SDK의 경우eventUploadPeriodSeconds또는eventUploadThreshold을 구성합니다. 다른 SDK에 대해서는 SDK 설명서를 참조하십시오.
- 이 문제를 해결하려면 이벤트 업로드 빈도를 조정하십시오. Android Kotlin SDK의 경우
- Amplitude의 배치 API 및 서버측 통합에는 본질적으로 지연이 있습니다.
- 이 문제를 해결하려면 배치 작업을 더 자주 예약하십시오.
- 사용자가 이벤트를 트리거했을 때 사용자의 셀룰러 또는 Wi-Fi 연결이 충분히 강하지 않은 경우 SDK는 연결이 강화될 때까지 해당 이벤트를 보관합니다.
- 이 문제에 대한 해결책은 없습니다.
Amplitude가 사용자 레코드를 병합할 때 사용자 수행 회수가 줄어들 수 있습니다.
Amplitude는 사용자 ID, 장치 ID 및 Amplitude ID로 구성된 시스템을 사용하여 고유 사용자를 추적합니다. 일부 사용자가 사용자 ID를 가지고 있지 않거나 익명 이벤트가 많은 경우, Amplitude는 먼저 이러한 익명 이벤트를 익명 프로필에 할당한 다음 나중에 이를 알려진 프로필에 병합합니다.
익명 사용자가 다시 돌아와 기존 프로필에 병합됨에 따라 데이터는 시간별 안정화됩니다. 이 작업에 걸리는 시간은 사용자 행동(사용자가 제품을 방문하는 빈도)과 설정(이벤트를 일괄 처리하는 빈도)에 따라 다릅니다. 매일 제품과 상호 작용하는 사용자는 병합 지연시간이 더 짧아집니다. 자주 방문하지 않는 사용자는 지연 시간이 더 길어집니다.
다른 플랫폼과의 데이터 불일치
Amplitude의 수치는 다른 공급업체의 리포트와 다를 수 있습니다. 원인은 다양할 수 있습니다.
숫자를 비교하기 전에 Amplitude가 사용자와 세션을 어떻게 추적하는지 살펴보십시오. Amplitude에서 고유 사용자 추적 및 세션 정의를 참조하십시오.
데이터 불일치 체크리스트
다음 질문을 데이터 불일치에 대한 문제 해결 체크리스트로 사용하십시오. 질문에 대해 ‘예’라고 대답할 수 있다면 그 요소가 원인이 아닐 가능성이 큽니다.
시간대는 Amplitude와 다른 플랫폼 간에 일치합니다.
그렇지 않은 경우 숫자를 비교하기 전에 시간대를 정렬하십시오. Amplitude는 수집한 데이터에 UTC로 타임스탬프를 지정하지만 Amplitude UI 내에서 시간대를 사용자 지정할 수 있습니다.
Amplitude에서 추적된 이벤트는 다른 플랫폼에서 추적한 이벤트와 일치합니다
그렇지 않은 경우 사용자 및 세션 수가 모두 추적되는 이벤트에 따라 달라지기 때문에 불일치할 가능성이 더 커집니다.
Amplitude와 다른 플랫폼은 동일한 웹 봇과 스크레이퍼를 차단합니다
그렇지 않으면 사용자 및 세션 수가 불일치할 가능성이 더 커집니다.
두 플랫폼 모두 관심 지표를 동일한 방식으로 정의합니다.
그렇지 않으면 불일치가 발생할 가능성이 더 큽니다.
다른 플랫폼은 Amplitude와 같은 방식으로 사용자를 병합합니다
그렇지 않은 경우 다른 플랫폼에서 사용자를 병합하는 데 사용하는 식별자에 따라 사용자 및 세션 수에 차이가 있을 수 있습니다.
세션 시간 초과 기간은 Amplitude와 다른 플랫폼 간에 일치합니다.
그렇지 않은 경우 세션 수에 차이가 있을 가능성이 더 큽니다.
Amplitude SDK의 경우 기본 세션 시간 제한 시간은 웹의 경우 30분, 모바일의 경우 5분입니다. 이러한 임계값은 사용자 정의할 수 있으므로 변경되었는지 여부를 개발자에게 확인하십시오.
Google 분석의 세션
Google Analytics와 Amplitude는 세션을 비슷하게 추적하지만 특정 공통 이벤트로 인해 세션 수에 차이가 날 수 있습니다.
| 시나리오 | Amplitude | Google 분석 | 소스 |
|---|---|---|---|
| 시간은 자정에 도달합니다 | 세션이 계속됨 | 현재 세션은 오후 11시 59분에 종료되고 새 세션은 오전 12시에 시작됩니다. | "시간 기반 만료"를 참조하십시오. |
| 캠페인 소스 변경 사항 | 세션이 계속됨 | 새 세션은 30분 첫 사용 후 시작됩니다. | "캠페인 기반 만료"를 참조하십시오. |
| 세션 이벤트 제한 | 제한 없음 | 처음 10개의 이벤트가 발생한 후 Google Analytics는 추적을 초당 1개의 이벤트로 제한합니다. | "세션당 이벤트 수 제한"을 참조하십시오. |
이 내용이 도움이 되었나요?