Pegasystemsコネクタ構成ガイド | サーバーサイドコネクタ

前提条件

Tealium EventStreamまたはAudienceStream
Pega Customer Decision Hubへの以下のアクセス：
- クライアントID、クライアントシークレット、アクセストークンURL
- Tealium Customer Data Connector コンポーネントの実装

仕組み

顧客の嗜好や次の最善の行動の正確な予測は、その顧客と最近の全ての接点に対する良好な理解に依存しています。Tealiumは、この正確でエンリッチされた顧客データを簡単に接続して、決定と推奨を情報提供することで、PegaのCustomer Decision Hubをエンリッチメントします。

Pegasystemsコネクタは、2つの方法で価値ある顧客データを接続します：

TealiumとPegaは、全てのクロスチャネルシグナルを集約した顧客プロファイルに基づいて統合された顧客情報を共有します。
Tealiumは、ウェブ、アプリ、コールセンター、その他のチャネルを通じて顧客のインタラクションをリアルタイムでPegaにストリームし、意思決定のためのその瞬間のコンテキストを提供します。

Pegasystemsコネクタは、EventStreamとAudienceStreamの両方のアクションをサポートし、EventStreamを通じてページビュー/インタラクションを追跡することができます。顧客識別子またはクッキーIDを使用して、異なるページタイプを構成し、インタラクション履歴をPegaに送信するためのマッピングを行うことができます。

さらに、Pega Customer Decision Hub内で次の最善の行動をトリガーするために、顧客識別子とともにオーディエンスセグメントとステータスをPegaに送信します。

コネクタアクション

アクション名	AudienceStream	EventStream
セグメントメンバーシップデータの更新（リアルタイム）	✓	✗
セグメントメンバーシップデータの更新（バッチ処理）	✓	✗
カスタムイベントデータの送信（リアルタイム）	✗	✓
カスタムイベントデータの送信（バッチ処理）	✗	✓
IDマージ	✓	✗
顧客プロファイルデータの送信	✓	✗

TealiumはPegaへのバッチ処理アクションをサポートしていますが、ユースケースの構成とバッチ処理の必要性についてはPegaのアカウントチームと相談することをお勧めします。

構成の構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法の一般的な指示については、About Connectorsの記事を参照してください。

コネクタを追加した後、以下の構成を構成します：

クライアントID：必須。クライアントに割り当てられた一意のID。
クライアントシークレット：必須。システムがクライアントに割り当てるパスワードで、Pega Platform認証モジュールでの認証に使用します。
アクセストークンURL：必須。認証後にクライアントのレスポンスとしてアクセストークンを受け取るために使用するリクエストURL。
認証方法：必須。Pega Platformへのアクセスに使用する認証方法。
- POST：クライアントの資格情報をPOSTリクエストの本文に送信します。
- BASIC：クライアントの資格情報（クライアントIDとクライアントシークレット）を認証ヘッダーの一部として外部アプリケーションに送信します。

クライアントが使用するRESTサービス認証には、クライアントIDとクライアントシークレットの資格情報が必要です。

コネクタの構成が完了したら、完了をクリックします。

アクション構成 - パラメータとオプション

続行をクリックしてコネクタアクションを構成します。アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

以下のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

アクション - セグメントメンバーシップデータの更新（リアルタイム）

このアクションを使用して、オーディエンスデータをPegaに送信し、Pega Customer Decision Hub内で次の最善の行動を決定するためのトリガーを作成します。リアルタイムでの決定を行うための訪問のプロファイルに関連するオーディエンスデータと追加のパラメータを送信します。

パラメータ

