이 페이지에서

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의 아키텍처는 사용자와 이벤트 모두에 대해 시간, 일, 주, 월별로 사전 집계된 세트를 사용합니다. 이 접근 방식은 대규모 쿼리를 지원하지만 불변의 데이터가 필요합니다.

사용자 개인정보 보호 API를 통해 GDPR 및 기타 개인정보 보호법을 준수하여 개별 사용자 수준에서 데이터를 삭제할 수 있습니다.

Amplitude는 어떻게 장치 ID를 설정하나요?

Amplitude는 클라이언트측 이벤트(Amplitude의 SDK 사용)와 서버측 이벤트(HTTP API)에 대해 기기 ID를 다르게 설정합니다.

  • SDK
    • Android의 경우, 사용자가 Google의 광고 ID를 기기 ID로 사용하도록 선택하지 않는 한 기기 ID는 기본적으로 무작위로 생성된 UUID로 설정됩니다.
    • iOS SDK의 경우 장치 ID는 공급업체 식별자(IDFV)로 기본값이 설정됩니다. 그렇지 않은 경우 SDK에서 이를 무작위로 생성합니다. 사용 가능한 경우 광고 식별자(IDFA)를 대신 사용하도록 선택할 수 있습니다.
  • 서버측(HTTP API)
    • 서버측 이벤트의 경우 이벤트에서 장치 ID를 수동으로 전송해야 합니다. 사용 가능한 장치 ID가 없는 경우 Amplitude는 장치 ID를 임의로 생성된 해시된 버전의 user_id로 설정합니다. 자세한 내용은 HTTP V2 API를 참조하십시오.
    • 서버측 및 클라이언트측 이벤트에 대해 동일한 장치 ID 설정을 유지하지 않는 경우 장치 모델, 언어 및 통신사가 동일하더라도 동일한 사용자는 다른 장치 ID를 가질 수 있습니다.

두 개의 다른 이벤트가 동일한 이름을 가질 수 있습니까?

아니요. 각 이벤트 이름은 전체 프로젝트에서 고유해야 합니다. Amplitude는 이름이 같은 두 이벤트를 동일한 이벤트로 취급합니다. 프로젝트에서 이름이 같은 두 이벤트를 발견하면 그 중 하나의 디스플레이 이름이 다른 이벤트와 동일한 이름으로 설정되었을 수 있습니다. Amplitude Data에서 이벤트를 확장하여 더 자세한 정보를 확인할 수 있습니다.

배열 값을 Amplitude로 전송할 수 있습니까?

예. 그러나 Amplitude는 배열 속성에 대한 정확한 일치를 지원하지 않습니다. 연산자를 사용하여 배열 내의 값을 필터링할 수 contains있습니다.

내 프로젝트에서 장치 정보(예: 장치 유형 또는 장치 제품군)가 'null'을 반환하는 이유는 무엇입니까?

Amplitude는 기기 또는 브라우저에서 기기 정보를 구문 분석할 수 없거나 기기가 Amplitude의 시스템에 매핑되어 있지 않은 경우 null 값을 반환합니다. 새 기기 값을 매핑하려면 Amplitude 지원 팀에 다음 정보를 문의하십시오.

  • 제조업체(예: samsung).
  • 모델(예: sm-g930u).
  • 장치 제품군(예: 삼성 갤럭시 폰).
  • 장치 유형(예: 삼성 갤럭시 S7).

내 세션이 새로운 세션 ID 값을 생성하는 이유는 무엇입니까?

Amplitude의 SDK를 통해 수집된 이벤트는 이벤트가 동일한 기기에서 발생한 경우 동일한 세션을 유지합니다*.* 세션 ID는 장치 ID가 변경될 때마다 변경됩니다.

JavaScript SDK의 기본 세션 시간 제한은 30분입니다. iOS/Android의 경우 이 시간은 5분입니다.

반복 수익 구독 이벤트를 어떻게 전송합니까?

