Stripe Projects를 통한 Amplitude 프로비저닝

Stripe Projects는 Stripe가 관리하는 단일 청구 관계 하에서 타사 서비스(데이터베이스, 인증, 분석 등)를 프로비저닝하는 CLI 도구입니다. Amplitude는 통합 공급자이므로 터미널을 떠나지 않고도 Amplitude 조직, 프로젝트 및 SDK API 키를 만들 수 있습니다.

stripe projects add amplitude/analytics

이 명령 하나가 Amplitude 조직을 생성하고(또는 기존 조직으로 다시 연결해 주고), 기본 프로젝트를 프로비저닝하고, API 키를 Stripe Projects 저장소에 기록합니다. 여기에서 npx @amplitude/wizard를 사용하여 Amplitude 마법사 CLI를 실행하거나 Amplitude Unified SDK를 직접 초기화하면 이벤트를 전송할 수 있습니다.

시작하기 전에

기존 Amplitude 계정은 필요 없습니다. 만약 사용자의 Stripe 프로필에 있는 이메일이 이미 Amplitude 조직을 소유하고 있다면, Amplitude는 이에 새 프로젝트를 연결합니다. 그렇지 않으면 Amplitude는 사용자를 위해 새로운 조직을 만듭니다.

카탈로그 찾아보기

프로비저닝하기 전에 Amplitude가 Stripe Projects를 통해 노출하는 내용을 확인하십시오.

stripe projects catalog amplitude
stripe projects catalog amplitude --json

두 가지 유형의 항목이 표시됩니다.

• amplitude/analytics: 배포 가능한 리소스입니다. 프로덕트 분석, 기능 플래그, 세션 리플레이 및 실험을 포함하는 Amplitude 프로젝트를 프로비저닝합니다.
• 플랜 서비스: 월간 추적 사용자(MTU) 할당량과 청구를 결정하는 구매 가능한 계층입니다. Amplitude는 항상 무료 요금제와 하나 이상의 plus-v3-* 유료 요금제를 제공합니다.

Amplitude 프로비저닝

무료 요금제

기본값은 무료입니다. 여기에는 최대 10,000명의 월간 추적 사용자, 핵심 분석, 기능 플래그 및 세션 리플레이가 포함됩니다. 청구 방법은 필요 없습니다.

stripe projects add amplitude/analytics

유료 요금제

카탈로그에서 계층을 선택하여 plan_tier 구성 필드로 전달합니다.

stripe projects add amplitude/analytics --config '{"plan_tier":"plus-v3-10k-mtu-monthly"}'

Stripe는 프로비저닝 시에 공유 지불 토큰을 통해 지불금을 수금합니다. 사용자의 카드 정보는 Amplitude에 절대 도달하지 않습니다. Stripe Projects는 월별 청구만 제공합니다. 연간 청구로 전환하려면 프로비저닝 후 _설정 > 청구_에서 Amplitude 대시보드로 이동하십시오.

계정 구성

Stripe 프로젝트에서 Amplitude를 처음 프로비저닝할 때 CLI는 다음 두 가지 필드를 입력하라는 메시지를 표시합니다.

• region: us 또는 eu입니다. Amplitude가 사용자의 데이터를 저장하고 처리하는 데이터 센터를 결정합니다. 이 설정은 Amplitude가 계정을 생성한 후에는 변경할 수 없습니다.
• marketing: 선택적 부울값입니다. Amplitude의 제품 업데이트 및 마케팅 이메일을 수신하도록 허용합니다.

고객이 얻는 혜택

성공적인 프로비저닝은 access_configuration 객체를 Stripe Projects 저장소에 기록합니다. 이를 로컬 환경으로 가져오십시오.

stripe projects env --pull

Vault는 다음을 저장합니다.

• api_key: 기본 Amplitude 프로젝트의 API 키입니다. 이를 사용하여 전체 Amplitude SDK를 초기화하십시오.
• dashboard_url: 조직의 대시보드에 대한 인증된 링크입니다(유료 요금제에만 해당).

여기서부터 이벤트 흐름에 대한 두 가지 경로를 사용할 수 있습니다.

