ドキュメントExperience Platform宛先ガイド

Pega プロファイルコネクタ

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • 管理者
  • ユーザー

概要 overview

Adobe Experience Platformの Pega Profile Connector を使用して Amazon Web Services （AWS） S3 ストレージへのライブアウトバウンド接続を作成し、Adobe Experience Platformから CSV ファイルにプロファイルデータを定期的に書き出して、独自の S3 バケットに入れます。 Pega Customer Decision Hub では、データジョブをスケジュールして、このプロファイルデータを S3 ストレージから読み込み、Pega Customer Decision Hub プロファイルを更新できます。

このコネクタは、プロファイルデータの最初の書き出しを設定するのに役立ち、Pega Customer Decision Hub に新しいプロファイルを定期的に同期するのにも役立ちます。 Customer Decision Hub に最新のデータを含めることで、次善のアクションの意思決定のための、顧客ベースに関するより優れた更新ビューが提供されます。

IMPORTANT
この宛先コネクタとドキュメントページは、Pegasystems が作成および管理します。 お問い合わせや更新のリクエストについては、Pega に直接お問い合わせください こちら。

ユースケース

Pega Profile Connector の宛先を使用する方法とタイミングをより深く理解するために、Adobe Experience Platformのお客様がこの宛先を使用して解決できるユースケースのサンプルを以下に示します。

ユースケース 1

マーケターは、最初に、Adobe Experience Platformから読み込まれたプロファイルデータを使用して Pega Customer Decision Hub を設定したいと考えています。 これは、最初のフル・ロードと、スケジュールに従ったデルタ・ロードです。

ユースケース 2

マーケターは、顧客プロファイルに関する Pega インサイトを継続的に強化する、Adobe Experience Platformの最新のプロファイルデータを Pega Customer Decision Hub で入手したいと考えています。

前提条件 prerequisites

この宛先を使用してAdobe Experience Platformからデータを書き出し、プロファイルを Pega Customer Decision Hub に読み込む前に、次の前提条件を満たしていることを確認してください。

  • バケット Amazon S3、データファイルのエクスポートおよびインポートに使用するフォルダーパスを設定します。
  • Amazon S3 アクセスキーと Amazon S3 秘密鍵を設定する：Amazon S3 で access key - secret access key ペアを生成して、Amazon S3 アカウントに Platform アクセス権を付与します。
  • Amazon S3 ストレージの場所に正常に接続してデータを書き出すには、Amazon S3 で Platform の IAM （Identity and Access Management） ユーザーを作成し、s3:DeleteObject、s3:GetBucketLocation、s3:GetObject、s3:ListBucket、s3:PutObject、s3:ListMultipartUploadParts などの権限を割り当てます
  • Pega Customer Decision Hub インスタンスが 8.8 バージョン以降にアップグレードされていることを確認します。

サポートされている ID supported-identities

Pega Customer Decision Hub では、以下の表で説明するカスタムユーザー ID のアクティベーションをサポートしています。 詳しくは、ID を参照してください。

ターゲット ID
説明
顧客 ID
Pega Customer Decision Hub およびAdobe Experience Platformでプロファイルを一意に識別する共通のユーザー ID

書き出しのタイプと頻度 export-type-frequency

宛先の書き出しのタイプと頻度について詳しくは、以下の表を参照してください。

項目
タイプ
メモ
書き出しタイプ
プロファイルベース
宛先のアクティベーションワークフローのプロファイル属性選択画面で選択した目的のスキーマフィールド（例：メールアドレス、電話番号、姓）と共に、セグメントのすべてのメンバーを書き出します。
書き出し頻度
バッチ
バッチ宛先では、ファイルが 3 時間、6 時間、8 時間、12 時間、24 時間の単位でダウンストリームプラットフォームに書き出されます。 詳しくは、バッチ（ファイルベース）宛先を参照してください。

宛先への接続 connect

IMPORTANT
宛先に接続するには、宛先の表示 および 宛先の管理 ​ アクセス制御権限が必要です。 詳しくは、アクセス制御の概要または製品管理者に問い合わせて、必要な権限を取得してください。

この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。宛先の設定ワークフローで、以下の 2 つの節でリストされているフィールドに入力します。

