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 OAuth2は、明示的にOAuth 2.0認証を必要とするサービスに使用されます。
始めるには、コネクタマーケットプレイスに移動し、使用したいWebhookインスタンスを追加します。コネクタの追加方法の一般的な指示については、Connector Overviewを参照してください。
コネクタのアクション
アクション名 | 説明 | Webhook (BasicAuth) | Webhook OAuth2 |
---|---|---|---|
HTTPリクエスト経由でイベントデータを送信 | URLエンコードされたJSON文字列またはJSONペイロードとして、イベントオブジェクト全体を送信します。 | ✓ | ✗ |
HTTPリクエスト経由で訪問データを送信 | URLエンコードされたJSON文字列またはJSONペイロードとして、訪問プロファイルオブジェクト全体を送信します。 | ✓ | ✗ |
HTTPリクエスト経由でカスタマイズデータを送信(高度) | マッピングを通じて指定された個々のイベント/訪問属性を送信します。 | ✓ | ✓ |
HTTPリクエスト経由でバッチ化されたカスタマイズデータを送信(高度) | マッピングを通じて指定されたバッチ化されたイベント/訪問属性を送信します。 | ✓ | ✓ |
HTTPレスポンスクッキー
クッキーベースのセッション管理はウェブブラウザで一般的ですが、ステートレスAPIと通信するサーバー間の環境では一般的に推奨されません。そのため、Webhookコネクタはクッキーベースのセッションを追跡せず、HTTPレスポンスのSet-Cookie
ヘッダー値を効果的に無視します。
最終更新日 :: 2022年June月23日