本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 匯入潛在客戶
<a name="lead-import"></a>

AWS Partner Central 中的**匯入潛在客戶**功能可讓您一次建立多個合作夥伴來源的潛在客戶。上傳 CSV 檔案以匯入您的潛在客戶。檔案中的每個有效資料列會透過 APN Customer Engagements (ACE) 程式建立一個潛在客戶。每個檔案最多可以匯入 100 個潛在客戶。

匯入後，您可以使用 AWS 參與訊號來充實您的潛在客戶，包括建議的動作和 AWS 洞察，例如 Marketplace 參與分數。使用這些洞見來排定推廣的優先順序，並找出最有可能轉換為機會的潛在客戶。

## CSV 範本
<a name="lead-import-csv-template"></a>

為了確保您的資料格式正確，請從**匯入潛在客戶**頁面下載 CSV 範本。範本包含 17 個資料欄。使用如下所示的確切資料欄標頭 - 系統會使用它們將您的資料映射至領導欄位。

### 必要欄位
<a name="lead-import-required-fields"></a>

下列是必要欄位。缺少任何這些欄位的資料列會失敗驗證，並顯示在失敗的記錄 CSV 中。


| 資料行 | 格式 | 說明 | 範例 | 
| --- | --- | --- | --- | 
| Company Name | 最多 120 個字元 | 客戶公司的法定名稱。此值也用於在 AWS Partner Central 中產生潛在客戶的顯示標題。 | Acme Corp | 
| Country | 預先定義的值 | 客戶位置的兩個字母國家/地區代碼，採用 ISO 3166-1 alpha-2 格式。程式碼必須符合其中一個接受的值。下載範本以取得完整清單。常見值：US、GB、DE、IN、JP、AU、CAFR、SG、、BR。 | US | 
| Contact Business Title | 最多 80 個字元 | 客戶公司主要聯絡人的職稱或角色。此欄位一律為必要 - 沒有業務標題的資料列失敗並顯示MISSING\_CONTACT錯誤。 | CTO, VP of Engineering | 
| Contact First Name | 最多 80 個字元 | 主要聯絡人的名字。每個聯絡人都需要名字、姓氏和電子郵件。 | Jane | 
| Contact Last Name | 最多 80 個字元 | 主要聯絡人的姓氏。 | Doe | 
| Contact Email | 有效的電子郵件格式，最多 80 個字元 | 聯絡人的商業電子郵件地址。必要，且 必須是有效的電子郵件格式 （例如 user@domain.com)。格式不正確的值會觸發INVALID\_EMAIL錯誤。 | jane.doe@acme.com | 

### 選填欄位
<a name="lead-import-optional-fields"></a>

下列欄位為您的潛在客戶提供額外的內容。如果資訊不可用，請保留空白。


| 資料行 | 格式 | 說明 | 範例 | 
| --- | --- | --- | --- | 
| Row Id | 正整數 | 每一列的唯一識別符。用於檔案內的重複資料刪除 – 如果兩列共用相同的 Row Id，則會略過第二列並顯示DUPLICATE\_ROW錯誤。未傳送至 AWS。 | 1, 2, 3 | 
| Street Address | 最多 255 個字元 | 客戶主要辦公室或據點的完整街道地址。 | 123 Main Street | 
| City | 最多 255 個字元 | 客戶的營運城市。 | Seattle | 
| State Or Region | 任意文字 | 國家/地區的州、省或區域。 | WA | 
| Postal Code | 最多 20 個字元 | 郵遞區號。 | 98101 | 
| Industry | 預先定義的值 | 客戶營運所在的產業垂直。如果提供， 必須與其中一個接受的值完全相符。如果不確定，請保留空白 - 無法辨識的值會觸發INVALID\_ENUM\_VALUE錯誤。接受的值：Aerospace、Agriculture、Automotive、Computers and Electronics、Consumer Goods、EducationEnergy - Oil and Gas、Energy - Power and UtilitiesFinancial Services、Gaming、、GovernmentHealthcareHospitality、Life Sciences、Manufacturing、Marketing and Advertising、、Media and Entertainment、MiningNon-Profit OrganizationOtherProfessional Services、、Real Estate and Construction、、、Retail、、、、Software and Internet、、、Telecommunications、Transportation and Logistics、Travel、、。 Wholesale and Distribution | Software and Internet | 
| Website Url | 4–255 個字元，URL 格式 | 客戶的公司網站 URL。必須是 4 到 255 個字元，並使用有效的 URL 格式 （例如 https://acme.com)。太短或非 URL 格式的值會導致資料列失敗。 | https://acme.com | 
| DUNS | 9 位數數字字串 | 客戶的 D-U-N-S 號碼，由 Dun & Bradstreet 發行的唯一商業識別符。用於硬式擴充和重複資料刪除。 | 123456789 | 
| Contact Phone | E.164 格式，最多 15 位數 | 主要聯絡人的電話號碼。必須遵循 E.164 國際格式：後接國碼和號碼的\+符號，不含空格或破折號。格式不正確的電話號碼會在建立潛在客戶API\_ERROR期間導致 。 | \+12065551234 | 
| Use Case | 任意文字，最多 255 個字元 | 與潛在客戶相關的 AWS 使用案例或工作負載的任意文字描述。此值不會根據固定值清單進行驗證。 | Migration and Transfer | 
| Business Problem | 20–2000 個字元 | 客戶核心業務挑戰或困擾點的說明。這有助於 AWS 了解潛在客戶的內容。如果提供，則 必須介於 20 到 2000 個字元之間。 | Legacy infrastructure modernization | 

## 匯入程序
<a name="lead-import-process"></a>

