このページ：ファイルを読み込みデータ管理アクティビティを使用して、ファイルを Adobe Experience Platform に取り込まずに、実行時に外部 CSV または TXT ファイルからオーケストレーションキャンペーンオーディエンスをターゲットにする方法について説明します。
ファイルを読み込みアクティビティは、データ管理アクティビティです。 これを使用して、外部ファイルに保存されるプロファイルとデータを操作します。 受信者リストが外部システム（例：CRM エクスポートやパートナーファイルなど）から取得され、最初に完全な Adobe Experience Platform 取り込みパイプラインを作成せずにキャンペーンを実行する場合、オーケストレーションキャンペーンで ファイルベースのターゲティング がサポートされます。
ファイルの設定時に、列のマッピング、データタイプ、NULL 処理、列ごとのエラーポリシーを定義できます。 検証に失敗した行は、キャンペーンの実行前に却下され、ログに記録されます。これにより、手作業による事前処理なしでクリーンなオーディエンスを維持できます。
ガードレールと制限 limitations
ファイルを読み込みアクティビティには、次の制限が適用されます。
- ファイルごとに最大 50 MB までアップロードできます。
- フラット構造の CSV ファイルと TXT ファイルのみがサポートされます。
- アップロードされたデータは、キャンペーンの実行時に使用され、Adobe Experience Platform データセットとして保存されません。
- アップロードされたファイルのデータの有効期間が短いため、ファイルの読み込み アクティビティは、スケジュールされたキャンペーンで使用することを意図していません。
チャネルとキャンバスのアクティビティに関する制限について詳しくは、ガードレールと制限を参照してください。
前提条件 prerequisites
オーケストレーションキャンペーンに ファイルを読み込み アクティビティを追加してメッセージアクティビティに接続する前に、管理者は次の 1 回限りの設定を完了する必要があります。
オーケストレーションキャンペーンで ファイルを読み込み アクティビティを使用するには、ユーザーに オーケストレーションキャンペーンでファイルを管理 権限を割り当てる必要があります。
権限の割り当て手順について詳しくは、ユーザーと役割の管理を参照してください。
ファイルタイプのターゲットディメンションの作成 file-target-dimension
ファイルタイプの プロファイルターゲットディメンション を使用すると、オーケストレーションキャンペーンは、Adobe Experience Platform スキーマの代わりにアップロードされたファイルから受信者を解決できます。 キャンペーン実行時にファイルオーディエンスが処理される際に使用される ID 名前空間と識別子フィールドを定義します。
管理／設定／キャンペーンターゲットディメンションからターゲットディメンションを作成します。 ターゲットディメンションの詳細情報
ファイルベースのターゲティング用のターゲットディメンションを作成する際は、以下の点を確認してください。
- ディメンションソースを ファイル に設定します。
- ファイルの識別子列に一致する ID 名前空間 を選択します（例：メール）。
- ID フィールドのパスを入力します。 アップロードしたファイルに
email列が含まれている場合は、識別子を含むファイルフィールド（例：email）を使用します。
ファイルベースの配信用のチャネル設定の作成 file-channel-configuration
ファイルタイプのターゲットディメンションを使用する専用のチャネル設定を作成します。 この設定は、キャンペーンキャンバスの ファイルを読み込み アクティビティに続くメッセージアクティビティで選択されます。
-
管理／チャネル／チャネル設定に移動し、新しい設定を作成します。
-
実行の詳細で、「オーケストレーションキャンペーン」タブを選択し、オーケストレーションキャンペーンの設定を有効にします。
-
「プロファイルターゲットディメンション」フィールドで、前の手順で作成したファイルタイプのターゲットディメンションを選択します。
-
残りのチャネル設定フィールドに入力して保存します。 オーケストレーションキャンペーンのチャネル設定の詳細情報
「ファイルを読み込み」アクティビティの設定 load-file-configuration
2 つの部分でアクティビティを設定します。サンプルファイルで期待されるファイル構造を定義し、キャンペーンの実行時に読み込むファイルを指定します。
-
ファイルを読み込みアクティビティをオーケストレーションキャンペーンキャンバスに追加します。
-
アクティビティの ラベル を入力します。
サンプルファイルの定義 sample-file
サンプルファイルを使用して、列と 書式設定 を設定します。 サンプルデータは、キャンペーンオーディエンスとしてインポートされません。
-
「サンプルファイル」セクションで、期待される構造を定義するローカルファイルを選択します。
note NOTE サンプルファイルは、列と書式設定のみを設定するために使用され、そのデータはキャンペーンオーディエンスとしてインポートされません。 形式は、キャンペーンの実行時に読み込むファイルと一致する必要があります。 -
ファイルタイプドロップダウンで、ファイルで 区切り列 を使用するか、固定幅の列を使用するかを指定します。
-
「列」セクションで、各列を展開し、そのプロパティを設定します。
データタイプを選択すると、そのタイプに追加のオプションが表示されます。 すべての列に共通するパラメーターとタイプ固有のオプションについて詳しくは、以下の節を展開してください。
accordion 共通の列パラメーター -
列を無視 - 選択した場合にインポートから列を除外します。
-
ラベル - 列の表示名（例：
email）。 -
内部名 - ファイルヘッダーから派生した列のシステム名（読み取り専用）。
-
データタイプ - 列のデータのタイプ。
-
NULL を許可 - 列の空の値の管理方法を指定します。
- Adobe Campaign のデフォルト値 - 数値フィールドに対してのみエラーを生成します。 それ以外の場合は NULL 値が挿入されます。
- 空の値を許可 - 空の値を許可します。 したがって、NULL 値が挿入されます。
- 常に反映 - 値が空の場合に、エラーを生成します。
-
エラー処理 - 列でエラーが発生した場合の動作を定義します。
- 値を無視 - 値を無視します。
- 行を却下 - すべての行に対して処理を行いません。
- エラーの場合はデフォルト値を使用 - エラーの原因となった値を「デフォルト値」フィールドで定義されたデフォルトの値と入れ替えます。
- 値が再マッピングされない場合はデフォルト値を使用 - マッピングのエラー値が定義されている場合を除き、エラーの原因となった値を「デフォルト値」フィールドで定義されたデフォルトの値と入れ替えます。
- 再マッピングの値がない場合は行を却下 - マッピングのエラー値が定義されている場合を除き、すべての行に対して処理を行いません。
-
デフォルト値 - エラー処理がデフォルト値を使用するように設定されている場合に使用するデフォルト値。
-
値の再マッピング - 特定の値を新しい値にマッピングします。 「マッピングを追加」をクリックして、各マッピングを定義します（例：
True／Falseを1／0に置き換えます）。
accordion 文字列列パラメーター - 幅 - 最大文字数。
- データ変換 - 文字列値に適用される大文字と小文字の変換（例：なしまたは大文字／小文字）。
- スペースの処理 - 文字列値の先頭または末尾のスペースを処理する方法。
accordion 整数列と浮動小数列のパラメーター -
形式 - ファイル内の数値の読み取り方法を定義します。
- その他 - 「区切り記号」セクションの 桁区切り記号 と 小数点の区切り記号 を定義します。
- 1,000.00 - コンマは桁区切り記号、ピリオドは小数点の区切り記号です。
- 1 000,00 - スペースは桁区切り記号、コンマは小数点の区切り記号です。
-
区切り記号（形式が その他 の場合）：
- 桁区切り記号 - 桁を数値でグループ化する文字（使用しない場合は空のままにする）。
- 小数点の区切り記号 - 数値の小数点以下に使用される文字（例：
,または.）。
accordion 日時列のパラメーター オプションは、データタイプが日付、時刻、日時であるかどうかによって異なります。
日付
-
日付形式 - ファイル内での日付の表示方法に一致するパターン（例：
yyyy/mm/dd）。 -
区切り記号：
- 年、月、日 - 年、月、日のコンポーネント間の文字（例：
/）。
- 年、月、日 - 年、月、日のコンポーネント間の文字（例：
時刻
-
時刻形式 - ファイル内での時刻の表示方法に一致するパターン（例：24 時間制の「時:分」の場合は
13:30）。 -
区切り記号：
- 時間、分、秒 - 時間、分、秒のコンポーネント間の文字（例：
:）。
- 時間、分、秒 - 時間、分、秒のコンポーネント間の文字（例：
日時
- 日付形式 - ファイル内での日付部分の表示方法に一致するパターン。
- 時刻形式 - ファイル内での時刻部分の表示方法に一致するパターン。
- 区切り記号 - 日時のコンポーネント間の文字。
-
-
「書式設定」セクションで、キャンペーンの実行時に行と列が正しく読み取られるように、ファイルの構造化方法を指定します。 ターゲットファイルは、サンプルファイルと同じ書式設定を使用する必要があります。
- 先頭行を列ヘッダーとして使用 - 選択すると、ファイルの先頭行は列名として処理されます。 このオプションは通常、ヘッダー行を含むファイルからサンプルを設定する場合に有効になります。
- 行番号を識別子として使用 - 選択すると、各行がファイル内の行番号で識別されます。
- レコードが複数の行にまたがる - 選択すると、1 つのレコードがファイル内の複数の行にまたがる場合があります（例：フィールドに改行が含まれている場合）。
- 無視する行 - データが読み取られる前にファイルの先頭でスキップする行数（例：コメント行やメタデータ行）。
- タイムゾーン - 日時の値が読み込まれた際に適用されるタイムゾーン。
- エンコード - ファイルの文字エンコーディング。 ソースファイルに一致するエンコーディングを選択します。
- 文字列区切り - ファイル内の文字列値を囲むために使用される文字。
- 列区切り記号 - 区切りファイル内の列を区切る文字。
-
「確認」をクリックして、サンプルファイルの設定を検証してください。
ターゲットファイルの定義 target-file
キャンペーンの実行時に読み込むファイルと、各行が既存の受信者に一致する方法を指定します。
-
「ターゲットファイル」セクションで、ターゲットにするオーディエンスを含む CSV または TXT ファイルを選択します。
note caution CAUTION ターゲットファイルが、サンプルファイルと同じ形式、列構造、列数に従っていることを確認してください。 -
「管理を却下」セクションで、ファイル処理中にエラーが発生した場合のアクティビティの動作を定義します。
- 許可されるエラー数 - アクティビティが失敗する前に許可されるエラーの最大数。
- ファイルに却下を保持 - 有効にすると、読み込めなかった行は、実行後にレビューのためにサーバー上の却下ファイルに書き込まれます。
-
オプションで、「インポート後にファイルを削除」を有効にすると、キャンペーンの実行後にアップロードされたファイルがサーバーから削除されます。
ファイルを読み込みがオーディエンスを解決したら、アウトバウンドトランジションをダウンストリームアクティビティに接続します。 キャンペーンアクティビティのオーケストレーション方法を学ぶ
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 use the Load file activity to target an Orchestrated campaign audience from an external CSV or TXT file at execution time, without ingesting the file into Adobe Experience Platform.
Intents:
- Target an Orchestrated campaign audience from an external CSV or TXT file without ingesting it into Adobe Experience Platform.
- Define column mappings, data types, NULL handling, and error-processing policies for the file structure.
- Create a File-type target dimension to resolve recipients from an uploaded file.
- Create a channel configuration for file-based delivery.
- Configure the sample file and the target file for the Load file activity.
- Connect the Load file activity to downstream message activities on the campaign canvas.
Glossary:
- Load file activity: a Data Management activity used to work with profiles and data stored in an external file on the Orchestrated campaign canvas to define the campaign audience (product-specific)
- File-type target dimension: a Profile Target Dimension with Dimension source set to File, letting Orchestrated campaigns resolve recipients from an uploaded file instead of an Adobe Experience Platform schema (product-specific)
- Sample file: the file used to configure Columns and Formatting for the Load file activity; its data is not imported as the campaign audience (product-specific)
- Target file: the CSV or TXT file containing the audience to target, loaded when the campaign runs (product-specific)
- Reject management: the Load file activity settings that define how the activity behaves when errors occur during file processing (product-specific)
Guardrails:
- You can upload up to 50 MB per file.
- Only flat-structure CSV and TXT files are supported.
- Uploaded data is used when the campaign runs and is not stored as an Adobe Experience Platform dataset.
- The Load file activity is not meant to be used in a scheduled campaign, because uploaded files have a short data lifetime.
- Standard profile-based channel configurations do not work with a file-based audience; use a channel configuration that targets the File-type dimension for any message activity that follows a Load file activity.
- The identity namespace and identity field path for a File-type target dimension cannot be changed after the target dimension is saved.
Prerequisites and permissions:
- Users must be assigned the Manage File in Orchestrated Campaigns permission to use the Load file activity in an Orchestrated campaign.
- A Profile Target Dimension of type File must be created, from Administration > Configurations > Campaign Target Dimension, before the Load file activity can resolve recipients from an uploaded file.
- A channel configuration that uses the File-type target dimension (enabled for Orchestrated campaigns under Execution details) must be created for the message activity that follows the Load file activity.
Applicability:
- Does not apply to: Healthcare Shield (the Load file activity is currently not available for use with it).
Terminology:
- Canonical name: Load file activity — variants: Load file
- Synonyms: none
- Do not confuse: “sample file” (used to configure columns and formatting; its data is not imported as the campaign audience) ≠ “target file” (the file loaded as the campaign audience when the campaign runs)
FAQ:
- Q: What is the Load file activity used for? — It is a Data Management activity used to work with profiles and data stored in an external file to define an Orchestrated campaign audience, without ingesting the file into Adobe Experience Platform.
- Q: Is the uploaded file stored in Adobe Experience Platform? — No, uploaded data is used when the campaign runs and is not stored as an Adobe Experience Platform dataset.
- Q: What permission is required to use the Load file activity? — The Manage File in Orchestrated Campaigns permission.
- Q: What must be set up before using the Load file activity? — A File-type Profile Target Dimension and a channel configuration that targets that dimension.
- Q: Can the Load file activity be used in a scheduled campaign? — It is not meant to be used in a scheduled campaign, because uploaded files have a short data lifetime.
- Q: Is the Load file activity available with Healthcare Shield? — No, it is currently not available for use with Healthcare Shield.
Examples:
- Value remapping on a column can replace
True/Falsewith1/0. - A Date column can use the date format
yyyy/mm/dd. - The identity field path for a File-type target dimension can be
email, if the uploaded files include anemailcolumn.
Best practices:
- Ensure the target file follows the same format, column structure, and number of columns as the sample file.
Related pages:
- For limits on channel and canvas activities: Guardrails and limitations (orchestrated/guardrails.md)
- For assigning the Manage File in Orchestrated Campaigns permission: Manage users and roles (administration/permissions.md)
- For creating the File-type target dimension: Learn more about target dimensions (orchestrated/target-dimension.md)
- For creating the channel configuration used after a Load file activity: Learn more about channel configurations for Orchestrated campaigns (orchestrated/channel-config.md)
- For connecting the Load file activity to downstream activities: Learn how to orchestrate campaign activities (orchestrated/orchestrate-activities.md)
Personas:
- marketer: Can target an Orchestrated campaign audience from an external CSV or TXT file without ingesting it into Adobe Experience Platform. Can configure column mappings, data types, NULL handling, and error-processing policies, then select the target file to load when the campaign runs. The page states that files can be up to 50 MB and only flat-structure CSV and TXT files are supported. Where: “Configure the Load file activity”.
Onboarding:
- Level: Intermediate
- First minimal step: Add a Load file activity to your Orchestrated campaign canvas.
- Success check: Rows that fail validation are rejected and logged before the campaign runs.
- Previous: Create a File-type target dimension before adding the Load file activity: Create your Targeting dimension (orchestrated/target-dimension.md); Create a channel configuration for file-based delivery before connecting a message activity: Configure your Channel configuration (orchestrated/channel-config.md)
- Next: Connect the Load file activity to downstream activities on the campaign canvas: Create Orchestrated campaigns with Adobe Journey Optimizer (orchestrated/orchestrate-activities.md)