SFTP 데이터 교환

당사의 SFTP(보안 파일 전송 프로토콜) 솔루션은 zero-touch, 보안 end-to-end 솔루션입니다. 고객 관계 관리(CRM) 마케팅 이메일 솔루션에 연결하는 데 사용되는 데이터 파일 전송을 자동화합니다.

one-time 설정 단계

마케팅 데이터 피드를 설정하려면 one-time SFTP 및 파일 암호화 프로세스를 수행하여 익스피디아로 파일을 안전하게 전송할 수 있는 공개 및 개인 키를 생성합니다.

1단계: 사이트 식별자 요청

SFTP 파일 교환을 설정하려면 세 가지 사이트 식별자 값이 필요합니다:

사이트 ID: 템플릿 사이트의 고유 식별자입니다.
tpid: eapid과 함께 익스피디아 시스템에서 판매 시점을 정의하는 여행 상품 ID입니다.
eapid: tpid과 함께 익스피디아 시스템에서 판매 시점을 정의하는 익스피디아 제휴 파트너 ID입니다.

파트너 솔루션 사이트( )의 지원 양식()을 사용하여 계정 관리자에게 이러한 값을 요청해야 합니다.

2단계: 키 만들기

원하는 방법을 사용하여 SFTP 및 파일 암호화 설정을 위한 공개 키와 개인 키를 생성하세요.

터미널(MacOS X) 또는 명령줄(Windows) 사용

Mac 터미널 또는 Windows 명령줄에 를 입력합니다 user@localhost: ssh-keygen -t rsa.
참고: 명령이 실패하면 IT 부서에 문의하여 실행할 수 있는 충분한 권한이 있는지 확인하세요.
메시지가 표시되면 비밀번호 요청을 비워둡니다.
키를 안전한 위치에 저장하세요.

키를 안전한 곳에 보관하세요. 개인 키를 분실한 경우 SFTP를 재설정해야 합니다.

키 생성기 사용

키 생성기를 다운로드하여 설치합니다.
생성기를 사용하여 RSA 공개/개인 키 쌍을 생성합니다.
로 시작하는 공개 키를 복사합니다. ssh-rsa. 다음 주소로 전송할 내용입니다. Expedia Group.
개인 키를 안전한 위치에 저장합니다. 암호화된 파일을 전송할 때마다 비밀번호 대신 사용하므로 삭제하지 마세요.

개인 키를 안전한 곳에 저장하세요. 키를 분실한 경우 SFTP를 재설정해야 합니다.

3단계: Expedia와 키 공유

SFTP 공개 키를 익스피디아와 안전하게 공유할 수 있습니다. 이 키를 안전하게 저장하고 SFTP 연결을 인증할 수 있는 계정을 생성해 드립니다. file-sharing 절차에서 사용할 사용자 아이디를 알려드립니다.

중요

Expedia는 SharePoint 을 보안 키 저장소로 사용합니다. 조직에서 SharePoint, 에 대한 액세스를 차단한 경우 보안 이메일을 통해 공개 키를 보낼 수도 있습니다. 이 문제가 발생하면 계정 관리자에게 문의하세요.

를 통해 조직 이름과 공개 SFTP 키를 업로드할 이메일 주소를 보내주세요.SharePoint. 익스피디아 런칭 매니저가 이메일 주소를 제공합니다.
SharePoint 에 조직에 맞는 폴더를 만들고 제공한 이메일 주소로 액세스 링크를 보내드립니다. 또한 업로드하기 전에 파일을 암호화하는 데 사용되는 공개 키도 업로드합니다.
액세스 이메일을 받으면 링크를 클릭하여 필요한 액세스 코드를 생성합니다. (참고: 영업일 기준 2일 이내에 받은 편지함에 액세스 코드가 표시되지 않으면 스팸 폴더를 확인하세요.)
생성한 공개키를 생성한 폴더에 업로드하고 폴더에서 gpg_encryption_public_key.asc을 다운로드합니다.
SFTP 계정을 사용할 준비가 되면 연락드리겠습니다.

파일 형식 및 구조

CRM 데이터 파일을 성공적으로 업로드하려면 다음 기준을 충족해야 합니다.

