> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/batch-submit-conversion-data.md).
# Enviar dados de conversão em lote
Você pode usar processamento em lote para enviar dados de conversão diretamente para a impact.com se seus dados de conversão não forem rastreados automaticamente — seja porque você os coleta no lado do servidor ou depende de cookies. Você também pode precisar de [enviar dados de conversão retroativamente](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/submit-conversion-data-via-ftp-or-email.md) em alguns momentos, como quando um cliente não usa o código promocional de um parceiro. Enviar esses dados garante que você atribua o crédito aos parceiros certos, mantenha seus relatórios precisos e, opcionalmente, modifique ou reverta ações antes que sejam bloqueadas.
* If you need help collecting conversion data with non-pixel tracking, reach out to your CSM or [contact support](https://app.impact.com/support/portal.ihtml?createTicket=true). To learn more about your tracking method and integration, we recommend consulting the original Technical Integration Plan provided to you by our Technical Services team.
* If you have *Connections* turned on for your account, setting up a conversion data pipeline will look different for you. Learn how to [create a Connection](/brand/what-would-you-like-to-learn-about/account-administration/account-settings/send-data-to-impactcom/data-connections-overview.md).
* The required parameters for web actions and mobile app actions are different. See [Mobile-Specific Parameters](/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/mobile-specific-parameters-for-ftp-or-email-conversion-reporting.md) for more information on submitting mobile app conversions.
{% stepper %}
{% step %}
### Prepare seu arquivo de dados
Siga as instruções abaixo para visualizar um arquivo modelo, adicionar seus dados de conversão e salvá-lo em formato .csv. O modelo de que você precisa depende de você estar rastreando conversões no *nível do item* (ou seja, incluindo o SKU, a quantidade etc. de cada item em um pedido) ou no *nível do pedido* (ou seja, rastreando apenas os próprios pedidos, não os itens dentro deles). Você também pode enviar [ação encadeada](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/actions-and-payouts/actions/track-your-conversion-funnel-using-chained-actions.md) dados.
{% hint style="warning" %}
**Aviso:** Recomendamos fortemente não enviar ações com mais de 88 dias, pois a impact.com atualmente não processa conversões enviadas por FTP com datas de evento além dessa janela. Conversões de até 398 dias podem ser processadas, mas somente se a atribuição for feita usando `MediaId`.
{% endhint %}
1. Selecione um dos links abaixo para visualizar o modelo de arquivo .csv que corresponde ao nível em que você rastreia as ações.
* [Modelo de Dados de Ações/Conversões em Nível de Item](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references/item-level-template)
* [Modelo de Dados de Ações/Conversões em Nível de Pedido](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references/order-level-template)
* [Modelo de Dados de Conversão de Ações Encadeadas](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references/chained-actions-template)
2. Adicione seus dados de conversão ao arquivo.
* Consulte a [Referência de Dados de Ações e Conversões da impact.com](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references) doc para exemplos e use este arquivo como referência para os parâmetros aceitos. Entre em contato com seu CSM para descobrir quais parâmetros seriam melhores incluir no seu modelo de dados de conversão.
3. Acrescente quaisquer parâmetros opcionais que você queira reportar como novas colunas no seu arquivo.
4. Salve seu arquivo em formato .CSV com um título e uma data fáceis de identificar (por exemplo, `2020-01-01_ActionData.csv`).
{% hint style="success" %}
**Observação:** Para arquivos em lote em nível de item, IDs de Pedido que tenham vários SKUs associados devem ser listados consecutivamente. Certifique-se de que os itens de linha com o mesmo ID de Pedido e SKUs diferentes sejam agrupados, ou você pode receber um `OID_DUPLICATE` erro para os SKUs listados mais abaixo no arquivo.
{% endhint %}
{% endstep %}
{% step %}
### Escolha seu método de envio
Você pode formatar e enviar seus dados via FTP/SFTP ou e-mail. Use o método que funcionar melhor para o que você deseja alcançar.
| If you want to... | Use this method... |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Submit a manual, one-time file with no coding | [Email](/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/submit-conversion-data-via-ftp-or-email.md) batch processing or [upload file via FTP](/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/batch-submit-conversion-data.md) |
| Set up automated conversion reporting | [Conversions API](https://integrations.impact.com/integration-guides/for-brands/tracking-integrations/api-online-sale/implementation), [push file via FTP](/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/batch-submit-conversion-data.md), or [pull file via FTP](/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/batch-submit-conversion-data.md) |
| {% endstep %} | |
{% step %}
### Envie seu arquivo de dados
1. Na barra de navegação superior, selecione  **\[Perfil do usuário] → Configurações**.
2. Na coluna da direita, em *Rastreamento*, selecione [**Tipos de Evento**](https://app.impact.com/secure/advertiser/tracking-settings/actiontracker/view-actiontracker-flow.ihtml).
3. Selecione o **nome** do Tipo de Evento para o qual você deseja enviar modificações em lote.
4. Ao lado de *Processamento de Devoluções*, selecione  **\[Editar]**.
5. Selecione **Automatizar processamento de devoluções (avançado)**.
6. Escolha um dos seguintes métodos relacionados a FTP ou e-mail para enviar seu arquivo:
Carregar arquivo para o servidor FTP do sistema
{% hint style="info" %}
Recomendamos dividir os arquivos FTP/SFTP para manter o número máximo de entradas por arquivo abaixo de 10.000.
{% endhint %}
1. Selecione **Carregue o arquivo no servidor FTP do sistema.**
2. Selecione **Enviar nome de usuário e senha FTP por e-mail** e **Salvar**.
3. Depois de receber suas credenciais FTP por e-mail, use um cliente FTP para se conectar à impact.com com as seguintes informações:
| | FTP | SFTP |
| ------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| **Servidor** | batch.impact.com | sftp\://batch.impact.com |
| **Porta** | 21 | 22 |
| **Nome de usuário** | (Seu nome de usuário FTP da impact.com, com diferenciação entre maiúsculas e minúsculas.) | (Seu nome de usuário SFTP da impact.com, com diferenciação entre maiúsculas e minúsculas.) |
| **Senha** | (Sua senha FTP da impact.com, com diferenciação entre maiúsculas e minúsculas.) | (Sua senha SFTP da impact.com, com diferenciação entre maiúsculas e minúsculas.) |
4. Depois de conectado, faça upload do seu arquivo para o diretório principal do servidor.
* Se você não tiver recebido o e-mail com as credenciais FTP, entre em contato com a pessoa que criou sua conta na impact.com. Como alternativa, [entre em contato com o suporte](https://app.impact.com/support/portal.ihtml).
Baixar arquivo do seu próprio servidor FTP
{% hint style="info" %}
Recomendamos dividir os arquivos FTP/SFTP para manter o número máximo de entradas por arquivo abaixo de 10.000.
{% endhint %}
1. Selecione **Baixar arquivo do seu próprio servidor FTP**.
2. Insira o **URL do servidor**, **Porta**, e **Diretório** caminho para o arquivo de modificações em lote no seu servidor FTP. Insira o **Nome de usuário** e **Senha** que a impact.com usará para se conectar ao seu servidor FTP.
3. Selecione **Salvar** e continue.
4. Carregue seu arquivo para o *Diretório* que você especificou acima.
* A impact.com tenta se conectar e baixar arquivos do seu servidor FTP a cada 24 horas, então seu arquivo pode levar até 24 horas para ser processado após o upload.
Enviar arquivo por e-mail para o servidor SMTP do sistema
1. Selecione **Enviar arquivo por e-mail para o servidor SMTP do sistema.**
2. Um endereço de e-mail exclusivo será fornecido para você logo abaixo do método selecionado. Copie esse endereço de e-mail.
3. Usando qualquer cliente de e-mail, envie um e-mail para o endereço exclusivo com seu arquivo de modificações em lote em anexo.
* Inclua somente o endereço de e-mail exclusivo para o tipo de evento no campo *Para:* Se você precisar enviar este arquivo para outras pessoas, inclua-as no campo *CC:* campo.
4. Você pode deixar o campo de assunto e o corpo da mensagem em branco.
* Veja abaixo um exemplo do endereço de e-mail (o seu será um pouco diferente):
{% endstep %}
{% step %}
### Revise o envio do seu arquivo
1. Na barra de navegação superior, selecione  **\[Perfil do usuário] →** **Configurações**.
2. Na coluna da esquerda, em *Técnico* seção, selecione [**Envios de Arquivos**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/ftp-file-submissions-flow.ihtml).
3. Use a tabela para revisar os envios recentes de arquivos que a impact.com recebeu, incluindo o status atual do processamento.
* A seguir, você pode ver vários erros que pode encontrar ao revisar envios de arquivos e as ações que pode tomar para corrigi-los.
Submission troubleshooting reference
| Issue | Action to take |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Records column shows 0 | Make sure the file extension is . CSV or .XML. |
| `NO_CHANGE` | There is no change made to the action. Please ensure you enter the final amount into the *Amount* column (e.g., enter 0 if you want to reverse actions). |
| `BAD_DISPOSITION` | The reason code you provided is not valid. Please use one of the standard reason codes.
Alternatively, you can set up a custom disposition code.
|
| `ALREADY_LOCKED` | The action locking period has already passed. The action can no longer undergo modifications or reversals. |
| `ActionTrackerld:ActionTrackerld value is invalid` | This should correspond to the [Event Type ID](/brand/what-would-you-like-to-learn-about/platform-features/event-types/how-do-i-find-my-event-type-ids.md) entered. |
| `ACTION_NOT_FOUND` | The `OID` you provided is incorrect. Please provide a correct `OID`. |
| `ALREADY_REVERSED` | The action has already been reversed. |
| `ALREADY_APPROVED` | The action has already been approved. |
{% endstep %}
{% endstepper %}
---
# 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/batch-submit-conversion-data.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
