> 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).

# Importe dados agregados de desempenho de outras redes

Quando você faz seu onboarding com a impact.com, você 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. A 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 no 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 fazer o upload dos 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, um primeiro exemplo de algumas dezenas a cem registros deve ser enviado primeiro. Em seguida, os relatórios de desempenho precisam ser confirmados como precisos antes que um upload em massa real seja realizado.
* Se você precisar reverter as alterações, o arquivo original deve ser enviado para a pasta *excluir* “como está”, sem modificações.
* Certifique-se de que o tamanho do arquivo de dados final 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 ser.

<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 a *Referência de colunas* abaixo para obter mais informações sobre os títulos de coluna suportados.

<details>

<summary>Referência de 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 da impact.com.</td></tr><tr><td>EventDateTimeEnd</td><td>Data</td><td>Sim</td><td>Data e hora correspondentes ao fim do evento no seguinte formato: yyyyMMddd hh:mm:ss z (ex.: 2023-10-18 23:59:59 EST).</td></tr><tr><td>EventDateTimeStart</td><td>Data</td><td>Sim</td><td>A data e hora correspondentes ao início do evento no seguinte formato: yyyyMMddd hh:mm:ss z (ex.: 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 de parceiro exclusivo associado à 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>Visualizações médias por visualizador único.</td></tr><tr><td>Bounces</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>Chamadas</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>Conversões</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>Delivers</td><td>Inteiro</td><td>Condicionalmente</td><td>A contagem de e-mails ou correspondências diretas 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>Opens</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>Sends</td><td>Inteiro</td><td>Condicionalmente</td><td>O número de e-mails ou correspondências diretas enviadas 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 visualizadores sociais.</td></tr><tr><td>Spots</td><td>Inteiro</td><td>Condicionalmente</td><td>Os espaços publicitários de terceiros.</td></tr><tr><td>Unsubscribes</td><td>Inteiro</td><td>Condicionalmente</td><td>O número de assinantes que cancelaram a assinatura para receber e-mails promocionais ou correspondências diretas, 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 view-through.</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 campanha 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 acionou 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 veiculado.</td></tr><tr><td>AdPlacement</td><td>String</td><td>Não</td><td>O posicionamento de anúncio de terceiros do anúncio que acionou 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 a ordem em que 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 está 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 para o 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 da 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 bem os elementos da sua campanha de anúncios correspondem às palavras-chave da pesquisa.</td></tr><tr><td>LandingPageRelevance</td><td>String</td><td>Não</td><td>Quão bem os elementos da sua página de destino correspondem às palavras-chave da 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 quão relevante e útil será a página de destino do seu site para as pessoas que clicam no seu anúncio. Páginas de destino com classificações 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 campanha ou anúncio específico na 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>Um acrônimo para 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 genérico.</td></tr><tr><td>Param2</td><td>String</td><td>Não</td><td>Um parâmetro de rastreamento genérico.</td></tr><tr><td>Param3</td><td>String</td><td>Não</td><td>Um parâmetro de rastreamento genérico.</td></tr><tr><td>Param4</td><td>String</td><td>Não</td><td>Um parâmetro de rastreamento genérico.</td></tr><tr><td>PricingModel</td><td>String</td><td>Não</td><td>O modelo de preços utilizado.</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 do 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 apresentado 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 fez 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 digitou 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 visualizadores.</td></tr><tr><td>UserAgent</td><td>String</td><td>Não</td><td>A string do 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 após enviar os dados não terá efeito.
{% endhint %}

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

1. No menu de navegação à esquerda, selecione ![](/files/160944180402269557074f48f2ece20bc35e8b4d) **\[Engajar] → Parceiros → Parceiros**.
2. Envie os mapeamentos personalizados de parceiros selecionando **Edição em massa** no canto superior direito. Saiba 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 dado aplicável a selecionar ao configurar uma conexão para dados históricos de desempenho é `aggregate_performance_data`.
   * O fuso horário de desempenho agregado selecionado durante a etapa de *Configuração adicional* é irrelevante e deve ser ignorado.
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 da 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.