> 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/account-administration/account-settings/send-data-to-impactcom/import-aggregate-performance-data-from-other-networks.md).

# Importar dados agregados de desempenho de outras redes

Quando você começa a usar o impact.com, pode ter dados agregados de desempenho em outra rede ou plataforma que deseja importar. Os dados de desempenho permitem monitorar e comparar o desempenho do seu programa ao longo do tempo. O impact.com oferece uma solução flexível para importar dados agregados de desempenho de qualquer rede ou plataforma.

#### Pré-requisitos

* Apenas dados agregados são suportados. Dados em nível de clique ou ação não são suportados.
* Você precisará mapear os dados de terceiros e fornecer mapeamentos personalizados antes de enviar os dados. Abordaremos essas etapas abaixo.

#### Melhores práticas

* Você deve adicionar os dados no formato correto.
* Após uma revisão técnica dos dados históricos mapeados, primeiro deve ser enviada uma amostra inicial de algumas dezenas a cem registros. Em seguida, os relatórios de desempenho precisam ser confirmados como precisos antes de realizar um envio em massa de fato.
* Se você precisar reverter as alterações, o arquivo original deve ser enviado para a *excluir* pasta ‘como está’, sem modificações.
* Certifique-se de que o tamanho final do arquivo de dados seja de 1 GB ou menos.

{% stepper %}
{% step %}

### Mapear dados da tabela

Crie um novo arquivo .csv e adicione cabeçalhos que correspondam às colunas dos seus dados. Veja o CSV de exemplo abaixo para ter uma ideia de como o conteúdo do arquivo .csv pode ficar.

<pre class="language-programlisting"><code class="lang-programlisting"><strong>SubAccountName,Discount,Revenue,Quantity,AdId,Cost,ReferringURL,AdName,AdCampaignId,EventDateTimeStart,OperatingSystem,DeviceType,EventType,MediaValue1,EventDateTimeEnd,ProductCategory,CampaignId,MediaId
</strong>"Some Partner",0.00,58.49,1,13564977,3.41,http://www.partner.com/email/onlineversion.jsp?dh_ABDA1546291792698~1,"Wired Plans",1554194,"2019-01-01 05:02:39 EST","Windows 10",Desktop,item_sale,,"2019-01-01 23:59:59 EST",Phones,15973,5343
"Some Partner",0.00,99.99,1,13564977,7.62,http://www.partner.com/email/onlineversion.jsp?dh_ABDA1546291792698~1,"Wired Plans",1554194,"2019-01-01 07:04:23 EST","Windows 10",Desktop,item_sale,2661135,"2019-01-01 23:59:59 EST",Phones,15973
</code></pre>

Mapeie as colunas dos dados da sua plataforma ou rede para as colunas correspondentes no CSV. Consulte o *Referência das colunas* abaixo para obter mais informações sobre os cabeçalhos de coluna suportados.

<details>

<summary>Referência das colunas</summary>