파일 형식은 .csv으로 시작해야 합니다. 파일을 암호화하면 파일 확장자가 .gpg로 변경됩니다.
쉼표가 아닌 파이프(|)를 사용하여 필드를 구분합니다.
파일 이름 지정 규칙에는 밑줄(_) 이외의 특수 문자가 포함되어서는 안 됩니다. 파일 이름은 eps_crm_marketing으로 시작하고 그 뒤에 조직 이름, 계정 관리자가 공유한 tpid, eapid, site_id및 업로드 날짜가 있어야 합니다. 예: eps_crm_marketing_<PartnerName>_<tpid>_<eapid>_<site_id>_YYYYMMDD.csv.
파일 데이터에는 아래 표의 모든 열이 순서대로 포함되어야 하며 모든 필수 필드에 값이 포함되어야 합니다.

열 이름	정의	샘플 값	유형	필수 항목
`first_name`	고객 이름	Chris	바이트열	—
`last_name`	고객 성	Smith	바이트열	—
`email`	고객 이메일	chris.smith@hotmail.com	바이트열	예
`mer_flag`	Marketing-eligible 등록자 플래그; 이메일 마케팅 수신 동의(예) 또는 수신 거부(아니오) 여부에 대한 고객의 의사 결정	예	바이트열	예
`mer_timestamp`	고객이 옵트인 또는 옵트아웃을 결정한 시점의 타임스탬프	2021-06-12 20:14:23.000000	바이트열	예
`lang_id`	사이트 언어( 로캘 세부 정보 표 참조); 이 값은 다음과 같습니다. case-sensitive	en_US en_FR	바이트열	예
`tpid`	익스피디아 계정 관리자가 제공한 여행 상품 ID	0000	숫자	예
`eapid`	익스피디아 계정 관리자가 제공한 익스피디아 제휴 파트너 ID	1234	숫자	예
`site_id`	익스피디아 계정 관리자가 제공한 템플릿 사이트의 고유 식별자	5678	숫자	예
`points_balance`	고객의 로열티 포인트 잔액	100000	숫자(최대 13자리)	—
`points_cash_value`	고객 로열티 포인트의 현금 가치	250	바코드(최대 10자)	—
`cash_value_currency`	로열티 포인트가 평가되는 통화	USD	텍스트(최대 3자)	—
`credit_card_type`	거래에 사용된 신용 카드 유형	YourBrand 카드	텍스트(최대 25자)	—
`loyalty_tier`	프로그램 내 고객의 로열티 등급	Platinum	텍스트(최대 25자)	—
`attribute1` `attribute2` `attribute3`	고객에 대한 추가 정보를 공유하는 데 사용되는 3개의 필드	잦은 여행자	바코드(최대 25자)	—

샘플 CSV 파일 내용

.csv 파일에는 파이프 문자(|)로 구분된 각 정보 요소가 포함됩니다. 파이프는 열 구분선 역할을 하며, 각 필드는 그 아래에 있는 정보의 열 머리글이 됩니다.

SFTP 연결 및 업로드

데이터를 업로드하기 전에 파일을 암호화해야 합니다.

암호화

당사는 개인 식별 정보(PII)를 보호하기 위해 PGP 암호화를 사용합니다. .csv파일을 암호화하기 위해 공개키(당사가 제공하는)를 사용하게 됩니다. 원하는 암호화 도구를 사용할 수 있지만, 저희는 주로 GPG 암호화 도구를 사용합니다.

Expedia 공개 키의 가져오기 대상으로 사용할 이메일 주소를 Expedia 시작 관리자에게 문의하세요.
비밀번호로 암호화하지 마세요 - 이 경우 개인 키를 사용하게 됩니다.
.gpg확장자를 사용하여 암호화된 파일을 저장합니다.

파일 업로드

다음 단계는 암호화된 파일을 업로드하는 것입니다. 모든 SFTP 연결 도구를 사용할 수 있습니다. 프로토콜로 SFTP를 선택하고 다음 세부 정보를 입력합니다:

서버: s-b1b59c1d2afa43cba.server.transfer.us-west-2.amazonaws.com
포트: 22
사용자 이름: <partnername-username> (예: BestTravel-CRMteam 또는 BestTravel-Asmith)
SSH 개인 키: 생성한 개인 키입니다.

조직의 비즈니스 요구에 따라 SFTP 파일 업로드 주기를 자동화할 수 있습니다.