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エクスペリエンスメッセージで個々の顧客を特定してターゲットにすることができます。Pegaとの統合により、TealiumのデータがPegaを通じてニュースレタープロモーションやプロモーションコードの提供など、カスタム顧客インタラクションをトリガーすることができ、カスタマージャーニーをパーソナライズするのに役立ちます。はじめに、Pegaにファーストパーティのパーソナライズデータを送信するHTTPリクエストを送信してください。
ベンダー要件
リクエストURL
PegaのDesigner Studioを使用して、PegaでカスタムリクエストURLを作成できます。リクエストURLは、Pegaの実装とPegaアカウントのサービスパッケージに基づいています。リクエストURLを作成する際には、特定のパスパラメータを含める必要があります。カスタムURLの変数とパスパラメータを指定するために、RESTサービスを構成するには、PegaのドキュメントにあるCreating a Service REST ruleを参照してください。Service RESTルールを作成した後、configuring the resources and processing detailsでRESTルールの構成を完了してください。
PegaのAPI、APIのベストプラクティス、およびREST統合の作成に関する詳細情報については、PegaのドキュメントにあるPega APIs and servicesを参照してください。
メソッドフィールド
サービスRESTルールで使用できるメソッドについての詳細は、PegaのドキュメントにあるService REST methodsを参照してください。
Webhook例
リクエスト本体は、カスタマイズ可能な本体テンプレートを持つJSONメッセージです。PegaはネストされたJSONまたはフラットJSONのいずれかを受け入れます。JSONリクエストの構造は、Designer Studioで指定されたPegaの実装とデータポイントに依存します。
Webhookコネクタの構成方法についての詳細は、コネクターテンプレート変数を参照してください。
この例では、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日