추적 계획 수립

추적 계획은 수집하는 모든 이벤트와 속성, 각 이벤트를 수집하는 이유 및 이를 전송하는 소스를 정의합니다. 계측 코드를 작성하기 전에 이를 빌드하면 분석가, PM, 엔지니어가 데이터가 저장된 후 필드 이름에 대해 논쟁하지 않고 하나의 스키마에서 작업할 수 있습니다. Amplitude Data에서 계획은 이벤트 및 속성 옆에 존재하므로 편집 내용은 계측, 거버넌스 및 Ampli 코드 생성기에 바로 흐릅니다.

팀원들이 이벤트와 속성을 함께 설계하기 위한 검토 가능한 공유 작업 공간을 원할 때 Amplitude Data의 UI에서 직접 계획을 구축하거나 업데이트할 수 있습니다. AI 코딩 클라이언트가 코드에서 직접 동일한 추적 계획을 생성하거나 편집하기를 원할 때 Amplitude MCP 서버를 대신 사용하십시오. 계획을 구축하기 전에 계획을 설계하는 데 필요한 전략에 대해서는 데이터 계획 플레이북을 참조하십시오.

추적 계획 찾기

Amplitude의 각 프로젝트에는 자체적인 추적 계획이 있습니다. 계획을 찾으려면 상단 탐색 메뉴에서 데이터 탭을 선택합니다. 그런 다음 왼쪽 탐색 메뉴의 맨 위에 있는 드롭다운에서 프로젝트를 선택합니다.

계획에 대한 이벤트 및 속성이 왼쪽에 표시됩니다.

추적 계획 업데이트

다음 두 가지 방법으로 계획을 업데이트할 수 있습니다.

• 구현 전에 새로운 이벤트와 속성을 사전에 계획하고, Amplitude 데이터를 사용하여 세부 사항을 정의하고, 팀원들과 협력하며, 추적할 대상에 동의하십시오. (권장사항)
• Amplitude가 처음 수집한 후 사후에 이벤트와 속성을 계획하세요. 기본적으로 이러한 이벤트 및 속성은 계획에 "예기치 않은"으로 표시됩니다. 이러한 데이터를 계획에 추가하거나, 데이터를 삭제하여 수집을 중지하고 데이터 카탈로그에서 제거할 수 있습니다.

또한 AI 코딩 클라이언트에서 Amplitude MCP 서버를 통해 이벤트, 속성 및 브랜치를 생성하고 업데이트할 수 있습니다. manage_amp_events와 같은 MCP 도구는 Amplitude 데이터에서 관리하는 것과 동일한 추적 계획을 수정합니다create_properties.

소스 생성

소스는 Amplitude로 전송된 데이터의 원본 출처를 나타냅니다(예: iOS, Android, 웹 및 백엔드). Ampli 개발자 경험을 사용할 때는 올바른 추적 라이브러리를 생성하기 위해 소스를 생성해야 합니다.

소스를 생성하려면 다음 단계를 수행하십시오.

1. 데이터 > 소스로 이동한 후 소스 추가를 선택합니다.
2. 추가하려는 SDK 소스를 선택합니다.
3. 새 소스의 이름을 지정하고 생성을 선택합니다.

이벤트 생성

이벤트는 사용자가 제품에서 수행할 수 있는 고유한 동작입니다. 이벤트를 생성할 때 이벤트에 대한 메타데이터를 지정할 수 있습니다. 이 메타데이터를 사용하면 구현 후 분석에서 구현 및 검색에 도움이 됩니다.

이벤트를 생성하려면 다음 단계를 수행하십시오.

1. 데이터 > 이벤트로 이동한 후 이벤트 생성을 선택합니다.

2. 이벤트에 이름을 지정하세요. Amplitude는 사용자의 명명 규칙에 맞는 수정 사항을 제안합니다.

3. 이 이벤트를 계측할 위치를 지정하려면 소스를 추가하십시오.

4. 다음을 비롯한 전체 관련 메타데이터를 추가하십시오.

   • 이벤트를 전송할 시기 또는 이벤트에 대한 중요한 세부 정보를 정의하는 데 도움이 되는 설명입니다.
   • 더 많은 컨텍스트를 제공하고 유사한 이벤트를 그룹화하기 위한 범주입니다.
   • 이벤트의 활성 또는 비활성 상태입니다. 활성 이벤트는 사용자가 트리거하는 이벤트입니다. 비활성 이벤트는 사용자와 관련이 있지만 직접적인 사용자 작업(예: 푸시 알림 수신)에 의해 시작되지는 않습니다.

5. 전체 관련 이벤트 속성을 이벤트에 추가합니다.

이벤트 속성 만들기

이벤트 속성은 이벤트와 사용자가 이벤트를 트리거한 컨텍스트를 설명합니다. 예를 들어 Song Title이벤트에 Song Played속성이 포함될 수 있습니다. 이름, 설명, 예제 및 규칙은 각 속성을 정의합니다. 규칙은 각 데이터 유형에 따라 다릅니다. 예를 들어, 특정 유형의 Song Title속성에는 최소 길이, 최대 길이 및 정규 표현식과 같은 규칙이 있을 String수 있습니다.

