匯入資料

如何收集資料

使用清單中的資料：讀取清單

在工作流中發送的資料可以來自清單，其中資料已事先準備並結構化。

此清單可能是直接在Adobe Campaign中建立或由​Import a list​選項匯入。 有關此選項的詳細資訊，請參閱此頁。

有關在工作流中使用讀清單活動的詳細資訊，請參閱讀清單。

從檔案載入資料

在工作流程中處理的資料可以從結構化檔案中擷取，以便匯入Adobe Campaign。

在資料載入（檔案）區段中可找到載入資料活動的說明。

要導入的結構化檔案示例：

lastname;firstname;birthdate;email;crmID
Smith;Hayden;23/05/1989;hayden.smith@example.com;124365
Mars;Daniel;17/11/1987;dannymars@example.com;123545
Smith;Clara;08/02/1989;hayden.smith@example.com;124567
Durance;Allison;15/12/1978;allison.durance@example.com;120987

匯入資料時的最佳實務

謹慎並遵循下面詳述的幾個簡單規則，將有助於確保資料庫內的資料一致性，並避免在資料庫更新或資料匯出期間發生常見錯誤。

使用導入模板

大部分的匯入工作流程應包含下列活動：Data loading (file)、Enrichment、Split、Deduplication、Update data。

使用匯入範本可讓您非常方便地準備類似的匯入，並確保資料庫中的資料一致性。 瞭解如何在Workflow templates區段中建立工作流程範本。

在許多項目中，導入是在沒有​Deduplication​活動的情況下構建的，因為項目中使用的檔案沒有重複項。 有時會從匯入不同的檔案中顯示重複項目。 因此，消除重複就很困難。 因此，重複資料消除步驟是所有導入工作流中的良好預防措施。

切勿假設傳入的資料是一致且正確的，或IT部門或Adobe Campaign主管負責處理。 在專案期間，請牢記資料清理。 在匯入資料時，可以消除重複資料、進行協調並維持一致性。

設定循環匯入區段中提供匯入範本範例。

使用平面檔案格式

匯入時最有效的格式是平面檔案。 平面檔案可以在資料庫級別以批量模式導入。

例如：

• 分隔符號：制表符或分號
• 首行含標題
• 無字串分隔字元
• 日期格式：YYYY/MM/DD HH:mm:SS

Adobe Campaign無法使用標準檔案匯入活動匯入XML檔案。 您可以使用JavaScript匯入XML檔案，但只能使用小卷：每個檔案的記錄不到10K。

使用壓縮和加密

盡可能使用壓縮檔案進行匯入和匯出。

在Linux上，可以使用命令行解壓縮檔案並同時導入。 例如：

zcat nl6/var/vp/import/filename.gz

如果檔案不安全，則最好對通過網路發送的檔案進行加密。 GPG可以用於此。

從檔案中批次載入資料

從檔案批次載入資料比一次並即時載入一行資料（例如透過Web服務）更有效。

使用Web services匯入並不有效率。 最好盡可能使用檔案。

呼叫外部Web服務以即時豐富描述檔也會造成效能問題和記憶體流失，因為它可在行層級運作。

如果您需要匯入資料，最好是使用工作流程批次執行，而非使用Web應用程式或Web服務即時執行。

使用資料管理

使用JavaScript以迭代模式（逐行）載入時，應限制為小卷。

為提高效率，請務必在資料管理工作流程中使用​Data Loading (File)​活動。

在增量模式下導入

常規導入必須在delta模式下完成。 這表示每次只會傳送已修改或新資料至Adobe Campaign，而非整個表格。

完整匯入應僅用於初始載入。

使用資料管理而非JavaScript匯入資料。

維持一致性

若要維持Adobe Campaign資料庫中的資料一致性，請遵循下列原則：

• 如果匯入的資料與Adobe Campaign中的參考表格相符，則應與工作流程中的該表格協調。 不應拒絕不符合的記錄。

• 請確定匯入的資料一律是​「已標準化」（電子郵件、電話號碼、直接郵件位址），且此標準化是可靠的，多年內不會變更。 如果不是這樣，有些復本可能會出現在資料庫中，而Adobe Campaign不提供進行「模糊」比對的工具，因此很難管理和移除它們。

• 事務性資料應具有協調密鑰，並與現有資料協調以避免建立重複資料。

• 依順序匯入相關檔案。

  如果匯入由多個彼此依存的檔案組成，工作流程應確保檔案的匯入順序正確。 檔案失敗時，不會導入其他檔案。

• 匯入資料​時，可以消除重複資料、進行協調並維持一致性。

使用案例：設定循環導入

如果您需要定期匯入具有相同結構的檔案，請使用匯入範本是最佳做法。

