> 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

Ao iniciar sua parceria com a impact.com, talvez você tenha dados agregados de desempenho de outra rede ou plataforma que queira 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 aceitos. Dados por clique ou por ação não são aceitos.
* Você precisará mapear os dados de terceiros e fornecer mapeamentos personalizados antes de fazer o upload. Vamos explicar essas etapas abaixo.

## Práticas recomendadas

* Você deve adicionar os dados no formato correto.
* Após uma análise técnica dos dados históricos mapeados, primeiro deve ser feito o upload de uma amostra inicial com algumas dezenas a cem registros. Em seguida, é necessário confirmar se os relatórios de desempenho estão corretos antes de fazer o upload em massa.
* Se precisar reverter as alterações, o arquivo original deverá ser enviado para a pasta *delete* sem modificações.
* Verifique se o arquivo final de dados tem no máximo 1 GB.

{% stepper %}
{% step %}

### Mapear os dados da tabela

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

<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 cabeçalhos de coluna aceitos.

<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 na 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 (por exemplo: 2023-10-18 23:59:59 EST).</td></tr><tr><td>EventDateTimeStart</td><td>Data</td><td>Sim</td><td>Data e hora correspondentes 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>Obrigatório em determinadas condições, se MediaValue1 não for informado</td><td>ID exclusivo do parceiro associado à impact.com.</td></tr><tr><td>MediaValue1</td><td>String</td><td>Obrigatório em determinadas condições, se MediaId não for informado</td><td>Um identificador exclusivo de um parceiro terceirizado. Este campo aceita qualquer valor alfanumérico. Se usar MediaValue1, o valor deverá ser mapeado. Consulte os <a href="#conditional-upload-custom-partner-mappings"><em>mapeamentos personalizados de parceiros</em></a> abaixo para obter mais informações.</td></tr><tr><td>AvgViewsPerUniqueViewer</td><td>Inteiro</td><td>Obrigatório em determinadas condições</td><td>Média de visualizações por espectador único.</td></tr><tr><td>Saídas rápidas</td><td>Inteiro</td><td>Obrigatório em determinadas condições</td><td>Número de assinantes que receberam e-mails devolvidos, conforme rastreado pela plataforma de terceiros.</td></tr><tr><td>Calls</td><td>Inteiro</td><td>Obrigatório em determinadas condições</td><td>Número de chamadas.</td></tr><tr><td>Cliques</td><td>Inteiro</td><td>Obrigatório em determinadas condições</td><td>Número de cliques no anúncio veiculado.</td></tr><tr><td>Conversions</td><td>Inteiro</td><td>Obrigatório em determinadas condições</td><td>Número de conversões geradas pelo anúncio.</td></tr><tr><td>ConversionsRejected</td><td>Inteiro</td><td>Obrigatório em determinadas condições</td><td>Número de conversões rejeitadas após a validação.</td></tr><tr><td>Cost</td><td>Decimal</td><td>Obrigatório em determinadas condições</td><td>Valor do custo.</td></tr><tr><td>Delivers</td><td>Inteiro</td><td>Obrigatório em determinadas condições</td><td>A quantidade de e-mails ou correspondências diretas entregues aos consumidores pela plataforma de terceiros durante a campanha publicitária.</td></tr><tr><td>Desconto</td><td>Decimal</td><td>Obrigatório em determinadas condições</td><td>O valor do desconto.</td></tr><tr><td>Impressões</td><td>Inteiro</td><td>Obrigatório em determinadas condições</td><td>O número de impressões do anúncio veiculadas.</td></tr><tr><td>Margem</td><td>Decimal</td><td>Obrigatório em determinadas condições</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>Obrigatório em determinadas condições</td><td>O número de cliques na oferta.</td></tr><tr><td>Opens</td><td>Inteiro</td><td>Obrigatório em determinadas condições</td><td>A quantidade 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>Obrigatório em determinadas condições</td><td>O número de curtidas na página.</td></tr><tr><td>Receita</td><td>Decimal</td><td>Obrigatório em determinadas condições</td><td>O valor da receita.</td></tr><tr><td>Sends</td><td>Inteiro</td><td>Obrigatório em determinadas condições</td><td>O número de e-mails ou correspondências diretas enviados aos consumidores pela plataforma de terceiros durante a campanha publicitária.</td></tr><tr><td>SocialUniqueViewers</td><td>Inteiro</td><td>Obrigatório em determinadas condições</td><td>O número de espectadores nas redes sociais.</td></tr><tr><td>Spots</td><td>Inteiro</td><td>Obrigatório em determinadas condições</td><td>Os espaços publicitários de terceiros.</td></tr><tr><td>Unsubscribes</td><td>Inteiro</td><td>Obrigatório em determinadas condições</td><td>O número de assinantes que cancelaram a inscrição para deixar de receber e-mails promocionais ou correspondências diretas, conforme registrado pela plataforma de terceiros.</td></tr><tr><td>ViewThroughConversions</td><td>Inteiro</td><td>Obrigatório em determinadas condições</td><td>O número de conversões por visualização.</td></tr><tr><td>WebsiteClicks</td><td>Inteiro</td><td>Obrigatório em determinadas condições</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ções).</td></tr><tr><td>AdCampaignGroupId</td><td>Inteiro</td><td>Não</td><td>O ID exclusivo associado ao grupo de campanhas publicitárias de terceiros.</td></tr><tr><td>AdCampaignGroupName</td><td>String</td><td>Não</td><td>O nome do grupo de campanhas publicitárias de terceiros. Os grupos de campanhas publicitárias simplificam o gerenciamento de campanhas ao agrupá-las.</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, a Pesquisa Google.</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 ao qual pertence o 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 veiculado.</td></tr><tr><td>AdPlacement</td><td>String</td><td>Não</td><td>O posicionamento do anúncio de terceiros 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>O custo do leilão.</td></tr><tr><td>AveragePosition</td><td>Inteiro</td><td>Não</td><td>Estatística que descreve a posição típica do seu anúncio 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>Browser</td><td>String</td><td>Não</td><td>O navegador do dispositivo, por exemplo, Safari ou Firefox.</td></tr><tr><td>City</td><td>String</td><td>Não</td><td>A cidade onde 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 onde 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 no 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 ocorrido.</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 do 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 do lance.</td></tr><tr><td>KeywordRelevance</td><td>String</td><td>Não</td><td>O grau de correspondência entre os elementos da sua campanha publicitária e as palavras-chave da pesquisa.</td></tr><tr><td>LandingPageRelevance</td><td>String</td><td>Não</td><td>O grau de correspondência entre os elementos da sua página de destino e as palavras-chave da pesquisa.</td></tr><tr><td>LandingPageURL</td><td>String</td><td>Não</td><td>O URL da página de destino.</td></tr><tr><td>LandingPageUserExperience</td><td>String</td><td>Não</td><td>Uma medida usada pelo AdWords para estimar o quanto a página de destino do seu site será relevante e útil para as pessoas que clicarem no seu anúncio. Em geral, páginas de destino com classificações mais altas são bem organizadas e contêm textos relacionados aos termos de pesquisa usados pelas pessoas.</td></tr><tr><td>MatchType</td><td>String</td><td>Não</td><td>O tipo de correspondência obtido pelo mecanismo de pesquisa.</td></tr><tr><td>MaxCPC</td><td>Inteiro</td><td>Não</td><td>O 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>Sigla de Metropolitan Statistical Area (área estatística metropolitana): 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 ou 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 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 o encaminhamento.</td></tr><tr><td>ReferringURL</td><td>String</td><td>Não</td><td>O URL de referência.</td></tr><tr><td>Região</td><td>String</td><td>Não</td><td>A região onde 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 genérico.</td></tr><tr><td>Text2</td><td>String</td><td>Não</td><td>Um parâmetro de texto genérico.</td></tr><tr><td>Text3</td><td>String</td><td>Não</td><td>Um parâmetro de texto genérico.</td></tr><tr><td>TrafficSource</td><td>String</td><td>Não</td><td>A origem do 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 o 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 de pessoas únicas que converteram.</td></tr><tr><td>UniqueViewers</td><td>Inteiro</td><td>Não</td><td>O número de visualizadores únicos.</td></tr><tr><td>UserAgent</td><td>String</td><td>Não</td><td>A string do agente do usuário que identifica o navegador do usuário.</td></tr></tbody></table>

**\***&#x50;elo menos uma das colunas marcadas como *Condicionalmente* obrigatórias deve ser incluída no arquivo.

</details>
{% endstep %}

{% step %}

### (Condicional) Fazer upload de mapeamentos personalizados de parceiros

{% hint style="warning" %}
**Aviso:** Você deve habilitar todos os mapeamentos personalizados de parceiros antes de tentar fazer upload dos dados. Atualizar os mapeamentos após o envio dos dados não terá efeito.
{% endhint %}

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

1. No menu de navegação à esquerda, selecione ![](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] → Parceiros → Parceiros**.
2. Faça upload de mapeamentos personalizados de parceiros selecionando **Edição em massa** no canto superior direito. Saiba mais sobre [mapeamentos personalizados de parceiros](https://help.impact.com/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="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FRaOrVAstmTBOzraeDOfB%2FUntitled%20design%20(1).png?alt=media&amp;token=b486fded-0351-4e70-8df5-36bba301047a" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Enviar o arquivo

1. Siga as etapas em [Criar uma conexão de upload de dados](https://help.impact.com/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 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 etapa *Configuração adicional* é irrelevante e deve ser ignorado.
2. Antes de fazer upload do arquivo CSV, entre em contato com o [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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
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=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
