フローにおける Webhook を理解する

このページで学べること

フローにおける Webhook と、Klaviyo からサードパーティのツールやアプリケーションへ情報を送信する仕組みについて学びます。Webhook の設定は複雑になる場合がある点にご注意ください。このセットアップを正しく完了するには、開発に関する知識または開発リソースがあることが推奨されます。こうした開発の手順を探している場合は、フローに Webhook アクションを追加する方法をご覧ください。

Webhook とは何ですか？

簡単に言うと、ウェブフックは、マーケティングツールとデータツールが相互にやり取りできる包括的な仕組みを提供します。例として、オンラインバンキングとクレジットカードの不正利用防止がどのように機能するかを想像してみましょう。誰かが不正にカードを使用した場合、その取引は小売店で記録され、その後銀行に送信されます。銀行はそれを分析し、カードに問題がある場合は電話またはメールで通知します。この購入をきっかけに、一連のシステムが通信してこのデータを移動し、最終的に通知が届きました。これらのシステムでは、このデータを伝達するためにウェブフックが使用されている可能性が高いです。ウェブフック：

• HTTP リクエストを介してアプリケーションが情報を渡したり、他のアプリケーション、ツール、サーバーを「呼び出す」ことを可能にします。
• 発生したイベント（例: 注文の確定、新しい顧客の購読など）に関する情報を送信します。
• イベントが発生したことをシステムに伝えたり、そのイベントに関する通知を受け取ったりできます。

このイベント情報は、その後、選択した方法と場所で配信されます。言い換えると、Webhook は、Klaviyo 内のデータや情報を、適切だと考える方法で他のマーケティングやツールに共有するための有用な手段を提供します。

Webhook の主な構成要素

Webhook はいくつかの要素で構成されています：

• トリガー
  Webhook の発火の原因となるイベント
• メッセージ（または「ペイロード」）
  Webhook が送信する内容（トリガーとなったイベントに関する重要な詳細、メッセージの送信先 URL、またはメッセージを受信するシステムの URL など）
• ヘッダー
  追加情報（認証など）を渡すための場所

フローの Webhook

Webhook は現在フロー内でのみ利用可能で、フローが特定のステージまたはステップに到達したときに送信されます。Webhook はその後、フローをトリガーしたイベントまたは受信者に関するデータを含む POST リクエストを送信します。

Webhook の送信を開始できるイベントは 1 つだけである点にご注意ください。購読者がトリガー条件を満たすと、Webhook が起動し、指定された URL にメッセージが送信されます。また、Webhook を送信できるのはフローのトリガーとなるイベント（つまり、フロー トリガーとして使用できるイベント）のみです。たとえば、フローはプロファイルの変更から直接トリガーできないため、プロファイルプロパティの変更を起点に Webhook を送信することはできません。
Klaviyo におけるイベントの例：

• 注文の確定
• チェックアウトの開始
• リストに登録

Webhook のユースケース

Webhook を生成できるフローのトリガーと、他のアプリケーションでこれらを実装する方法に関する実用的なユースケースを理解することが重要です。

例：

• 離脱した顧客の再エンゲージメントを目的にメッセージを送信する。
• 顧客の誕生日にメッセージを送信し、ロイヤルティポイントという形でギフトを提供する。
• 新しい購読者がリストに登録するたびに Webhook を送信する。プロファイルデータを別のプラットフォームに送信できます。
• 購読者についてより詳しく把握するために、顧客に NPS アンケートを送信する。
• 購読者がセグメントまたはリストに追加されたことに基づいてトリガーされるメッセージまたは POST リクエストを送信します。ただし、フロー トリガーとしての “Received Email" イベントはサポートしていない点にご注意ください。

実際の例

お客様とオンラインおよび郵送でコミュニケーションできるように、Klaviyo をダイレクトメールツールに接続することにしました。新規顧客の Shah がウェブサイトにアクセスし、E コマースストアでいくつかの商品を購入しました。今後、Shah に全コレクションの印刷カタログを送付したいと考えています。

