> 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. Dados de conversão de chamadas enviados em lote para a impact.com via FTP são normalmente processados em até 24 horas e aparecerão como ações pendentes na plataforma impact.com. #### Faça o upload do seu arquivo .CSV Para enviar para o servidor FTP da impact.com, você precisará recuperar primeiro 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 na impact.com; alternativamente [contatar 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/45f862e198f73982700ff092afe256a7fe2e0fff) **\[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ê quer enviar dados e, em seguida, selecione ![](/files/19661962d7c41673a711ca84d7efe61f00165e41) **\[Mais] → Ver/Editar**. 4. Ao lado de *Processamento de devoluções*, selecione ![](/files/f1c5fe94457426459cac3548436ce2a195dcde68) **\[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 ter suas credenciais de FTP, use um cliente FTP para se conectar à impact.com. * O endereço FTP é `ftp://import.impact.com/{name}` * Você pode usar um conjunto de credenciais existente ou um conjunto de credenciais gerado automaticamente. 8. Depois de conectado, envie seu arquivo para o 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 obrigatórios necessários no seu arquivo .CSV.
Referência do formato do arquivo de conversão de chamadas | Campo | Tipo | Obrigatório | Descrição | | ----------------------------- | ------------------- | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `CampaignId` | Inteiro | **Obrigatório** | Identificador exclusivo da campanha (ou programa) à qual a conversão da chamada está associada. | | `MediaId` | Inteiro | **Obrigatório** | Identificador exclusivo do parceiro ou da fonte de mídia. | | `EventDate` | datetime (ISO 8601) | **Obrigatório** | Formato ISO 8601 da data e hora em que o evento de conversão da chamada ocorreu. | | `ActionTrackerId` | Inteiro | **Obrigatório** | Identificador exclusivo do rastreador de ação (ou seja, tipo de evento) que está rastreando a chamada telefônica. | | `CallProvider` | String | **Obrigatório** | O fornecedor ou cliente que está enviando os dados do evento de chamada | | `CallSessionId` | String | **Obrigatório** | Um ID de sessão exclusivo que o fornecedor ou cliente usa para identificar a chamada. | | `CallerId` | String | **Obrigatório** | O número de telefone da chamada de origem, usado para corresponder à conversão final. | | `CalledPhoneNumber` | String | **Obrigatório** | O número de telefone de destino ou o número de telefone que recebeu a chamada. | | `CallDuration` | String | **Obrigatório** | Duração total da chamada (em segundos). | | `TalkDuration` | String | **Obrigatório** | Duração real da conversa da chamada (em segundos). | | `AdId` | Inteiro | Opcional | Identificador exclusivo do anúncio associado à conversão da chamada. | | `CallStatus` | String | Opcional |

Esse valor indica o resultado final da chamada. Se o campo não estiver presente na solicitação, nós o definimos como ANSWER por padrão. Os valores válidos são:

UNKNOWN\_CALLERID

FAILURE

CONGESTION

INCOMPLETE

CANCEL

IVR\_DROPOFF

NO\_TRANSFER\_ATTEMPT

ANSWER

| | `CallerPhoneNumberCountry` | String | Opcional | Código de país de dois dígitos para o número de telefone de origem (ISO 3166 alpha-2). Quando NULL, o padrão é US. | | `CalledPhoneNumberCountry` | String | Opcional | Código de país de dois dígitos para o número de telefone chamado (ISO 3166 alpha-2). Quando NULL, o padrão é US. | | `SubId1` | String | Opcional | Esse valor é específico e está disponível apenas 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 a impact.com lhe reporte. | | `SubId2` | String | Opcional | | | `SubId3` | String | Opcional | | | `ClickId` | String | Opcional | Identificador exclusivo e sensível a maiúsculas e minúsculas gerado pela impact.com de 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. | | `Zip` | Inteiro | Opcional | CEP do CallerId - conforme identificado pelo fornecedor de rastreamento de chamadas. | | `RepeatCaller` | String | Opcional | Chamada repetida vs. nova para indicar se o chamador foi registrado como chamador recorrente pelo fornecedor de rastreamento de chamadas. | | `PhoneType` | String | Opcional | O tipo de telefone (ou seja, fixo, celular). | | `CallRecording` | String | Opcional | URL exclusiva da gravação da chamada. | | `IvrDuration` | String | Opcional | Duração, em segundos, que a chamada passou na árvore de IVR. | | `Keypresses` | String | Opcional | Lista de nomes únicos das teclas pressionadas durante a chamada. | | `Key1` | String | Opcional | Nome da primeira tecla que foi pressionada. | | `Key2` | String | Opcional | Nome da segunda tecla que foi pressionada. | | `Key3` | String | Opcional | Nome da terceira tecla que foi pressionada. | | `Key4` | String | Opcional | Nome da quarta tecla que foi pressionada. | | `TrafficSource` | String | Opcional | Origem da transação (fonte de mídia de referência). | | `OptInSms` | String | Opcional | Se o chamador optou por receber uma promoção por SMS. | | `UserAgent` | String | Opcional | O user agent do gerador de conversão. | | `DispositionName` | String | Opcional | O nome do evento de conversão. | | `SaleAmount` | Moeda | Opcional | Se for conversão de venda, valor da venda | | `ReferenceId` | String | Opcional | Código de disposição do cliente para referência. | | `CustomConversionEvent1Name` | String | Opcional | Nome personalizado para relatar eventos de conversão | | `CustomConversionEvent2Name` | String | Opcional | | | `CustomConversionEvent3Name` | String | Opcional | | | `CustomConversionEvent1Value` | String | Opcional | Valor personalizado para relatar eventos de conversão | | `CustomConversionEvent2Value` | String | Opcional | | | `CustomConversionEvent3Value` | String | Opcional | | | `VendorEventId` | String | Opcional | Será exclusivo para o evento de chamada e exclusivo para o evento de conversão. | | `PromoNumberDescription` | String | Opcional | Descreve o número de telefone chamado | | `CustomCallEvent1Name` | String | Opcional | Nome personalizado para relatar eventos de chamada | | `CustomCallEvent2Name` | String | Opcional | | | `CustomCallEvent3Name` | String | Opcional | | | `CustomCallEvent1Value` | String | Opcional | Valor personalizado para relatar eventos de chamada | | `CustomCallEvent2Value` | String | Opcional | | | `CustomCallEvent3Value` | String | Opcional | |
#### CSV de exemplo Copie estes dados de CSV de exemplo para usar na importação do seu arquivo. ```programlisting CampaignId,MediaId,EventDate,ActionTrackerId,CallProvider,CallSessionId,CallerId,CalledPhoneNumber,CallDuration,TalkDuration,AdId,CallStatus,CallerPhoneNumberCountry,CalledPhoneNumberCountry,SubId1,SubId2,SubId3,ClickId,City,Region,Zip,RepeatCaller,PhoneType,CallRecording,IvrDuration,Keypresses,Key1,Key2,Key3,Key4,OptInSms,UserAgent,DispositionName,SaleAmount,ReferenceId,CustomConversionEvent1Name,CustomConversionEvent2Name,CustomConversionEvent3Name,CustomConversionEvent1Value,CustomConversionEvent2Value,CustomConversionEvent3Value,VendorEventId,PromoNumberDescription,CustomCallEvent1Name,CustomCallEvent2Name,CustomCallEvent3Name,CustomCallEvent1Value,CustomCallEvent2Value,CustomCallEvent3Value 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.