첫 번째 구독 관련 수익 이벤트 이후, Apple 또는 Google은 해당 구독이 활성화되었는지 여부를 확인해야 합니다. 구독이 활성화되어 있는 경우, Amplitude는 해당 구독의 시간 간격에 구독 수익 이벤트를 수신합니다.

봇 트래픽 사용자를 어떻게 필터링합니까?

Amplitude SDK는 사용자 에이전트를 사용하여 일부 사용자 속성(예: 장치 유형)을 채우지만 사용자 에이전트 자체를 수집하거나 저장하지는 않습니다. 일부 고객은 사용자 에이전트를 사용자 지정 사용자 속성으로 저장하고 이러한 방식으로 봇 사용자를 제거하는 로직을 구현합니다.

또는 의심스러운 봇 사용자의 IP 주소를 확인할 수 있는 경우 데이터 필터를 사용하여 해당 IP 주소에서 발생하는 이벤트를 차단할 수 있습니다. 자세한 내용은 봇 웹 트래픽 차단에 관한 Amplitude의 헬프 센터 문서를 참조하세요.

내부 사용자를 차단 및 필터링

데이터를 깨끗하게 유지하기 위해 Amplitude는 프로덕션 프로젝트와 함께 개발 프로젝트를 설정하고 테스트 데이터를 개발 프로젝트에만 전송할 것을 권장합니다. 프로덕션 환경을 테스트하는 동안에도 내부 데이터를 프로덕션 프로젝트로 전송할 수 있습니다. 내부 사용자 이벤트는 제품 메트릭을 잘못 부풀릴 수 있으므로 정확한 보고를 위해 이러한 이벤트를 차단하거나 필터링해야 합니다.

특정 사용자를 어떻게 차단하나요?

귀사는 조직의 IP 주소에서 시작된 모든 내부 이벤트 데이터가 Amplitude 애널리틱스로 수집되는 것을 차단할 수 있습니다. 프로젝트의 데이터 필터 페이지를 사용하여 필터를 설정할 수 있습니다.

지정된 IP 주소에서 발생하는 이벤트를 차단하도록 필터를 설정하려면 다음 단계를 수행하십시오.

  1. 데이터에서 필터로 이동한 다음 +블록 필터 만들기를 클릭합니다.
  2. 나타나는 플라이아웃 패널에서 필터를 적용할 환경을 선택합니다.
  3. 블록 드롭다운 메뉴에서 이벤트를 선택합니다.
  4. 다른 두 개의 드롭다운 메뉴에서 IP 주소 및 같음을 선택합니다. 그런 다음 차단할 IP 주소를 입력하십시오.
  5. 블록 데이터를 클릭합니다.
  6. 차단할 각 IP 주소에 대해 4단계부터 6단계까지 반복합니다.

데이터 필터를 추가하려면 조직의 매니저 또는 관리자여야 합니다.

이 필터를 설정한 후에는 Amplitude가 수집 시 IP 주소 목록에서 전송된 모든 이벤트를 삭제합니다.

이 필터는 IP 주소 수집을 방지하기 위해 Amplitude의 SDK 구성을 수정한 경우에는 작동하지 않습니다. 필터는 수집된 IP 주소가 차단한 IP와 일치하는 이벤트만 삭제합니다.

특정 사용자를 어떻게 필터링합니까?

Amplitude 차트의 세그멘테이션 모듈을 사용하여 언제든지 내부 사용자 이벤트를 세분화할 수 있습니다. 사용자 ID, 장치 ID, Amplitude ID, IP 주소 또는 식별 가능한 사용자 속성(예: 사용자 이름 또는 이메일)을 기준으로 사용자를 분류합니다.

사용자 세그먼트를 저장하려면 어떻게 해야 합니까?

사용자 세그먼트를 저장하고 차트에 고정할 수 있으므로 매번 필터를 다시 생성할 필요가 없습니다. 불러오기 세그먼트를 기본값으로 설정하면 Amplitude는 차트 생성 또는 새로 만들기 버튼을 통해 생성한 모든 새 차트에 해당 세그먼트를 적용합니다. 그러면 적용된 필터가 차트에 나타납니다.

사용자 목록은 어떻게 관리합니까?

