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