SFTPによるデータ交換
当社のSFTP（セキュア・ファイル転送プロトコル）ソリューションは、zero-touch, のセキュアなend-to-endソリューションです。これにより、当社の顧客関係管理（CRM）マーケティングメールソリューションへの接続に使用されるデータファイルの送信が自動化されます。
one-timeの設定手順
マーケティングデータフィードを設定するには、one-timeのSFTPおよびファイル暗号化プロセスを実行し、Expediaへの安全なファイル転送に必要な公開鍵と秘密鍵を生成していただきます。
手順1：サイト識別子の申請
SFTPによるファイル転送を設定するには、3つのサイト識別子値が必要となります：
- サイトID：テンプレートサイトを一意に識別するための識別子です。
tpid: 旅行商品のIDです。これは、eapidと組み合わせて、エクスペディアのシステムにおける販売拠点を特定するものです。eapid: エクスペディアの提携パートナーID。これは、tpidと合わせて、エクスペディアシステムにおける販売拠点を定義するものです。
弊社のサポートフォームをご利用ください。 パートナーソリューションサイト アカウントマネージャー からこれらの値を取得するには、
ステップ2：鍵を作成する
SFTPおよびファイル暗号化の設定用に、お好みの方法で公開鍵と秘密鍵を生成してください。
ステップ3：Expediaにキーを共有してください
SFTPの公開鍵を、エクスペディアと安全に共有することになります。この鍵を安全に保管し、SFTP接続の認証に使用できるアカウントを作成いたします。file-sharingの手続きでご利用いただくユーザー名をお知らせいたします。
重要
エクスペディアでは、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 | お客様の名前 | クリス | Varchar | — |
last_name | お客様の姓 | Smith | Varchar | — |
email | お客様用Eメール | 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 | ロイヤルティ ポイントの評価に用いられる通貨 | JPY | テキスト（最大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接続とアップロード
データをアップロードする前に、ファイルを暗号化しておく必要があります。
暗号化
当社は、個人を特定できる情報（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ファイルのアップロード頻度を自動化することができます。