<table><thead><tr><th width="228.7734375">Nome da coluna de destino</th><th width="83.328125">Tipo</th><th width="139.15625">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td>CampaignId</td><td>Inteiro</td><td>Sim</td><td>ID do programa do impact.com.</td></tr><tr><td>EventDateTimeEnd</td><td>Data</td><td>Sim</td><td>DateTime correspondente ao fim do evento no seguinte formato: yyyyMMddd hh:mm:ss z (por exemplo: 2023-10-18 23:59:59 EST).</td></tr><tr><td>EventDateTimeStart</td><td>Data</td><td>Sim</td><td>O DateTime correspondente ao início do evento no seguinte formato: yyyyMMddd hh:mm:ss z (por exemplo: 2023-10-18 09:23:67 EST).</td></tr><tr><td>MediaId</td><td>Inteiro</td><td>Condicionalmente, se MediaValue1 não for fornecido</td><td>O ID exclusivo do parceiro associado ao impact.com.</td></tr><tr><td>MediaValue1</td><td>String</td><td>Condicionalmente, se MediaId não for fornecido</td><td>Um identificador exclusivo de um parceiro de terceiros. Este campo aceita qualquer valor alfanumérico. Se estiver usando MediaValue1, o valor deve ser mapeado. Veja <a href="#conditional-upload-custom-partner-mappings"><em>mapeamentos personalizados de parceiros</em></a> abaixo para mais informações.</td></tr><tr><td>AvgViewsPerUniqueViewer</td><td>Inteiro</td><td>Condicionalmente</td><td>Média de visualizações por espectador único.</td></tr><tr><td>Rejeições</td><td>Inteiro</td><td>Condicionalmente</td><td>O número de assinantes que tiveram e-mails devolvidos, conforme rastreado pela plataforma de terceiros.</td></tr><tr><td>Calls</td><td>Inteiro</td><td>Condicionalmente</td><td>Número de chamadas.</td></tr><tr><td>cliques</td><td>Inteiro</td><td>Condicionalmente</td><td>O número de cliques no anúncio exibido.</td></tr><tr><td>Conversions</td><td>Inteiro</td><td>Condicionalmente</td><td>O número de conversões geradas pelo anúncio.</td></tr><tr><td>ConversionsRejected</td><td>Inteiro</td><td>Condicionalmente</td><td>O número de conversões rejeitadas após a validação.</td></tr><tr><td>Custo</td><td>Decimal</td><td>Condicionalmente</td><td>O valor do custo.</td></tr><tr><td>Entregas</td><td>Inteiro</td><td>Condicionalmente</td><td>A contagem de e-mails ou mala direta entregues aos consumidores por meio da plataforma de terceiros durante a campanha de anúncios.</td></tr><tr><td>Desconto</td><td>Decimal</td><td>Condicionalmente</td><td>O valor do desconto.</td></tr><tr><td>impressões</td><td>Inteiro</td><td>Condicionalmente</td><td>Número de impressões do anúncio exibido.</td></tr><tr><td>Margem</td><td>Decimal</td><td>Condicionalmente</td><td>Um campo de valor para ações padrão ou aprovadas, calculado como Valor da venda - Custo dos produtos.</td></tr><tr><td>OfferClicks</td><td>Inteiro</td><td>Condicionalmente</td><td>O número de cliques na oferta.</td></tr><tr><td>Aberturas</td><td>Inteiro</td><td>Condicionalmente</td><td>A contagem de e-mails abertos pelos consumidores por meio da plataforma de terceiros para a campanha.</td></tr><tr><td>PageLikes</td><td>Inteiro</td><td>Condicionalmente</td><td>O número de curtidas na página.</td></tr><tr><td>Receita</td><td>Decimal</td><td>Condicionalmente</td><td>O valor da receita.</td></tr><tr><td>Envios</td><td>Inteiro</td><td>Condicionalmente</td><td>O número de e-mails ou mala direta enviados aos consumidores por meio da plataforma de terceiros durante a campanha de anúncios.</td></tr><tr><td>SocialUniqueViewers</td><td>Inteiro</td><td>Condicionalmente</td><td>O número de espectadores sociais.</td></tr><tr><td>Spots</td><td>Inteiro</td><td>Condicionalmente</td><td>Os spots de terceiros.</td></tr><tr><td>Cancelamentos de assinatura</td><td>Inteiro</td><td>Condicionalmente</td><td>O número de assinantes que cancelaram o recebimento de e-mails promocionais ou mala direta, conforme rastreado pela plataforma de terceiros.</td></tr><tr><td>ViewThroughConversions</td><td>Inteiro</td><td>Condicionalmente</td><td>O número de conversões por visualização.</td></tr><tr><td>WebsiteClicks</td><td>Inteiro</td><td>Condicionalmente</td><td>O número de cliques no site.</td></tr><tr><td>ActionTrackerId</td><td>Inteiro</td><td>Não</td><td>O identificador exclusivo do tipo de evento (anteriormente conhecido como rastreador de ação).</td></tr><tr><td>AdCampaignGroupId</td><td>Inteiro</td><td>Não</td><td>O ID exclusivo associado ao grupo de campanha de anúncios de terceiros.</td></tr><tr><td>AdCampaignGroupName</td><td>String</td><td>Não</td><td>O nome do grupo de campanha de anúncios de terceiros. Os grupos de campanhas de anúncios são usados para simplificar o gerenciamento de campanhas, agrupando-as.</td></tr><tr><td>AdCampaignId</td><td>Inteiro</td><td>Não</td><td>O ID exclusivo atribuído à campanha na plataforma de marketing de terceiros.</td></tr><tr><td>AdCampaignName</td><td>String</td><td>Não</td><td>O nome associado a cada uma das campanhas na plataforma de marketing de terceiros.</td></tr><tr><td>AdDistributionType</td><td>String</td><td>Não</td><td>O canal de distribuição de anúncios de terceiros, por exemplo, Google Search.</td></tr><tr><td>AdGroupId</td><td>Inteiro</td><td>Não</td><td>O ID exclusivo associado ao grupo de anúncios de terceiros.</td></tr><tr><td>AdGroupName</td><td>String</td><td>Não</td><td>O nome do grupo de anúncios de terceiros do anúncio que gerou o clique.</td></tr><tr><td>AdId</td><td>String</td><td>Não</td><td>O ID do anúncio de terceiros.</td></tr><tr><td>AdName</td><td>String</td><td>Não</td><td>O nome do anúncio na plataforma de terceiros.</td></tr><tr><td>AdNetwork</td><td>String</td><td>Não</td><td>O nome da rede de anúncios de terceiros na qual o anúncio foi exibido.</td></tr><tr><td>AdPlacement</td><td>String</td><td>Não</td><td>O posicionamento do anúncio de terceiros do anúncio que gerou o clique.</td></tr><tr><td>AdPosition</td><td>String</td><td>Não</td><td>A ordem em que seu anúncio aparece em uma página em relação a outros anúncios.</td></tr><tr><td>AdSize</td><td>String</td><td>Não</td><td>O tamanho do anúncio.</td></tr><tr><td>AdType</td><td>String</td><td>Não</td><td>O tipo de anúncio de terceiros.</td></tr><tr><td>AuctionCost</td><td>Decimal</td><td>Não</td><td>Custo do leilão.</td></tr><tr><td>AveragePosition</td><td>Inteiro</td><td>Não</td><td>Estatística que descreve como seu anúncio normalmente se classifica em relação a outros anúncios. Essa classificação determina em que ordem os anúncios aparecem na página.</td></tr><tr><td>Navegador</td><td>String</td><td>Não</td><td>O navegador do dispositivo, por exemplo, Safari ou Firefox.</td></tr><tr><td>Cidade</td><td>String</td><td>Não</td><td>A cidade em que o usuário estava localizado quando o anúncio foi exibido.</td></tr><tr><td>País</td><td>String</td><td>Não</td><td>O país em que o usuário estava localizado quando o anúncio foi exibido.</td></tr><tr><td>CustomerEmail</td><td>String</td><td>Não</td><td>O e-mail do cliente.</td></tr><tr><td>CustomerId</td><td>String</td><td>Não</td><td>ID de terceiros do cliente.</td></tr><tr><td>CustomerSegment</td><td>String</td><td>Não</td><td>O segmento de terceiros ao qual o cliente é atribuído.</td></tr><tr><td>DataCost</td><td>Decimal</td><td>Não</td><td>O custo dos dados.</td></tr><tr><td>DeviceName</td><td>String</td><td>Não</td><td>O nome do dispositivo.</td></tr><tr><td>DeviceType</td><td>String</td><td>Não</td><td>O tipo de dispositivo ao qual o anúncio foi exibido.</td></tr><tr><td>EventName</td><td>String</td><td>Não</td><td>O nome do evento de terceiros.</td></tr><tr><td>EventType</td><td>String</td><td>Não</td><td>O tipo de evento que ocorreu.</td></tr><tr><td>ImpactAdId</td><td>Inteiro</td><td>Não</td><td>O ID do anúncio do impact.com.</td></tr><tr><td>Keyword</td><td>String</td><td>Não</td><td>A palavra-chave de lance que correspondeu à pesquisa.</td></tr><tr><td>KeywordId</td><td>Inteiro</td><td>Não</td><td>O ID da palavra-chave de lance de terceiros associado à palavra-chave de lance.</td></tr><tr><td>KeywordRelevance</td><td>String</td><td>Não</td><td>Quão de perto os elementos da sua campanha de anúncios correspondem às palavras-chave de pesquisa.</td></tr><tr><td>LandingPageRelevance</td><td>String</td><td>Não</td><td>Quão de perto os elementos da sua página de destino correspondem às palavras-chave de pesquisa.</td></tr><tr><td>LandingPageURL</td><td>String</td><td>Não</td><td>A URL da página de destino.</td></tr><tr><td>LandingPageUserExperience</td><td>String</td><td>Não</td><td>Uma medida que o AdWords usa para estimar o quão relevante e útil será a página de destino do seu site para pessoas que clicarem no seu anúncio. Páginas de destino com notas mais altas geralmente são bem organizadas e têm texto relacionado aos termos de pesquisa de uma pessoa.</td></tr><tr><td>MatchType</td><td>String</td><td>Não</td><td>O tipo de correspondência alcançado pelo mecanismo de busca.</td></tr><tr><td>MaxCPC</td><td>Inteiro</td><td>Não</td><td>Lance máximo que você está disposto a pagar por uma determinada campanha ou anúncio em sua plataforma de pesquisa paga.</td></tr><tr><td>Método</td><td>String</td><td>Não</td><td>O mecanismo usado para inserir o registro. Os métodos comumente usados são <em>Inserir</em>, <em>Atualizar</em>, <em>Substituir</em>, ou <em>Excluir</em>.</td></tr><tr><td>Money1</td><td>Decimal</td><td>Não</td><td>Um parâmetro monetário diverso.</td></tr><tr><td>Money2</td><td>Decimal</td><td>Não</td><td>Um parâmetro monetário diverso.</td></tr><tr><td>Money3</td><td>Decimal</td><td>Não</td><td>Um parâmetro monetário diverso.</td></tr><tr><td>MSA</td><td>String</td><td>Não</td><td>Acrônimo de Metropolitan Statistical Area: a área metropolitana do usuário, onde o anúncio foi exibido.</td></tr><tr><td>Numeric1</td><td>Inteiro</td><td>Não</td><td>Um parâmetro numérico diverso.</td></tr><tr><td>Numeric2</td><td>Inteiro</td><td>Não</td><td>Um parâmetro numérico diverso.</td></tr><tr><td>Numeric3</td><td>Inteiro</td><td>Não</td><td>Um parâmetro numérico diverso.</td></tr><tr><td>OperatingSystem</td><td>String</td><td>Não</td><td>O sistema operacional do dispositivo: iOS, Android, Windows, Mac.</td></tr><tr><td>Param1</td><td>String</td><td>Não</td><td>Um parâmetro de rastreamento diverso.</td></tr><tr><td>Param2</td><td>String</td><td>Não</td><td>Um parâmetro de rastreamento diverso.</td></tr><tr><td>Param3</td><td>String</td><td>Não</td><td>Um parâmetro de rastreamento diverso.</td></tr><tr><td>Param4</td><td>String</td><td>Não</td><td>Um parâmetro de rastreamento diverso.</td></tr><tr><td>PricingModel</td><td>String</td><td>Não</td><td>O modelo de preços empregado.</td></tr><tr><td>ProductCategory</td><td>String</td><td>Não</td><td>A categoria do produto.</td></tr><tr><td>ProductCategoryId</td><td>Inteiro</td><td>Não</td><td>O ID da categoria de produto de terceiros.</td></tr><tr><td>ProductId</td><td>String</td><td>Não</td><td>O ID do produto ou SKU do produto em destaque no anúncio clicado.</td></tr><tr><td>ProductSubCategory</td><td>String</td><td>Não</td><td>A subcategoria do produto.</td></tr><tr><td>QualityScore</td><td>Inteiro</td><td>Não</td><td>Uma estimativa da qualidade dos seus anúncios.</td></tr><tr><td>Quantidade</td><td>Inteiro</td><td>Não</td><td>A quantidade do produto disponibilizada no anúncio.</td></tr><tr><td>ReferringDomain</td><td>String</td><td>Não</td><td>O domínio que gerou a referência.</td></tr><tr><td>ReferringURL</td><td>String</td><td>Não</td><td>A URL de referência.</td></tr><tr><td>Região</td><td>String</td><td>Não</td><td>A região em que o usuário estava localizado quando o anúncio foi exibido.</td></tr><tr><td>SearchText</td><td>String</td><td>Não</td><td>O termo de pesquisa que o usuário inseriu no mecanismo de busca.</td></tr><tr><td>SharedId</td><td>String</td><td>Não</td><td>Um valor de rastreamento compartilhado com o anunciante.</td></tr><tr><td>SubAccountId</td><td>Inteiro</td><td>Não</td><td>O ID do subafiliado ou parceiro na plataforma impact.com.</td></tr><tr><td>SubAccountName</td><td>String</td><td>Não</td><td>O nome do subafiliado ou parceiro.</td></tr><tr><td>SubId1</td><td>String</td><td>Não</td><td>Um valor de rastreamento incluído nos relatórios do data warehouse.</td></tr><tr><td>SubId2</td><td>String</td><td>Não</td><td>Um valor de rastreamento incluído nos relatórios do data warehouse.</td></tr><tr><td>SubId3</td><td>String</td><td>Não</td><td>Um valor de rastreamento incluído nos relatórios do data warehouse.</td></tr><tr><td>TargetMarketSize</td><td>String</td><td>Não</td><td>Tamanho do mercado-alvo.</td></tr><tr><td>Text1</td><td>String</td><td>Não</td><td>Um parâmetro de texto diverso.</td></tr><tr><td>Text2</td><td>String</td><td>Não</td><td>Um parâmetro de texto diverso.</td></tr><tr><td>Text3</td><td>String</td><td>Não</td><td>Um parâmetro de texto diverso.</td></tr><tr><td>TrafficSource</td><td>String</td><td>Não</td><td>A fonte de tráfego do parceiro de mídia de pesquisa paga.</td></tr><tr><td>TrafficType</td><td>String</td><td>Não</td><td>A categoria ou tipo de tráfego, usado em CPC/CPL/CPA.</td></tr><tr><td>UniqueClicks</td><td>Inteiro</td><td>Não</td><td>O número de cliques únicos.</td></tr><tr><td>UniquePeopleConverting</td><td>Inteiro</td><td>Não</td><td>O número único de pessoas que convertem.</td></tr><tr><td>UniqueViewers</td><td>Inteiro</td><td>Não</td><td>O número único de espectadores.</td></tr><tr><td>UserAgent</td><td>String</td><td>Não</td><td>A string de user agent que rastreia o navegador do usuário.</td></tr></tbody></table>

