Pega Webhookコネクタ構成ガイド
この記事では、テンプレート変数を使用してPega APIにカスタムリクエストアクションを送信する、高度なWebhookの構成方法について説明します。
前提条件
- Pega Customer Decision Hubを構成する
- Event Streaming API HubまたはCustomer Data Platform(CDP)
仕組み
Pegaの送信Webhookを使用すると、PegaのCustomer Decision Hub、Next-Best-Actionsデザイナー、およびCustomer Profileデザイナーと連携できます。TealiumとPegaを併用することで、セキュリティ規制への準拠、リアルタイムデータ収集を活用した迅速な対応、Next-Best-Experienceメッセージによる個々の顧客の識別とターゲティングが可能になります。Pegaと連携すると、Tealiumのデータをトリガーとして、ニュースレターによるプロモーションやPegaを通じたプロモーションコードの提供など、カスタムの顧客インタラクションを実行でき、カスタマージャーニーのパーソナライズに役立ちます。開始するには、HTTPリクエストを送信して、パーソナライズされたファーストパーティデータをPegaに送信します。
ベンダー要件
リクエストURL
PegaのDesigner Studioを使用して、カスタムリクエストURLを作成できます。リクエストURLは、使用しているPegaの実装とPegaアカウント内のサービスパッケージに基づきます。リクエストURLを作成する際は、特定のパスパラメータを含める必要があります。カスタムURLの変数とパスパラメータの指定を含むRESTサービスの構成方法については、PegaドキュメントのService RESTルールの作成を参照してください。Service RESTルールを作成したら、そのルールのリソースと処理の詳細を構成して、RESTルールの構成を完了します。
PegaのすべてのAPI、APIのベストプラクティス、およびREST連携の作成方法について詳しくは、PegaドキュメントのPegaのAPIとサービスを参照してください。
メソッドフィールド
Service RESTルールで使用できるメソッドについて詳しくは、PegaドキュメントのService RESTのメソッドを参照してください。
Webhookの例
リクエストボディは、カスタマイズ可能なボディテンプレートを持つJSONメッセージです。Pegaは、ネストされたJSONとフラットなJSONのいずれも受け付けます。JSONリクエストの構造は、Pegaの実装とDesigner Studioで指定したデータポイントによって異なります。
Webhookコネクタの構成について詳しくは、コネクターテンプレート変数を参照してください。
この例では、Webhookはユーザーを識別するためのパラメータを含むPageViewリクエストを送信します。
メソッド:
POSTURL:
https://<host>:<port>/prweb/PRRestService/<servicepackage>/<serviceclass>/<servicemethod>ボディのコンテンツタイプ:
application/jsonボディデータ:
Map `{{data}}` To Bodyテンプレート変数:
Map "PageView" To IntentMap customer_id to IDMap tealium_firstparty_visitor_id To CookieidvalueMap Last event timestamp To time
テンプレート:
- 名前:
data - テンプレート:
- 名前:
{
"Cookieidvalue": "{{Cookieidvalue}}",
"ID": "{{ID}}",
"Intent": "{{Intent}}",
"Lastviewedproduct": "{{time}}"
}
最終更新日 :: 2022年May月4日