내부 사용자 목록은 시간별로 변경될 수 있으며, 사용자가 공통 속성을 공유하지 않을 경우 이 목록을 유지하는 데 노력이 필요합니다. 이러한 경우, Amplitude의 행동 코호트 기능을 사용하고 Amplitude에서 차단할 내부 사용자 코호트를 가져옵니다.

사용자 속성을 적용하는 것과 동일한 방법으로 이 코호트를 차트에 적용할 수 있습니다. 내부 코호트를 제외한 사용자 세그먼트를 생성한 후에는 쉽게 액세스할 수 있도록 세그먼트를 저장하고 고정하십시오.

또한 내부 사용자 코호트를 유지 관리하기 위해 행동 코호트를 프로그래밍 방식으로 업데이트할 수도 있습니다. 자세한 내용은 행동 코호트 API를 참조하세요.

관련 리소스

이벤트 또는 속성 숨기기, 차단 또는 삭제

이벤트나 속성을 숨기고, 차단하고, 삭제하는 것의 대상 구간 차이점은 바로 명확하지 않습니다. 숨겨진 이벤트 및 속성이나 차단된 이벤트는 여전히 프로젝트의 계측 제한에 수행 회수가 포함되지만 삭제된 이벤트 및 속성은 포함되지 않습니다.

이러한 옵션은 이벤트 또는 속성을 선택한 후에만 Amplitude 데이터 상단의 메뉴에 나타납니다.

숨겨진 이벤트 또는 속성이란 무엇입니까?

사용자가 Amplitude 차트에서 해당 이벤트나 속성을 쿼리하기를 원하지 않지만 해당 이벤트에 대한 데이터를 수집하려는 경우 해당 이벤트나 속성을 숨깁니다.

드롭다운, 패스파인더 결과 및 페르소나 차트에서 이벤트나 속성을 숨길 수 있습니다.

  • 드롭다운에서 숨기기를 사용하면 Amplitude 차트의 드롭다운 목록에서 해당 이벤트나 속성을 선택할 수 없습니다.
  • Pathfinder 또는 페르소나 결과에서 이벤트 또는 속성을 숨기면 해당 차트의 계산에서 해당 이벤트가 제외됩니다. Amplitude는 여전히 데이터를 수집하며, 이벤트 또는 속성은 숨김을 해제한 후 다시 쿼리할 수 있게 됩니다.

이벤트 또는 속성을 차단하는 것은 무엇을 의미합니까?

기록 데이터를 계속 쿼리하기를 원하지만 새 데이터 수집을 중단하려는 경우 이벤트 또는 속성을 차단합니다. 차단은 특정 이벤트로 인해 월간 이벤트 볼륨 제한에 도달할 때 유용합니다.

이벤트나 속성을 차단하면 Amplitude는 해당 이벤트나 속성을 수집하고 처리하는 것을 중단합니다. 차단 이전에 Amplitude가 수집한 차단된 이벤트 및 속성은 드롭다운에서 계속 선택할 수 있으며 차트에서도 사용할 수 있습니다. 블록을 생성한 후 전송된 데이터는 사용자 스트림이나 차트 결과에 나타나지 않습니다.

차단을 해도 해당 데이터를 Amplitude로 전송하는 것을 중단할 수는 없으므로 성공 응답을 여전히 받게 됩니다. Amplitude는 처리 단계 전에 데이터를 삭제하므로 데이터를 복구할 수 없습니다.

삭제된 이벤트 및 속성은 어떻게 됩니까?

데이터 구조를 체계적으로 유지하기 위해 더 이상 필요하지 않은 이벤트나 속성을 삭제합니다. 불필요한 이벤트와 속성이 너무 많으면 프로젝트의 계측 한계에 도달할 수 있습니다.

차단과 마찬가지로 Amplitude는 삭제된 이벤트와 속성을 수집하지 않으며, 삭제 후 전송된 데이터를 복구할 수 없습니다. 차단된 항목과 달리 삭제된 이벤트와 속성은 드롭다운에서 사용할 수 없습니다.