![](/files/7143472b7c4c6f73e04ce6c976a70d052ad65893) Pelo menos uma das colunas marcadas como *Condicionalmente* obrigatórias deve ser incluída no seu arquivo.

</details>
{% endstep %}

{% step %}

### (Condicional) Enviar mapeamentos personalizados de parceiros

{% hint style="warning" %}
**Aviso:** Você deve ativar quaisquer mapeamentos personalizados de parceiros antes de tentar enviar seus dados. Atualizar os mapeamentos depois de enviar os dados não terá efeito.
{% endhint %}

Os mapeamentos personalizados de parceiros são necessários se você não puder fornecer ao impact.com IDs de parceiro em seus dados.

1. No menu de navegação à esquerda, selecione ![](/files/160944180402269557074f48f2ece20bc35e8b4d) **\[Engage] → Parceiros → Parceiros**.
2. Envie mapeamentos personalizados de parceiros selecionando **Edição em massa** no canto superior direito. Leia mais sobre [mapeamentos personalizados de parceiros](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/assign-custom-tracking-values-to-partners.md).

<div data-with-frame="true"><figure><img src="/files/44a1763f5969f79dc9c25a51d3f9bce108b038ab" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Enviar o arquivo

1. Siga as etapas em [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) para criar uma conexão SFTP.
   * O tipo de dados aplicável a ser selecionado ao configurar uma conexão para dados históricos de desempenho é `aggregate_performance_data`.
   * O fuso horário de desempenho agregado selecionado durante a *Configuração adicional* etapa de Configuração adicional é irrelevante e deve ser ignorada.
2. Antes de enviar seu arquivo CSV, entre em contato com [suporte](https://app.impact.com/support/portal.ihtml) e trabalhe com um engenheiro de implementação do impact.com para verificar o arquivo.
   {% 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/account-administration/account-settings/send-data-to-impactcom/import-aggregate-performance-data-from-other-networks.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.