Stripe のスタートガイド

このページで学べること

Stripe を Klaviyo と連携して、お客様の請求書と支払いデータに基づいてメールをパーソナライズし、ターゲットを絞り込む方法を学びます。

Stripe 外部連携は、2 つのステップで設定します。まず、Klaviyo で外部連携を有効にして Stripe を接続します。次に、Stripe で Webhook を設定します。これにより、特定の Stripe データがリアルタイムで Klaviyo に同期されます。

Stripe から同期するデータの概要は次のとおりです：

• 請求書が発行されたタイミング、および各請求書に含まれる項目
• ユーザーが支払いに失敗した場合、払い戻しされた場合、または支払いに成功した場合の支払い情報

Klaviyo で Stripe 外部連携を有効にする

1. Klaviyo で、[外部連携] タブを選択します。
2. [アプリを探す]を選択し、Stripeを検索してから、カードをクリックします。
3. 次に、[インストール] をクリックします。
4. [Stripe に接続] をクリックします。これにより Stripe のウェブサイトに移動します。必要に応じてログインしてください。
5. Klaviyo に接続する Stripe アカウントを選択し、[接続] をクリックします。
   

6. Klaviyo に戻り、署名シークレットを入力して Stripe Webhook を検証することもできます（推奨）。これは Stripe の [開発者]＞[Webhook] にあり、外部連携にセキュリティをさらに強化するレイヤーを追加します。
   

7. このページから Webhook URL をコピーします。次のセクションで、これを Stripe アカウントに貼り付けます。
8. [設定を完了] をクリックします。

Stripe の Webhook を設定する

次に、Stripe のウェブ Webhook を設定します。これにより、Stripe のデータをリアルタイムで同期できるようになります。

1. Stripe を新しいタブで開き、[Developers] タブに移動します。
2. [Webhook] を選択し、[エンドポイントを追加] をクリックします。
   

3. 次のフィールドに入力してください：
   • エンドポイント URL
     Klaviyo からコピーした URL を貼り付けてください。
   • バージョン
     最新の API バージョンを選択してください。
   • 
     送信するイベント Klaviyo では charge と invoice のデータポイントが必要です。Events to send ドロップダウンで、charge と invoice のイベントをすべて選択します。必要に応じて、charge.dispute のイベントをすべて省略できます。以下のすべてのイベントのエンドポイントを作成します：
     • charge.captured
     • charge.expired
     • charge.failed
     • charge.pending
     • charge.refunded
     • charge.succeeded
     • charge.updated
     • invoice.created
     • invoice.deleted
     • invoice.finalized
     • invoice.marked_uncollectible
     • invoice.payment_action_required
     • invoice.payment_failed
     • invoice.payment_succeeded
     • invoice.sent
     • invoice.upcoming
     • invoice.updated
     • invoice.voided
4. すべての請求および請求書イベントを選択したら、[エンドポイントを追加] を選択します。
   

5. Webhook が有効になっていることの確認が表示されます。
   

6. Stripe 外部連携が有効になりました。

Stripe から同期されたデータを表示

有効な外部連携を確認するには：

1. Klaviyo で [アナリティクス] ドロップダウンをクリックし、[メトリック] を選択します。
2. Stripe の「支払い完了」メトリックを見つけ、[アクティビティ フィード] アイコンをクリックします。
   

3. 外部連携でデータの同期が開始されている場合、Stripe を通じて発行された請求書がここに表示されます。外部連携が完全に同期されると、Klaviyo アカウント内で Stripe 外部連携の横に緑色の枠線が表示されます。Klaviyo は Stripe データをすべてインポートします。これを確認するには、特定の日の成功した支払い回数を Stripe インターフェースの数と比較し、一致することを確認します。
4. たとえば、「成功した支払い」メトリックの[チャート] 見出しをクリックします。このチャートは、デフォルトで過去 30 日間のデータを表示します。昨日のデータ ポイントにマウスオーバーするか、チャート下のデータ テーブルを見て、昨日の支払い件数を確認してください。その数を Stripe に保存されているものと比較すると、完全に一致することが確認できます。
5. データが一致しない場合、原因として最も考えられるのは、Klaviyo アカウントのタイムゾーンが Stripe アカウントのタイムゾーンと一致していないことです。Klaviyo でタイムゾーン設定を確認するには：
   • 左下のアカウント名をクリックしてください。
   • 次に、[設定] > [組織] をクリックします。
   • Time zone まで下にスクロールします。

