Klaviyo で利用できるさまざまな Webhook を理解する

このページで学べること

Klaviyo で利用できる Webhook ソリューションの違いと、それぞれを使用すべきタイミングについて説明します。

始める前に

Webhook とは何ですか？

ウェブフックを使用すると、KlaviyoはHTTPリクエストを介して情報を渡したり、他のアプリケーション、ツール、サーバーを「呼び出したり」できます。発生したイベント（例：注文の確定、新しい顧客の購読など）に関する情報を送信したり、イベントが発生したことを外部システムに通知したりできます。

ウェブフックはいくつかの主要なコンポーネントで構成されています：

• トピック
  Webhook が起動する原因となるイベントです。
• 本文（または “the payload”）
  Webhook が送信するデータ。
• ヘッダー
  追加情報（認証など）を渡す場所です。
• 宛先URL
  ウェブフックリクエストを受信するエンドポイントです。

フロー Webhook

アクションとして、フローにウェブフックを追加できます。プロファイルがLiveに設定された構成済みのウェブフックアクションに到達すると、Klaviyoはペイロードに含めたデータを使用して、宛先URLにPOSTリクエストを送信します。これには、プロファイルの詳細や、メトリックトリガーのフローではフローをトリガーしたイベントのデータを含めることができます。

メトリック、リスト、セグメント、または日付プロパティでトリガーされるフローに、フローのウェブフックを追加できます。Received email、Clicked email、Marked email as spamなどのメッセージ関連イベントは、フローのトリガーとして使用できません。

フローの Webhook の使用例

フローウェブフックが最も効果的なユースケースの例は次のとおりです。

• セグメントまたはリストに購読者が追加されたことをトリガーとして、メッセージまたは POST リクエストを送信します。
• プロファイルがエンゲージメントなしのセグメントに入ったときに送信抑制を自動化します。
• 顧客が購入した際に、WhatsAppやFacebook Messengerなどのサービスを通じて、パーソナライズされたお礼のメッセージを送信します。

アドバンストKDPのウェブフック

アドバンストKlaviyoデータプラットフォームのウェブフックは、フローのステップとは独立して、イベントに応じて外部システムに通知します。Klaviyoがリクエストボディを作成します。事前構築済みのイベントペイロードを外部システムに送信する場合は、これらのウェブフックを使用してください。そのシステムには、リクエストを受信して処理できるエンドポイントが必要です。

アドバンストKlaviyoデータプラットフォームのウェブフックは、フローウェブフックよりも幅広いトピックに対応しており、Get Events APIで利用できるメッセージ関連イベントも含まれます。ウェブフックを設定する際に、個々のメトリックをトピックとして選択してください。

例：

• メールイベント（例：メールを受信、メールをクリック、メールを迷惑メールとしてマーク）
• SMS イベント（例: Sent SMS、Received SMS）
• プッシュ通知イベント（例：プッシュ通知の受信、プッシュ通知のバウンス）
• 外部連携からのイベント（つまり、Klaviyoが作成したファーストパーティ外部連携からのイベント）
• API イベント（例：Klaviyo の API を介して同期されたイベント）

これには、古い購読解除イベント（メールの購読解除リンクのクリック）、メール受信、またはメールクリックなど、フローのトリガーとして使用できないメッセージ関連イベントが含まれます。メールマーケティングからの購読解除は、フローのトリガーにできる別のイベントです。

また、アドバンストKDPのウェブフックでは、単独トリガーのフローに依存するフローウェブフックとは異なり、一度に複数のトリガーを購読できます。

アドバンストKDPのウェブフックの使用例

• 顧客のメールマーケティングの購読解除イベントを外部システムに同期します。
• ヘルプデスク ソフトウェアに Received Email イベントをレポートして、担当者がお客様への対応向上のためにメール履歴を確認できるようにします。
• Klaviyo の データウェアハウス同期ではサポートされていないデータウェアハウスに、すべてのメール送信、開封、クリックを同期します。

コード

コードはアドバンストKlaviyoデータプラットフォームに含まれています。これらのイベントトリガー関数を使用するには、アカウントでアドバンストKlaviyoデータプラットフォームを利用できる必要があります。このプランを追加する方法や、新規登録した方が開始する方法については、請求ガイドをご覧ください。

コードは、イベントトリガーに応じてカスタム関数を実行するためにウェブフックを使用します。KlaviyoのエディタでPythonまたはJavaScriptを直接記述でき、Klaviyoがコードの実行、モニタリング、ログ記録を管理します。

イベントに応じて実行されるカスタム関数を記述するための開発リソースがある場合は、コードを使用してください。Klaviyoが関数をホストするため、トリガーとなるウェブフックを受信するために独自のエンドポイントをホストする必要はありません。別のシステムにデータを送信するには、コードがそのシステムのAPIまたはサービスに接続する必要があります。

CodeとアドバンストKlaviyoデータプラットフォームのウェブフックでは、個別のメトリックをトリガーとして選択できます。

Example Code のユース ケース

• Pythonライブラリを使用してイベントデータを読み取り、カスタムロジックで使用するために予約都市などの値を抽出します。
• Klaviyo の API を使用して、イベント メタデータに基づくカスタム プロファイルプロパティを設定します。
• AIサービスを呼び出して、プロファイルとカート内の商品に基づき、各カゴ落ちに合わせたカスタムメッセージを作成します。

その他のリソース