パラメータ	説明
サービスエンドポイントURL	あなたのPegaシステムで定義されたサービスエンドポイントURL。サービスエンドポイントURLは以下の構造を使用しますが、カスタマイズ可能で、Pegaの連絡先から提供される場合があります：`https://<host>:<port>/prweb/PRRestService/<servicepackage>/<serviceclass>/<servicemethod>`
顧客ID	必須。Pega Customer Profileの主キー。
名前	必須。Pegaプラットフォームに送信されるオーディエンス名。オーディエンス名または同様の値を文字列としてPegaに渡すように構成することをお勧めします。
ステータス	必須。オーディエンスに参加するか、オーディエンスから離れるかを決定するオーディエンストリガーアクション。希望するアクションに基づいて、参加または離脱の値をセグメントステータスフィールドにマッピングすることをお勧めします。
ネームスペース	必須。Pegaに提供されるオーディエンスデータを補完するために使用される任意のサブカテゴリパラメータ。
最終資格取得時間	必須。ユーザーがオーディエンスに参加したときのタイムスタンプ。日付属性はISO 8601形式に変換されます。マッピングされていない場合、このパラメータはISO 8601形式の現在のタイムスタンプで初期化されます。例：`2022-08-30T01:13:16.081Z`。

アクション - セグメントメンバーシップデータの更新（バッチ処理）

バッチ制限

このアクションは、ベンダーへの大量のデータ転送をサポートするためにバッチリクエストを使用します。詳細については、Batched Actionsを参照してください。リクエストは、以下のいずれかの閾値が満たされるか、プロファイルが公開されるまでキューに入れられます：

最大リクエスト数：10000
最古のリクエストからの最大時間：60分
リクエストの最大サイズ：100MB

TealiumはPegaへのバッチアクションをサポートすることができますが、ユースケースの構成とバッチ処理の必要性については、Pegaのアカウントチームと相談することをお勧めします。

パラメータ

パラメータ	説明
サービスエンドポイントURL	あなたのPegaシステムで定義されたサービスエンドポイントURL。サービスエンドポイントURLは以下の構造を使用しますが、カスタマイズ可能で、Pegaの連絡先から提供される場合があります：`https://<host>:<port>/prweb/PRRestService/<servicepackage>/<serviceclass>/<servicemethod>`
顧客ID	必須。Pega Customer Profileの主キー。
名前	必須。Pegaプラットフォームに送信されるオーディエンス名。オーディエンス名または同様の値を文字列としてPegaに渡すように構成することをお勧めします。
ステータス	必須。オーディエンスに参加するか、オーディエンスから離れるかを決定するオーディエンストリガーアクション。希望するアクションに基づいて、参加または離脱の値をセグメントステータスフィールドにマッピングすることをお勧めします。
ネームスペース	必須。Pegaに提供されるオーディエンスデータを補完するために使用される任意のサブカテゴリパラメータ。
最終資格取得時間	必須。ユーザーがオーディエンスに参加したときのタイムスタンプ。日付属性はISO 8601形式に変換されます。マッピングされていない場合、このパラメータはISO 8601形式の現在のタイムスタンプで初期化されます。例：`2022-08-30T01:13:16.081Z`。

アクション - カスタムイベントデータの送信（リアルタイム）

このEventStreamアクションを使用して、主にページビューのリアルタイムイベントデータをPegaに送信し、Pegasystemsエンドポイント内で集約します。

パラメータ

パラメータ	説明
サービスエンドポイントURL	値はあなたのPegaシステムで定義されたサービスエンドポイントURLです。サービスエンドポイントURLは以下の構造を使用しますが、カスタマイズ可能で、Pegaの連絡先から提供される場合があります：`https://<host>:<port>/prweb/PRRestService/<servicepackage>/<serviceclass>/<servicemethod>`
ページタイプ	必須。訪問したページのタイプ。
デバイスタイプ	必須。イベント生成に使用されたデバイス。
イベントタイプ	必須。イベントの名前。`tealium_event`の値を使用することを推奨します。
顧客ID	Pega顧客プロファイルの主キー。Cookie IDが提供されていない場合は必須です。
Cookie ID	顧客IDが提供されていない場合は必須です。両方が提供された場合、顧客IDのみが使用されます。
イベントタイムスタンプ	イベントが生成された時間。日付属性はISO 8601形式に変換されます。マッピングされていない場合、現在のタイムスタンプがISO 8601形式で初期化されます。例：`2022-08-30T01:13:16.081Z`。
ページロケーション	PageViewイベントが提供された場合、ページURLが必要です。
ページ閲覧者クティブタイム	訪問がページに費やした時間（秒）。