• 권장사항: Amplitude Wizard CLI를 실행하십시오. 이 도구는 사용자의 프레임워크를 감지하고, 사용자의 코드베이스에 맞게 조정된 추적 이벤트를 제안하며, 이를 대신하여 계측합니다. 수동 SDK 연결이 필요 없습니다.

  shell

  복사

  npx @amplitude/wizard
  

• 직접 SDK를 초기화하십시오. Amplitude Unified SDK(분석, 세션 리플레이 및 실험을 하나의 패키지로 통합)를 앱에 추가하십시오.

  javascript

  API 키복사

  import { Amplitude } from "@amplitude/unified";
  Amplitude.init(process.env.AMPLITUDE_API_KEY);
  Amplitude.track("Button Clicked", { button_name: "Sign Up" });
  

  플랫폼별 SDK를 원하시면 Amplitude 빠른 시작으로 이동하십시오.

요금제 변경

stripe projects upgrade를 사용하여 대상 구간 계층을 이동합니다. 이 명령은 사용자의 analytics 리소스에 대해 비파괴 업데이트를 실행합니다. 프로젝트, API 키 및 기존 이벤트 데이터는 변경되지 않고 유지됩니다.

stripe projects upgrade amplitude/analytics --config '{"plan_tier":"plus-v3-100k-mtu-monthly"}'

다음을 사용하여 유료 요금제를 취소하십시오.

stripe projects remove amplitude/analytics

결제 주기가 끝날 때까지 유료 기능을 계속 사용할 수 있으며, 그 후에는 계정이 자동으로 무료 상태로 변경됩니다. 프로젝트, 이벤트 및 대시보드는 그대로 유지됩니다.

대시보드 열기

CLI에서 직접 인증된 대시보드 세션을 시작하십시오.

stripe projects open amplitude

딥링크 URL은 수명이 짧고 일회용입니다. 매번 새롭게 생성하십시오. 이 링크를 클릭하면 이미 로그인된 조직의 기본 분석 뷰로 이동할 수 있습니다.

데이터 상주

Amplitude는 미국과 유럽에서 별도의 데이터 센터를 운영합니다. 프로비저닝 시 선택한 region은 조직을 수명 동안 해당 중 하나에 고정시킵니다. 영역을 전환하려면 Amplitude 서포트를 통해 수동으로 마이그레이션해야 합니다.

EU 지역의 경로는 eu.amplitude.com 및 api.eu.amplitude.com를 통과합니다. region: "eu"를 사용하여 프로비저닝할 때 SDK 초기화가 서버 영역을 EU로 설정했는지 확인하십시오.

Amplitude.init(process.env.AMPLITUDE_API_KEY, { serverZone: "EU" });

재방문 사용자

사용자의 Stripe 프로필 이메일이 기존 Amplitude 로그인과 이미 일치하는 경우, Stripe Projects는 새 계정을 생성하는 대신 프로비저닝 요청을 기존 계정에 연결합니다. 사용자의 이메일이 단일 조직에 속해 있는 경우 CLI는 해당 조직에 해당하는 자격 증명을 자동으로 수신합니다. 여러 개에 속한 경우 프로비저닝을 완료하기 전에 하나를 선택하라는 메시지가 CLI에 표시됩니다.

어떤 Stripe Projects 디렉토리에서든 stripe projects add amplitude/analytics를 실행할 수 있습니다. 각 프로비저닝은 동일한 조직 내에 새로운 Amplitude 프로젝트를 생성하며, 이는 개발, 스테이징 및 프로덕션 환경을 분리하는 데 유용합니다.

문제 해결

• requires_payment_method 유료 프로비저닝에 오류가 발생했습니다. 먼저 stripe projects billing add를 사용하여 청구 방법을 추가한 다음 다시 시도하십시오.
• 잘못된 지역입니다. 지역은 변경할 수 없습니다. stripe projects remove amplitude/analytics를 실행하여 리소스를 삭제한 다음 올바른 지역으로 다시 프로비저닝하십시오. 이렇게 하면 새로운 Amplitude 조직이 생성됩니다. 이전 항목은 제자리에 그대로 유지되지만 Stripe와는 연결되지 않습니다.
• API 키를 분실했습니다. stripe projects env --pull를 실행하여 저장소를 새로 고치거나, Amplitude 대시보드의 _설정 > 프로젝트_에서 키를 가져오십시오.