Webhookコネクタについて
この記事では、利用可能なWebhookコネクタについて説明します。
要件
- イベントデータ用に有効化されたTealiumアカウント(EventStream用)
- 訪問データ用に有効化されたTealiumアカウント(AudienceStream用)
動作原理
Webhookコネクタは、URL、URLパラメータ、ヘッダー、クッキー、ボディコンテンツタイプ、ボディデータを含むHTTPリクエストのすべての側面を使用して、カスタマイズされたデータをベンダーに送信します。Webhookはバッチ処理もサポートしています。さらに、複雑で動的なデータ形式を扱うために設計された強力なテンプレート機能を含んでいます。
ベンダーの認証要件に基づいて選択できるWebhookコネクタは以下の4つです:
- Webhook(BasicAuth):認証が不要、またはユーザー名とパスワードの基本認証のみが必要なサービス用。
- Webhook(OAuth2 - 3-Legged):アクセストークンを取得するためにサービスにログインする必要があります。
- Webhook(OAuth2 - 2-Legged):サービスにログインする必要はありません。認証に必要な情報でWebhookが構成されます。
- Webhook(JWT):JSON Webトークン認証を使用します。サービスにログインする必要はありません。認証に必要な情報でWebhookが構成されます。
Webhook OAuth2は、OAuth 2.0認証を明示的に要求するサービスに使用されます。
始めるには、コネクタマーケットプレイスにアクセスして使用したいWebhookインスタンスを追加してください。コネクタの追加方法についての一般的な指示については、コネクタ概要を参照してください。
アクション
| アクション名 | 説明 | Webhook(BasicAuth) | Webhook OAuth2 |
|---|---|---|---|
| HTTPリクエストを介してイベントデータを送信 | イベントオブジェクト全体をURLエンコードされたJSON文字列またはJSONペイロードとして送信します。 | ✓ | ✓ |
| HTTPリクエストを介して訪問データを送信 | 訪問プロファイルオブジェクト全体をURLエンコードされたJSON文字列またはJSONペイロードとして送信します。 | ✓ | ✓ |
| HTTPリクエストを介してカスタマイズされたデータを送信(高度) | マッピングで指定された個々のイベント/訪問属性を送信します。 | ✓ | ✓ |
| HTTPリクエストを介してバッチデータを送信 | イベントオブジェクト全体をURLエンコードされたJSON文字列またはJSONペイロードとして送信します。 | ✓ | ✓ |
| HTTPリクエストを介してバッチカスタマイズデータを送信(高度) | マッピングで指定されたバッチイベント/訪問属性を送信します。 | ✓ | ✓ |
詳細については、アクションパラメータを参照してください。
HTTPレスポンスクッキー
クッキーベースのセッション管理はWebブラウザでは一般的ですが、ステートレスAPIと通信するサーバー間環境では一般的に推奨されません。そのため、Webhookコネクタはクッキーベースのセッションを追跡せず、HTTPレスポンスのSet-Cookieヘッダー値を効果的に無視します。
最終更新日 :: 2025年December月3日