SFTP 데이터 교환
당사의 SFTP(보안 파일 전송 프로토콜) 솔루션은 zero-touch, 의 보안 end-to-end 솔루션입니다. 이 기능은 당사의 고객 관계 관리(CRM) 마케팅 이메일 솔루션에 연결하는 데 사용되는 데이터 파일의 전송을 자동화합니다.
one-time 설정 단계
마케팅 데이터 피드를 설정하려면, one-time 을 통해 SFTP 및 파일 암호화 절차를 수행하여 익스피디아로 파일을 안전하게 전송하기 위한 공개 키와 개인 키를 생성해야 합니다.
1단계: 사이트 식별자 요청하기
SFTP 파일 전송을 설정하려면 다음 세 가지 사이트 식별자 값이 필요합니다:
- 사이트 ID: 템플릿 사이트를 식별하는 고유 식별자입니다.
tpid: 여행 상품 ID로, ‘eapid’과 함께 익스피디아 시스템 내의 판매 지점을 정의합니다.eapid: 익스피디아 제휴 파트너 ID로,tpid와 함께 익스피디아 시스템 내의 판매 지점을 정의합니다.
저희 웹사이트의 지원 양식을 이용하시기 바랍니다. 파트너 솔루션 사이트 계정 관리자에게 이러한 값을 요청하려면.
2단계: 키 생성하기
원하는 방법을 사용하여 SFTP 및 파일 암호화 설정을 위한 공개 키와 개인 키를 생성하십시오.
3단계: 익스피디아에 키를 공유하세요
SFTP 공개 키를 익스피디아와 안전하게 공유하게 됩니다. 이 키를 안전하게 보관하고, 이를 통해 SFTP 연결을 인증할 수 있는 계정을 생성해 드리겠습니다. file-sharing 절차에서 사용하실 사용자 이름을 안내해 드리겠습니다.
- 귀사의 명칭과 공개 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 | 고객 성 | 크리스 | Varchar | — |
last_name | 고객 성 | Smith | Varchar | — |
email | 고객 이메일 | chris.smith@hotmail.com | Varchar | 예 |
mer_flag | Marketing-eligible 수신 동의 표시; 이메일 마케팅 수신 동의(YES) 또는 거부(NO)에 대한 고객의 결정 | 예 | Varchar | 예 |
mer_timestamp | 고객이 가입 또는 해지를 결정한 시점의 타임스탬프 | 2021-06-12 20:14:23.000000 | Varchar | 예 |
lang_id | 사이트 언어; 이 값이 case-sensitive >> 로케일 세부 정보 표 보기 | en_US en_FR | Varchar | 예 |
tpid | 익스피디아 계정 관리자가 제공한 여행 상품 ID | 0000 | 숫자 | 예 |
eapid | 익스피디아 계정 관리자가 제공한 익스피디아 제휴 파트너 ID | 1234 | 숫자 | 예 |
site_id | 익스피디아 계정 관리자가 제공한 템플릿 사이트의 고유 식별자 | 5678 | 숫자 | 예 |
points_balance | 고객의 로열티 포인트 잔액 | 100000 | 번호 (최대 13자리) | — |
points_cash_value | 고객의 로열티 포인트의 현금 가치 | 250 | Varchar (최대 10자) | — |
cash_value_currency | 로열티 포인트의 평가 기준이 되는 통화 | USD | 텍스트 (최대 3자) | — |
credit_card_type | 거래에 사용된 신용카드의 종류 | YourBrand 카드 | 텍스트 (최대 25자) | — |
loyalty_tier | 귀사의 프로그램 내 고객 충성도 등급 | Platinum | 텍스트 (최대 25자) | — |
attribute1 attribute2 attribute3 | 고객에 대한 추가 정보를 공유하는 데 사용되는 3개의 입력란 | 자주 여행하는 사람 | VARCHAR (최대 25자) | — |
CSV 파일 내용 예시
.csv 파일에는 각 정보 항목이 파이프 기호(|)로 구분되어 포함됩니다. 파이프는 열 구분자 역할을 하며, 각 필드는 그 아래에 있는 정보의 열 머리글이 됩니다.
first_name|last_name|email|mer_flag|mer_timestamp|lang_id|tpid|eapid|site_id
John|Doe|your.customer@email.com|Y|2022-01-01 20:14:23.000000|en_us|0000|1234|5678
SFTP 연결 및 파일 업로드
데이터를 업로드하기 전에 파일을 암호화해야 합니다.
암호화
당사는 개인 식별 정보(PII)를 보호하기 위해 PGP 암호화를 사용합니다. 저희가 제공해 드릴 공개 키를 사용하여 .csv 파일을 암호화하시면 됩니다. 원하시는 암호화 도구를 자유롭게 사용하셔도 되지만, 저희는 주로 GPG 암호화 도구를 사용합니다.
- 익스피디아 런치 매니저에게 익스피디아 공개 키의 가져오기 대상 주소로 사용할 이메일 주소를 문의하세요.
- 비밀번호로 암호화하지 마세요. 암호화할 때는 개인 키를 사용하게 됩니다.
.gpg확장자로 암호화된 파일을 저장하세요
파일 업로드
다음 단계는 암호화된 파일을 업로드하는 것입니다. SFTP 연결 도구는 어떤 것이든 사용하실 수 있습니다. 프로토콜로 SFTP를 선택하고, 다음 정보를 입력하십시오:
- 서버:
s-b1b59c1d2afa43cba.server.transfer.us-west-2.amazonaws.com - 포트:
22 - 사용자 이름:
<partnername-username>(예:BestTravel-CRMteam또는BestTravel-Asmith) - SSH 개인 키: 사용자가 생성한 개인 키
조직의 비즈니스 요구 사항에 따라 SFTP 파일 업로드 주기를 자동화할 수 있습니다.