삭제된 이벤트나 속성이 포함된 차트는 계속 사용할 수 있지만 삭제된 항목을 새 차트에 포함시킬 수는 없습니다. 차트에서 삭제된 이벤트를 제거한 경우에는 삭제를 취소하지 않으면 해당 이벤트를 다시 추가할 수 없습니다. 삭제된 이벤트는 여전히 차트 결과에 나타나므로 삭제된 이벤트에 대한 차트 데이터를 제거하거나 숨기려면 이벤트를 삭제하기 전에 드롭 필터를 생성하십시오.

숨기기, 차단 및 삭제의 차이점은 무엇입니까?

기록 데이터 수정 또는 삭제

Amplitude 아키텍처는 사용자와 이벤트에 대해 시간, 일, 주, 월별로 사전 집계된 세트를 사용합니다. 이 접근 방식은 확장성이 뛰어나지만 데이터가 불변이라는 단점이 있습니다.

Amplitude가 이미 수집한 이벤트를 어떻게 수정하나요?

귀하의 계정이 그로쓰 또는 엔터프라이즈 요금제에 속해 있는 경우 Amplitude의 셀프 서비스 데이터 삭제를 참조하십시오.

다른 계정 유형의 경우 직접 수정이 불가능합니다. 해결 방법:

  1. Export API를 사용하여 모든 프로젝트 데이터를 내보냅니다.
  2. 데이터를 정리합니다(예: 필요한 변경 사항을 적용).
  3. 배치 API를 사용하여 정리된 데이터를 새 프로젝트에 업로드합니다.

Identify API를 사용하여 사용자 속성을 업데이트했습니다. 내 차트에 여전히 '없음' 값이 있는 이유는 무엇입니까?

Identify API는 향후 이벤트에 대한 사용자 속성 값만 업데이트합니다. Amplitude가 이미 수집한 데이터를 변경할 수 없습니다. Amplitude에 대해 다른 이벤트를 전송하여 업데이트된 속성 값을 적용합니다. Amplitude가 사용자 속성을 업데이트하는 방법에 대한 자세한 내용은 사용자 속성 및 이벤트를 참조하십시오.

실수로 사용자에게 이벤트를 전송했습니다. 이 특정 사용자에 대한 이 특정 이벤트를 어떻게 삭제합니까?

수행할 수 없습니다. 수집된 데이터는 변경할 수 없습니다. 비슷한 결과를 얻으려면 다음 절차를 시도하십시오.

  1. 이벤트를 삭제하거나 차단하십시오.
    • 이로 인해 모든 사용자에 대해 이벤트가 Amplitude에 진입하지 못하게 됩니다.
    • 해당 이벤트는 여전히 사용자의 이벤트 스트림에 나타나지만 쿼리에는 사용할 수 없습니다.
  2. 삭제 또는 차단이 작동하지 않는 경우 이전 FAQ에 설명된 해결 방법을 시도해 보십시오.

과거 데이터를 Amplitude로 다시 채우려면 어떻게 해야 하나요?

데이터 다시 채우기 안내서를 참조하십시오.

날짜 선택기 동작

날짜 선택기는 사용자가 수행 중인 분석의 기간을 선택합니다. 두 날짜 사이의 대상 구간, 특정 날짜 이후 또는 지난 x일, 주 또는 개월 동안 수집된 데이터를 분석하도록 선택할 수 있습니다.

날짜 선택기는 시간을 처리하는 방법에 미묘한 차이가 있습니다.

오프셋

마지막을 사용할 경우 쿼리는 지정된 시간 프레임의 데이터를 반환하고 아직 완료되지 않은 최신 간격도 반환합니다.

예를 들어 날짜 선택기를 지난 30일로 설정하면 Amplitude는 지난 30일 동안의 데이터를 검색하고 오늘 경과한 시간을 더합니다.

미완료일에서 데이터를 제외하려면, 또는 지연된 일괄 처리 수집 시스템을 사용할 경우, 오프셋을 사용하십시오. 날짜 선택기에서 +오프셋을 클릭한 다음 오프셋할 일수를 입력합니다.