若要匯入潛在客戶，請導覽至 AWS Partner Central **中的潛在客戶**索引標籤，然後選擇**匯入潛在客戶**。匯入會執行下列步驟：

1. **選取您的檔案** — 選擇 CSV 檔案 （僅限 .csv 格式）。檔案必須包含 1 到 100 列的潛在客戶資料。如果檔案格式無效或超過資料列限制，**匯入潛在客戶**按鈕會保持停用狀態。

1. **資料欄映射** — 系統會驗證所有必要的範本資料欄標頭是否存在。如果缺少必要的資料欄，則會顯示下載**範本**按鈕的錯誤，以便您可以從正確的格式開始。

1. **驗證** — 會檢查每一列的必要欄位、資料格式、有效的列舉值和重複偵測。失敗驗證的資料列會收集到可下載的失敗記錄檔案中。如果所有資料列都失敗，系統會將您重新導向至含錯誤通知的潛在客戶頁面。

1. **潛在客戶建立** — 提交有效資料列以建立潛在客戶。您導覽至潛在客戶頁面，其中包含三個結果之一：
   + **成功** — 已成功建立所有資料列。
   + **部分成功** — 部分資料列已建立，但其他資料列失敗。提供**下載失敗的記錄**連結。
   + **錯誤** — 所有資料列失敗。提供**下載失敗的記錄**連結。

## 對匯入錯誤進行故障診斷
<a name="lead-import-errors"></a>

當資料列在匯入期間失敗時，您可以下載失敗的記錄 CSV 檔案，其中包含所有原始資料欄加上 `Error Code`和 `Error Message`資料欄。使用錯誤碼來識別和修正問題，然後僅重新上傳失敗的資料列。


| 錯誤碼 | 原因 | Resolution | 
| --- | --- | --- | 
| MALFORMED\_ROW | 資料列完全空白或僅包含空格。 | 移除空白資料列，或至少填入必要欄位。 | 
| MISSING\_COMPANY | Company Name 欄位為空。 | 新增有效的公司名稱。 | 
| MISSING\_COUNTRY | Country 欄位為空。 | 新增有效的 ISO 3166-1 alpha-2 國家/地區代碼 （例如，、USDE、JP)。 | 
| MISSING\_CONTACT | 其中一個必要的聯絡欄位為空白：Contact Business Title、Contact Last Name、 Contact First Name或 Contact Email。 | 提供聯絡人的業務標題、名字、姓氏和電子郵件。 | 
| INVALID\_EMAIL | Contact Email 值存在，但不是有效的電子郵件格式。 | 使用有效的電子郵件地址 （例如 jane.doe@acme.com)。 | 
| INVALID\_ENUM\_VALUE | Industry 或 Country值不符合接受的值。 | 對於 Industry（選用）：使用 CSV 範本中支援的值，或將欄位保留空白。對於 Country（必要）：將 取代為範本中有效的 ISO 3166-1 alpha-2 程式碼 US（例如，、DE、JP)。 | 
| DUPLICATE\_ROW | 該Row Id值已出現在相同檔案中的先前資料列中。 | 確保每一列都有唯一的 Row Id，或移除重複的資料列。 | 
| API\_ERROR | 資料列通過驗證，但潛在客戶建立請求失敗 （限流、伺服器錯誤或網路錯誤）。 | 等待幾分鐘，然後僅重新匯入失敗的資料列。如果問題仍然存在，請聯絡 AWS Partner Central Support。 | 

## 失敗的記錄 CSV
<a name="lead-import-failed-records"></a>

當匯入部分或完全失敗時，AWS Partner Central 會產生失敗的記錄 CSV 檔案，您可以從潛在客戶頁面上的**下載失敗的記錄**連結下載。此檔案包含未成功匯入的每個資料列，以及失敗的原因。

**檔案格式**  
失敗的記錄 CSV 包含所有原始的 17 個範本資料欄，您的資料會完全按照上傳的方式保留，加上在結尾附加的兩個額外資料欄： `Error Code`和 `Error Message`。資料列的顯示順序與原始檔案相同。

**驗證錯誤**  
驗證步驟期間失敗的資料列 （在嘗試建立潛在客戶之前） 包含錯誤碼，例如 `MISSING_CONTACT`、 `MISSING_COMPANY`或 `INVALID_EMAIL`。例如，如果您在沒有 的情況下上傳資料列`Contact Business Title`，則每個資料列會出現在失敗的記錄檔案中，並將 `Error Code`設定為 `MISSING_CONTACT`，並將 `Error Message`設定為 `Contact business title is required.`

**API 錯誤**  
在建立潛在客戶期間通過驗證但失敗的資料列會顯示，並將 `Error Code`設定為 `API_ERROR`。`Error Message` 包含服務傳回的特定原因。例如，不遵循 E.164 格式 (`+`後接國家/地區代碼和號碼） 的電話號碼會產生描述格式限制條件的錯誤訊息。檢閱錯誤訊息、更正失敗記錄檔案中的資料，以及僅重新上傳失敗的資料列。

**重新匯入失敗的資料列**  
若要修正並重新匯入失敗的資料列，請下載失敗的記錄 CSV、更正 `Error Code`和 `Error Message`欄中標記的值、移除這兩個資料欄，然後上傳更正的檔案。您不需要重新匯入在原始上傳中成功的資料列。

## 限制
<a name="lead-import-quotas"></a>


| 限制 | Value | 
| --- | --- | 
| 每個 CSV 檔案的資料列上限 | 100 | 
| 檔案格式 | 僅限 CSV (.csv) | 
| 每個檔案的最小資料列數 | 1 |