アクション - カスタムイベントデータの送信（バッチ）

バッチ制限

このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、以下のいずれかの閾値が満たされるか、プロファイルが公開されるまでキューに入れられます：

リクエストの最大数：10000
最古のリクエストからの最大時間：60分
リクエストの最大サイズ：100MB

このEventStreamアクションを使用して、主にページビューのバッチイベントデータをPegaに送信し、Pegasystemsエンドポイント内で集約します。

TealiumはPegaへのバッチアクションをサポートできますが、バッチングの必要性とユースケースの構成についてはPegaアカウントチームと相談することを推奨します。

パラメータ

パラメータ	説明
サービスエンドポイントURL	値は、Pegaシステムで定義されたサービスエンドポイントURLです。サービスエンドポイントURLは以下の構造を使用しますが、カスタマイズ可能で、Pegaの連絡先から提供される場合があります：`https://<host>:<port>/prweb/PRRestService/<servicepackage>/<serviceclass>/<servicemethod>`
ページタイプ	必須。訪問したページのタイプ。
デバイスタイプ	必須。イベント生成に使用されたデバイス。
イベントタイプ	必須。イベントの名前。`tealium_event`の値を使用することを推奨します。
顧客ID	Pega顧客プロファイルの主キー。Cookie IDが提供されていない場合は必須です。
Cookie ID	顧客IDが提供されていない場合は必須です。両方が提供された場合、顧客IDのみが使用されます。
イベントタイムスタンプ	イベントが生成された時間。日付属性はISO 8601形式に変換されます。マッピングされていない場合、現在のタイムスタンプがISO 8601形式で初期化されます。例：`2022-08-30T01:13:16.081Z`。
ページロケーション	PageViewイベントが提供された場合、ページURLが必要です。
ページ閲覧者クティブタイム	訪問がページに費やした時間（秒）。

アクション - IDマージ

このアクションを使用して、顧客の行動情報をマージし、累積的な行動データに基づいたより正確な推奨事項と次の最善の行動決定を生成します。

Tealiumでの推奨構成

以下のPegasystemsコネクタ構成を推奨します：

次の属性を作成します：
- Pega顧客ID：（EventStream文字列）データレイヤーから継承されます。
- Pega顧客ID群：（AudienceStream文字列の配列）Tealiumによって結合されたPega顧客ID。
- Pega顧客ID群の数：（AudienceStream数）Pega顧客ID群の文字列の長さ。
条件がPega顧客ID群の数 > 1であるPegaマッチチェックという名前のオーディエンスを作成します。
既存のPegaコネクタに顧客行動データのマージアクションを追加します。ここで：
- トリガー：訪問の終了時にオーディエンス内。
- チェックを外す：訪問開始時にはこのオーディエンスのメンバーではなかった。

パラメータ

パラメータ	説明
主ID / 副ID	必須。主IDと副IDを含む文字列の配列。最初の値は主IDで、その後の値は副IDです。例：`["ID12345","ID12346","ID12347"]`。
アプリケーション名	既知の顧客と未知の見込み客のデータが保存されているアプリケーションのID。この値が渡されない場合、アプリケーションIDはサービスURLのアプリケーションエイリアスの値から識別されます。
コンテキスト名	コンテキスト名を選択するか、カスタムコンテキスト名を入力します：顧客、提供者、または加入者。

ベンダーリソース

Pega：Tealium Customer Data Connectorのインストール