Stripe のメトリック

Stripe は次のメトリックを Klaviyo に同期します：

• 決済エラー
• 請求書を発行
• 返金済みの支払い
• 正常に支払い済み

決済エラー

このメトリックは、Stripe を通じて行われた支払いが失敗としてマークされるたびに記録されます。このメトリックを使用して、支払いが失敗している顧客をターゲットにし、未払い残高があることを知らせます。以下の基準に基づいて、「支払い失敗」イベントをフィルタリングし、ターゲットを絞ることができます。

• AttemptCount
  この請求書がユーザーへの請求を試行した回数。
• 通貨
  支払いに失敗した請求書の通貨（例：USD、GBP）。
• 請求書
  この支払い失敗が Stripe 内で紐付けられている請求書です。
• 理由
  Stripe でこの支払いが失敗した理由。例：カードの有効期限が切れています、カードが拒否されました。

請求書を発行

このメトリックは、Stripe を通じてお客様に請求書が発行されるたびに記録されます。このメトリックを使用して、請求書が発行されたものの、支払いが完了していない、または支払いが失敗したお客様でセグメントを作成します。また、今後の支払いについてお客様に通知するために、セグメントをトリガーする用途にも使用できます。

返金済みの支払い

このメトリックは、Stripe を通じて支払いを返金したときにイベントを記録します。以下の条件に基づいて、返金済の支払いイベントをフィルタリングし、ターゲットを絞ることができます：

• 金額
  返金された支払いの金額です。

正常に支払い済み

このメトリックは、お客様が Stripe を通じて請求書の支払いに成功するたびに記録されます。これらのイベントには、お客様、請求書、請求書に含まれる商品に関するデータが含まれます。このメトリックを使用すると、お客様が支払い後に自動請求書を送信したり、メールフローで、お客様がウェブサイト上でアクティブであるものの、商品やサービスの支払いを行っていないタイミングを判断したりできます。その後、それらのユーザーに対して、ウェブサイトで購入してもらうための割引を提供するメールを送信できます。

以下の基準に基づいて、Successfully Paid イベントをフィルタリングし、ターゲットを絞ることができます。

• 通貨
  支払い済みの請求書の通貨（例：USD、GBP）。
• 請求書
  この支払いが Stripe で紐付けられている請求書です。

顧客データ

Klaviyo は、各個人をメールアドレスで一意に識別します。Stripe が新しいメールアドレスで顧客データを同期した場合、Klaviyo は顧客のメールアドレスと関連する Stripe のメトリックで構成される新しいプロファイルを作成します。クレジットカードの有効期限は、顧客のプロファイル内のカスタムプロパティとして保存されます。

Klaviyo で Stripe データを使用する

Stripe のメトリックまたはメタデータは、Klaviyo でフローをトリガーするために使用できます。

自動請求書

Stripe の Successfully Paid メトリックによってトリガーされる請求書フローを設定すると、支払い後に請求書の受領書を顧客に自動で送信できます。

このフローでは、Stripe の支払い属性を参照するテンプレートタグを使用して、動的な支払い詳細を表示するメールを自動的に生成できます。

メールテンプレートに動的データを埋め込む方法の詳細については、テンプレートタグと変数構文に関する記事をご覧ください。

Stripe の支払い失敗フロー

Stripe の「支払い失敗」メトリックによってトリガーされる自動フローを使用して、支払いの失敗を顧客に通知します。

トラブルシューティング

Stripe の同期で、すべてのアクティビティが Klaviyo に表示されません。

Stripe イベントが Klaviyo に同期されない最も一般的な理由は、イベントに関連付けられたメールアドレスがないためです。Klaviyo はメールアドレスを使用して個人を一意に識別するため、メールアドレスに関連付けられていない人のプロファイルは作成できません。同様に、メールアドレスに関連付けられていない場合、Klaviyo はイベントをプロファイルにリンクできません。

名と姓の入力は必ずしも一貫しておらず一意でもないため、この情報だけに基づいてプロファイルを作成することはありません。そうすると、重複や不正確なトラッキングにつながる可能性があります。

メールアドレスが関連付けられている場合でも Stripe データが Klaviyo に同期されない場合は、サポートチームにお問い合わせください。

達成できること

これで Stripe を Klaviyo と連携し、同期されたデータの使用方法を学習できました。

その他のリソース