이 페이지에서

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 시작하기

SDK 중 하나 또는 Segment, mParticle, Tealium과 같은 타사 연동을 사용하여 Amplitude에 데이터를 전송한 다음, 차트에 실제 제품 사용량이 반영되도록 이벤트, 사용자 속성 및 그룹 유형을 계측하십시오. Amplitude는 과거 이벤트 데이터를 소급하여 이름을 변경하거나 변경할 수 없으므로, 계측 사항을 배포하기 전에 최소 두 개의 프로젝트(스테이징용 하나, 프로덕션용 하나)를 설정하십시오.

새로운 Amplitude 프로젝트를 처음부터 시작하려는 경우 여기에서 시작하십시오. 이미 데이터를 전송하고 있으며 분석을 위해 데이터를 모델링해야 하는 경우, 대신 Data Planning Playbook으로 이동하십시오.

계측 모범 사례

Amplitude를 계측할 때 권장되는 모범 사례를 따르십시오.

  • 항상 계측을 테스트하십시오: Amplitude는 조직의 모든 운영 프로젝트에 대해 테스트 프로젝트를 갖출 것을 권장합니다. 테스트 프로젝트를 통해 운영 데이터를 Amplitude로 전송하기 전에 계측을 테스트할 수 있는 안정적인 방법을 이용할 수 있습니다.
  • Amplitude는 과거 데이터를 소급하여 변경할 수 없습니다. 계측이 잘못된 경우, 이미 수집한 데이터를 나중에 정리할 수 없습니다.
  • Amplitude 프로젝트를 최소 두 개 설정하십시오. 하나는 개발 또는 스테이징 환경용이고 다른 하나는 프로덕션 환경용입니다. 두 프로젝트는 테스트 데이터를 프로덕션 데이터와 분리하여 유지합니다.
  • 올바른 키 전송: HTTP API를 사용하여 서버 측에서 데이터를 전송하는 경우 각 이벤트와 함께 session_id 및 insert_id를 전송하십시오.

Amplitude가 데이터를 수신하는 방법

SDK 또는 제3자를 통해 Amplitude에 데이터를 전송할 수 있습니다.

Amplitude API

Amplitude는 플랫폼과 함께 사용할 수 있는 많은 API를 보유하고 있습니다.

모든 API 참조를 확인하십시오.

Amplitude 스키마

데이터 계획 플레이북에서는 Amplitude 스키마가 어떻게 구성되는지 설명합니다. 택소노미 설계에 대한 자세한 내용은 이 문서를 참조하십시오.

이벤트 명명 규칙

이벤트를 계측한 후에는 원시 데이터에서 해당 이벤트 유형의 이름을 변경할 수 없습니다. 예를 들어 앱 v1.0에서 개발자는 다음과 같은 이벤트 유형을 계측합니다.

Amplitude.getInstance().logEvent('Play song');

나중에 앱의 v2.0에서 개발자는 이 이벤트 유형을 인스트리먼트합니다.

Amplitude.getInstance().logEvent('play song');

Amplitude에 전달된 문자열은 대소문자를 구분하므로 Amplitude는 이 두 이벤트 유형을 별도의 이벤트로 해석합니다. 계측 다음 기간동안 이벤트 이름이 일관된 구문을 따르는지 확인하십시오.

사용자 속성 구현

사용자 속성은 개별 사용자에게 고유한 속성입니다. 사용자 속성의 예로는 위치, 언어, 계정 유형, 지출된 금액 또는 플레이어 유형이 있습니다.

추적할 사용자 속성에 대한 개인화 추천은 데이터 계획 플레이북을 참조하십시오.

Amplitude SDK에는 사용자 속성 값을 업데이트하는 데 사용할 수 있는 몇 가지 사용자 속성 작업이 포함되어 있습니다.

  • set: 속성 값을 설정하거나 덮어씁니다.
  • setOnce: 값이 아직 설정되지 않은 경우에만 값을 설정합니다.
  • unset: 값을 null로 설정해제합니다.
  • add: 지정된 숫자만큼 숫자 값을 증가시킵니다.
  • append: 값을 속성 배열에 추가합니다.
  • prepend: 속성 배열 앞에 값을 추가합니다.

또한 Identify API를 사용하여 다른 이벤트를 전송하지 않고도 사용자의 사용자 속성 값을 업데이트할 수 있습니다. 새 값은 사용자가 유기적으로 전송하는 다음 이벤트에 적용됩니다.

계측 그룹 유형

Amplitude의 계정 수준 보고 기능을 사용하려면 그룹 유형을 추적하도록 설정하십시오. 계정 수준 보고를 사용하면 별도의 사용자 속성 그룹별로 수행 회수가 가능하므로 개별 사용자 수준이 아닌 그룹 수준에서 데이터를 처리할 수 있습니다. Amplitude는 최대 5개의 그룹 유형을 허용합니다. 타사 도구를 사용하여 Amplitude를 계측하는 경우(mParticle, Segment, Tealium), 이 최대 임계값은 파트너의 제한 사항에 따라 더 낮아질 수 있습니다.

Amplitude가 고유 사용자와 세션을 추적하는 방법

Amplitude는 사용자 ID, 장치 ID 및 Amplitude ID 시스템을 통해 고유 사용자를 추적합니다. 자세한 내용은 고유 사용자 추적을 참조하십시오.

Amplitude에서 세션은 사용자가 제품 첫 사용 후 활동하고 있는 단일 연속 기간입니다. Amplitude는 모든 이벤트와 함께 세션 ID를 전송하므로 세션을 추적할 수 있습니다. 자세한 내용은 Amplitude의 세션 추적을 참조하십시오.

인기 있는 SDK 구성 옵션

이 섹션에서는 사용자가 일반적으로 수정하는 Amplitude SDK 구성 옵션에 대해 자세히 설명합니다.

  • minTimeBetweenSessions (iOS/Android): 새 세션이 시작되기 전 앱이 백그라운드 상태로 유지되어야 하는 최소 시간입니다.
  • sessionTimeout (웹): 새 세션이 시작되기 전에 경과해야 하는 이벤트 대상 구간의 최소 시간입니다.
  • batchEvents: 모바일 SDK의 경우 기본적으로 활성화되며 웹의 경우 선택 사항입니다.
  • eventUploadPeriodMillis: 이 옵션은 batchEvents을 활성화한 경우 이벤트 배치 업로드 대상 구간을 설정합니다.
  • eventUploadThreshold: 이 옵션은 batchEvents을 활성화한 경우 배치당 최소 이벤트 수를 설정합니다.
  • optOut: 활성화된 경우 현재 사용자를 추적에서 제외합니다.
  • offline: 이벤트의 전송을 방지합니다.
  • saveEvents: 모든 SDK에 대해 기본적으로 활성화됩니다. SDK가 전송되지 않은 이벤트를 장치에 저장할 수 있도록 합니다.
  • savedMaxCount: 장치에 불러오기 된 전송되지 않은 이벤트의 최대 수입니다. 기본값은 1000입니다.

데이터 다시 채우기

다음과 같은 경우 데이터 다시 채우기를 고려하십시오.

  1. Amplitude에서 과거 데이터를 분석하려는 경우. Amplitude로 데이터를 다시 채우는 방법에 대한 자세한 지침은 데이터 다시 채우기 가이드를 참조하십시오.
  2. 귀하의 제품에는 이미 기존 사용자가 있습니다. 이러한 사용자가 Amplitude에서 언제 신규 사용자였는지를 정확하게 반영하려고 합니다.

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