Stripe ProjectsによるAmplitudeのプロビジョニング

Stripe Projectsは、Stripeが管理する単一の課金関係の下でサードパーティのサービス(データベース、認証、アナリティクスなど)をプロビジョニングするCLIツールです。Amplitudeは統合プロバイダーであるため、端末を離れることなくAmplitudeの組織、プロジェクト、SDK APIキーを作成できます。

shell
stripe projects add amplitude/analytics

この1つのコマンドでAmplitude組織の作成(または既存の組織への紐付け)、デフォルトのプロジェクトのプロビジョニング、およびStripe ProjectsのボルトへのAPIキーの書き込みが行われます。そこから、Amplitude Unified SDKを直接初期化し、イベントを送信します。

Stripe経由で課金を管理し、Amplitudeを同じ課金関係の下でプロビジョニングしたい場合、Stripe Projectsを使用します。Stripe以外でAmplitudeアカウントを作成したい場合は、amplitude.comで登録してください。

Stripe ProjectsにはStripe CLIが必要です。インストールと認証の手順については、Stripe Projectsドキュメントを参照してください。

始める前に

Before you start

  • Stripe CLI、使用するStripeアカウントに対して認証済みのもの。

  • Stripe Projectsディレクトリ — お持ちでない場合はstripe projects init <name>を実行します。

  • 有料プランのみ:お使いのStripeアカウントの請求方法、stripe projects billing addで追加されます。

既存のAmplitudeアカウントは必要ありません。 Stripeプロフィール上のメールアドレスがすでにAmplitudeの組織を所有している場合、Amplitudeは新しいプロジェクトをその組織にリンクします。 そうでなければ、Amplitudeはあなたのために新しい組織を作り出します。

カタログの閲覧

プロビジョニングを行う前に、AmplitudeがStripe Projectsを通じて公開するものを確認してください:

shell
stripe projects catalog amplitude
stripe projects catalog amplitude --json

次の2種類のエントリが表示されます。

  • amplitude/analytics:デプロイ可能なリソースです。 プロダクト分析、機能フラグ、セッションリプレイ、実験などを含むAmplitudeプロジェクトをプロビジョニングします。
  • プランサービス:月次トラッキングユーザー(MTU)割り当てと請求額を決定する購入可能なサービスレベルです。Amplitudeは常に無料プランと1つ以上のplus-v3-*有料プランを提供しています。

Amplitudeのプロビジョニング

無料プラン

デフォルトでは無料です。これには、200万件の無料イベント、コア分析、機能フラグ、セッションリプレイが含まれています。支払い方法は必要ありません。

shell
stripe projects add amplitude/analytics

有料プラン

カタログから階層を選択し、それをplan_tier設定フィールドとして渡します。

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

Stripeは、プロビジョニング時に共有支払トークンを通じて支払いを収集します。カードの詳細情報がAmplitudeに届くことはありません。 Stripe Projectsは月額課金のみを提供しています。 年間請求に切り替えるには、プロビジョニング後にAmplitudeダッシュボードの_[設定] > [請求]_に移動します。

アカウント設定

Stripeプロジェクトで初めてAmplitudeをプロビジョニングすると、CLIは次の2つのフィールドの入力を求めます。

  • region:usまたはeu。Amplitudeがデータを保存および処理するデータセンターを決定します。 この設定は、Amplitudeがアカウントを作成した後も変更できません。
  • marketing:オプションのboolean値です。Amplitudeからのプロダクトアップデートやマーケティングメールを受け取ることができます。

得られるもの

プロビジョニングが成功すると、access_configurationオブジェクトがStripe Projectsのボルトに書き込まれます。 ローカル環境に導入してください。

shell
stripe projects env --pull

ボルトには以下が格納されます。

  • api_key:デフォルトのAmplitudeプロジェクトのAPIキーです。Amplitude SDKの初期化に使用します。
  • dashboard_url:組織のダッシュボードへの認証済みリンクです(有料プランのみ)。

ここから、Amplitude Unified SDK(分析、セッションリプレイ、実験を1つのパッケージにまとめたもの)を初期化し、イベントの送信を開始します。

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

プラットフォーム固有のSDKについては、Amplitudeのインストールを参照してください。

自動作成されたデフォルト以外のプロジェクト用のAPIキーが必要な場合は、Amplitudeダッシュボードの_[設定] > [プロジェクト]_から取得してください。stripe projects open amplitudeで認証済みセッションを開きます。

プランを変更する

階層間を移動するにはstripe projects upgradeを使用します。 このコマンドは、analyticsリソースに対して非破壊的な更新を発行します。 プロジェクト、API キー、既存のイベントデータは変更なく引き継がれます。

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

以下を使用して有料プランをキャンセルできます:

shell
stripe projects remove amplitude/analytics

有料機能は請求サイクルが終了するまで維持され、その後アカウントは自動的に無料に切り替わります。 プロジェクト、イベント、ダッシュボードは、そのまま残ります。

ダッシュボードを開く

認証済みダッシュボードセッションをCLIから直接起動します。

shell
stripe projects open amplitude

ディープリンクURLは寿命が短く、1回のみ使用されます。毎回新しいものを生成してください。 このリンクをクリックすると、すでにログインしている組織のメインアナリティクスビューにドロップされます。

データのレジデンシー

Amplitudeは米国とEUで別々のデータセンターを運営しています。 プロビジョニング時に選択したregionにより、組織は永続的にそのうちの1つに固定されます。リージョンを切り替えるには、Amplitudeサポートを通して手動での移行する必要があります。

EU地域はeu.amplitude.comおよびapi.eu.amplitude.comを通ります。region: "eu"を使用してプロビジョニングする際には、SDKの初期化でサーバーゾーンがEUに設定されていることを確認してください:

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

リピートユーザー

Stripeプロフィールメールアドレスが既存のAmplitudeログインとすでに一致している場合、Stripe Projectsは新しいアカウントを作成するのではなく、プロビジョニングリクエストを既存のアカウントにリンクします。 電子メールが単一の組織に属している場合、CLI はその組織に適用される認証情報を自動的に受け取ります。 電子メールが複数のものに属している場合、プロビジョニングを完了する前に1つを選択するよう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ダッシュボードの_[設定] > [プロジェクト]_からキーを取得してください。

これは役に立ちましたか?

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.

このページでは