このページ：プロファイルを更新アクションアクティビティを使用して、お客様がジャーニーを進む際に、既存の Adobe Experience Platform プロファイルを強化または修正する方法について説明します。
お客様がジャーニーを進む際に、プロファイルを更新アクションアクティビティを使用して、既存の Adobe Experience Platform プロファイルを強化または修正します。ジャーニーイベント、設定されたデータソース、静的な値から取得したフィールド値を設定すると、ジャーニーキャンバスから離れることなく、プロファイルデータを正確で実用的に維持できます。このアクティビティを設定する前に、適用されるガードレールと制限を確認してください。
データセットの選択 dataset-selection
プロファイルを更新アクティビティには、更新を保存する専用のデータセットが必要です。 このアクティビティは（データレイクではなく）プロファイルストアのみを更新するので、すべての更新を、プロファイルを更新アクション専用に指定されたプロファイル対応データセットに保存する必要があります。
また、プロファイルを更新アクティビティ設定には ID 名前空間は必要ありません。そのため、選択したデータセットには、ジャーニーを開始したアクションで使用した、更新で使用する名前空間と同じ ID 名前空間を使用します。 また、選択したデータセットで ID マップを使用することもできます。 正しい ID 名前空間を持つデータセットや、ID マップを使用するデータセットを選択しないと、プロファイルを更新アクティビティが失敗します。
プロファイルを更新アクティビティの設定 use-profile-update
ジャーニーで プロファイルを更新 アクティビティを設定するには、次の手順に従います。
-
ジャーニーのデザインを開始します。詳しくは、初めてのジャーニーの作成を参照してください。
-
パレットの「アクション」セクションで、「プロファイルを更新」アクティビティをキャンバスにドロップします。
-
リストからスキーマを選択します。
note NOTE 選択した XDM プロファイルスキーマに既に存在するフィールドのみが選択できます。必要なフィールドが一覧表示されていない場合は、最初に Adobe Experience Platform のスキーマに追加します。 -
「フィールド」をクリックして、更新するフィールドを選択します。
-
リストからデータセットを選択します。
note NOTE 「プロファイルを更新」アクションは、プロファイルデータをリアルタイムで更新しますが、データセットは更新されません。 データセットの選択は、プロファイルがデータセットに関連するレコードであるため、必要です。 -
「値」フィールドをクリックして、使用する値を定義します。
-
簡単な式エディターを使用して、データソースまたは受信イベントからフィールドを選択できます。
-
特定の値を定義する場合や高度な機能を活用する場合は、「詳細設定モード」を選択します。
-
-
同じアクションで追加のプロファイル属性を更新するには、「別のフィールドを更新」をクリックし、フィールドと値の選択を繰り返します。1 回の プロファイルを更新 アクションで、最大 5 つのフィールドと値のペアを追加できます。ガードレールと制限を参照してください。
これで、プロファイルを更新アクティビティを設定できました。
プロファイル更新のテスト using-the-test-mode
テストモードでは、プロファイルの更新はテストプロファイルにすぐに反映され、シミュレートされないことに注意してください。
テストモードでは、テストプロファイルのみがジャーニーにエントリできます。 新しいテストプロファイルを作成することも、既存のプロファイルをテストプロファイルに変換することもできます。 Adobe Experience Platform では、プロファイル属性は CSV ファイルのインポートまたは API 呼び出しを介して更新できます。より迅速な代替手段は、ジャーニー内で プロファイルを更新 アクティビティを使用し、テストプロファイルのブール値フィールドを true に設定することです。
既存のプロファイルをテストプロファイルに変換する方法について詳しくは、この節を参照してください。
ガードレールと制限 guardrails
- プロファイルを更新アクションは、名前空間を持つジャーニーでのみ使用できます。
- このアクションでは、既存のフィールドのみが更新され、新しいプロファイルフィールドは作成されません。
- アクションは、シンプルなフィールドタイプ（文字列、数値、ブール値）のみをサポートします。定義済みリスト、推奨値、オブジェクト配列、複雑なコレクション（例：製品リスト）として定義された XDM フィールドはサポートされていません。
- プロファイルを更新アクションを使用して、購入などのエクスペリエンスイベントを生成することはできません。
- 他のアクションのように、エラーやタイムアウトの場合の代替パスを定義できます。2 つのアクションを並行して配置することはできません。
- プロファイルの更新が、同じジャーニーのダウンストリームですぐに使用可能になることは保証されません。更新された値がまだ反映されていない場合があるので、プロファイルを更新アクションでフィールドに値を書き込んだ直後に、そのフィールドを読み取るアクションを配置することは回避してください。
- プロファイルを更新アクティビティでは、プロファイルストアのみが更新され、データレイクは更新されません。
- 1 回の プロファイルを更新 アクションで、最大 5 つのフィールドと値のペアを更新できます。「別のフィールドを更新」ボタンを使用して、さらにペアを追加します。
- パフォーマンスを向上させるには、属性ごとに 1 つのアクションを使用するのではなく、複数の属性更新を 1 つの プロファイルを更新 アクションにグループ化します。
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page explains how to configure the Update Profile activity to enrich or correct an existing Adobe Experience Platform profile with data from journey events, datasources, or static values as a customer progresses through a journey.
Intents:
- Configure the Update Profile activity to modify existing profile attributes during a journey
- Select a profile-enabled dataset dedicated to Update Profile actions
- Map field values from journey events, datasources, or static values to profile attributes
- Update multiple profile attributes (up to five) in a single activity
- Test profile updates in journey test mode
Glossary:
- Update Profile activity: An action activity that writes new values to existing fields in an Adobe Experience Platform profile in real time as a profile moves through a journey (product-specific)
- Profile Store: The Adobe Experience Platform store that holds real-time customer profile data, distinct from the Data Lake (product-specific)
- Identity namespace: A label that distinguishes identity contexts (e.g., email, CRM ID) used to match the profile being updated (product-specific)
- Profile-enabled dataset: An Adobe Experience Platform dataset configured to contribute records to the unified profile (product-specific)
Guardrails:
- The Update Profile action can only be used in journeys that have a namespace defined.
- The action only updates existing XDM fields; it cannot create new profile fields.
- Only simple field types are supported (string, number, boolean); enumerations, object arrays, and complex collections are not supported.
- The action cannot generate experience events such as purchases.
- Up to five field/value pairs can be updated in a single Update Profile action.
- Do not share the dedicated dataset with batch or streaming ingestion processes, as other ingestion runs will overwrite Update Profile changes.
- Profile updates may not be immediately available downstream in the same journey execution.
- The activity only updates the Profile Store, not the Data Lake.
Terminology:
- Canonical name: Update Profile — Acronym: none — variants: Update Profile activity, Update Profile action
- Synonyms: “Profile Store” = “Real-Time Customer Profile store”
- Do not confuse: “Profile Store” (updated by this activity) ≠ “Data Lake” (not updated by this activity)
FAQ:
- Q: Can the Update Profile activity create new profile fields? — No, it can only update fields that already exist in the selected XDM Profile schema.
- Q: Why should I use a dedicated dataset for Update Profile actions? — Sharing the dataset with batch or streaming ingestion can cause other ingestion runs to overwrite the changes made by the Update Profile activity.
- Q: Are profile updates immediately visible to downstream activities in the same journey? — No, updated values may not yet be reflected if an action reads the same field immediately after the Update Profile activity writes it.
- Q: How many fields can I update in a single Update Profile action? — Up to five field/value pairs can be configured in a single activity using the “Update another field” button.
- Q: Do profile updates apply in test mode? — Yes, in test mode the updates take effect immediately on the test profile and are not simulated.