宛先に対する認証 authenticate

宛先に対して認証するには、必須フィールドに入力し、「宛先に接続」を選択します。

  • Amazon S3アクセスキー および秘密鍵 : Amazon S3 で access key - secret access key ペア ​Amazon S3 生成して、Amazon S3 アカウントにAdobe Experience Platform アクセス権を付与します。 詳しくは、Amazon Web Services に関するドキュメントを参照してください。

宛先の詳細の入力 destination-details

Amazon S3 への認証接続を確立したら、宛先の次の情報を指定します。

Pega プロファイルコネクタの宛先の詳細に関する入力済みフィールドを示す UI 画面の画像

宛先の詳細を設定するには、必須フィールドに入力し、「次へ」を選択します。 UI のフィールドの横のアスタリスクは、そのフィールドが必須であることを示します。

  • 名前：この宛先を識別するのに役立つ名前を入力します。
  • 説明：この宛先の説明を入力します。
  • バケット名：この宛先で使用する Amazon S3 バケットの名前を入力します。
  • フォルダーパス：書き出したファイルをホストする宛先フォルダーへのパスを入力します。
  • 圧縮タイプ：圧縮タイプとして GZIP または NONE を選択します。
TIP
宛先に接続ワークフローでは、書き出したオーディエンスファイルごとにAmazon S3 ストレージにカスタムフォルダーを作成できます。 手順については、マクロを使用して、ストレージの場所にフォルダーを作成するを参照してください。

アラートの有効化 enable-alerts

アラートを有効にすると、宛先へのデータフローのステータスに関する通知を受け取ることができます。リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。アラートについて詳しくは、UI を使用した宛先アラートの購読についてのガイドを参照してください。

宛先接続の詳細の入力を終えたら「次へ」を選択します。

この宛先に対してオーディエンスをアクティブ化 activate

IMPORTANT
  • データをアクティブ化するには、宛先の表示、宛先のアクティブ化、プロファイルの表示 および セグメントの表示 ​ アクセス制御権限が必要です。 アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。
  • ID を書き出すには、ID グラフの表示 ​ アクセス制御権限が必要です。
    宛先に対してオーディエンスをアクティブ化するために、ワークフローでハイライト表示されている ID 名前空間を選択します。 {width="100" modal="regular"}

この宛先に対してオーディエンスをアクティブ化する手順については、 プロファイル書き出しのバッチ宛先に対するオーディエンスデータのアクティブ化を参照してください。

属性と ID のマッピング map

マッピング ​手順では、プロファイルに書き出す属性および ID フィールドを選択できます。 また、書き出したファイル内のヘッダーを選択して、任意のわかりやすい名前に変更することもできます。詳しくは、「バッチの宛先をアクティベート」UI チュートリアルのマッピング手順を参照してください。

データの書き出しを検証する exported-data

Pega Profile Connector の宛先の場合、Platform は、指定されたAmazon S3 ストレージの場所に .csv ファイルを作成します。 ファイルについて詳しくは、オーディエンスの有効化チュートリアルの プロファイル書き出しのバッチ宛先に対するオーディエンスデータの有効化を参照してください。

S3 からプロファイルデータが正常に読み込まれると、Pega Customer プロファイルデータストアにデータが挿入されます。 次の図に示すように、読み込まれた顧客プロファイルデータを Pega Customer Profile Designer で検証できます。
顧客プロファイルDesignerでAdobeプロファイルデータを検証できる UI 画面の画像

ま Pega Customer Decision Hub、データ管理者は、次の図に示 Customer Profile Designer ように、S3 からプロファイルデータを定期的に読み込むように、データジョブを設定できます。 データジョブを設定して Amazon S3 からプロファイルデータをインポートする方法について詳しくは、 その他のリソースを参照してください。
顧客プロファイルDesignerでデータジョブを設定する UI 画面の画像

その他のリソース additional-resources

Pega Customer Decision Hub の データジョブのインポートを参照してください。

データの使用とガバナンス data-usage-governance

Adobe Experience Platform のすべての宛先は、データを処理する際のデータ使用ポリシーに準拠しています。Adobe Experience Platform がどのようにデータガバナンスを実施するかについて詳しくは、データガバナンスの概要を参照してください。

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6