在此頁面上:瞭解如何使用載入檔案資料管理活動,在執行時從外部CSV或TXT檔案鎖定協調的行銷活動對象,而不將檔案擷取到Adobe Experience Platform。
載入檔案活動是一項 資料管理 活動。 使用它來處理儲存在外部檔案中的設定檔和資料。 如果您的收件者清單來自外部系統(例如,CRM匯出或合作夥伴檔案),而且您想要執行行銷活動而不先建置完整的Adobe Experience Platform擷取管道,則它在協調的行銷活動中支援檔案型鎖定目標。
在檔案設定期間,您可以定義欄對應、資料型別、NULL處理和每欄錯誤原則。 未通過驗證的列會在行銷活動執行前遭到拒絕並記錄,讓對象保持乾淨,無需手動預先處理。
權限 permissions
若要在協調的行銷活動中使用 載入檔案 活動,必須指派正確的許可權給使用者。 這兩個許可權都可在許可權UI中的Adobe Experience Platform > Adobe Journey Optimizer > 協調的行銷活動下使用。
- 在協調的行銷活動中檢視檔案 — 授予唯讀存取權。 具有此許可權的使用者可以在包含 載入檔案 活動的協調行銷活動上預覽結果,但無法新增活動或上傳檔案。
- 在協調的行銷活動中管理檔案 — 需要將 載入檔案 活動新增至行銷活動畫布並上傳檔案。 將此許可權指派給需要建立或設定 載入檔案 活動的使用者。
如需指派許可權的指示,請參閱管理使用者和角色。
護欄與限制 limitations
下列限制適用於載入檔案活動:
- 每個檔案最多可上傳50 MB。
- 僅支援平面結構的CSV和TXT檔案。
- 行銷活動執行時會使用上傳的資料,而不會儲存為Adobe Experience Platform資料集。
如需頻道和畫布活動的限制,請參閱護欄和限制。
先決條件 prerequisites
管理員必須先完成下列一次性設定,您才能將 載入檔案 活動新增至已協調的行銷活動並連線至訊息活動。
建立檔案型別目標維度 file-target-dimension
型別 檔案 的 設定檔目標Dimension 可讓協調的行銷活動從上傳的檔案而不是Adobe Experience Platform結構描述中解析收件者。 它會定義在行銷活動執行時處理檔案對象時使用的身分名稱空間和識別碼欄位。
從管理 > 設定 > 促銷活動目標Dimension建立目標維度。 深入瞭解目標維度
為檔案型鎖定目標建立目標維度時,請確定:
- 將 Dimension來源 設定為檔案。
- 選取與檔案中識別項資料行相符的身分識別名稱空間,例如電子郵件。
- 輸入識別欄位路徑。 使用包含識別碼的檔案欄位,例如,如果上傳的檔案包含
email欄,則為email。
建立檔案式傳送的通道設定 file-channel-configuration
建立使用檔案型別目標維度的專用通道設定。 此設定是在您的行銷活動畫布中的 載入檔案 活動之後的訊息活動中選取。
-
瀏覽至管理 > 管道 > 管道設定,然後建立新的設定。
-
在 執行詳細資料 下,選取 協調的行銷活動 索引標籤,並啟用協調行銷活動的設定。
-
在 設定檔目標Dimension 欄位中,選取在上一步中建立的檔案型別目標維度。
-
完成其餘通道設定欄位並儲存。 進一步瞭解協調行銷活動的管道設定
設定載入檔案活動 load-file-configuration
將活動設定為兩部分:使用範例檔案定義預期的檔案結構,然後指定行銷活動執行時要載入的檔案。
-
新增 載入檔案 活動至您的協調行銷活動畫布。
-
輸入活動的標籤。
定義範例檔案 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)。 -
分隔符號:
- 年、月、日 — 年、月和日元件之間的字元(例如,
/)。
- 年、月、日 — 年、月和日元件之間的字元(例如,
時間
-
時間格式 — 符合時間在檔案中顯示方式的模式(例如,
13:30表示24小時與分鐘)。 -
分隔符號:
- 小時、分鐘、秒 — 小時、分鐘和秒元件之間的字元(例如,
:)。
- 小時、分鐘、秒 — 小時、分鐘和秒元件之間的字元(例如,
日期和時間
- 日期格式 — 與檔案中日期部分的顯示方式相符的模式。
- 時間格式 — 符合時間部分在檔案中顯示方式的模式。
- 分隔符號 — 日期與時間元件之間的字元。
-
-
在 格式 區段中,指定檔案的結構方式,以便在行銷活動執行時正確讀取列和欄。 目標檔案必須使用與範例檔案相同的格式。
- 使用第一行做為資料行標題 — 選取時,會將檔案的第一行視為資料行名稱。 從包含標頭列的檔案設定範例時,通常會啟用此選項。
- 使用行號作為識別碼 — 選取時,每個資料列都會以其在檔案中的行號識別。
- 記錄跨越多行 — 選取時,單一記錄可跨越檔案中的多行(例如,當欄位包含分行符號時)。
- 要忽略的行數 — 讀取資料之前,在檔案開頭要略過的行數(例如,註解或中繼資料行)。
- 時區 — 匯入日期和時間值時套用的時區。
- 編碼 — 檔案的字元編碼。 選取符合您來源檔案的編碼。
- 字串分隔符號 — 用來在檔案中括住字串值的字元。
- 欄分隔符號 — 分隔檔案中欄的字元。
-
按一下 確認 以驗證範例檔案組態。
定義目標檔案 target-file
指定要在行銷活動執行時載入的檔案,以及每一列如何與現有收件者比對。
-
在 目標檔案 區段中,選取包含目標對象的CSV或TXT檔案。
note caution CAUTION 確保目標檔案遵循與範例檔案相同的格式、欄結構和欄數。 -
在 拒絕管理 區段中,定義檔案處理期間發生錯誤時活動的行為:
- 允許的錯誤數 — 活動失敗之前允許的錯誤數上限。
- 將拒絕專案保留在檔案中 — 啟用時,無法載入的資料列會寫入伺服器上的拒絕檔案,以供執行後檢閱。
-
選擇性地啟用匯入後刪除檔案,以在行銷活動執行後從伺服器移除上傳的檔案。
在 載入檔案 解析對象之後,將輸出轉變連線到下游活動。 了解如何協調行銷活動