# Enviar Dados de Conversão via FTP ou E-mail

<a href="https://pxa.impact.com/student/activity/1117597?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?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 você estiver coletando dados de conversão (ou seja, ações) no lado do servidor ou por meio de um cookie, será necessário enviar seus dados para a impact.com para poder visualizar o desempenho do seu programa, atribuir crédito aos parceiros e modificar ou reverter quaisquer ações antes que elas sejam bloqueadas.

Este documento orienta você no formato e envio dos seus dados de conversão e pressupõe que você já tenha começado a coletar dados.

#### Antes de começar

* Se precisar de ajuda para coletar dados de conversão com rastreamento não baseado em pixel, entre em contato com seu CSM ou [contate 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* ativadas para sua conta, configurar um pipeline de dados de conversão ficará diferente para você. Saiba como [criar uma Conexão](https://help.impact.com/brand/pt-br/account-administration/account-settings/send-data-to-impactcom/data-connections-overview).
* Os parâmetros obrigatórios para ações web e ações em aplicativos móveis são diferentes. Veja [Parâmetros Específicos para Mobile](https://help.impact.com/brand/pt-br/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/mobile-specific-parameters-for-ftp-or-email-conversion-reporting) para mais informações sobre o envio de conversões de aplicativos móveis.

{% 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 fora desse intervalo. Conversões com até 398 dias podem ser processadas, mas somente se a atribuição for feita usando `MediaId`.
{% endhint %}

#### Etapa 1: Prepare seus dados

Siga as instruções abaixo para visualizar um arquivo de modelo, inserir seus dados de conversão e salvá-lo no formato .csv. O modelo que você precisa depende se você está rastreando conversões no *nível de item* (ou seja, incluindo o SKU, quantidade etc. de cada item em um pedido) ou no *nível de pedido* (ou seja, apenas rastreando os próprios pedidos, não os itens dentro deles). Você também pode enviar [dados de ação encadeada](https://help.impact.com/brand/pt-br/platform-features/actions-and-payouts/actions/track-your-conversion-funnel-using-chained-actions) .

1. Selecione um dos links abaixo para visualizar o modelo de arquivo .csv que corresponde ao nível em que você rastreia ações.
   * [Modelo de Dados/Ações em Nível de Item](https://integrations.impact.com/impact-brand/docs/item-level-data#item-level-template)
   * [Modelo de Dados/Ações em Nível de Pedido](https://integrations.impact.com/impact-brand/docs/order-level-data#order-level-template)
   * [Modelo de Dados de Ações Encadeadas](https://integrations.impact.com/impact-brand/docs/chained-actions#chained-actions-template)
2. Adicione seus dados de conversão ao arquivo.
   * Veja o [documento de Referência de Ações e Dados de Conversão da impact.com](https://integrations.impact.com/impact-brand/docs/impactcom-action-conversion-data-references) 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. Anexe quaisquer parâmetros opcionais que deseje relatar como novas colunas no seu arquivo.
4. Salve seu arquivo em formato .CSV com um título e data facilmente identificáveis (por exemplo, `2020-01-01_ActionData.csv`).

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Observação:</strong> Para arquivos em lote em nível de item, IDs de pedido que tenham vários SKUs associados devem ser listados consecutivamente. Não agrupar itens com a mesma ID de pedido e SKUs diferentes resultará em um <code>ERRO OID_DUPLICATE</code> para os SKUs listados mais abaixo no arquivo.</p></div>

#### Etapa 2: Envie seu arquivo de dados

{% tabs %}
{% tab title="Enviar via FTP/SFTP" %}

* Recomendamos dividir arquivos FTP/SFTP para manter o número máximo de entradas por arquivo abaixo de 10000.
* Para enviar um arquivo ao servidor FTP/SFTP da impact.com, você precisará recuperar as credenciais da conta primeiro. Siga as instruções abaixo para saber como receber suas credenciais 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%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[Perfil do usuário] →** **Configurações**.
2. Na coluna direita, em *Rastreamento*, selecione **Tipos de Evento**.
3. Passe o cursor sobre o tipo de evento para o qual você deseja enviar dados de rastreamento de ações no lado do servidor, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **\[Mais]** à direita e 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%2Fgit-blob-6027673a720a6522269e1861ad0554c4a85baf29%2F9dcf248c757a094c6af27798e61091b8425a0afa1637ae0e5ba3448c5f85b1a1.svg?alt=media) **\[Editar]**.
5. Selecione **Automatizar o processamento de devoluções (avançado) → Enviar arquivo para o servidor FTP do sistema**.
6. Selecione **Enviar por e-mail Nome de usuário e senha do FTP** e **Salvar**.

   * Depois de receber suas credenciais FTP/SFTP, use um cliente FTP/SFTP 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 sensível a maiúsculas/minúsculas.) | (Seu nome de usuário SFTP da impact.com sensível a maiúsculas/minúsculas.) |
   | **Senha**           | (Sua senha FTP da impact.com sensível a maiúsculas/minúsculas.)           | (Sua senha SFTP da impact.com sensível a maiúsculas/minúsculas.)           |
7. Uma vez conectado, envie seu arquivo para o diretório principal do servidor. Após um envio bem-sucedido, vá para a **Etapa 3: Reveja o envio do arquivo** seção abaixo.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Observação:</strong> Se você não recebeu o e-mail com as credenciais FTP/SFTP, entre em contato com a pessoa que criou sua conta na impact.com. Alternativamente, <a href="https://app.impact.com/secure/mediapartner/support/customer-support-portal-flow.ihtml">contate o suporte</a>.</p></div>

{% endtab %}

{% tab title="Buscar arquivo via FTP/SFTP" %}

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%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[Perfil do usuário] →** **Configurações**.
2. Na coluna direita, em *Rastreamento*, selecione **Tipos de Evento**.
3. Passe o cursor sobre o tipo de evento para o qual você deseja enviar dados de rastreamento de ações no lado do servidor, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **\[Mais]** à direita e 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%2Fgit-blob-6027673a720a6522269e1861ad0554c4a85baf29%2F9dcf248c757a094c6af27798e61091b8425a0afa1637ae0e5ba3448c5f85b1a1.svg?alt=media) **\[Editar]**.
5. Selecione **Buscar arquivo do seu próprio servidor FTP**.
6. Insira o **URL do servidor**, **Porta**e o caminho do diretório para o arquivo de dados de ação em seu servidor FTP/SFTP/FTPS. Insira o **Nome de usuário** e **Senha** que a impact.com usará para se conectar ao seu servidor FTP/SFTP/FTPS.
7. Selecione **Salvar** e continue.
8. Carregue seu arquivo de dados de ação no diretório que você especificou acima (ponto 6). A impact.com tenta conectar e baixar arquivos do seu servidor FTP/SFTP/FTPS a cada 24 horas. Aguarde pelo menos 24 horas para a impact.com baixar seu arquivo.
   {% endtab %}

{% tab title="Anexar arquivo 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%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[Perfil do usuário] →** **Configurações**.
2. Na coluna direita, em *Rastreamento*, selecione **Tipos de Evento**.
3. Passe o cursor sobre o tipo de evento para o qual você deseja enviar dados de rastreamento de ações no lado do servidor, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **\[Mais]** à direita e 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%2Fgit-blob-6027673a720a6522269e1861ad0554c4a85baf29%2F9dcf248c757a094c6af27798e61091b8425a0afa1637ae0e5ba3448c5f85b1a1.svg?alt=media) **\[Editar]**.
5. Selecione **Enviar arquivo por e-mail ao servidor SMTP do sistema**, em seguida copie seu endereço de e-mail exclusivo.
6. Usando qualquer cliente de e-mail, envie um e-mail para o endereço exclusivo com seu arquivo de dados de ação como anexo. (Inclua apenas **o endereço de e-mail exclusivo para o tipo de evento** no *Para:* campo. Se precisar enviar este arquivo para outros, inclua-os em *CC:* linha.)

   Você pode deixar o campo de assunto e o corpo da mensagem em branco.
   {% endtab %}
   {% endtabs %}

#### Etapa 3: Reveja 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%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[Perfil do usuário] →** **Configurações**.
2. Na coluna esquerda, na seção *Técnica* , selecione **Envios de Arquivo**.
3. Use a tabela para revisar envios de arquivo recentes que a impact.com recebeu, incluindo o status atual de processamento.
   * Abaixo, você pode ver vários erros que pode encontrar ao revisar envios de arquivo e ações que pode tomar para corrigi-los.

<details>

<summary>Erros ao revisar envios de arquivo</summary>

Alguns erros comuns ao revisar envios de arquivo podem incluir:

| Problema                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Ação a tomar                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Coluna de registros mostra 0                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Certifique-se de que a extensão do arquivo seja .CSV ou .XML.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `ActionTrackerId: Valor inválido`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | <p>O <code>ActionTrackerId</code> não pertence ao <code>Tipo de Evento</code> enviado.</p><p>1. Navegue até <img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media" alt=""> <strong>\[Perfil do usuário] → Configurações → Rastreamento</strong>.</p><p>2. Selecione <strong>Tipos de Evento</strong> e verifique o <code>Tipo de Evento</code>.</p> |
| <p><code>NO\_REFERRERS\_FOUND</code> ou um dos seguintes parâmetros é obrigatório:</p><p>• <code>ClickId</code></p><p>• <code>CustomerId</code></p><p>• <code>CustomProfileId</code></p><p>• <code>CustomClickId</code></p><p>• <code>OrderPromoCode</code></p><p>• <code>MediaPartnerId</code></p><p>• <code>UniqueUrl</code></p><p>• <code>CallerId</code></p><p>• <code>GoogAId</code></p><p>• <code>AndroidId</code></p><p>• <code>AppleIfa</code></p><p>• <code>AppleIfv</code></p><p>• <code>WinId</code></p><p>• <code>PhoneNumber</code></p><p>• <code>Odin1</code></p><p>• <code>DeviceId</code></p><p>• <code>OpenUdId</code></p><p>• <code>Mac</code></p><p>• <code>MacMd5</code> é obrigatório</p> | <p>Você não forneceu nenhum parâmetro relacionado à atribuição.</p><p>Forneça pelo menos um parâmetro de atribuição, para que o sistema possa identificar a qual parceiro atribuir.</p>                                                                                                                                                                                                                                                                                                                                                                           |
| `OID_Duplicate`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | <p>O <code>OID</code> já está no sistema da impact.com. Forneça um tipo de evento exclusivo.</p><p><strong>Observação:</strong> Se você está tentando enviar conversões não atribuídas que já foram relatadas para nós no passado, use um OID ligeiramente diferente. Ex.: xxxxxx <strong>\_1</strong>.</p>                                                                                                                                                                                                                                                       |
| `CLICK_AFTER_CONVERSION_EVENT`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | O clickid enviado ocorreu após o evento de conversão. Por favor, verifique se os `ClickId` e `EventDate` enviados estão corretos.                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `NO_VALID_REFERRERS_FOUND ACTIONTERMS_NOT_FOUND`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | O contrato com o parceiro ativo durante o `EventDate` não inclui este tipo específico de evento. Certifique-se de verificar seu contrato com o parceiro em ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Contratos → Contratos**.                                                                                                  |
| `NO_VALID_REFERRERS _ FOUND CONTRACT_NOT_FOUND`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | <p>Não há contrato ativo com o parceiro durante o <code>EventDate</code>.</p><p>• Selecione <img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media" alt=""> <strong>\[Engage] → Contratos → Contratos</strong> para verificar o histórico de contratos.</p>                                                                                          |
| `NO_VALID_REFERNO_VALID_REFERRERS_FOUND OUTSIDE_ASSOCIATION_WINDOW`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | <p>A conversão está fora da janela de encaminhamento por clique indicada nos termos do contrato. A configuração padrão é 30 dias.</p><p>• Selecione <img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media" alt=""> <strong>\[Engage] → Contratos → Contratos</strong> para verificar a janela de encaminhamento para um parceiro específico.</p>    |

</details>
