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

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

shell

stripe projects add amplitude/analytics

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

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のプロビジョニング

無料プラン

デフォルトでは無料です。これには、毎月最大10,000人の追跡ユーザー、コアアナリティクス、機能フラグ、セッションリプレイが含まれています。支払い方法は必要ありません。

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：組織のダッシュボードへの認証済みリンクです（有料プランのみ）。

ここから、イベントの流れへの2つのパスがあります。

推奨事項：Amplitude Wizard CLIを実行してください。 フレームワークを検出し、コードベースに合わせて追跡イベントを提案したうえで、コードを組み込んでくれます。SDKの手動での組み込みは必要ありません。
shell
```
npx @amplitude/wizard
```
SDKを自分で初期化してください。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"}'

変更点	有効
無料→プラス	今すぐStripeは残りのサイクルに対して日割り料金を請求します。
プラス → より高いプラス	今すぐStripeは残りのサイクルに対して日割り料金を請求します。
プラス → プラスを下げる	現在の請求サイクルの終了時に予定されています。返金やクレジットはありません。
プラス → キャンセル	現在のサイクルの終了時にスケジュールされています。無料に戻ります。
無料	キャンセルは不要です。無料プランは課金されず、いつまでもアクティブなままです。

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

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ダッシュボードの_[設定] > [プロジェクト]_からキーを取得してください。

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