SFTP 資料交換
我們的 SFTP (安全檔案傳輸協定) 解決方案是基於 zero-touch, 的安全 end-to-end 解決方案。它能自動發送用於連接我們的客戶關係管理 (CRM) 行銷電子郵件解決方案的資料檔案。
one-time 的設定步驟
要設定行銷資料饋送,您需要執行「one-time」的 SFTP 及檔案加密流程,以產生公鑰和私鑰,藉此確保與 Expedia 之間檔案傳輸的安全性。
步驟 1:申請您的網站識別碼
您需要三個網站識別碼值來設定 SFTP 檔案傳輸:
- 網站 ID:您模板網站的唯一 識別碼。
tpid:旅遊產品編號,此編號連同「eapid」共同定義了 Expedia 系統中的銷售據點。eapid: Expedia 合作夥伴識別碼,該識別碼與tpid共同定義了 Expedia 系統中的銷售據點。
您應使用我們網站上的支援表單 合作夥伴解決方案網站 請向您的客戶經理索取這些數值。
步驟 2:建立您的金鑰
請使用您偏好的方法,為 SFTP 及檔案加密設定產生公鑰和私鑰。
步驟 3:將您的密鑰分享給 Expedia
您將能安全地與 Expedia 分享您的 SFTP 公開金鑰。我們將安全地儲存此金鑰,並建立一個帳戶,讓您能夠透過該帳戶驗證 SFTP 連線。我們將提供您一個使用者名稱,供您在 file-sharing 流程中使用。
- 請透過 # 提供貴組織的名稱,以及您將用來上傳公開 SFTP 金鑰的電子郵件地址 SharePoint. 您的 Expedia 上線經理將會提供該電子郵件地址。
- 我們將在 SharePoint 建立一個專屬於貴組織的資料夾,並將存取連結寄送至您提供的電子郵件地址。我們還會上傳用於在上傳前加密檔案的公鑰。
- 收到該存取電子郵件後,請點擊連結以產生所需的存取碼。(注意:若在兩個工作天內未在收件匣中看到存取碼,請務必檢查您的垃圾郵件資料夾。)
- 請將您生成的公開金鑰上傳至我們建立的資料夾,並從該資料夾下載 ``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 訂閱者標記;客戶決定是否訂閱 (是) 或取消訂閱 (否) 電子郵件行銷 | 是 | Varchar | 是 |
mer_timestamp | 客戶決定加入或退出時的時間戳記 | 2021-06-12 20:14:23.000000 | Varchar | 是 |
lang_id | 網站語言 (請參閱的「語言環境」詳細資料表);此值並非 case-sensitive | en_US en_FR | Varchar | 是 |
tpid | 由您的 Expedia 客戶經理提供的旅遊產品編號 | 0000 | 數字 | 是 |
eapid | 由 Expedia 客戶經理提供的 Expedia 合作夥伴識別碼 | 1234 | 數字 | 是 |
site_id | 由 Expedia 客戶經理提供的範本網站專屬識別碼 | 5678 | 數字 | 是 |
points_balance | 客戶的忠誠度積分餘額 | 100000 | 號碼 (最多 13 位數) | — |
points_cash_value | 客戶忠誠度積分的現金價值 | 250 | Varchar (最多 10 個字元) | — |
cash_value_currency | 忠誠點數的計價貨幣 | USD | 文字 (最多 3 個字元) | — |
credit_card_type | 用於該交易的信用卡類型 | YourBrand 卡片 | 文字 (最多 25 個字元) | — |
loyalty_tier | 客戶在您計畫中的忠誠度層級 | 白金卡 | 文字 (最多 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 連線與上傳
在上傳資料之前,您應先對檔案進行加密。
加密
我們採用 PGP 加密技術來保護個人可識別資訊 (PII)。您將使用我們的公開金鑰 (我們會提供給您) 來加密您的 ``.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 檔案的上傳頻率。