> 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/submit-conversion-data-via-ftp-or-email.md).

# Enviar dados de conversão retroativamente

<a href="https://pxa.impact.com/student/activity/1117597?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0&#x26;utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=tra-350&#x26;utm_campaign=help-center" class="button primary">Faça o curso PXA</a>

Se os dados de conversão não forem rastreados automaticamente — seja porque você os coleta no servidor, depende de cookies ou porque um cliente não usa o código promocional de um parceiro —, você pode enviá-los retroativamente à impact.com. Assim, você pode atribuir o crédito aos parceiros corretos, manter seus relatórios precisos e, se desejar, modificar ou reverter ações antes que sejam bloqueadas.

Este artigo explica como formatar e enviar seus dados por *e-mail*, o método mais simples para um envio retroativo único.

## Que outros métodos posso usar?

| If you want to...                             | Use this method...                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Submit a manual, one-time file with no coding | ​[Email](https://help.impact.com/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](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.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](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.md), or [pull file 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.md) |

## Enviar dados de conversão retroativamente

{% embed url="<https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FQia5p714TJ3C2pnrfT6f%2Fcon-250-10.mp4?alt=media&token=e34b3ec6-9751-4bf3-ae5e-5360f173877a>" %}

* 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](https://help.impact.com/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](https://help.impact.com/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.

{% hint style="warning" %}
**Pré-requisito:** Para usar esse recurso, você precisa ter a edição do produto Essentials ou superior. Entre em contato com o [suporte](https://app.impact.com/support/portal.ihtml?createTicket=true&) para fazer o upgrade.
{% endhint %}

{% stepper %}
{% step %}

### Preparar seu arquivo de dados

Siga as instruções abaixo para visualizar um arquivo de modelo, adicionar seus dados de conversão e salvá-lo no formato .csv. O modelo necessário depende de você rastrear conversões no *nível do item* (ou seja, incluindo o SKU, a quantidade etc. de cada item de um pedido) ou no *nível do pedido* (ou seja, rastreando apenas os pedidos, e não os itens incluídos neles). Você também pode enviar dados de [ações encadeadas](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/actions-and-payouts/actions/track-your-conversion-funnel-using-chained-actions.md) .

{% hint style="warning" %}
**Aviso:** Recomendamos fortemente que você não envie ações com mais de 88 dias, pois atualmente o impact.com não processa conversões enviadas por FTP com datas de evento anteriores a esse período. 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 correspondente ao nível em que você rastreia as ações.
   * [Modelo de dados de ações/conversões no nível do 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 no nível do pedido](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references/order-level-template)
   * [Modelo de dados de conversões 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 o [Documento de referência de dados de ações e conversões do impact.com](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references) para ver exemplos e use este arquivo como referência dos parâmetros aceitos. Entre em contato com seu CSM para saber quais parâmetros são mais adequados para incluir no modelo de dados de conversão.
3. Adicione como novas colunas ao arquivo os parâmetros opcionais que deseja incluir nos relatórios.
4. Salve o arquivo no 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:** Em arquivos de lote no nível do item, os IDs de pedido associados a vários SKUs devem ser listados consecutivamente. Se os itens de linha com o mesmo ID de pedido e SKUs diferentes não forem agrupados, ocorrerá um erro `OID_DUPLICATE` para os SKUs listados mais abaixo no arquivo
{% endhint %}
{% endstep %}

{% step %}

### Envie o arquivo de dados por e-mail

1. Na barra de navegação superior, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Perfil do usuário] → Configurações**.
2. Na coluna à direita, em *Rastreamento*, selecione [**Tipos de evento**](https://app.impact.com/secure/advertiser/tracking-settings/actiontracker/view-actiontracker-flow.ihtml).
3. Passe o cursor sobre o tipo de evento para o qual você quer enviar dados de conversão e selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FaMIlbqH54V4Ow5JvT0I0%2F%5BMore%5D%20vNext%202.svg?alt=media\&token=6d5449e8-e413-48fa-b059-58ebb3e2c271) **\[Mais]**, depois selecione **Visualizar / Editar**.
4. Ao lado de *Processamento de devoluções*, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fkka3dqJOx8ZhiX82RDLt%2FEdit_light.svg?alt=media\&token=f454405c-ebd8-49af-90db-22efc27476bf) **\[Editar]**.
5. Selecione **Enviar arquivo por e-mail para o servidor SMTP do sistema**, depois copie seu endereço de e-mail exclusivo.
6. Antes de enviar o arquivo, confirme o seguinte:
   * Seu arquivo está salvo no formato .CSV.
   * Você escolheu o nível de dados correto: nível do item para detalhes do produto ou nível do pedido para totais do pedido.
   * Você está usando o modelo da impact.com correspondente ao nível de dados escolhido.
7. Usando qualquer cliente de e-mail, envie uma mensagem para o endereço exclusivo com o arquivo de dados de conversão anexado.
   * Inclua somente o endereço de e-mail exclusivo para o tipo de evento no campo *Para:* . Se precisar enviar esse arquivo para outras pessoas, inclua os endereços no campo *CC:* .
8. Deixe em branco o campo de assunto e o corpo da mensagem e **envie** o e-mail.
   {% endstep %}

{% step %}

### Revise o envio do arquivo

1. Na barra de navegação superior, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Perfil do usuário] →** **Configurações**.
2. Na coluna à esquerda, em *Técnico* selecione a seção [**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 recebidos pela impact.com, incluindo o status de processamento atual.
   1. Abaixo, você pode ver vários erros que pode encontrar ao revisar os envios de arquivos e as ações que pode realizar para corrigi-los.

<details>

<summary>Submission troubleshooting reference</summary>

| 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`                                  | <p>The reason code you provided is not valid. Please use one of the standard <a href="https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md">reason codes</a>.</p><p>Alternatively, you can set up a <a href="https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/manage-disposition-codes.md">custom disposition code</a>.</p> |
| `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](https://help.impact.com/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.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |

</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 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/submit-conversion-data-via-ftp-or-email.md?ask=<question>&goal=<user_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.