此範例說明如何預先設定可重複用於匯入來自Adobe Campaign資料庫中CRM的設定檔的工作流程。 有關每個活動的所有可能設定的詳細資訊，請參閱此部分。

1. 從​Resources > Templates > Workflow templates​建立新的工作流程範本。

2. 新增下列活動：

   • Data loading (file):定義包含要導入資料的檔案的預期結構。
   • Enrichment:協調導入的資料與資料庫資料。
   • Split:根據記錄是否可以調節，建立篩選器以不同方式處理記錄。
   • Deduplication:在將傳入檔案插入資料庫之前，先從該檔案中消除重複資料。
   • Update data:使用導入的配置檔案更新資料庫。

   

3. 配置​Data Loading (file)​活動：

   • 上傳範例檔案以定義預期的結構。 範例檔案應僅包含幾行，但是導入時需要的所有列。 檢查並編輯檔案格式，以確保每列的類型設定正確：文字、日期、整數等。 例如：

     lastname;firstname;birthdate;email;crmID
     Smith;Hayden;23/05/1989;hayden.smith@mailtest.com;123456
     

   • 在​Name of the file to load​區段中，選擇​Upload a file from the local machine​並將欄位留空。 每次從此模板建立新工作流時，您都可以在此處指定所需的檔案，只要該檔案與定義的結構相對應。

     您可以使用任何選項，但必須相應修改模板。 例如，如果您選擇​Specified in the transition，則可以先添加​File Transfer​活動，然後再檢索要從FTP/SFTP伺服器導入的檔案。 有了S3或SFTP連線，您也可以使用Adobe即時客戶資料平台，將區段資料匯入Adobe Campaign。 有關詳細資訊，請參閱文檔。

     

4. 設定​Enrichment​活動。 此活動的目的是識別傳入的資料。

   • 在​Enrichment​標籤中，選擇​Add data​並定義匯入資料與收件者定位維度之間的連結。 在此範例中，CRM ID​自訂欄位用於建立連結條件。 只要您需要欄位或欄位組合，就能識別唯一記錄。
   • 在​Reconciliation​標籤中，保留​Identify the document from the working data​選項未選中。

   

5. 設定​Split​活動，以擷取一個轉場中已協調的收件者，以及在第二個轉場中無法協調但擁有足夠資料的收件者。

   然後，可以使用與已調節的收件人之間的轉換來更新資料庫。 然後，如果檔案中有一組最小資訊，則與未知收件人的轉換可用於在資料庫中建立新收件人條目。

   無法協調且沒有足夠資料的收件者會在補充的對外轉場中選取，並可匯出成個別檔案或略過。

   • 在活動的​General​標籤中，選擇​Use the additional data only​作為篩選設定，並確保​Targeting dimension​自動設定為​Enrichment。

     選中​Generate complement​選項，可查看是否無法在資料庫中插入任何記錄。 如果需要，您可以對補充資料套用進一步的處理：檔案匯出、清單更新等。

   • 在​Subsets​標籤的第一個子集中，在入站人口中添加過濾條件，以僅選擇收件者主鍵不等於0的記錄。 這樣，在該子集中選擇與資料庫收件人協調的檔案資料。

     

   • 添加第二個子集，選擇具有足夠資料要插入到資料庫中的未協調記錄。 例如：電子郵件地址、名字和姓氏。

     子集按其建立順序進行處理，這意味著當處理此第二子集時，已存在於資料庫中的所有記錄都已在第一子集中選擇。

     

   • 在​Complement​中選擇前兩個子集中未選擇的所有記錄。

6. 配置位於先前配置的​Split​活動首次出站轉移後的​Update data​活動。

   • 選擇​Update​作為​Operation type ，因為入站過渡僅包含資料庫中已存在的收件人。

   • 在​Record identification​區段中，選擇​Using reconciliation keys​並定義定位維度與在​Enrichment​中建立的連結之間的索引鍵。 在此範例中，會使用​CRM ID​自訂欄位。

   • 在​Fields to update​節中，指定收件者維中的欄位，以使用檔案中相應列的值進行更新。 如果檔案列的名稱與收件人維欄位的名稱相同或幾乎相同，則可以使用魔術棒按鈕自動匹配不同的欄位。

     

7. 配置位於包含未協調收件者之轉場後的​Deduplication​活動：

   • 選擇​Edit configuration，並將定位維設定為從工作流的​Enrichment​活動生成的臨時方案。

     

   • 在此範例中，電子郵件欄位可用來尋找獨特的描述檔。 您可以使用任何您確定已填入的欄位，以及唯一組合的一部分。

   • 在​Deduplication method​螢幕中，選擇​Advanced parameters​並選中​Disable automatic filtering of 0 ID records​選項，以確保未排除主鍵等於0的記錄（這應是此轉換的所有記錄）。

   

