關於Customer Attributes的資料檔案和資料來源

上傳Customer Attributes至Experience Cloud的資料檔案需求和多個資料來源。

您需要存取企業的 CRM 或類似資料。您上傳至Experience Cloud的資料必須是.csv檔案。 如果透過 FTP 或 sFTP 上傳,也要上傳 .fin 檔案。

Customer Attributes的設計每天處理一些檔案。 為減緩許多小型檔案延遲處理的問題,系統會將來自相同組織的上一批 30 分鐘內傳送的檔案轉送至優先順序較低的佇列。

允許的檔案類型和命名需求 section_6F64FA02ACCC4215B0862CB6A1821FBF

檔案類型
說明
.csv

逗號分隔值檔案 (例如在 Excel 中建立的檔案)。此檔案包含客戶屬性資料。

命名需求: 請確定副檔名不包含空格。

.fin

(必要) .fin 檔案會告訴系統您已完成上傳資料。.fin 檔案的名稱必須和 .csv 檔案的名稱相同。

Adobe 建議您建立副檔名為 .fin 的空白文字檔。空白檔案可節省空間和上傳時間。

注意:.fin檔案上傳後不可重新命名。.fin 檔案必須另外上傳,且不能將先前上傳的檔案重新命名。

您以客戶屬性 FTP 上傳 .fin 檔案後,系統會迅速擷取資料 (約一分鐘內)。這一點優於其他 Adobe FTP 型服務,後者擷取資料的頻率較低 (大約每一小時一次)。

若使用拖放上傳方法,則不需要 .fin 檔案。

.gz 或 .zip

.gz (gzip) 或 .zip - 適用於壓縮檔。.zip 檔案的封存不可包含超過一個檔案。

命名需求:.zip 或 .gz 的名稱應該與 .csv 的名稱相同。例如,若您的 .csv 檔案是 crm_small.csv,則 .zip 檔案應該是 crm_small.csv.zip。

.fin 檔案的名稱必須和 .csv 檔案的名稱相同。

屬性資料檔案的需求 section_169FBF5B7BBA47CE825B7A330CF3FE98

範例 CSV

CSV 檔案必須符合下列格式:

屬性資料檔案的需求

在文字編輯器中檢視的相同檔案:

屬性資料檔案的需求

準則

項目
說明
拖放

拖放檔案應小於 100 MB。

若使用拖放上傳方法,則不需要 .fin 檔案。

客戶 ID 欄

第一欄必須是不重複的客戶 ID。使用的 ID 應該對應至傳遞到 Experience Cloud ID Service 的 ID。

若使用 Analytics,ID 會儲存在 prop 或 eVar 中。

若為Target,則為setCustomerID值。

此客戶 ID 是您的 CRM 針對資料庫中每個人使用的不重複識別碼。其餘欄是來自您 CRM 的屬性。您需選擇要上傳的屬性數量。

建議欄標題使用好記的可讀名稱,但並不強制要求。上傳後驗證結構時,可以將易記名稱對應到已上傳的列和欄。

關於客戶 ID

企業一般會使用來自 CRM 系統的客戶 ID。這個 ID 是在有人登入時使用 setCustomerIDs 呼叫設定的。在上傳至Experience Cloud的CRM檔案中,此ID也會當作索引鍵使用。 別名 ID 是 Audience Manager 中資料存放區的易記名稱,用於儲存別名資料。系統會將別名傳送至此資料存放區 (透過 setCustomerIDs)。CRM 檔案會套用至該資料存放區中的資料。

如需 setCustomerIDs 相關資訊,請參閱客戶 ID 和驗證狀態

後續標題和欄

後續標題應代表每個屬性的名稱。

這些欄應包含 CRM 的客戶屬性。

屬性數限制

您可以上傳數百欄 .csv 至Experience Cloud的客戶屬性服務。 但是在設定訂閱及選取屬性時,系統將套用以下限制 (視您擁有的應用程式而定):

  • Analytics Standard:共 3 個
  • Analytics Premium:每一報表套裝 200 個
  • Adobe Target Standard: 5 個
  • Adobe Target Premium: 200 個
列數限制
列數並無已知限制。
欄數限制
為顧及實用性,請將欄數限制在 200 欄左右。
字元數限制
建立 Analytics 訂閱時,會將已上傳檔案的欄位長度截斷為 255。
FTP 准則和大小限制
  • FTP 的檔案大小上限為每次上傳 4 GB。
  • 檔案大小下限為每次上傳 10 MB。
  • 您可以每隔半小時上傳一個檔案。
  • 您應將 .csv (和 .fin) 檔案拖放到 FTP 網站的根資料夾中。

重要:FTP 帳戶的允許空間總計為 40 GB。您有責任刪除已處理的檔案。

檔案需求

每個屬性來源都應包含相同數目的逗號分隔欄位。

包含分行符號、雙引號或逗號的欄位必須加上引號。

欄位中的雙引號字元必須使用反斜線 (\) 逸出。

空白欄會儲存為 null 。

多個檔案

上傳客戶屬性資料時,如果您想要連續快速上傳多個檔案,尤其是如果檔案很大,請先確認上一個檔案已處理完畢,然後再上傳下一個檔案。您可查看上一個檔案是在何時移至客戶屬性 FTP 帳戶內的已處理或失敗資料夾,藉此監控進度。

如果您將大型檔案分割為較小的檔案並連續快速地提交這些檔案,除非您可確保每個檔案都處理完畢,然後再提交下一個檔案,否則實際上會讓處理速度變慢。

字元編碼
在日本,需強制使用 UTF-8。
歷史資料

客戶屬性會繫結至 Analytics 中的基礎訪客設定檔。因此在 Analytics 中,該訪客設定檔的整個生命週期中,客戶屬性 都會與該訪客相關聯。此個人資料包括客戶首次登入前發生的行為。

如果您使用 Data Warehouse 回填方法,資料會連結至以 Analytics ID (AID) 為基礎的 post_visid_high/low。如果您使用 Experience Cloud ID Service,資料會繫結至以 Experience Cloud ID (MID) 為基礎的 post_visid_high/low。

請注意,自2022年10月起,將不再提供Data Warehouse回填方法。

資料摘要
資料摘要中無法使用客戶屬性。

使用多項資料來源 section_76DEB6001C614F4DB8BCC3E5D05088CB

建立、修改或刪除客戶屬性來源時,大約會有一小時的延遲,之後 ID 就會開始與新資料來源同步。

每個客戶屬性來源的別名 ID 必須是唯一 ID。如果您有多個資料來源使用相同的 ID,則應依照下列方式設定:

在 VisitorAPI.js 中或 Dynamic Tag Management 的 Experience Cloud ID 工具中:

設定兩個客戶 ID 以便對應至適當的資料來源:

Visitor.setCustomerIDs({
     "ds_id1":"123456",
     "ds_id2":"123456"
});

(如需詳細資訊,請參閱客戶 ID 和驗證狀態)。

Experience Cloud > People > 客戶屬性 ​中:

使用與上述客戶 ID 對應的不重複別名 ID,建立兩個客戶屬性來源。使用此方法可將相同的參考 ID 傳送至多個客戶屬性來源。

recommendation-more-help
872fc4ed-f5f7-4b59-a6f8-4ddabe5aac1f