Pega Webhookコネクタ構成ガイド
この記事では、Pega APIのテンプレート変数を使用してカスタムリクエストアクションを送信するための高度なWebhookを構成する方法について説明します。
前提条件
- Pega Customer Decision Hubの構成
- Tealium EventStream API HubまたはTealium AudienceStream CDP
仕組み
PegaのアウトゴーイングWebhookは、PegaのCustomer Decision Hub、Next-Best-Actionsデザイナー、およびCustomer Profileデザイナーとの統合を可能にします。TealiumとPegaを一緒に使用することで、セキュリティ規制の遵守、リアルタイムのデータ収集の活用、Next-Best-experienceメッセージで個々の顧客を特定・ターゲティングすることが可能になります。Pegaとの統合により、Tealiumのデータがカスタムの顧客インタラクション(ニュースレタープロモーションやプロモーションコードの提供など)をトリガーし、カスタマージャーニーをパーソナライズするのに役立ちます。始めるには、Pegaに第一者パーソナライズデータを送信するHTTPリクエストを送信します。
ベンダーの要件
リクエストURL
PegaのDesigner Studioを使用して、PegaでカスタムリクエストURLを作成することができます。リクエストURLは、特定のPegaの実装と、Pegaアカウント内のサービスパッケージに基づいています。リクエストURLを作成する際には、特定のパスパラメータを含める必要があります。カスタムURLの変数とパスパラメータを指定してRESTサービスを構成する方法については、PegaのドキュメンテーションのService REST ruleの作成を参照してください。Service REST ruleを作成した後は、リソースと処理詳細の構成を完了して、REST ruleの構成を完了します。
PegaのすべてのAPI、APIのベストプラクティス、REST統合の作成に関する情報については、PegaのドキュメンテーションのPega APIs and servicesを参照してください。
メソッドフィールド
サービスRESTルールで使用できるメソッドについての詳細は、PegaのドキュメンテーションのService REST methodsを参照してください。
Webhookの例
リクエストボディは、カスタマイズ可能なボディテンプレートを持つJSONメッセージです。PegaはネストされたJSONまたはフラットなJSONを受け入れます。JSONリクエストの構造は、Pegaの実装とDesigner Studioで指定されたデータポイントによります。
Webhookコネクタの構成についての詳細は、Webhook Template Variables Guideを参照してください。
この例では、Webhookはユーザーを識別するパラメータを持つPageView
リクエストを送信します。
-
メソッド:
POST
-
URL:
https://<host>:<port>/prweb/PRRestService/<servicepackage>/<serviceclass>/<servicemethod>
-
ボディコンテンツタイプ:
application/json
-
ボディデータ:
Map `{{data}}` To Body
-
テンプレート変数:
Map "PageView" To Intent
Map customer_id to ID
Map tealium_firstparty_visitor_id To Cookieidvalue
Map Last event timestamp To time
-
テンプレート:
- 名前:
data
- テンプレート:
- 名前:
{
"Cookieidvalue": "{{Cookieidvalue}}",
"ID": "{{ID}}",
"Intent": "{{Intent}}",
"Lastviewedproduct": "{{time}}"
}
最終更新日 :: 2022年May月4日