このページでは、 「ファイルを読み込み」データ管理アクティビティを使用して、ファイルをAdobe Experience Platformに取り込まずに、実行時に外部CSVまたはTXT ファイルからオーケストレーションされたキャンペーンオーディエンスをターゲットにする方法を説明します。
ファイルを読み込みアクティビティは、データ管理アクティビティです。 外部ファイルに保存されているプロファイルとデータを操作する場合に使用します。 受信者リストが外部システム（CRM書き出しやパートナーファイルなど）から取得され、最初に完全なAdobe Experience Platform取り込みパイプラインを構築せずにキャンペーンを実行する場合、オーケストレーションされたキャンペーンで ファイルベースのターゲティング がサポートされます。
ファイルの設定時に、列のマッピング、データタイプ、NULL処理、列ごとのエラーポリシーを定義できます。 検証に失敗した行は、キャンペーンが実行される前に却下され、ログに記録されます。これにより、手作業による事前処理なしでオーディエンスをクリーンに保つことができます。
権限 permissions
オーケストレーションされたキャンペーンでファイルを読み込み アクティビティを使用するには、ユーザーに適切な権限を割り当てる必要があります。 両方の権限は、権限UIのAdobe Experience Platform > Adobe Journey Optimizer > オーケストレーションされたキャンペーンで使用できます。
- オーケストレーションされたキャンペーンでファイルを表示 – 読み取り専用アクセス権を付与します。 この権限を持つユーザーは、ファイルを読み込み アクティビティを含むオーケストレーションされたキャンペーンの結果をプレビューできますが、アクティビティを追加したりファイルをアップロードしたりすることはできません。
- オーケストレーションされたキャンペーンでファイルを管理 — ファイルを読み込み アクティビティをキャンペーンキャンバスに追加し、ファイルをアップロードするために必要です。 この権限は、ファイルの読み込み アクティビティを作成または設定する必要があるユーザーに割り当てます。
権限の割り当て方法については、 ユーザーと役割の管理を参照してください。
ガードレールと制限 limitations
ファイルをロード アクティビティには、次の制限が適用されます。
- 1つのファイルにつき最大50 MBまでアップロードできます。
- フラット構造のCSV ファイルとTXT ファイルのみがサポートされます。
- アップロードされたデータは、キャンペーンの実行時に使用され、Adobe Experience Platform データセットとして保存されません。
チャネルとキャンバスのアクティビティに関する制限については、 ガードレールと制限を参照してください。
前提条件 prerequisites
オーケストレーションされたキャンペーンにファイルを読み込み アクティビティを追加してメッセージアクティビティに接続する前に、管理者は次の1回限りの設定を完了する必要があります。
ファイル形式のターゲットディメンションの作成 file-target-dimension
ファイル型の プロファイルターゲットDimension を使用すると、オーケストレーションされたキャンペーンは、Adobe Experience Platform スキーマではなく、アップロードされたファイルから受信者を解決できます。 キャンペーン実行時にファイルオーディエンスが処理されるときに使用されるID名前空間と識別子フィールドを定義します。
管理 > 設定 > Campaign Target Dimensionからターゲットディメンションを作成します。 ターゲットディメンションの詳細
ファイルベースのターゲティング用のターゲットディメンションを作成する場合は、次のことを確認してください。
- Dimension ソースを ファイル に設定します。
- ファイルのID列に一致する ID名前空間 を選択します（例：電子メール）。
- ID フィールドのパスを入力します。 アップロードしたファイルに
email列が含まれている場合は、識別子を含むファイルフィールド（例：email）を使用します。
ファイルベースの配信用のチャネル設定の作成 file-channel-configuration
ファイル形式のターゲットディメンションを使用する専用のチャネル設定を作成します。 この設定は、キャンペーンキャンバスのファイルの読み込み アクティビティに続くメッセージアクティビティで選択されます。
-
管理 > チャネル > チャネル設定に移動し、新しい設定を作成します。
-
「実行の詳細」で、「オーケストレーションされたキャンペーン」タブを選択し、オーケストレーションされたキャンペーンの設定を有効にします。
-
「プロファイルターゲットDimension」フィールドで、前の手順で作成したファイルタイプのターゲットディメンションを選択します。
-
残りのチャネル設定フィールドに入力して保存します。 オーケストレーションされたキャンペーンのチャネル設定について詳しく見る
「ファイルを読み込み」アクティビティの設定 load-file-configuration
2つの部分でアクティビティを設定します。サンプルファイルで想定されるファイル構造を定義し、キャンペーンの実行時に読み込むファイルを指定します。
-
オーケストレーションされたキャンペーンキャンバスにファイルを読み込み アクティビティを追加します。
-
アクティビティの ラベル を入力します。
サンプルファイルの定義 sample-file
サンプルファイルを使用して、列と 書式設定 を設定します。 サンプルデータは、キャンペーンオーディエンスとして読み込まれません。
-
「サンプルファイル」セクションで、想定される構造を定義するローカルファイルを選択します。
note NOTE サンプルファイルは、列と書式のみを設定するために使用され、そのデータはキャンペーンオーディエンスとして読み込まれません。 形式は、キャンペーンの実行時に読み込むファイルと一致する必要があります。 -
「ファイルタイプ」ドロップダウンで、ファイルで 区切り列 または 固定幅の列 を使用するかどうかを指定します。
-
列 セクションで、各列を展開し、そのプロパティを設定します。
データタイプを選択すると、そのタイプに追加のオプションが表示されます。 すべての列に共通するパラメーターとタイプ固有のオプションについては、以下のセクションを展開してください。
accordion 共通の列パラメーター -
列を無視 – 選択した場合にインポートから列を除外します。
-
Label – 列の表示名（例：
email）。 -
内部名 — ファイル ヘッダーから派生した列のシステム名（読み取り専用）。
-
Data type – 列のデータのタイプ。
-
Allow NULLs – 列の空の値の管理方法を指定します。
- Adobe Campaign default – 数値フィールドに対してのみエラーが発生します。 それ以外の場合はNULL値を挿入します。
- 空の値を許可 – 空の値を許可します。 したがって、null 値が挿入されます。
- Always populated – 値が空の場合にエラーを生成します。
-
エラー処理 – 列でエラーが発生した場合の動作を定義します。
- 値を無視 – 値は無視されます。
- 行を却下 – 行全体が処理されません。
- エラーの場合はデフォルト値を使用 — エラーの原因となる値を、デフォルト値 フィールドで定義されたデフォルト値に置き換えます。
- 値が再マッピングされない場合は、デフォルト値を使用します – 誤った値にマッピングが定義されていない限り、デフォルト値 フィールドで定義されているデフォルト値にエラーを引き起こす値を置き換えます。
- リマップ値がない場合は行を却下 – 誤った値にマッピングが定義されていない限り、行全体は処理されません。
-
デフォルト値 — エラー処理がデフォルト値を使用するように設定されている場合に使用するデフォルト値。
-
値の再マッピング – 特定の値を新しい値にマッピングします。 「マッピングを追加」をクリックして、各マッピングを定義します（例：
True/Falseを1/0に置き換えます）。
accordion 文字列列パラメーター - 幅 – 最大文字数。
- データ変換 – 文字列値に適用される大文字と小文字の変換（例：「なし」または「大文字/小文字」）。
- 空白の管理 – 文字列値の先頭または末尾のスペースを処理する方法。
accordion 整数列と浮動小数列のパラメーター -
形式 — ファイル内の数値の読み取り方法を定義します。
- その他 — 区切り記号 セクションの 千区切り記号 と 小数区切り記号 を定義します。
- 1,000.00 — コンマは千区切り記号、ピリオドは小数区切り記号です。
- 1 000,00 – 数千の区切り記号はスペース、小数点の区切り記号はコンマ。
-
区切り記号 （形式が その他 の場合）:
- 千区切り記号 – 数千を数値でグループ化する文字（使用しない場合は空のままにする）。
- 小数点区切り記号 – 数値の小数点以下桁に使用される文字（例：
,または.）。
accordion 日付と時刻の列パラメーター オプションは、データ型が日付、時刻または 日時 であるかどうかによって異なります。
日付
-
日付形式 — ファイル内での日付の表示方法に一致するパターン（
yyyy/mm/ddなど）。 -
区切り記号:
- 年、月、日 – 年、月、日のコンポーネント間の文字（
/など）。
- 年、月、日 – 年、月、日のコンポーネント間の文字（
時間
-
時間形式 — ファイル内に表示される時間に一致するパターン（例：
13:30、24時間および分）。 -
区切り記号:
- 時間、分、秒 – 時間、分、秒のコンポーネント間の文字（例：
:）。
- 時間、分、秒 – 時間、分、秒のコンポーネント間の文字（例：
日時
- 日付形式 — ファイル内での日付部分の表示方法に一致するパターン。
- 時刻の形式 — ファイル内での時刻の表示方法と一致するパターン。
- 区切り記号 – 日付と時刻のコンポーネント間の文字。
-
-
「フォーマット」セクションで、キャンペーンの実行時に行と列が正しく読み取られるように、ファイルの構造化方法を指定します。 ターゲットファイルは、サンプルファイルと同じフォーマットを使用する必要があります。
- 最初の行を列ヘッダーとして使用 – 選択すると、ファイルの最初の行は列名として扱われます。 このオプションは、通常、ヘッダー行を含むファイルからサンプルを設定する場合に有効になります。
- 行番号を識別子として使用 – 選択すると、各行がファイル内の行番号で識別されます。
- 複数の行にまたがるレコード – 選択すると、1つのレコードがファイル内の複数の行にまたがることができます（たとえば、フィールドに改行が含まれている場合）。
- 無視する行 — データが読み取られる前にファイルの先頭でスキップする行数（コメント行やメタデータ行など）。
- タイムゾーン – 日付と時刻の値が読み込まれたときに適用されるタイムゾーン。
- Encoding — ファイルの文字エンコーディング。 ソースファイルに一致するエンコーディングを選択します。
- 文字列区切り — ファイル内の文字列値を囲むために使用される文字。
- 列区切り記号 – 区切りファイル内の列を区切る文字。
-
「確認」をクリックして、サンプルファイル設定を検証します。
ターゲットファイルを定義 target-file
キャンペーンの実行時に読み込むファイルと、各行が既存の受信者に一致する方法を指定します。
-
「ターゲットファイル」セクションで、ターゲットとするオーディエンスを含むCSVまたはTXT ファイルを選択します。
note caution CAUTION ターゲットファイルが、サンプルファイルと同じ形式、列構造、列数に従っていることを確認します。 -
「管理を却下」セクションで、ファイル処理中にエラーが発生した場合のアクティビティの動作を定義します。
- 許可されるエラー数 — アクティビティが失敗する前に許可されるエラーの最大数。
- 却下をファイルに保持 – 有効にすると、読み込めなかった行は、実行後にレビューのためにサーバー上の却下ファイルに書き込まれます。
-
オプションで、インポート後にファイルを削除を有効にして、キャンペーンの実行後にアップロードしたファイルをサーバーから削除します。
ファイルを読み込みがオーディエンスを解決したら、アウトバウンドトランジションをダウンストリームアクティビティに接続します。 キャンペーンアクティビティの調整方法の詳細情報