Webhookコネクタについて
WebhookコネクタをHTTP APIエンドポイントに接続して、イベントデータまたは訪問データを直接サービスに送信します。これは、完全なJSONペイロードを投稿するか、個々の属性をリクエストフィールドにマッピングすることによって行います。
要件
- イベントデータ用に有効化されたTealiumアカウント(EventStream用)
- 訪問データ用に有効化されたTealiumアカウント(AudienceStream用)
動作原理
Webhookコネクタは、HTTPリクエストを通じてイベントまたは訪問データをベンダーに送信します。HTTPリクエストのすべての側面を構成して、ベンダーに必要な正確なリクエストを作成できます。
認証
HTTPベースのWebhookコネクタに対応する認証方法は以下の通りです:
- BasicAuth: リクエストと共に送信されるユーザー名とパスワードを使用してWebhookリクエストを認証します。
- OAuth2 3-Legged: ユーザーの同意を得たフローを通じてWebhookリクエストを認証し、ユーザーの代わりにアクセストークンを発行します。サービスにログインしてアクセストークンを取得する必要があります。
- OAuth2 2-Legged: ユーザーの関与なしにサーバー間でアクセストークンを使用してWebhookリクエストを認証します。
- JWT: JSON Webトークンを使用してWebhookリクエストを認証します。
Webhook OAuth2は、OAuth 2.0認証を明示的に要求するサービスに使用されます。
詳細については、Webhook認証を参照してください。
Webhookを使用してデータをJDBC互換データベースに送信する方法については、Webhook JDBCを参照してください。
アクション
| アクション名 | 説明 | Webhook (BasicAuth) | Webhook OAuth2 |
|---|---|---|---|
| HTTPリクエストを介してイベントデータを送信 | イベントオブジェクト全体をURLエンコードされたJSON文字列またはJSONペイロードとして送信します。 | ✓ | ✓ |
| HTTPリクエストを介して訪問データを送信 | 訪問プロファイルオブジェクト全体をURLエンコードされたJSON文字列またはJSONペイロードとして送信します。 | ✓ | ✓ |
| HTTPリクエストを介してカスタマイズされたデータを送信(高度) | マッピングで指定された個々のイベント/訪問属性を送信します。 | ✓ | ✓ |
| HTTPリクエストを介してバッチデータを送信 | イベントオブジェクト全体をURLエンコードされたJSON文字列またはJSONペイロードとして送信します。 | ✓ | ✓ |
| HTTPリクエストを介してバッチカスタマイズデータを送信(高度) | マッピングで指定されたバッチイベント/訪問属性を送信します。 | ✓ | ✓ |
詳細については、Webhook アクションとパラメータを参照してください。
HTTPレスポンスクッキー
クッキーベースのセッション管理はWebブラウザーで一般的ですが、ステートレスAPIと通信するサーバー間環境では一般的に推奨されません。そのため、Webhookコネクタはクッキーベースのセッションを追跡せず、HTTPレスポンスのSet-Cookieヘッダー値を効果的に無視します。
最終更新日 :: 2025年December月17日