> 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/pt-br/data-api/data-overview-1/syncing-data-via-file-protocols-1.md). # Sincronizar dados via protocolos de arquivo Esta seção explica os protocolos suportados por Epsilon Retail Media e fornece diretrizes para nomear arquivos com o objetivo de otimizar os downloads automáticos do seu servidor. Para downloads seguros, envie ao seu Epsilon Retail Media representante os detalhes necessários — tipo de protocolo, host, porta, caminho do arquivo — e quaisquer credenciais de autenticação necessárias, como nome de usuário e senha. Você deve armazenar seus arquivos de dados no servidor para permitir a recuperação por meio de protocolos padrão, como Google Cloud Storage (GCS), HTTPS e SFTP. ## Protocolos suportados Aqui estão os protocolos suportados que oferecem métodos seguros para armazenamento e transferência de arquivos, garantindo uma comunicação segura com os sistemas da Epsilon Retail Media . ### GCS (recomendado) O GCS é nosso mecanismo preferido para armazenamento e recuperação de arquivos devido aos seus recursos robustos de segurança e integração perfeita com a Epsilon Retail Media . ### HTTPS O protocolo HTTPS fornece um método seguro para transferência de arquivos, suportando autenticação baseada em senha. Isso garante uma comunicação criptografada entre seu servidor e a Epsilon Retail Media. {% hint style="warning" %} Arquivos maiores são mais bem sincronizados via GCS Feeds com mais de 100.000 produtos são mais bem sincronizados pela metodologia de bucket para melhorar o desempenho. {% endhint %} ### SFTP Ao usar o Protocolo de Transferência de Arquivos Seguro (SFTP), a Epsilon Retail Media suporta dois métodos de autenticação para baixar arquivos de dados: * **Nome de usuário e senha**: Este método padrão usa credenciais para autenticar o acesso. * **Autenticação por chave pública**: Você também pode usar a chave pública da Epsilon Retail Media. Para isso, certifique-se de que a chave pública fornecida abaixo esteja instalada em seu servidor SFTP para facilitar transferências seguras de arquivos. #### 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== ``` #### Produção ``` 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== ``` ## Compactação e criptografia de dados Antes de fazer upload de dados para o seu servidor para sincronização, pode ser necessário compactar e criptografar os arquivos. Quando a compactação e a criptografia são usadas em arquivos de dados, a Epsilon Retail Media assume que a compactação ocorre antes da criptografia. * Para compactação de dados, suportamos os formatos zip e gzip. No entanto, recomendamos o gzip em vez do zip devido às suas melhores taxas de compactação e amplo suporte. Arquivos compactados são descompactados antes do processamento. * Para criptografia de dados, os arquivos são descriptografados no momento do download. Use as chaves públicas fornecidas para criptografar os arquivos antes de fazer o upload para o seu servidor, garantindo que apenas a Epsilon Retail Media possa acessar os dados com segurança. ## Convenção de nomenclatura de arquivos Para permitir que a Epsilon Retail Media baixe e processe seu arquivo de dados, você precisa fornecer o protocolo, host, porta e detalhes do caminho do arquivo. Escolha um horário diário conveniente para garantir que seu arquivo de dados esteja pronto no servidor, pois a Epsilon Retail Media irá baixá-lo todos os dias. A abordagem mais direta para especificar um arquivo de destino diário para os downloads da Epsilon Retail Mediaé usar um nome de arquivo explícito. Isso permite que a Epsilon Retail Media recupere o arquivo diretamente do seu servidor. Para aqueles que usam os protocolos FTP, FTPS ou SFTP, também oferecemos métodos adicionais para especificar arquivos de destino por meio do que chamamos de modos de arquivo de destino. Essas opções incluem: * Rolling\_earliest * Rolling\_earliest\_24\_hours * Rolling\_latest * Rolling\_latest\_24\_hours. A seleção de um modo de arquivo de destino exige que você forneça um modelo baseado em texto para nomes de arquivos de dados. Este modelo inclui uma string especial, `{\*}`, que ajuda a Epsilon Retail Media corresponder aos nomes de arquivos no seu servidor e selecionar o arquivo correto a cada dia. Por exemplo, considere o modelo `ERMCatalogData_AU_{\*}.txt`. Este modelo exige que os nomes dos arquivos comecem com `ERMCatalogData_AU` e terminem com `.txt`. Usando este modelo, os seguintes nomes de arquivo corresponderiam: `ERMCatalogProduct_AU_20190315.txt` `ERMCatalogProduct_AU_20190314.txt` `ERMCatalogProduct_AU_20190312.txt` Para evitar o download de arquivos de dados que ainda estão em processo de upload, a Epsilon Retail Media baixa apenas arquivos que foram modificados pela última vez mais de um minuto antes do acesso ao servidor. Embora vários arquivos possam corresponder ao modelo, a Epsilon Retail Media processa apenas um arquivo por vez. A seleção do arquivo apropriado entre vários candidatos é guiada pelo modo de arquivo de destino escolhido, que é discutido em detalhes abaixo. ### Rolling\_earliest Neste modo de arquivo de destino, os arquivos são filtrados com base no modelo de nome fornecido. Uma vez filtrados, os arquivos são ordenados em ordem crescente de seus nomes, e o primeiro arquivo nesta ordem é selecionado para download. Por exemplo, se o modelo de nome de arquivo for `ERMCatalogData_AU_{\*}.txt` e a lista filtrada de nomes de arquivos incluir o seguinte: `ERMCatalogProduct_AU_20190312.txt` `ERMCatalogProduct_AU_20190313.txt` `ERMCatalogProduct_AU_20190314.txt` Neste modo, o arquivo `ERMCatalogProduct_AU_20190312.txt` é escolhido para download. ### Rolling\_earliest\_24\_hours Neste modo de arquivo de destino, os arquivos são inicialmente filtrados com base no modelo de nome especificado. Da lista filtrada, apenas os arquivos modificados nas últimas 24 horas são considerados. Os arquivos são então ordenados em ordem crescente por nome, e o primeiro arquivo nesta ordem é selecionado para download. Por exemplo, vamos supor que o horário atual seja `2019-03-15 10:30:07`, e o modelo de nome de arquivo seja `ERMCatalogData_AU_{\*}.txt`. Se a lista filtrada de nomes de arquivos incluir o seguinte: | Nome do arquivo | Última modificação | | ----------------------------------- | ------------------ | | 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 | Neste modo, o arquivo `ERMCatalogProduct_AU_20190314.txt` é escolhido para download. ### Rolling\_latest Neste modo de arquivo de destino, os arquivos são filtrados com base no modelo de nome especificado. Após a filtragem, os arquivos são ordenados em ordem decrescente por seus nomes. O primeiro arquivo nesta lista ordenada é selecionado para download. Por exemplo, se o modelo de nome de arquivo for `ERMCatalogData_AU_{\*}.txt`, e a lista filtrada de nomes de arquivos incluir o seguinte: `ERMCatalogProduct_AU_20190314.txt` `ERMCatalogProduct_AU_20190313.txt` `ERMCatalogProduct_AU_20190312.txt` Neste modo, o arquivo `ERMCatalogProduct_AU_20190314.txt` é escolhido para download. Este modo é semelhante ao Rolling\_earliest, mas em vez de ordenar os arquivos em ordem crescente, eles são ordenados em ordem decrescente. ### Rolling\_latest\_24\_hours Neste modo de arquivo de destino, os arquivos são inicialmente filtrados usando o modelo de nome especificado. Da lista filtrada, apenas os arquivos modificados nas últimas 24 horas são considerados. Os arquivos são então ordenados em ordem decrescente por seus nomes, e o primeiro arquivo nesta ordem é selecionado para download. Por exemplo, suponha que o horário atual seja `2019-03-15 10:30:07`, e o modelo de nome de arquivo seja `ERMCatalogData_AU_{\*}.txt`. Se a lista filtrada de nomes de arquivos incluir: | Nome do arquivo | Última modificação | | ----------------------------------- | ------------------ | | 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 | Neste modo, o arquivo `ERMCatalogProduct_AU_20190315.txt` é escolhido para download. Este modo é semelhante ao Rolling\_earliest\_24\_hours, mas aqui os arquivos são ordenados em ordem decrescente em vez de 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/pt-br/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.