収益トラッキングのためにStripeをどのように統合しますか？

Stripeを接続することで、Zenovayはトラフィックデータと並べて収益を表示できます — どのマーケティングソースが有料顧客を生み出したか、どのページで彼らがコンバートしたか、どのキャンペーンが取引を成立させたか。

セットアップはウェブサイトごとに、そのウェブサイトのダッシュボード内で行われます。貼り付ける認証情報は1つです。制限付きStripe APIキーです。そしてZenovayがWebhookの配線を処理します。

Stripeを接続する

1. 1

   ウェブサイトのRevenue設定を開く

   app.zenovay.comで、接続したいウェブサイトを開き、設定に移動してRevenueタブを開きます。各Stripe接続は1つのZenovayウェブサイトにマッピングされます。

2. 2

   Stripeを選択

   Stripeカードをクリックします。簡単なセットアップフォームが表示されます。

3. 3

   制限付きAPIキーを作成して貼り付け

   Zenovayはストライプの「制限付きキーを作成」画面に直接リンクし、必要な読み取り権限（残高、料金、サブスクリプション、顧客、支払い意図、チェックアウトセッション、請求書）とWebhook書き込みがあります。Stripeでキーを作成し、コピーして（rk_live_…またはrk_test_…で始まります）、フィールドに貼り付けて、接続をクリックします。

4. 4

   Zenovayが配線を完了するのを待つ

   キーを保存すると、Zenovayはそれを検証し、Stripeアカウントにwebhookエンドポイントを自動的に作成します。Stripeダッシュボードに触れることなく、支払いが流れ始めます。完了すると、カードは接続済みと表示され、緑色の「認証情報を確認しました」バッジが表示されます。

接続後、ダッシュボードのRevenueタブにはMRR、ARR、訪問者当たりの収益、およびソース別収益のチャートが表示されます。収益は接続した時点からキャプチャされます。Zenovayはstripeがwebhookイベントを送信する際に支払いを記録し、過去のStripe履歴をバックインポートしません。

Webhookを手動で設定（オプション）

Zenovayがあなたのためにstripewebhookを作成するので、ほとんどの人はこれを必要としません。webhookを自分でセットアップしたい場合（たとえば、StripeキーにWebhook書き込み権限がない場合）、StripeをZenovayレシーバーにポイントして署名シークレットを貼り付け直すことができます。

1. Stripe Dashboardで、Developers → Webhooks → Add endpointに移動します。
2. エンドポイントURL：https://api.zenovay.com/api/webhooks/stripe/YOUR_WEBSITE_ID（あなたのウェブサイトIDはウェブサイトのダッシュボードのページURLにあります）。
3. これらのイベントを選択します：
   • checkout.session.completed
   • payment_intent.succeeded
   • invoice.paid
   • customer.subscription.created
   • customer.subscription.updated
   • customer.subscription.deleted
4. 保存してから、エンドポイントの署名シークレットをコピーします（whsec_…で始まります）。
5. Zenovayの設定 → 統合 → Stripeフォームに戻り、署名シークレットを貼り付けて、Zenovayが受信イベントを確認できるようにします。

支払いを訪問者に帰属させる

支払いからトラフィックソースへの帰属が機能するには、訪問者の匿名Zenovay IDがStripeレコードに到達する必要があります。最も簡単な方法は、チェックアウトセッションのclient_reference_idとして設定するか、チェックアウト時にメタデータとして添付することです：

// チェックアウトサーバーで
const visitorId = req.cookies['zv_visitor_id'] // またはクライアントが渡す方法
stripe.checkout.sessions.create({
  // ...
  client_reference_id: visitorId,
  metadata: { zenovay_visitor_id: visitorId }
})

支払いが完了すると、ZenovayのWebhookハンドラーはclient_reference_id（またはmetadata.zenovay_visitor_id / metadata.visitor_id）を読み取り、支払いを訪問者のセッション（ソース、キャンペーン、支払い前に訪問したページを含む）に結合します。訪問者IDのない支払いは依然として収益として記録されますが、ソース属性はありません。

利用可能な帰属モデルは何ですか

Zenovayは複数の帰属モデルを計算するため、加重するタッチポイントに応じてクレジットがどのように変わるかを確認できます：

• Last Touch — クレジットは支払いが発生したセッションのソースに帰属します。
• First Touch — クレジットは訪問者が最初に到来したソースに帰属します。
• Linear — クレジットがパス上のすべてのタッチポイント間で均等に分割されます。
• Position-Based — 最初と最後のタッチポイントにより大きく加重されます。
• Time-Decay — コンバージョンに近いタッチポイントがより多くのクレジットを獲得します。

Revenueタブでそれらを切り替えて、各モデルがクレジットをどのように割り当てるかを比較します。

切断

ウェブサイトのRevenue設定タブでStripeカードを開き、削除をクリックします。デフォルトでは、これは認証情報を切断するだけです。既存の支払いレコードはデータ保持期間中ダッシュボードに残ります。履歴的な収益データも削除したい場合は、確認ダイアログのカスケード削除オプションをチェックしてください（削除される正確なレコード数を表示します）。

Zenovayの統合を削除しても、Stripe側のwebhookは削除されません。Stripe Dashboardのエンドポイントも削除することをお勧めします。

関連情報

• Webhook概要
• eコマース収益トラッキング
• API概要
• トラッキングスクリプトのインストール