> 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-call-conversion-data-via-ftp.md). # Enviar dados de conversão de chamadas via FTP Faça o curso PXA Marcas que estão rastreando dados de conversão de chamadas podem enviar esses dados em lote em um arquivo .CSV que é carregado no servidor FTP da Impact com credenciais exclusivas. Os dados de conversão de chamadas enviados em lote ao impact.com via FTP normalmente são processados em até 24 horas e aparecerão como ações pendentes na plataforma impact.com. #### Envie seu arquivo .CSV Para enviar ao servidor FTP do impact.com, primeiro você precisará recuperar as credenciais da conta. Siga as instruções abaixo para saber como receber por e-mail suas credenciais existentes. {% hint style="warning" %} **Observação:** Se você não recebeu o e-mail, entre em contato com a pessoa que criou sua conta no impact.com, ou alternativamente [entre em contato com o suporte](https://app.impact.com/secure/mediapartner/support/customer-support-portal-flow.ihtml?execution=e1s1). {% endhint %} 1. Na barra de navegação superior, selecione ![](/files/24b09e08af742531bcfb4e5dc0f1976c6026280a) **\[Perfil do usuário] → Configurações**. 2. Na coluna da direita, em *Rastreamento*, selecione **Tipos de evento**. 3. Passe o cursor sobre o tipo de evento para o qual você deseja enviar dados e, em seguida, selecione ![](/files/19661962d7c41673a711ca84d7efe61f00165e41) **\[Mais] → Ver/Editar**. 4. Ao lado de *Processamento de devoluções*, selecione ![](/files/12d9fe11cb158abf4a98f08e987fb85e3430db2e) **\[Editar]**. 5. Selecione **Automatizar o processamento de devoluções (avançado) → Upload em lote**. 6. Escolha uma conexão FTP selecionando ![](/files/27a40f26b5bd84bf51b027f804aa6f07400faa96) **\[Caixa desmarcada]**. * Como alternativa, selecione **Criar nova conexão**. Saiba como [criar uma conexão de upload de dados](/brand/pt-br/what-would-you-like-to-learn-about/account-administration/account-settings/send-data-to-impactcom/create-a-data-upload-connection.md). 7. Depois de obter suas credenciais FTP, use um cliente FTP para se conectar ao impact.com. * O endereço FTP é `ftp://import.impact.com/{name}` * Você pode usar um conjunto existente de credenciais ou um conjunto de credenciais gerado automaticamente. 8. Depois de conectado, carregue seu arquivo no diretório principal do servidor. #### Especificações do formato do arquivo de conversão de chamadas Os dados de conversão de chamadas são preenchidos em um arquivo .CSV. Consulte a especificação abaixo para todos os cabeçalhos de coluna necessários no seu arquivo .CSV.
Referência do formato do arquivo de conversão de chamadas | Campo | Tipo | Obrigatório | Descrição | | ---------------------------------------- | ---------------------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `IdDaCampanha` | Inteiro | **Obrigatório** | Identificador exclusivo da campanha (ou programa) à qual a conversão de chamada está associada. | | `IdDaMídia` | Inteiro | **Obrigatório** | Identificador exclusivo do parceiro ou da fonte de mídia. | | `DataDoEvento` | data e hora (ISO 8601) | **Obrigatório** | Formato ISO 8601 da data e hora em que o evento de conversão de chamada ocorreu. | | `IdDoRastreadorDeAção` | Inteiro | **Obrigatório** | Identificador exclusivo do rastreador de ação (ou seja, tipo de evento) que está rastreando a chamada telefônica. | | `ProvedorDaChamada` | String | **Obrigatório** | O fornecedor ou cliente que está enviando os dados do evento de chamada | | `IdDaSessãoDaChamada` | String | **Obrigatório** | Um ID de sessão exclusivo que o fornecedor ou cliente usa para identificar a chamada. | | `IdDoChamador` | String | **Obrigatório** | O número de telefone da chamada de origem, usado para corresponder à conversão final. | | `NúmeroDeTelefoneChamado` | String | **Obrigatório** | O número de telefone de destino ou o número que recebeu a chamada. | | `DuraçãoDaChamada` | String | **Obrigatório** | Duração total (em segundos) da chamada. | | `DuraçãoDaConversa` | String | **Obrigatório** | Duração real da conversa (em segundos) da chamada. | | `IdDoAnúncio` | Inteiro | Opcional | Identificador exclusivo do anúncio associado à conversão da chamada. | | `StatusDaChamada` | String | Opcional |

Este valor indica o resultado final da chamada. Se o campo não estiver presente na solicitação, usamos ATENDIDA por padrão. Os valores válidos são:

ID\_DO\_CHAMADOR\_DESCONHECIDO

FALHA

CONGESTIONAMENTO

INCOMPLETA

CANCELADA

ABANDONO\_NO\_IVR

SEM\_TENTATIVA\_DE\_TRANSFERÊNCIA

ATENDIDA

