このページ：ファイルを読み込みデータ管理アクティビティを使用して、ファイルを 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 ターゲットファイルが、サンプルファイルと同じ形式、列構造、列数に従っていることを確認してください。 -
「管理を却下」セクションで、ファイル処理中にエラーが発生した場合のアクティビティの動作を定義します。
- 許可されるエラー数 - アクティビティが失敗する前に許可されるエラーの最大数。
- ファイルに却下を保持 - 有効にすると、読み込めなかった行は、実行後にレビューのためにサーバー上の却下ファイルに書き込まれます。
-
オプションで、「インポート後にファイルを削除」を有効にすると、キャンペーンの実行後にアップロードされたファイルがサーバーから削除されます。
ファイルを読み込みがオーディエンスを解決したら、アウトバウンドトランジションをダウンストリームアクティビティに接続します。 キャンペーンアクティビティの調整方法の詳細情報