Developer Hub
此為系統自動產生的翻譯

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 及檔案加密設定產生公鑰和私鑰。

|

使用終端機 (MacOS X) 或命令列 (Windows)

  1. 在 Mac 終端機或 Windows 命令列中,輸入 user@localhost: ssh-keygen -t rsa.
    注意:若指令執行失敗,請向您的 IT 部門確認,確保您擁有足夠的權限來執行該指令。
  2. 當系統提示時,請將密碼短語欄位留空。
  3. 請將您的鑰匙存放在安全的地方。

請務必將鑰匙存放在安全的地方。如果您遺失了私密金鑰,就必須重設 SFTP。

使用金鑰產生器

  1. 下載並安裝密鑰產生器。
  2. 請使用此產生器來建立一組 RSA 公鑰/私鑰對。
  3. 複製該公鑰,其開頭為 ssh-rsa. 這是您將發送給 Expedia Group.
  4. 請將私鑰儲存於安全的位置。請勿刪除它——每次傳送加密檔案時,您都會用它來取代密碼。

請務必將您的私鑰存放在安全的地方。如果您遺失了金鑰,就必須重設 SFTP。

步驟 3:將您的密鑰分享給 Expedia

您將能安全地與 Expedia 分享您的 SFTP 公開金鑰。我們將安全地儲存此金鑰,並建立一個帳戶,讓您能夠透過該帳戶驗證 SFTP 連線。我們將提供您一個使用者名稱,供您在 file-sharing 流程中使用。

Information

重要事項

Expedia 採用 SharePoint 作為安全的金鑰儲存庫。如果您的組織封鎖了對 SharePoint, 的存取,您也可以透過安全電子郵件傳送公開金鑰。若這對您造成困擾,請與您的客戶經理聯繫。

  1. 請透過 # 提供貴組織的名稱,以及您將用來上傳公開 SFTP 金鑰的電子郵件地址 SharePoint. 您的 Expedia 上線經理將會提供該電子郵件地址。
  2. 我們將在 SharePoint 建立一個專屬於貴組織的資料夾,並將存取連結寄送至您提供的電子郵件地址。我們還會上傳用於在上傳前加密檔案的公鑰。
  3. 收到該存取電子郵件後,請點擊連結以產生所需的存取碼。(注意:若在兩個工作天內未在收件匣中看到存取碼,請務必檢查您的垃圾郵件資料夾。)
  4. 請將您生成的公開金鑰上傳至我們建立的資料夾,並從該資料夾下載 ``gpg_encryption_public_key.asc 檔案。
  5. 當 SFTP 帳戶準備就緒時,我們會與您聯繫。

檔案格式與結構

要成功上傳 CRM 資料檔案,這些檔案應符合以下條件。

  • 檔案格式應以.csv 為開頭。當您加密檔案時,請將檔案副檔名更改為 .gpg.
  • 請使用縱橫線 (|),而非逗號,來區分欄位。
  • 檔案命名規範不應包含下劃線以外的特殊字元 (_)。檔案名稱必須以eps_crm_marketing 開頭,後面依序為您的組織名稱;您的帳戶經理提供的tpideapidsite_id;以及上傳日期。例如:eps_crm_marketing_<PartnerName>_<tpid>_<eapid>_<site_id>_YYYYMMDD.csv
  • 檔案資料應包含下表中所有欄位,且須按順序排列,並必須在所有必填欄位中填入值。
欄位名稱定義範例值類型必填
first_name客戶名字克里斯Varchar
last_name客戶的姓氏SmithVarchar
email電子郵件chris.smith@hotmail.comVarchar
mer_flagMarketing-eligible 訂閱者標記;客戶決定是否訂閱 (是) 或取消訂閱 (否) 電子郵件行銷Varchar
mer_timestamp客戶決定加入或退出時的時間戳記2021-06-12 20:14:23.000000Varchar
lang_id網站語言 (請參閱的「語言環境」詳細資料表);此值並非 case-sensitiveen_US
en_FR
Varchar
tpid由您的 Expedia 客戶經理提供的旅遊產品編號0000數字
eapid由 Expedia 客戶經理提供的 Expedia 合作夥伴識別碼1234數字
site_id由 Expedia 客戶經理提供的範本網站專屬識別碼5678數字
points_balance客戶的忠誠度積分餘額100000號碼 (最多 13 位數)
points_cash_value客戶忠誠度積分的現金價值250Varchar (最多 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-CRMteamBestTravel-Asmith
  • SSH 私密金鑰:您所生成的私密金鑰

您可以根據貴組織的業務需求,自動設定 SFTP 檔案的上傳頻率。

這個頁面有幫助嗎?
我們能如何改善內容?
感謝您協助我們進行改善!