엔지니어를 위한 빠른 시작

For engineers implementing Amplitude15분Intermediate

이 빠른 시작 가이드는 Amplitude를 처음 구현하는 엔지니어를 위한 것입니다. 다음 단계에 따라 Browser SDK를 설치하고, 이벤트가 프로젝트로 전송되는지 확인하며, 사용자를 식별하십시오.

You'll set up

Before you start

  • Amplitude 계정 및 프로젝트 API 키. 프로젝트가 없는 경우 프로젝트 생성으로 이동합니다. 제품의 코드베이스(스택에 따라 프런트엔드 또는 백엔드)에

  • 액세스하세요.

  • Amplitude 조직의 멤버, 개발자 또는 관리자 역할.

팀에서 추적할 내용을 아직 결정하지 못하고 있다면 코드를 작성하기 전에 먼저 계측 예비 작업으로 이동하여 추적 계획을 조정하십시오.

  1. 설치

    브라우저 SDK 추가

    SDK 브라우저는 데이터를 Amplitude로 전송하는 가장 빠른 방법입니다. 하나의 설치 방법을 선택하고 해당 페이지의 안내를 따르십시오. 페이지 마지막에는 이벤트가 도착했는지 확인하는 단계가 포함되어 있습니다:

    또한 Amplitude는 계정을 처음 생성할 때 프로젝트 설정에서 사전 구성된 스니펫과 AI 프롬프트를 제공합니다.

    초기화 후, 첫 번째 사용자 지정 이벤트를 전송하기 위해 amplitude.track('Event Name', { property: 'value' })(을)를 호출하십시오.

  2. 캡처

    자동 캡처 활성화

    자동 캡처는 전체 수동 이벤트 호출 없이 클릭, 페이지 조회수, 세션, 양식 상호 작용, 파일 다운로드 및 마케팅 속성을 추적합니다. 스크립트 스니펫 및 AI 프롬프트 설치 메서드는 이를 자동으로 활성화합니다. 직접 설정하려면 초기화 중autocapture에 옵션을 전달하십시오.

    js
    amplitude.init("AMPLITUDE_API_KEY", {
      autocapture: {
        attribution: true,
        fileDownloads: true,
        formInteractions: true,
        pageViews: true,
        sessions: true,
        elementInteractions: true,
        networkTracking: true,
        webVitals: true,
        frustrationInteractions: true,
      },
    });
    

    Amplitude Debugger를 열어 페이지 뷰, 세션 및 상호작용 이벤트가 도착하는지 확인합니다. 자동 캡처가 처리하는 동작에 대해 추가 추적 코드를 추가할 필요가 없습니다.

    자동 캡처는 광범위한 행동 데이터를 캡처하는 데 가장 적합합니다. 구매, 업그레이드 및 주요 기능 사용과 같은 비즈니스 핵심 작업의 경우 명시적 amplitude.track() 호출을 추가하여 해당 이벤트가 올바른 속성을 갖도록 하십시오.

  3. Identify

    사용자를 식별하십시오

    자동 캡처는 사용자가 무엇을 하는지는 기록하지만 누구인지에 대한 정보는 기록하지 않습니다. 사용자가 가입하거나 로그인할 때 사용자 ID를 설정하여 Amplitude가 세션과 기기에 걸쳐 해당 활동을 연결하도록 하십시오. 해당 장치의 다음 사용자가 ID를 상속받지 않도록 로그아웃 시 호출하십시오reset().

    js
    // On sign-up or login
    amplitude.setUserId("USER_ID");
    // On logout
    amplitude.reset();
    

    이메일 주소가 아닌 자체 시스템의 안정적인 식별자로 USER_ID바꾸십시오. 해당 사용자에게 속한 이벤트를 전송하기 전에 사용자 ID를 설정하십시오. 사용자 ID 선택에 대한 모범 사례를 보려면 사용자 식별로 이동하십시오.

다음 단계

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

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.

이 페이지에서