

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 리드 가져오기
<a name="lead-import"></a>

AWS Partner Central의 **리드 가져오기** 기능을 사용하면 파트너가 생성한 리드를 한 번에 여러 개 생성할 수 있습니다. CSV 파일을 업로드하여 리드를 가져옵니다. 파일의 각 유효한 행은 APN Customer Engagements(ACE) 프로그램을 통해 하나의 리드를 생성합니다. 파일당 최대 100개의 리드를 가져올 수 있습니다.

가져온 후에는 Marketplace AWS 참여 점수와 같은 권장 조치 및 AWS 인사이트를 포함하여 참여 신호를 통해 리드를 강화할 수 있습니다. 이러한 인사이트를 사용하여 아웃리치를 우선시하고 기회로 전환할 가능성이 가장 높은 리드를 식별합니다.

## 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 형식의 고객 위치에 대한 2자 국가 코드입니다. 코드는 허용되는 값 중 하나와 일치해야 합니다. 전체 목록의 템플릿을 다운로드합니다. 공통 값: US, GB, DE, IN, JP, AU, CA, FR, , 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, , Education, Energy - Oil and Gas, Energy - Power and UtilitiesGaming, Financial ServicesGovernment, Healthcare, Hospitality, Life Sciences, Manufacturing, Marketing and Advertising, Media and Entertainment, Mining, Non-Profit Organization, Professional Services, Real Estate and Construction, OtherRetailSoftware 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자리 숫자 문자열 | Dun & Bradstreet에서 발급한 고유한 비즈니스 식별자인 고객의 D-U-N-S 번호입니다. 견고성 보강 및 중복 제거에 사용됩니다. | 123456789 | 
| Contact Phone | E.164 형식, 최대 15자리 | 기본 연락처의 전화번호입니다. E.164 국제 형식: \+ 기호 뒤에 공백이나 대시 없이 국가 코드와 번호가 와야 합니다. 전화번호 형식이 잘못되면 리드 생성 API\_ERROR 중에이 발생합니다. | \+12065551234 | 
| Use Case | 자유 텍스트, 최대 255자 | 리드와 관련된 AWS 사용 사례 또는 워크로드에 대한 자유 텍스트 설명입니다. 이 값은 고정된 값 목록에 대해 검증되지 않습니다. | Migration and Transfer | 
| Business Problem | 20\~2,000자 | 고객의 핵심 비즈니스 과제 또는 문제점에 대한 설명입니다. 이렇게 하면 리드의 컨텍스트를 AWS 이해하는 데 도움이 됩니다. 제공된 경우 20\~2,000자여야 합니다. | 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>

가져오기 중에 행이 실패하면 모든 원본 열과 `Error Code` 및 열이 포함된 실패한 레코드 CSV 파일을 다운로드할 수 `Error Message` 있습니다. 오류 코드를 사용하여 문제를 식별하고 수정한 다음 실패한 행만 다시 업로드합니다.


| 오류 코드 | 원인 | 해결 방법 | 
| --- | --- | --- | 
| 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`각 행은가 로, `MISSING_CONTACT`가 로 `Error Code` 설정된 실패한 레코드 파일에 나타납니다`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>


| Limit | 값 | 
| --- | --- | 
| CSV 파일당 최대 행 수 | 100 | 
| 파일 형식 | CSV(.csv) 전용 | 
| 파일당 최소 행 수 | 1 | 