새 이벤트 속성을 생성하려면 다음 단계를 수행하십시오.

1. Amplitude Data에서 데이터 > 속성으로 이동한 다음 이벤트 속성 탭을 선택합니다.

2. 이벤트 속성 생성을 선택합니다.

3. 이벤트 속성에 이름을 지정하고 속성에 다음을 비롯한 전체 관련 메타데이터를 추가하십시오.

   • 설명입니다. 예제 값을 포함하면 도움이 될 수 있습니다.
   • 이 속성이 이 이벤트에 필요한지 여부입니다. 필수인 경우, Amplitude가 해당 값을 포함하지 않는 이벤트를 수신하면 Amplitude 데이터는 경고를 생성합니다.
   • 데이터 유형(예: 문자열 또는 숫자) 및 추가 규칙입니다.

이제 이 속성을 이벤트에 추가할 수 있습니다.

기존 속성을 추가하거나 이벤트 첫 사용 후 새 속성을 생성하려면 다음 단계를 수행하십시오.

1. Amplitude Data에서 데이터 > 이벤트로 이동한 다음 속성을 추가할 이벤트를 선택합니다.
2. 이벤트 세부 정보 창에서 속성 추가를 선택합니다.
3. 새 속성의 이름을 지정하거나 기존 속성을 선택하여 이벤트에 추가하십시오.

사용자 속성 만들기

사용자 속성은 사용자에 대한 특성을 캡처합니다. 사용자 속성을 설정한 후에는 해당 값이 업데이트될 때까지 사용자가 트리거하는 모든 후속 이벤트에 해당 속성이 자동으로 적용됩니다.

새 사용자 속성을 생성하려면 다음 단계를 수행하십시오.

1. Amplitude Data에서 데이터 > 속성으로 이동한 다음 사용자 속성 탭을 선택합니다.

2. 사용자 속성 생성을 선택합니다. 새 사용자 속성에 이름을 지정합니다.

3. 다음을 비롯한 전체 관련 메타데이터를 속성에 추가하십시오.

   • 설명입니다. 예제 값을 포함하면 도움이 될 수 있습니다.
   • 데이터 유형(예: 문자열 또는 숫자) 및 추가 규칙입니다.

그룹 속성을 사용하여 그룹 만들기

그룹 속성을 사용하면 group()호출이 실행될 때마다 사용자를 특정 계정(예: 이름, 업종 또는 직원)과 쉽게 연결할 수 있습니다. 그룹 속성은 사용자 그룹을 추적하려는 경우에 유용합니다(예: 회사 내의 특정 사용자가 아닌 회사 전체의 이벤트를 추적하려는 경우).

그룹을 생성하려면 다음 단계를 수행하십시오.

1. Amplitude Data에서 데이터 > 그룹으로 이동한 다음 그룹 만들기를 선택합니다.

2. 그룹에 이름을 지정하고 전체 관련 메타데이터를 추가하십시오. 여기에는 다음이 포함됩니다.

   • 설명입니다. 예제 값을 포함하면 도움이 될 수 있습니다.
   • 데이터 유형(예: 문자열 또는 숫자) 및 추가 규칙입니다.

3. 이 그룹 유형에 적용되는 전체 그룹 속성을 추가합니다.

그룹 속성을 생성하려면 다음 단계를 수행하십시오.

1. Amplitude Data에서 데이터 > 속성으로 이동한 다음 그룹 속성 탭을 선택합니다.

2. 그룹 속성 만들기를 선택합니다.

3. 그룹에 이름을 지정하고 전체 관련 메타데이터를 추가하십시오. 여기에는 다음이 포함됩니다.

   • 설명입니다. 예제 값을 포함하면 도움이 될 수 있습니다.
   • 데이터 유형(예: 문자열 또는 숫자) 및 추가 규칙입니다.

계획에 대한 협업

변경 사항에 대한 피드백을 원하시면 전체 이벤트 또는 속성의 서식 있는 텍스트 편집기에서 동료를 @멘션하여 이메일 알림이나 Slack 메시지를 보낼 수 있습니다. 이 접근법은 분기에서 작업하고 사용하려는 이벤트 및 속성 이름을 완성할 때 유용합니다.

개발자에게 계획을 보내십시오.

마지막으로, 이 계획을 개발자들에게 보내십시오.

Ampli 개발자 도구를 사용하는 경우 사용자의 추적 계획을 수집하여 이를 형식 안전한 자동 생성된 코드로 개발자에게 제공합니다. Amplitude Data는 모든 인기 플랫폼과 프로그래밍 언어를 위한 추적 라이브러리를 생성할 수 있습니다. 자동 생성된 라이브러리는 분석 공급자의 SDK 위에 있는 경량 래퍼로서 유형 안전을 제공하고 린팅을 지원하며 입력 유효성 검사와 같은 추가 기능을 지원합니다. 이 코드는 추적 계획의 사양을 정확하게 복제하고 모든 규칙과 요구 사항을 적용합니다.

또한 브랜치에 대한 링크를 보내거나 Amplitude 데이터로 직접 보낼 수도 있습니다. 여기서 고객은 지정한 세부 정보를 검토할 수 있습니다.