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.
Stripe
早期アクセス
この機能は早期アクセスです。 この期間中、機能のさまざまな側面はまだ開発されている可能性があり、このドキュメントは常に最新であるとは限りません。 ご質問がある場合は、までお問い合わせください。Amplitude Support.
この連携により、StripeからAmplitudeに収益イベントがインポートされるため、AmplitudeでStripeの財務データを追跡および分析できます。
Amplitudeはこの連携を維持しています。サポートが必要な場合は、Amplitude サポートにお問い合わせください。
前提条件
- 複数のAmplitudeプロジェクトがある場合は、正確なイベントトラッキングを確保するために、この連携をそれぞれ別々に設定してください。
- Stripeイベントペイロードにはアカウント識別子が含まれていないため、Amplitudeは異なるアカウントからのStripeイベントを区別できません。 複数のStripeアカウントを同じAmplitudeプロジェクトに接続すると、データの重複や不正確な収益報告が発生する可能性があります。
- この連携は、Stripe Webhookを設定した後に発生したイベントのみを記録します。それ以前に発生したことは何も遡及的にキャプチャしたりAmplitudeに送信したりすることはありませんので、できるだけ早く設定してください。
- 収益データをAmplitudeに送信する前に、すべての財務金額を希望する通貨に正規化してください。 Amplitudeは通貨換算を自動的に処理しません。また、通貨レポートに一貫性がないと、収益に関するインサイトが歪む可能性があります。
- この連携は、収益関連のトランザクションイベントのみを取り込みます。
- 追跡の誤りを避けるためには、メタデータを
amplitude_id正しくuser_id設定してください。そうしないと、同じユーザーからのイベントがAmplitudeで別々のユーザーとして表示される可能性があります。 Stripeクライアントを更新して、適切なイベント重複排除を実現するために、メタデータフィールド内に正しいユーザー識別子を渡してください。
連携を設定する
- Stripe アカウントにログインし、_Developers > Event 送信先_に移動します。
- [エンドポイントを追加] をクリックして Webhook を作成します。
- 指定したURLを_Endpoint URL_フィールドに貼り付けて、データをAmplitudeプロジェクトに転送します。
- APIバージョン2024-06-20を選択し、Amplitudeに取り込むイベントを選択します。
- **「イベントを選択」**をクリックして、Amplitudeに転送したいトピックを指定します。 Amplitudeが収益イベントとして
payment_intent分類することに注意してください。 - Stripeクライアントコードに正しいユーザーIDを設定することで、StripeとAmplitude間のユーザーイベントの適切な重複排除を確保できます。 この連携は、イベントペイロードから特定の優先順位でユーザーIDを検索します。ユーザーIDが支払い意図やその他の関連イベントでメタデータとして正しく渡されていることを確認してください。
AmplitudeがStripeイベントデータからユーザーIDを収集する順序は次のとおりです。
data.object.metadata.amplitude_iddata.object.metadata.user_iddata.object.customer_emaildata.object.customer.emaildata.object.receipt_emaildata.object.customer
AmplitudeでStripeイベントを表示:チャートとコホートの例
以下は、連携の設定後に追跡できる重要なグラフと指標です。
総収益
- イベントを選択する:
[Stripe] invoice.payment_succeededなど、成功した支払いやトランザクションを追跡するイベントを選択します。 - メトリックを設定する: _プロパティ合計_を使用して総収益を計算します。プロパティを
amount_paidまたは収益金額を格納する別のプロパティに設定します。これは、成功したすべての支払いイベントからの収益総額の合計です。 - セグメンテーションを適用する: 上記の手順1でイベントをトリガーしたすべてのユーザーによって生み出された総収益の概要を表示するには、[すべてのユーザー] を選択します。
ユーザー1人あたりの平均購入回数
- イベントを選択する:
self-serve: stripe payment intent success、Purchase Completed、またはOrder Successなど、トランザクションまたは購入の成功を示すイベントを選択します。 - メトリックを設定する: ユーザーあたりの平均イベント数を測定して、ユーザーがイベントをトリガーする頻度を追跡します。
- セグメンテーションを適用する: [すべてのユーザー] を選択すると、そのイベントに関連するすべてのユーザーアクティビティの概要が表示されます。
購入頻度の分布
- イベントを選択する:
[Stripe] invoice.payment_succeededなど、支払いや購入の成功を追跡するイベントを選択します。 - メトリックを設定する: [頻度] を選択すると、ユーザーが選択したイベントをトリガーした回数を測定できます。
- バケットを設定する: 購入頻度を分類するためにバケットを定義します。 これにより、各頻度カテゴリに属するユーザーの数を視覚化できます。
- セグメンテーションを適用する: [すべてのユーザー] を選択すると、ユーザーが購入する頻度の概要が表示されます。
N週間のリテンション
- 開始イベントを選択する: 取引または購入が成功したことを示すイベントを選択します (例:
[Stripe] invoice.payment_succeeded)。 - リターンイベントを選択する: 同じイベントまたは類似のイベントを選択して、再度購入するために戻ってきたユーザーを追跡できます。
- リテンションメトリックを設定する: [Return On] を選択すると、ユーザーが特定の時間枠 (たとえば、数週間) 内に同じイベントをトリガーするために戻ってきた時点に基づいてリテンションを測定できます。このチャートには、複数の週(第 0 週、第 1 週など)にわたるリテンションが表示され、その後の週に何人のユーザーが購入を行った後に再び利用したかを示します。
- セグメンテーションを適用する: [すべてのユーザー] を選択すると、購入を行い、戻ってきたすべてのユーザーの概要が表示されます。
プロダクト別の収益
- イベントを選択する: トランザクションまたは支払いの成功を示すイベントを選択します (例:
[Stripe] invoice.payment_succeeded)。 - メトリックを設定する: _プロパティ合計_を使用して総収益を計算します。プロダクトの詳細を保存する説明フィールド(または同様のフィールド)を使用して、プロダクトカテゴリまたは名前ごとにグループ化します。これは各プロダクトの総収益を合計したものです。
- プロダクトごとのグループ化:結果をプロダクト名またはカテゴリごとにグループ化して、プロダクトごとの収益を視覚化します。
- セグメンテーションを適用する: すべてのユーザーを選択して、販売された_すべての製品の収益_の内訳を表示します。
プロダクトごとの注文数
- イベントを選択する:トランザクションまたは注文の成功を表すイベントを選択します (例:
[Stripe] invoice.payment_succeeded)。 - メトリックを設定する: ユニーク を使用して、イベントのユニークな発生数をカウントします。__
- プロダクトごとにグループ化:[説明] フィールド (または同様のプロダクト関連フィールド) を使用して、プロダクト名または説明ごとにデータをグループ化します。これにより、プロダクトごとの注文数の内訳が表示されます。
- セグメンテーションを適用する: すべてのユーザーによって行われた各プロダクトの注文数の完全な概要を表示するには、_すべてのユーザー_を選択します。
コホート: 最初の7日間で100ドル以上を消費したユーザー
- イベントを実行したユーザーを選択する: 成功したトランザクションをキャプチャするイベント(例:
[Stripe] payment_intent.succeeded)を選択します。 - 収益条件を設定する: 単一の取引または複数の取引で100ドル以上を消費したユーザーをフィルタリングするための条件を適用します
$revenue > 100。 - カウント条件を設定する: イベントが少なくとも 1 回発生したことを確認するための条件を追加します。
- 期間を定義する: トランザクションは、ユーザーの最初のインタラクションから7日以内に発生したものでなければならず、より柔軟な追跡を行うために過去30日以内に発生したものである必要があると指定します。
AmplitudeでサポートされているStripeイベント
この表は、Stripe から Amplitude に送信された収益関連イベントの一覧です。 これらのイベントを使用すると、課金、払い戻し、請求書、支払いなどの金融取引を追跡できます。 各イベントに関連付けられたプロパティの詳細については、Stripeイベントの公式ドキュメントを参照してください。
| カテゴリー | Stripeイベント | 概要 |
|---|---|---|
| 支払いと返金 | charge.succeeded | 課金が成功した場合に発生します。 |
| 支払いと返金 | charge.refunded | 一部の返金を含め、支払いに対する返金が行われたときに発生します。 |
| 支払いと返金 | charge.captured | 以前にキャプチャされていなかった支払いがキャプチャされたときに発生します。 |
| 支払いと返金 | charge.updated | 課金の説明やメタデータが更新された場合、または非同期キャプチャ時に発生します。 |
| 支払いと返金 | charge.failed | 課金の試みに失敗した場合に発生します。 |
| 請求書 | invoice.payment_succeeded | 請求書の支払いが成功した場合に発生します。 |
| 請求書 | invoice.paid | 請求書の支払いが成功した場合や、請求書が外部で支払い済みとしてマークされた場合に発生します。 |
| 請求書 | invoice.finalized | 請求書の下書きが確定され、未払いの請求書に更新されたときに発生します。 |
| 請求書 | invoice.marked_uncollectible | 請求書が回収不能とマークされている場合に発生します。 |
| 請求書 | invoice.payment_failed | 請求書の支払いが失敗した場合に発生します。 |
| 請求書 | invoice.voided | 請求書が無効になった場合に発生します。 |
| 請求書 | invoice.sent | 請求書の電子メールが送信されたときに発生します。 |
| 請求書 | invoice.created | 新しい請求書が作成されたときに発生します。 このイベントでWebhookを使用する方法と、それがイベントに与える影響については、「サブスクリプションでWebhookを使用する方法」を参照してください。 |
| 支払い意図 | payment_intent.succeeded | PaymentIntentが支払いを正常に完了したときに発生します。 このイベントはAmplitudeの特別な$revenueイベントです。 |
| 支払い意図 | payment_intent.canceled | PaymentIntentキャンセルされたときに発生します。 |
| 支払い意図 | payment_intent.payment_failed | PaymentIntentが支払い方法または支払いの作成を試みたときに失敗した場合に発生します。 |
| 支払い意図 | payment_intent.amount_capturable_updated | PaymentIntentにキャプチャすべき資金がある場合に発生します。 PaymentIntentのamount_capturableプロパティをチェックして、キャプチャできる量を判断してください。 amount_to_captureを指定した量までのPaymentIntent値でキャプチャできます。 PaymentIntents の取得方法の詳細についてはこちらをご覧ください。 |
| チェックアウトセッション | checkout.session.completed | チェックアウトセッションが正常に完了したときに発生します。 |
| チェックアウトセッション | checkout.session.async_payment_succeeded | 遅延支払い方法を使用した PaymentIntent が成功した場合に発生します。 |
| チェックアウトセッション | checkout.session.async_payment_failed | 遅延支払い方法を使用した PaymentIntent が失敗した場合に発生します。 |
| プラットフォーム手数料 | application_fee.created | 支払いに対してプラットフォーム手数料が作成されたときに発生します。 |
| プラットフォーム手数料 | application_fee.refunded | 申請料が払い戻された場合に発生します。これは、チャージの払い戻しによる場合でも、申請料を直接払い戻す場合でも発生します。これには部分的な返金が含まれます。 |
| プラットフォーム手数料 | application_fee.refund.updated | 申請料の払い戻しが更新されたときに発生します。 |
| 残高 | balance.available | Stripeの残高が更新されたときに発生します。デフォルトでは、Stripeは毎日お客様の残高にある資金をお客様の銀行アカウントに自動的に送金します。このイベントは、負のトランザクションに対してトリガーされません。 |
| 発行 | issusing_authorization.created | 認可が作成されたときに発生します。 |
| 発行 | issusing_transaction.created | 発行トランザクションが作成されたときに発生します。 |
これは役に立ちましたか?