ここで Webhook がこれらの体験を結び付けることができます。すでに E コマースストアを Klaviyo に連携済みである必要があります。Klaviyo では、Placed Order イベントに基づいてトリガーされるフローを設定します。その後、ダイレクトメールツールの Webhook を共有し、メッセージ（つまり、ペイロード）にお客様の氏名、住所、注文内容などの詳細を含めます。

これで、（Shah のような）誰かが注文すると、イベントによってその住所へ印刷カタログの送付が開始される可能性があります。Webhook の購入イベントにより、Klaviyo からダイレクトメールツールへ、ほぼリアルタイムで情報（つまりメッセージまたはペイロード）が送信されます。

Klaviyo の Webhook ではできないことは何ですか？

Webhook は、双方向のデータ同期を目的としていません。つまり、他のプラットフォームを Klaviyo に接続して、Klaviyo からそれらにデータを送信することはできますが、データを Klaviyo に戻すことはできません。情報は Klaviyo から、接続した指定のシステムまたはアプリケーションへと送信されますが、その逆方向には送信されません。Webhook は API と異なり、この一方向の方法でのみ機能します。

また、情報のプロンプトに選択するイベント、それがどれくらいの頻度で発生するか、そしてそのデータが最終的にシステム内のどこに送られるかを考慮することも重要です。Klaviyo はフローのデータをプラットフォームに接続するためのフレームワークを提供しますが、最終的な価値は、その情報が Klaviyo を離れた後にどこへ行き、何を促す可能性があるかによって決まります。そのため、Klaviyo は Webhook が機能しているかどうかのみを監視でき、データがシステムを離れた後にどこへ送られるのか、または何をしているのかは監視できません。

最後に、Webhook を介して Klaviyo が送信できるデータと送信できないデータを検討することが重要です。フローのトリガーの仕組みにより、Klaviyo は特定のデータポイントを Webhook 経由で送信できません。たとえば、購読者がメールを開封するたびのメール開封エンゲージメントデータは送信できません。開封に基づいてフローをトリガーできないためです。

同様に、イベントトリガー型フローの Webhook ペイロードでイベントベースの動的変数を使用できますが、利用可能な変数は、フローをトリガーした元のイベントに紐づきます（つまり、フローメールと同様です）。たとえば、Started Checkout イベントによってトリガーされるカゴ落ちフローがある場合、そのイベントの動的変数を Webhook ペイロードで使用できます。ただし、同じフロー内で Added to Cart メトリックを使用したフローフィルターまたは分岐も使用している場合、この追加データを Webhook ペイロードに含めることはできません。

そのため、Webhook を設定する際は、どのフローがどのデータポイントをサポートできるか、および Webhook の設定で何を達成したいのかを検討することが重要です。

現在、クーポンコード、ウェブ フィード、商品フィードはフロー Webhook でサポートされていません。

Webhook を設定すべきなのは誰ですか？

上記のとおり、Klaviyo に接続するシステム、情報またはデータのパッケージ方法、そして取得するデータまたは情報は、すべて任意に決められます。

この点を踏まえ、Klaviyo から適切なイベントが送信され、アプリケーションに正しく POST されるようにするため、Webhook を設定する開発リソースの利用を強く推奨します。Webhook が失敗した場合、Klaviyo からエラーも提供されます。ただし、Webhook 設定に関するより深い問題、またはデータが最終的にどのようにアプリケーションへ POST されているかについては、診断できない場合があります。

要件と考慮事項

Webhook を適切に設定し、付随するシステムでテストするための開発者リソースを確保することに加えて、Klaviyo にはこの機能を使用するための重要な要件がいくつかあります。

• Klaviyo で Webhook を設定できるのは、フローを作成するためのアクセス権を持つユーザーロールのみです。これには、マネージャー、管理者、オーナーのロールが含まれます。
• セキュリティを強化するために、Webhook を使用する、または既存のフロー内で新しい Webhook アクションを追加するには、アカウント内で2 段階認証を有効にする必要があります。

設定する準備はできましたか？

Webhook は、Klaviyo から外部のシステムまたはアプリケーションへデータを伝達するための強力な仕組みを提供します。Webhook の設定を開始する準備ができたら、フローに Webhook アクションを追加する方法に関する開発者向けドキュメント ガイドをご覧ください。

その他のリソース