> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/ja/data-api/data-overview-1/syncing-data-via-file-protocols-1.md). # ファイルプロトコル経由でのデータ同期 このセクションでは、以下によってサポートされているプロトコルについて説明します： 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. {% hint style="warning" %} 大きなファイルはGCS経由での同期が適しています 100,000点を超える商品のフィードは、パフォーマンスを向上させるためにバケット方式で同期するのが最適です。 {% endhint %} ### SFTP Secure File Transfer Protocol（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 がサーバー上のファイル名を照合し、毎日正しいファイルを選択するのに役立ちます。 例えば、次のテンプレートを考えます： `ERMCatalogData_AU_{\*}.txt`。このテンプレートでは、ファイル名が次で始まる必要があります： `ERMCatalogData_AU` で終わり、次で終わる必要があります： `.txt`。このテンプレートを使用すると、次のファイル名が一致します： `ERMCatalogProduct_AU_20190315.txt` `ERMCatalogProduct_AU_20190314.txt` `ERMCatalogProduct_AU_20190312.txt` アップロードの途中であるデータファイルのダウンロードを避けるため、 Epsilon Retail Media サーバーにアクセスする1分以上前に最終更新されたファイルのみをダウンロードします。 複数のファイルがテンプレートに一致する可能性がありますが、 Epsilon Retail Media 一度に1つのファイルのみを処理します。複数の候補から適切なファイルを選択する方法は、選択したターゲットファイルモードによって決定されます。これについては以下で詳しく説明します。 ### Rolling\_earliest このターゲットファイルモードでは、提供された名前テンプレートに基づいてファイルがフィルター処理されます。フィルター処理後、ファイルは名前の昇順で並べ替えられ、この順序で最初のファイルがダウンロード対象として選択されます。 例えば、ファイル名テンプレートが次のようになっている場合： `ERMCatalogData_AU_{\*}.txt` で、フィルター処理されたファイル名のリストに以下が含まれているとします： `ERMCatalogProduct_AU_20190312.txt` `ERMCatalogProduct_AU_20190313.txt` `ERMCatalogProduct_AU_20190314.txt` このモードでは、ファイル `ERMCatalogProduct_AU_20190312.txt` がダウンロード対象として選択されます。 ### Rolling\_earliest\_24\_hours このターゲットファイルモードでは、ファイルはまず指定された名前テンプレートに基づいてフィルター処理されます。フィルター処理されたリストから、過去24時間以内に更新されたファイルのみが考慮されます。その後、ファイルは名前の昇順で並べ替えられ、この順序で最初のファイルがダウンロード対象として選択されます。 例えば、現在時刻が次であると仮定します： `2019-03-15 10:30:07`、ファイル名テンプレートは次のとおりです： `ERMCatalogData_AU_{\*}.txt`。フィルター処理されたファイル名のリストに以下が含まれている場合： | ファイル名 | 最終更新日時 | | ----------------------------------- | ----------------- | | ERMCatalogProduct\_AU\_20190312.txt | 13/03/19 15:35:11 | | ERMCatalogProduct\_AU\_20190313.txt | 13/03/19 15:35:08 | | ERMCatalogProduct\_AU\_20190314.txt | 14/03/19 15:35:10 | | ERMCatalogProduct\_AU\_20190315.txt | 15/03/19 10:05:07 | このモードでは、ファイル `ERMCatalogProduct_AU_20190314.txt` がダウンロード対象として選択されます。 ### Rolling\_latest このターゲットファイルモードでは、指定された名前テンプレートに基づいてファイルがフィルター処理されます。フィルター処理後、ファイルは名前の降順で並べ替えられます。この並べ替えられたリストの最初のファイルがダウンロード対象として選択されます。 例えば、ファイル名テンプレートが次の場合： `ERMCatalogData_AU_{\*}.txt`で、フィルター処理されたファイル名のリストに以下が含まれているとします： `ERMCatalogProduct_AU_20190314.txt` `ERMCatalogProduct_AU_20190313.txt` `ERMCatalogProduct_AU_20190312.txt` このモードでは、ファイル `ERMCatalogProduct_AU_20190314.txt` がダウンロード対象として選択されます。 このモードはRolling\_earliestに似ていますが、ファイルを昇順で並べ替える代わりに降順で並べ替えます。 ### Rolling\_latest\_24\_hours このターゲットファイルモードでは、ファイルは最初に指定された名前テンプレートを使用してフィルター処理されます。フィルター処理されたリストから、過去24時間以内に更新されたファイルのみが考慮されます。その後、ファイルは名前の降順で並べ替えられ、この順序で最初のファイルがダウンロード対象として選択されます。 例えば、現在時刻が次であると仮定します： `2019-03-15 10:30:07`、ファイル名テンプレートは次のとおりです： `ERMCatalogData_AU_{\*}.txt`。フィルター処理されたファイル名のリストに以下が含まれている場合： | ファイル名 | 最終更新日時 | | ----------------------------------- | ----------------- | | ERMCatalogProduct\_AU\_20190312.txt | 13/03/19 15:35:11 | | ERMCatalogProduct\_AU\_20190313.txt | 13/03/19 15:35:08 | | ERMCatalogProduct\_AU\_20190314.txt | 14/03/19 15:35:10 | | ERMCatalogProduct\_AU\_20190315.txt | 15/03/19 10:05:07 | このモードでは、ファイル `ERMCatalogProduct_AU_20190315.txt` がダウンロード対象として選択されます。 このモードはRolling\_earliest\_24\_hoursに似ていますが、ファイルは昇順ではなく降順で並べ替えられます。 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.citrusad.com/retail-media-interface/integration/ja/data-api/data-overview-1/syncing-data-via-file-protocols-1.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.