> 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 o processamento em lote para enviar dados de conversão diretamente ao impact.com se seus dados de conversão não forem rastreados automaticamente — seja porque você os coleta no 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 casos, como quando um cliente não informa 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 elas sejam bloqueadas.

* Se você precisar de ajuda para coletar dados de conversão com rastreamento não baseado em pixel, entre em contato com seu CSM ou [entre em contato com o suporte](https://app.impact.com/support/portal.ihtml?createTicket=true). Para saber mais sobre seu método de rastreamento e integração, recomendamos consultar o Plano de Integração Técnica original fornecido a você pela nossa equipe de Serviços Técnicos.
* Se você tiver *Conexões* ativado para a sua conta, configurar um pipeline de dados de conversão será diferente para você. Saiba como [criar uma conexão](/brand/pt-br/what-would-you-like-to-learn-about/account-administration/account-settings/send-data-to-impactcom/data-connections-overview.md).
* Os parâmetros necessários para ações na web e ações de aplicativos móveis são diferentes. Consulte [Parâmetros específicos para dispositivos móveis](/brand/pt-br/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) para mais informações sobre o envio de conversões de aplicativos móveis.

{% stepper %}
{% step %}

### Prepare seu arquivo de dados

Siga as instruções abaixo para visualizar um arquivo de modelo, adicionar seus dados de conversão e salvá-lo em formato .csv. O modelo de que você precisa depende de se você está 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 pedidos em si, 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 o impact.com atualmente não processa conversões enviadas por FTP com datas de evento além dessa janela. Conversões com 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 Conversão/Ações no Nível do Item](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references/item-level-template)
   * [Modelo de Dados de Conversão/Ações no Nível do Pedido](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references/order-level-template)
   * [Modelo de Dados de Conversão de Ações Encadeadas](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references/chained-actions-template)
2. Adicione seus dados de conversão ao arquivo.
   * Consulte o [Referência de Dados de Ações e Conversões do impact.com](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references) documentação 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 para incluir no seu modelo de dados de conversão.
3. Adicione quaisquer parâmetros opcionais que você queira informar como novas colunas no seu arquivo.
4. Salve seu arquivo no formato .CSV com um título e data facilmente identificáveis (por exemplo, `2020-01-01_ActionData.csv`).

{% hint style="success" %}
**Observação:** Para arquivos em lote no nível do item, os IDs de pedido que tenham múltiplos SKUs associados devem ser listados consecutivamente. Certifique-se de que os itens de linha com o mesmo ID de pedido e SKUs diferentes estejam agrupados juntos, ou você poderá 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 melhor funcione para o que você deseja alcançar.

| Se você quiser...                                 | Use este método...                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Envie um arquivo manual, único, sem programação   | ​[Email](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/batch-submit-conversion-data#email-file-to-system-smtp-server) processamento em lote ou [enviar arquivo via FTP](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/batch-submit-conversion-data#upload-file-to-system-ftp-server)                                                                                                        |
| Configurar relatórios automatizados de conversões | ​[Conversões](https://integrations.impact.com/brand-api-reference/reference/conversions/conversions) API, [enviar arquivo via FTP](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/batch-submit-conversion-data#upload-file-to-system-ftp-server), ou [baixar arquivo via FTP](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/batch-submit-conversion-data#pull-file-from-your-own-ftp-server) |
| {% endstep %}                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |

{% step %}

### Envie seu arquivo de dados

1. Na barra de navegação superior, selecione ![](/files/cc510dcd14da0c528f14731f55068f027f9c731d) **\[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 ![](/files/f1c5fe94457426459cac3548436ce2a195dcde68) **\[Editar]**.
5. Selecione **Automatizar o processamento de devoluções (avançado)**.
6. Escolha um dos seguintes métodos relacionados a FTP ou e-mail para enviar seu arquivo:

<details>

<summary>Carregar arquivo para o servidor FTP do sistema</summary>

{% 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 **Carregar arquivo para o servidor FTP do sistema.**
2. Selecione **Enviar por e-mail o nome de usuário e a senha do FTP** e **Salvar**.
3. Depois de receber suas credenciais de FTP por e-mail, use um cliente FTP para se conectar ao 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 de FTP do impact.com, sensível a maiúsculas e minúsculas.) | (Seu nome de usuário de SFTP do impact.com, sensível a maiúsculas e minúsculas.) |
   | **Senha**           | (Sua senha de FTP do impact.com, sensível a maiúsculas e minúsculas.)           | (Sua senha de SFTP do impact.com, sensível a maiúsculas e minúsculas.)           |
4. Depois de conectado, carregue seu arquivo para o diretório principal do servidor.
   * Se você não recebeu o e-mail com as credenciais de FTP, entre em contato com a pessoa que criou sua conta no impact.com. Como alternativa, [entre em contato com o suporte](https://app.impact.com/support/portal.ihtml).

</details>

<details>

<summary>Obter arquivo do seu próprio servidor FTP</summary>

{% 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 **Obter arquivo do seu próprio servidor FTP**.
2. Informe 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 o 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.
   * O 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 envio.

</details>

<details>

<summary>Enviar arquivo por e-mail para o servidor SMTP do sistema</summary>

1. Selecione **Enviar arquivo por e-mail para o servidor SMTP do sistema.**
2. Um endereço de e-mail exclusivo será fornecido logo abaixo do método selecionado. Copie este endereço de e-mail.
3. Usando qualquer cliente de e-mail, envie uma mensagem para o endereço exclusivo com seu arquivo de modificações em lote em anexo.
   * Inclua apenas 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:* .
4. Você pode deixar o campo de assunto e o corpo da mensagem em branco.
   * Veja um exemplo do endereço de e-mail abaixo (o seu será um pouco diferente):

<div data-with-frame="true"><figure><img src="/files/739ae6191ed360ee90cfe7b3c0ec6d362fe72df5" alt="" width="446"><figcaption></figcaption></figure></div>

</details>
{% endstep %}

{% step %}

### Revise o envio do seu arquivo

1. Na barra de navegação superior, selecione ![](/files/45f862e198f73982700ff092afe256a7fe2e0fff) **\[Perfil do usuário] →** **Configurações**.
2. Na coluna 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 de arquivos recentes que o impact.com recebeu, incluindo o status atual de processamento.
   * Abaixo, você pode ver vários erros que pode encontrar ao revisar os envios de arquivos e as ações que pode tomar para corrigi-los.

<details>

<summary>Referência de solução de problemas de envio</summary>

| Problema                                           | Ação a tomar                                                                                                                                                                 |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| A coluna Registros mostra 0                        | Certifique-se de que a extensão do arquivo seja . CSV ou .XML.                                                                                                               |
| `NO_CHANGE`                                        | Nenhuma alteração foi feita na ação. Certifique-se de inserir o valor final na *Amount* coluna (por exemplo, insira 0 se quiser reverter as ações).                          |
| `ALREADY_LOCKED`                                   | O período de bloqueio da ação já passou. A ação não pode mais passar por modificações ou reversões.                                                                          |
| `ActionTrackerld:ActionTrackerld value is invalid` | Isso deve corresponder ao [ID do tipo de evento](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/event-types/how-do-i-find-my-event-type-ids.md) inserido. |
| `ACTION_NOT_FOUND`                                 | O `OID` fornecido está incorreto. Forneça um `OID`.                                                                                                                          |
| `ALREADY_REVERSED`                                 | A ação já foi revertida.                                                                                                                                                     |
| `ALREADY_APPROVED`                                 | A ação já foi aprovada.                                                                                                                                                      |

</details>
{% 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 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.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=<question>&goal=<endgoal>
```

`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.
