このセクションでは、Epsilon Retail Mediaがサポートしているプロトコルを説明し、サーバーからの自動ダウンロードを効率化するためのファイル名の付け方のガイドラインを提供します。安全にダウンロードするためには、プロトコルタイプ、ホスト、ポート、ファイルパスなどの必要な詳細情報と、ユーザー名やパスワードなどの認証情報をEpsilon Retail Mediaの担当者に送信してください。Google Cloud Storage(GCS)、HTTPS、SFTPなどの標準プロトコルを使用して取得できるようにするには、データファイルをサーバーに保存する必要があります。
サポートされているプロトコル
Epsilon Retail Mediaシステムとの安全な通信を確保するための、安全なファイルストレージおよび転送方法を提供するサポートされているプロトコルは以下の通りです。
GCS(推奨)
GCSはその強力なセキュリティ機能とEpsilon Retail Mediaシステムとのシームレスな統合により、ファイルの保存と取得において当社が推奨するメカニズムです
HTTPS
HTTPS プロトコルは、パスワード認証をサポートすることで、安全なファイル転送を可能にします。これにより、貴社のサーバーとEpsilon Retail Mediaの間で暗号化された通信が確保されます。
SFTP
セキュアファイル転送プロトコル(SFTP)を使用する場合、Epsilon Retail Mediaはデータファイルをダウンロードするための2つの認証方法に対応しています。
- ユーザー名とパスワード:この標準的な方法では、資格情報を使用してアクセスを認証します。
- 公開鍵認証:Epsilon Retail Mediaの公開鍵を使用することもできます。このためには、安全なファイル転送を容易にするために、以下に示す公開鍵がSFTPサーバーにインストールされていることを確認してください。
ステージング
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQDMd4w5Z6hsjlUc0/r3dTJ+IaM9Mm+l3ZTrX3D5+30ZNiAb3Mhvlp8gv37CFKzqM90oFejl15bbr5dymjycsOWInxqkMyLOTbdMFAk7hmicNvN5bt3tx/Z0UewNvAx0Uw9Qxu7SCMSAalk9l7dqLp5RFFj+RHq9ApV8KIA/Fw2mjCw2vrJhiRWeuUuNNQTbGFBA5y72ATeYA2p0ZK3/TTJxyxCL70zGVxFG0jdAurfXKujYaF73Ql/gl5wmtnxGvTORtvObQdc2jCTsynj1w17LSZAdeoPQGnQkVCk37ZUnWTw8s4RYjHFVunsTDxJO5Qnw5yj8oqhe5IdpQyavUj+otRd6900q/3dK60IELH6AFz+ZEqudlBh8ZO2hvHIDS2Ii5S3LunlejykAVdRl7RVHA17Pk3mmrHCS6i3n9ZliBYeVQiKme2jHVB+ESrHFxQWl3ct9MYFNlAqwuhTFQRSG9ioSEHX5Dnmqk8aqbm/4pYY4b7YHOcIpHrtrVrFTJ3vLM1If1OVrDQidFhi1ArmoCU+PO65jNSeMj27m/HoX7Mbcmi8F++Op3MgP8iJrohE0Wjz+use7nlDtQTtDxDeEQQYGqsz4DOtH/jn1TWRynaXZqwPqC5Q6b52QM22T+E3rgT/4G7yJU3IRKioByOck251MEtOEgSCvvIAaV685fQ==
本番
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQCtpIUFoYu8OUesZGP9rffv6/hky1HbQCAhC8hNRmcWpdptzRYsKIZFPz9t2vb85dierTZqJstAEJkePHd25cZ8btIBacbAR49avCIXiBuVgvlJk1+Er2dyYqSzSeFhpzlZxi4CkGo/Nsx7yxPi5693fdVF3vr+/iencw1tdLJJXfT6j1YLBCREg+IziBCO6m9P0QQGEDXYvsOmIzl0CJ8enU7gjvnYL5ify1/aGpoXv9/XcCYJWXTQmvmISknOMdC4pBiuDqsE9CX27FLQQb1ZT5jNrqD5hFsEo0rWqLiCbb5qoxIdMSe/IbA+sewgpgTPNJXeCNLSSH/MHhj2IgiMZGDDDaVaqMZD7N2jeQdI6SQbgvXiLTTUL4gNyO5eN9oqoeJumeZMi0+MQ7kkfHDYGtKe3RMxL7heL650HL+eWDIybezyPdQmfyVew9KuN0uB+2X+2NxQs8ZLqow486XDfUDfo+rPuoIvkYy7Z8ox+gne+1iAk43TCekcDwxlc56R9muMtGLuzzg1x9s9MqsAg5JNWEPQ8giAwCQJwm7h3UcCY3TJCn0LUzYHc7Ycr11JfIXL47vYGH3C0XBYlbEU/8m4VhhexzgJi8G/reclY5pfjtwQGOiobsxLsWgGx6Qoz/qWqmGwQIg+qi7jvA7jnltUP+RTFZpmd18/dSxB+w==
データの圧縮と暗号化
同期のためにデータをサーバーにアップロードする前に、ファイルを圧縮して暗号化する必要がある場合があります。データファイルに圧縮と暗号化の両方が使用される場合、Epsilon Retail Mediaは圧縮が暗号化の前に行われると想定します。
- データ圧縮については、zip形式とgzip形式をサポートしています。しかし、圧縮率が高く、広くサポートされているため、zipよりもgzipをお勧めします。圧縮ファイルは処理前に解凍されます。
- データの暗号化のため、ファイルはダウンロード時に復号されます。提供された公開鍵を使用して、ファイルをサーバーにアップロードする前に暗号化し、Epsilon Retail Mediaのみがデータに安全にアクセスできるようにしてください。
ファイルの命名規則
Epsilon Retail Mediaがデータファイルをダウンロードして処理できるようにするには、プロトコル、ホスト、ポート、ファイルパスの詳細を提供する必要があります。Epsilon Retail Mediaは毎日データファイルをダウンロードするため、データファイルがサーバー上に確実に準備されるよう、毎日都合の良い時間を選択してください。
Epsilon Retail Mediaのダウンロード用に毎日のターゲットファイルを指定する最も簡単な方法は、明示的なファイル名を使用することです。これにより、Epsilon Retail Mediaはサーバーからファイルを直接取得できます。
FTP、FTPS、またはSFTPプロトコルを使用している場合は、ターゲットファイルモードと呼ばれる方法でターゲットファイルを指定するための追加の方法も提供しています。これらのオプションには以下が含まれます。
- Rolling_earliest
- Rolling_earliest_24_hours
- Rolling_latest
- Rolling_latest_24_hours.
ターゲットファイルモードを選択するには、データファイル名のためのテキストベースのテンプレートを提供する必要があります。このテンプレートには、特別な文字列が含まれています。 {\*}
これにより、Epsilon Retail Mediaはお客様のサーバー上のファイル名を照合し、毎日正しいファイルを選択できるようになります。
例えば、テンプレート CitrusAdCatalogData_AU_{\*}.txt
を例とします。このテンプレートでは、ファイル名は CitrusAdCatalogData_AU
で始まり、 .txt
で終わる必要があります。このテンプレートを使用すると、以下のファイル名が一致します。
CitrusAdCatalogProduct_AU_20190315.txt
CitrusAdCatalogProduct_AU_20190314.txt
CitrusAdCatalogProduct_AU_20190312.txt
アップロード中のデータファイルをダウンロードしないように、Epsilon Retail Mediaは、サーバーにアクセスする1分以上前に最後に変更されたファイルのみをダウンロードします。
複数のファイルがテンプレートに一致する場合がありますが、Epsilon Retail Mediaは一度に1つのファイルしか処理しません。複数の候補から適切なファイルを選択するには、以下で詳しく説明するターゲットファイルモードを選択します。
Rolling_earliest
このターゲットファイルモードでは、指定された名前テンプレートに基づいてファイルがフィルタリングされます。フィルタリング後、ファイルは名前の昇順で並べ替えられ、この順序で最初のファイルがダウンロードのために選択されます。
たとえば、ファイル名テンプレートが CitrusAdCatalogData_AU_{\*}.txt
で、フィルターされたファイル名のリストに次が含まれている場合:
CitrusAdCatalogProduct_AU_20190312.txt
CitrusAdCatalogProduct_AU_20190313.txt
CitrusAdCatalogProduct_AU_20190314.txt
このモードでは、ファイル CitrusAdCatalogProduct_AU_20190312.txt
がダウンロードのために選択されます。
Rolling_earliest_24_hours
このターゲットファイルモードでは、指定された名前テンプレートに基づいて、ファイルが最初にフィルタリングされます。フィルタリングされたリストから、直近24時間以内に変更されたファイルのみが考慮されます。ファイルは名前の昇順で並べ替えられ、その順序の最初のファイルがダウンロード用に選択されます。
例えば、現在の時刻が 2019-03-15 10:30:07
で、ファイル名のテンプレートが CitrusAdCatalogData_AU_{\*}.txt
であると仮定します。フィルタリングされたファイル名のリストに以下が含まれている場合:
ファイル名 | 最終更新日 |
---|---|
CitrusAdCatalogProduct_AU_20190312.txt | 2019年3月13日15:35:11 |
CitrusAdCatalogProduct_AU_20190313.txt | 2019年3月13日 15:35:08 |
CitrusAdCatalogProduct_AU_20190314.txt | 2019年3月14日 15:35:10 |
CitrusAdCatalogProduct_AU_20190315.txt | 2019年3月15日 10:05:07 |
このモードでは、ファイル CitrusAdCatalogProduct_AU_20190314.txt
がダウンロードのために選択されます。
Rolling_latest
このターゲットファイルモードでは、指定された名前テンプレートに基づいてファイルがフィルタリングされます。フィルタリング後、ファイルは名前の降順で並べ替えられます。この並べ替えられたリストの最初のファイルがダウンロード用に選択されます。
たとえば、ファイル名テンプレートが CitrusAdCatalogData_AU_{\*}.txt
で、フィルターされたファイル名のリストに次が含まれている場合:
CitrusAdCatalogProduct_AU_20190314.txt
CitrusAdCatalogProduct_AU_20190313.txt
CitrusAdCatalogProduct_AU_20190312.txt
このモードでは、ファイル CitrusAdCatalogProduct_AU_20190314.txt
がダウンロードのために選択されます。
このモードはRolling_earliestと似ていますが、ファイルを昇順ではなく降順で並べ替えます。
Rolling_latest_24_hours
このターゲットファイルモードでは、ファイルは最初に指定された名前テンプレートを使用してフィルタリングされます。フィルタリングされたリストから、直近24時間以内に変更されたファイルのみが考慮されます。その後、ファイルは名前の降順で並べ替えられ、この順序で最初のファイルがダウンロード用に選択されます。
例えば、現在の時刻が 2019-03-15 10:30:07
で、ファイル名のテンプレートが CitrusAdCatalogData_AU_{\*}.txt
。フィルタリングされたファイル名のリストに以下が含まれている場合:
ファイル名 | 最終更新日 |
---|---|
CitrusAdCatalogProduct_AU_20190312.txt | 2019年3月13日15:35:11 |
CitrusAdCatalogProduct_AU_20190313.txt | 2019年3月13日 15:35:08 |
CitrusAdCatalogProduct_AU_20190314.txt | 2019年3月14日 15:35:10 |
CitrusAdCatalogProduct_AU_20190315.txt | 2019年3月15日 10:05:07 |
このモードでは、ファイル CitrusAdCatalogProduct_AU_20190315.txt
がダウンロードのために選択されます。
このモードはRolling_earliest_24_hoursに似ていますが、ここではファイルは昇順ではなく降順でソートされます。