오프셋을 제거하려면 'Offset by' 텍스트 근처의 'X'를 클릭하십시오.

제외

날짜 이후 또는 지난 x 일, 주 또는 개월 옵션을 사용할 경우 현재 일, 주 또는 월을 제외할 수도 있습니다. 이 기능은 선택한 기간에 대한 데이터를 완전히 사용할 수 없는 경우에 유용합니다.

차트에서 불완전한 시간 간격을 제외하려면 날짜 선택기에서 +제외를 누르고 불완전한 간격 옵션을 선택합니다. 현재 날짜는 더 이상 점선으로 프레임에 표시되지 않으며 Amplitude는 이 날짜를 분석에서 제외합니다.

이 설정을 되돌리려면 [불완전 간격]을 선택 해제하십시오. 동일한 프로세스를 사용하여 현재 주, 현재 달 또는 현재 분기를 제외하거나 포함시킬 수 있습니다.

Amplitude는 오프셋과 제외를 동시에 사용하는 것을 지원하지 않습니다.

특정 날짜 제외

분석에서 특정 요일을 제외할 수 있습니다. 이 옵션은 사용자 지정 일정에 따라 운영되는 조직에 적합합니다. 예를 들어 소매업체는 매장이 문을 닫는 일요일을 제외할 수 있고, SaaS 기업은 주중 근무 시간의 행동에 집중하기 위해 주말을 생략할 수 있습니다.

특정 날짜를 제외하면 차트 시각적 효과와 평균 및 롤링 윈도우와 같은 지표 계산 모두에 영향을 미칩니다.

특정 날짜 제외는 다음 차트 유형만 지원합니다.

  • 세그멘테이션.
  • 퍼널.
  • 데이터 테이블
  • 리텐션
  • 세션.

특정 날짜 제외는 다음 시간 범위만 지원합니다.

  • 마지막으로
  • 날짜 이후.

특정 날짜를 제외하는 기능은 기간 대비 기간 분석에서는 작동하지 않으며, realtime간격 설정과도 작동하지 않습니다.

Amplitude가 제외된 날짜를 처리하는 방법

날짜를 제외할 때 Amplitude는 다음과 같이 수행합니다:

  • 계산과 차트 시각화에서 일수를 제거합니다.
  • 평균의 경우, 기간 내 유효 일수를 기준으로 계산합니다. 예를 들어, 수요일을 제거한 일요일 - 토요일(7일) 범위를 살펴보고 있는 경우 다음과 같습니다.
    • 평균이 아닌 시계열 분석의 경우 데이터는 수요일을 제거한 상태로 정상적으로 표시됩니다.
    • 집계 데이터 분석의 경우 데이터는 집계에 수요일을 포함하지 않습니다.
  • 평균화 분석(예: 이동 구간)의 경우 Amplitude는 제외된 날짜를 분자나 분모에 포함하여 계산하지 않습니다. 7일간의 이동 구간을 사용하는 경우 Amplitude는 데이터 포인트를 0으로 처리하고 윈도우 내 유효한 일수(이 예제의 경우 6일)를 기준으로 평균을 나눕니다.
  • 일일이 아닌 또는 시간별이 아닌 간격 분석의 경우 Amplitude는 차트나 테이블에서 데이터를 제거하지 않습니다. 그러나 데이터에는 여전히 기본 날짜가 제거되어 있습니다.

이 방법은 인위적으로 낮은 평균을 방지하고 차트의 창을 일관되게 유지합니다.

시간 입력

날짜 이후 또는 대상 구간을 사용할 때 시간 입력을 활성화하여 범위를 더욱 좁힐 수 있습니다. 시간 입력을 사용하면 시작 시간 또는 종료 시간을 입력하여 분석에 세분성을 더할 수 있습니다.

날짜 선택기의 시간 입력 기능은 이벤트 세분화 및 퍼널 분석 차트에만 사용할 수 있습니다.