8. 配置位於先前配置的​Deduplication​活動之後的​Update data​活動。

   • 選擇​Insert​作為​Operation type ，因為入站過渡僅包含資料庫中不存在的收件人。

   • 在​Record identification​節中，選擇​Directly using the targeting dimension​並選擇​Recipients​維。

   • 在​Fields to update​節中，指定收件者維中的欄位，以使用檔案中相應列的值進行更新。 如果檔案列的名稱與收件人維欄位的名稱相同或幾乎相同，則可以使用魔術棒按鈕自動匹配不同的欄位。

     

9. 在​Split​活動進行第三次轉換後，如果要跟蹤未插入資料庫的資料，請添加​Data extraction (file)​活動和​File transfer​活動。 設定這些活動，以匯出您需要的欄，並在FTP或SFTP伺服器上傳輸檔案，您可在其中擷取該欄。

10. 新增​End​活動並儲存工作流程範本。

範本現在可以使用，而且適用於每個新的工作流程。 然後，需要全部指定包含要在​Data loading (file)​活動中導入的資料的檔案。

在處理之前解壓縮或解密檔案

關於預處理階段

Adobe Campaign可讓您匯入壓縮或加密的檔案。 在資料載入（檔案）活動中讀取之前，您可以先定義預先處理來解壓縮或解密檔案。

若要這麼做：

1. 使用控制面板來產生公用／私用金鑰對。

   注意

   控制面板適用於AWS托管的所有客戶（現場托管其行銷實例的客戶除外）。

2. 如果您的Adobe Campaign安裝是由Adobe代管，請聯絡Adobe客戶服務，以便在伺服器上安裝必要的公用程式。

3. 如果您的Adobe Campaign安裝是內部部署，請安裝您要使用的公用程式(例如：GPG、GZIP)以及應用程式伺服器上的必要金鑰（加密金鑰）。

然後，您就可以在工作流程中使用所需的預處理命令：

1. 在工作流程中新增及設定​File transfer​活動。
2. 新增​Data loading (file)​活動並定義檔案格式。
3. 核取 Pre-process the file 選項。
4. 指定要套用的預處理命令。
5. 新增其他活動以管理來自檔案的資料。
6. 儲存並執行您的工作流程。

在下面的使用案例中提供了示例。

相關主題：

• 資料載入（檔案）活動。
• 壓縮或加密檔案。

使用案例：導入使用控制面板生成的密鑰加密的資料

在此使用案例中，我們將建立工作流程，以便使用「控制面板」中產生的金鑰，匯入在外部系統中加密的資料。

在影片中探索此功能

執行此使用案例的步驟如下：

1. 使用「控制面板」產生金鑰對（公開／私用）。 控制面板文檔中提供了詳細步驟。

   • 公開金鑰將會與外部系統共用，外部系統會使用它來加密要傳送至Campaign的資料。
   • Campaign Classic將使用私密金鑰解密傳入的加密資料。

   

2. 在外部系統中，使用從「控制面板」下載的公開金鑰來加密要匯入Campaign Classic的資料。

3. 在Campaign Classic中，建立工作流程以匯入加密資料，並使用透過控制面板安裝的私密金鑰加以解密。 為此，我們將建立以下工作流程：

   

   • File transfer 活動：將檔案從外部來源傳輸至Campaign Classic。在此範例中，我們要從SFTP伺服器傳輸檔案。
   • Data loading (file) 活動：將檔案中的資料載入到資料庫中，然後使用「控制面板」中生成的專用密鑰對其進行解密。

4. 開啟​File transfer​活動，然後指定您要從中匯入加密。gpg檔案的外部帳戶。

   

   有關如何配置活動的全局概念，請參閱本節。

5. 開啟​Data loading (file)​活動，然後根據您的需求進行設定。 有關如何配置活動的全局概念可在本節中獲得。

   將預處理階段添加到活動中，以便解密傳入資料。 要執行此操作，請選擇​Pre-process the file​選項，然後在​Command​欄位中複製並貼上此解密命令：

   gpg --batch --passphrase passphrase --decrypt <%=vars.filename%>

   

   注意

   在此示例中，我們使用「控制面板」預設使用的密碼短語，即「密碼短語」。

   如果您過去透過客戶服務要求在實例上安裝了GPG金鑰，密碼短語可能已變更，而且依預設會與密碼短語不同。

6. 按一下​OK​確認活動配置。

7. 您現在可以執行工作流程。 執行完該操作後，您可以簽入工作流日誌，確認已執行解密，且已導入檔案中的資料。

   

教學課程影片

本視訊說明如何使用GPG金鑰解密資料。

其他Campaign Classic操作視訊可在這裡取得。