로열티 포인트 조정
일일 포인트 조정(recon) 파일은 고객에 대한 정확한 로열티 포인트 합계를 유지하는 데 도움을 주기 위한 것입니다. 익스피디아는 시스템 총액을 조정할 수 있는 권한이 없으므로, 고객이 로열티 포인트를 사용하여 여행을 예약하면 회원님의 기록에 해당 사용 내역이 반영되어야 합니다.
매일 오전 12시부터 오후 11시 59분까지 24시간 동안 템플릿 사이트에서 발생한 거래에 대한 정보가 포함된 .csv
파일을 전송합니다.
파일은 보안 파일 전송 프로토콜(SFTP)을 통해 매일 교환되며, 익스피디아 런칭 매니저와 동의하게 됩니다.
정찰 파일 이름
일일 포인트 정찰 파일의 표준 명명 규칙은 브랜드 또는 조직 이름, 템플릿 사이트가 운영되는 국가 코드, 파일 생성 날짜 및 시간(순서대로)입니다. 각 요소는 다음과 같이 밑줄(_) 문자로 구분해야 합니다: YourBrand_countrycode_date.csv.
날짜 형식은 dd_mm_yyyy_hhmm,, 국가 코드는 다음과 같아야 합니다. case-sensitive. 참고: 익스피디아 측에서는 국가 코드의 유효성을 검사하지 않으며 메타데이터로만 사용됩니다.
예를 들어 파일 이름은 다음과 같을 수 있습니다: YourBrand_USA_28_04_2024_0800.csv.
파일 정보
파일에는 여러 표준 헤더와 해당 값이 포함되어 있습니다. 조정이 필요한 추가 필드가 있는 경우 표준 값 뒤에 해당 필드를 포함할 수 있습니다.
템플릿 사이트에 정확하게 반영되도록 헤더 이름 주위의 공백이나 보이지 않는 문자를 잘라내야 합니다.
표준 헤더 | 설명 | 데이터 형식 | 샘플 값 |
---|---|---|---|
거래 날짜 | 거래 날짜 | dd-month-yy hh.mm.ss (널 또는 공백이 아님) | 18-Aug-22 19.22.44 |
주문 ID | API 요청에서 공유된 Expedia 주문 ID 참고: Excel에서 파일을 열면 기본 가져오기 규칙으로 인해 이 필드의 값이 손상될 수 있습니다. | String (널 또는 공백이 아님) | 9223371999748510705 |
요청 ID | 익스피디아가 조정에 사용하기 위해 제공하는 고유 요청 식별자 | String (널 또는 공백이 아님) | |
파트너 확인 ID | 귀하가 제공하는 고유한 거래 식별자 | String (널 또는 공백이 아님) | 다양 |
거래 유형 | 표시되는 거래 유형(유효한 값에는 사용 또는 환불이 포함됩니다. | String | 사용 |
수량 총 포인트 | 거래의 총 포인트 수. 항상 양수여야 합니다. | Integer | 1500 |
가치 총 포인트 | 사용된 포인트의 통화 가치 참고: 모든 거래에 대해 이 값이 올바르게 해석되었는지 확인하기 위해 익스피디아 론칭 관리자가 이 값에 대한 자세한 내용을 회원님과 논의할 것입니다. | Integer | 500 |
통화 코드 | 포인트 가치에 사용되는 ISO 표준 통화 코드(예: USD, CAD, AUD) | String | USD |
온보딩 및 파일 전송 단계
일일 포인트 정찰 파일을 전송하려면 데이터의 보안을 보장하는 통신 프로토콜을 설정해야 합니다.
- 먼저 SSH(보안 셸) 공개/비공개 키 쌍을 생성하고 공개 키를 당사와 공유합니다.
- 파일을 암호화하고 업로드하는 데 사용할 공개 키를 공유해 드립니다.
- SSH 개인 키를 통해 연결하고 지정된 디렉터리에 암호화된 파일을 업로드할 수 있도록 SFTP 세부 정보를 공유해 드립니다.
SFTP 세부 정보
서버 | 값 |
---|---|
테스트 | Host: secure-file-transfer-test.expedia.com UserName: <To be provided by Expedia> 폴더 : /<file to be uploaded inside root folder> |
PROD | Host: secure-file-transfer.expedia.com UserName: <To be provided by Expedia> 폴더 : /<file to be uploaded inside root folder> |