시간 세분화를 활성화하려면 날짜 선택기에서 +시간을 클릭합니다. 시간 입력을 활성화한 후 선택한 날짜 범위에 포함될 시작 또는 종료 시간을 시간, 분, 초 단위로 입력하십시오.

시간 입력을 끄려면 입력된 시간 근처의 'X'를 클릭하십시오.

사전 설정

또한 날짜 선택기는 반복적인 분석을 간소화하고 팀 간의 일관성을 보장하기 위해 사전 설정을 지원합니다.

사전 설정 사용

사전 설정을 사용하면 다음과 같은 사전 정의된 시간 범위에 빠르게 액세스할 수 있습니다.

  • 지난 7일간
  • 지난달.
  • 연간 현재까지.
  • 사용자 정의 회계 기간입니다.

사전 설정을 선택하면 날짜 선택기가 연관된 시간 범위를 자동으로 채웁니다.

사용자 정의 사전 설정

제품 출시, 캠페인 또는 테스트 기간과 같은 반복적인 분석 기간에 대한 사용자 정의 사전 설정을 생성할 수 있습니다. 사전 설정에는 다음이 포함될 수 있습니다.

  • 구체적인 시작/종료 날짜.
  • 상대적 기간(예: '지난 60일').
  • 선택적 제외(예: 불완전한 데이터 또는 특정 평일).

Amplitude는 프로젝트 수준에서 사전 설정을 정의하며, 프로젝트 전체에서 사용할 수 있습니다. 관리자와 매니저는 프로젝트 설정에서 이러한 사전 설정을 작성, 편집 및 관리할 수 있습니다.

기본 사전 설정

사용자는 지정된 프로젝트에 대해 자신만의 기본 사전 설정을 정의할 수도 있습니다. 이 사전 설정은 새 차트를 만들 때 자동으로 적용됩니다.

새 조직에서 메뉴를 열 수 없음

왜 신규 사용자는 왼쪽 메뉴를 탐색할 수 없나요?

Amplitude에서 새 조직을 만들 때, 모든 팀원은 Amplitude 설정 페이지에서 시작합니다. 왼쪽 메뉴를 열 수 있는 옵션이 없습니다. 새 사용자는 설정 페이지에서 "고정" 상태로 나타날 수 있으며 Amplitude의 다른 페이지로 이동할 수 없습니다.

이는 Amplitude가 작업할 데이터가 생기기 전에는 어떤 차트도 채울 수 없기 때문에 발생합니다. 왼쪽 메뉴를 열려면 먼저 데이터 소스를 설정하고 Amplitude로 데이터를 전송하십시오. 차트에 쿼리할 데이터가 추가되면 왼쪽 메뉴가 확장되며 Amplitude UI를 통해 탐색할 수 있습니다.

Firefox 수집 실패

Firefox가 Amplitude SDK를 차단하는 이유는 무엇입니까?

Firefox에서는 추적 방지 기능이 표준 모드에서 자동으로 활성화됩니다. 이 기능을 '엄격'으로 전환하거나 비공개 브라우저 창을 사용할 때 Amplitude는 이벤트를 기록할 수 없습니다. 추적 보호는 웹을 탐색할 때 사용자의 개인 정보를 보호하기 위해 교차 사이트 추적기를 차단합니다.

추적 보호가 무엇인지, 그리고 추적에 어떤 영향을 미치는지에 대해 더 자세히 알아보려면 Mozilla의 문서를 참조하세요.

추적 보호는 사이트 간 추적을 방지하기 때문에, 이는 Amplitude SDK를 차단합니다. Firefox는 네트워크 요청을 차단하므로 이벤트 수집에 실패합니다.

Firefox 브라우저에서 추적 보호가 활성화되어 있을 때 다음 오류가 나타납니다.

POST 요청에 실패했습니다.

수집 문제를 해결하려면 어떻게 해야 합니까?

Amplitude 엔지니어링 팀에 따르면, 가장 좋은 해결책은 프록시 서버를 구축하고 JS SDK를 연결하는 것입니다. 자세한 내용은 프록시 생성 방법에 대한 문서를 참조하십시오.

이 내용이 도움이 되었나요?