| | `PaísDoNúmeroDoChamador` | String | Opcional | Código de país de dois dígitos do número de telefone de origem (ISO 3166 alpha-2). Quando NULL, o padrão é US. | | `PaísDoNúmeroChamado` | String | Opcional | Código de país de dois dígitos do número de telefone chamado (ISO 3166 alpha-2). Quando NULL, o padrão é US. | | `SubId1` | String | Opcional | Este valor é específico e está disponível somente para o parceiro de mídia. Este é o espaço reservado onde o Parceiro de Mídia pode adicionar pontos de dados que deseja que o impact.com reporte de volta. | | `SubId2` | String | Opcional | | | `SubId3` | String | Opcional | | | `IdDoClique` | String | Opcional | Identificador exclusivo, sensível a maiúsculas e minúsculas, gerado pelo impact.com para um clique de referência, usado para construir a jornada do consumidor. | | `País` | String | Opcional | País do CallerId - conforme identificado pelo fornecedor de rastreamento de chamadas. | | `Cidade` | String | Opcional | Cidade do CallerId - conforme identificado pelo fornecedor de rastreamento de chamadas. | | `Região` | String | Opcional | Região do CallerId - conforme identificado pelo fornecedor de rastreamento de chamadas. | | `CEP` | Inteiro | Opcional | CEP do CallerId - conforme identificado pelo fornecedor de rastreamento de chamadas. | | `ChamadorRecorrente` | String | Opcional | Chamada recorrente vs. nova para indicar se o chamador foi registrado como recorrente pelo fornecedor de rastreamento de chamadas. | | `TipoDeTelefone` | String | Opcional | O tipo de telefone (isto é, fixo, celular). | | `GravaçãoDaChamada` | String | Opcional | URL exclusiva da gravação da chamada. | | `DuraçãoDoIVR` | String | Opcional | Duração em segundos que a chamada passou na árvore de IVR. | | `TeclasPressionadas` | String | Opcional | Lista de nomes de teclas exclusivas que foram pressionadas durante a chamada. | | `Tecla1` | String | Opcional | Nome da primeira tecla que foi pressionada. | | `Tecla2` | String | Opcional | Nome da segunda tecla que foi pressionada. | | `Tecla3` | String | Opcional | Nome da terceira tecla que foi pressionada. | | `Tecla4` | String | Opcional | Nome da quarta tecla que foi pressionada. | | `FonteDeTráfego` | String | Opcional | Fonte da transação (fonte de mídia de referência). | | `OptInSms` | String | Opcional | Se o chamador optou por receber uma promoção por SMS. | | `AgenteDoUsuário` | String | Opcional | O user agent do gerador da conversão. | | `NomeDaDisposição` | String | Opcional | O nome do evento de conversão. | | `ValorDaVenda` | Moeda | Opcional | Se for uma conversão de venda, valor da venda | | `IdDeReferência` | String | Opcional | Código de disposição do cliente para referência. | | `NomePersonalizadoDoEventoDeConversão1` | String | Opcional | Nome personalizado para relatório de eventos de conversão | | `NomePersonalizadoDoEventoDeConversão2` | String | Opcional | | | `NomePersonalizadoDoEventoDeConversão3` | String | Opcional | | | `ValorPersonalizadoDoEventoDeConversão1` | String | Opcional | Valor personalizado para relatório de eventos de conversão | | `ValorPersonalizadoDoEventoDeConversão2` | String | Opcional | | | `ValorPersonalizadoDoEventoDeConversão3` | String | Opcional | | | `IdDoEventoDoFornecedor` | String | Opcional | Será exclusivo para o evento de chamada e exclusivo para o evento de conversão. | | `DescriçãoDoNúmeroPromocional` | String | Opcional | Descreve o número de telefone chamado | | `NomePersonalizadoDoEventoDeChamada1` | String | Opcional | Nome personalizado para relatório de eventos de chamada | | `NomePersonalizadoDoEventoDeChamada2` | String | Opcional | | | `NomePersonalizadoDoEventoDeChamada3` | String | Opcional | | | `ValorPersonalizadoDoEventoDeChamada1` | String | Opcional | Valor personalizado para relatório de eventos de chamada | | `ValorPersonalizadoDoEventoDeChamada2` | String | Opcional | | | `ValorPersonalizadoDoEventoDeChamada3` | String | Opcional | |
#### Exemplo de CSV Copie estes dados de exemplo de CSV para usar na importação do seu arquivo. ```programlisting IdDaCampanha,IdDaMídia,DataDoEvento,IdDoRastreadorDeAção,ProvedorDaChamada,IdDaSessãoDaChamada,IdDoChamador,NúmeroDeTelefoneChamado,DuraçãoDaChamada,DuraçãoDaConversa,IdDoAnúncio,StatusDaChamada,PaísDoNúmeroDoChamador,PaísDoNúmeroChamado,SubId1,SubId2,SubId3,IdDoClique,Cidade,Região,CEP,ChamadorRecorrente,TipoDeTelefone,GravaçãoDaChamada,DuraçãoDoIVR,TeclasPressionadas,Tecla1,Tecla2,Tecla3,Tecla4,OptInSms,AgenteDoUsuário,NomeDaDisposição,ValorDaVenda,IdDeReferência,NomePersonalizadoDoEventoDeConversão1,NomePersonalizadoDoEventoDeConversão2,NomePersonalizadoDoEventoDeConversão3,ValorPersonalizadoDoEventoDeConversão1,ValorPersonalizadoDoEventoDeConversão2,ValorPersonalizadoDoEventoDeConversão3,IdDoEventoDoFornecedor,DescriçãoDoNúmeroPromocional,NomePersonalizadoDoEventoDeChamada1,NomePersonalizadoDoEventoDeChamada2,NomePersonalizadoDoEventoDeChamada3,ValorPersonalizadoDoEventoDeChamada1,ValorPersonalizadoDoEventoDeChamada2,ValorPersonalizadoDoEventoDeChamada3 1000,987654,2022-03-01T04:10:49-05:00,19283,Acme,1A5B9C4D0E0F7G1H0I,8005550100,11,8, ``` --- # 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/submit-call-conversion-data-via-ftp.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.