> 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/it/data-api/data-overview-1/syncing-data-via-file-protocols-1.md). # Sincronizzare i dati tramite protocolli di file Questa sezione spiega i protocolli supportati da Epsilon Retail Media e fornisce le linee guida per la denominazione dei file al fine di semplificare i download automatici dal tuo server. Per download sicuri, invia al tuo Epsilon Retail Media rappresentante i dettagli necessari: tipo di protocollo, host, porta, percorso del file e qualsiasi credenziale di autenticazione richiesta, come nome utente e password. È necessario archiviare i file di dati sul server per consentire il recupero tramite protocolli standard, come Google Cloud Storage (GCS), HTTPS e SFTP. ## Protocolli supportati Di seguito sono riportati i protocolli supportati che offrono metodi sicuri per l'archiviazione e il trasferimento dei file, garantendo una comunicazione sicura con i sistemi Epsilon Retail Media . ### GCS (consigliato) GCS è il nostro meccanismo preferito per l'archiviazione e il recupero dei file grazie alle sue solide funzionalità di sicurezza e all'integrazione perfetta con Epsilon Retail Media . ### HTTPS Il protocollo HTTPS fornisce un metodo sicuro per il trasferimento dei file supportando l'autenticazione basata su password. Ciò garantisce una comunicazione crittografata tra il tuo server e Epsilon Retail Media. {% hint style="warning" %} I file più grandi si sincronizzano meglio tramite GCS I feed con oltre 100.000 prodotti si sincronizzano al meglio tramite la metodologia bucket per migliorare le prestazioni. {% endhint %} ### SFTP Quando si utilizza il Secure File Transfer Protocol (SFTP), Epsilon Retail Media supporta due metodi di autenticazione per il download dei file di dati: * **Nome utente e password**: questo metodo standard utilizza le credenziali per autenticare l'accesso. * **Autenticazione con chiave pubblica**: è anche possibile utilizzare la chiave pubblica di Epsilon Retail Media. A tale scopo, assicurati che la chiave pubblica fornita di seguito sia installata sul tuo server SFTP per facilitare i trasferimenti di file sicuri. #### Staging ``` ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQDMd4w5Z6hsjlUc0/r3dTJ+IaM9Mm+l3ZTrX3D5+30ZNiAb3Mhvlp8gv37CFKzqM90oFejl15bbr5dymjycsOWInxqkMyLOTbdMFAk7hmicNvN5bt3tx/Z0UewNvAx0Uw9Qxu7SCMSAalk9l7dqLp5RFFj+RHq9ApV8KIA/Fw2mjCw2vrJhiRWeuUuNNQTbGFBA5y72ATeYA2p0ZK3/TTJxyxCL70zGVxFG0jdAurfXKujYaF73Ql/gl5wmtnxGvTORtvObQdc2jCTsynj1w17LSZAdeoPQGnQkVCk37ZUnWTw8s4RYjHFVunsTDxJO5Qnw5yj8oqhe5IdpQyavUj+otRd6900q/3dK60IELH6AFz+ZEqudlBh8ZO2hvHIDS2Ii5S3LunlejykAVdRl7RVHA17Pk3mmrHCS6i3n9ZliBYeVQiKme2jHVB+ESrHFxQWl3ct9MYFNlAqwuhTFQRSG9ioSEHX5Dnmqk8aqbm/4pYY4b7YHOcIpHrtrVrFTJ3vLM1If1OVrDQidFhi1ArmoCU+PO65jNSeMj27m/HoX7Mbcmi8F++Op3MgP8iJrohE0Wjz+use7nlDtQTtDxDeEQQYGqsz4DOtH/jn1TWRynaXZqwPqC5Q6b52QM22T+E3rgT/4G7yJU3IRKioByOck251MEtOEgSCvvIAaV685fQ== ``` #### Produzione ``` 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== ``` ## Compressione ed crittografia dei dati Prima di caricare i dati sul server per la sincronizzazione, potrebbe essere necessario comprimere e crittografare i file. Quando sui file di dati si utilizzano sia la compressione che la crittografia, Epsilon Retail Media presume che la compressione avvenga prima della crittografia. * Per la compressione dei dati, supportiamo i formati zip e gzip. Tuttavia, consigliamo gzip rispetto a zip a causa dei suoi migliori rapporti di compressione e dell'ampio supporto. I file compressi vengono decompressi prima dell'elaborazione. * Per la crittografia dei dati, i file vengono decrittografati al momento del download. Utilizza le chiavi pubbliche fornite per crittografare i file prima di caricarli sul tuo server, garantendo che solo Epsilon Retail Media possa accedere ai dati in modo sicuro. ## Convenzione di denominazione dei file Per consentire a Epsilon Retail Media di scaricare ed elaborare il tuo file di dati, devi fornire i dettagli relativi a protocollo, host, porta e percorso del file. Scegli un orario giornaliero comodo per assicurarti che il tuo file di dati sia pronto sul server, poichè Epsilon Retail Media lo scaricherà ogni giorno. L'approccio più semplice per specificare un file target giornaliero per i download di Epsilon Retail Mediaconsiste nell'utilizzare un nome file esplicito. Ciò consente a Epsilon Retail Media di recuperare direttamente il file dal tuo server. Per coloro che utilizzano protocolli FTP, FTPS o SFTP, offriamo anche metodi aggiuntivi per specificare i file target attraverso quelle che chiamiamo modalità file target. Queste opzioni includono: * Rolling\_earliest * Rolling\_earliest\_24\_hours * Rolling\_latest * Rolling\_latest\_24\_hours. La selezione di una modalità file target richiede di fornire un modello basato su testo per i nomi dei file di dati. Questo modello include una stringa speciale, `{\*}`, che aiuta Epsilon Retail Media a far corrispondere i nomi dei file sul tuo server e a selezionare il file corretto ogni giorno. Ad esempio, considera il modello `ERMCatalogData_AU_{\*}.txt`. Questo modello richiede che i nomi dei file inizino con `ERMCatalogData_AU` e finiscano con `.txt`. Utilizzando questo modello, i seguenti nomi di file corrisponderebbero: `ERMCatalogProduct_AU_20190315.txt` `ERMCatalogProduct_AU_20190314.txt` `ERMCatalogProduct_AU_20190312.txt` Per evitare di scaricare file di dati che sono ancora in fase di caricamento, Epsilon Retail Media scarica solo i file modificati l'ultima volta più di un minuto prima dell'accesso al server. Sebbene più file possano corrispondere al modello, Epsilon Retail Media elabora un solo file alla volta. La selezione del file appropriato tra più candidati è guidata dalla modalità file target scelta, discussa in dettaglio di seguito. ### Rolling\_earliest In questa modalità file target, i file vengono filtrati in base al modello di nome fornito. Una volta filtrati, i file vengono ordinati in ordine crescente in base ai loro nomi e il primo file in questo ordine viene selezionato per il download. Ad esempio, se il modello del nome del file è `ERMCatalogData_AU_{\*}.txt` e l'elenco filtrato dei nomi di file include quanto segue: `ERMCatalogProduct_AU_20190312.txt` `ERMCatalogProduct_AU_20190313.txt` `ERMCatalogProduct_AU_20190314.txt` In questa modalità, viene quindi scelto il file `ERMCatalogProduct_AU_20190312.txt` per il download. ### Rolling\_earliest\_24\_hours In questa modalità file target, i file vengono inizialmente filtrati in base al modello di nome specificato. Dall'elenco filtrato vengono presi in considerazione solo i file modificati nelle ultime 24 ore. I file vengono quindi ordinati in ordine crescente per nome e il primo file in questo ordine viene selezionato per il download. Ad esempio, ipotizziamo che l'ora corrente sia `2019-03-15 10:30:07`e il modello del nome del file sia `ERMCatalogData_AU_{\*}.txt`. Se l'elenco filtrato dei nomi dei file include quanto segue: | Nome del file | Ultima modifica | | ----------------------------------- | ----------------- | | 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 | In questa modalità, viene quindi scelto il file `ERMCatalogProduct_AU_20190314.txt` per il download. ### Rolling\_latest In questa modalità file target, i file vengono filtrati in base al modello di nome specificato. Dopo il filtraggio, i file vengono ordinati in ordine decrescente in base ai loro nomi. Il primo file in questo elenco ordinato viene selezionato per il download. Ad esempio, se il modello del nome del file è `ERMCatalogData_AU_{\*}.txt`, e l'elenco filtrato dei nomi di file include quanto segue: `ERMCatalogProduct_AU_20190314.txt` `ERMCatalogProduct_AU_20190313.txt` `ERMCatalogProduct_AU_20190312.txt` In questa modalità, viene quindi scelto il file `ERMCatalogProduct_AU_20190314.txt` viene scelto per il download. Questa modalità è simile a Rolling\_earliest, ma invece di ordinare i file in ordine crescente, vengono ordinati in ordine decrescente. ### Rolling\_latest\_24\_hours In questa modalità file target, i file vengono inizialmente filtrati utilizzando il modello di nome specificato. Dall'elenco filtrato vengono presi in considerazione solo i file modificati nelle ultime 24 ore. I file vengono quindi ordinati in ordine decrescente in base ai loro nomi e il primo file in questo elenco ordinato viene selezionato per il download. Ad esempio, si presuppone che l'ora corrente sia `2019-03-15 10:30:07`e il modello del nome del file sia `ERMCatalogData_AU_{\*}.txt`. Se l'elenco filtrato dei nomi di file include: | Nome del file | Ultima modifica | | ----------------------------------- | ----------------- | | 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 | In questa modalità, viene quindi scelto il file `ERMCatalogProduct_AU_20190315.txt` viene scelto per il download. Questa modalità è simile a Rolling\_earliest\_24\_hours, ma qui i file sono ordinati in ordine decrescente anziché crescente. --- # 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/it/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.