# Importar dados agregados de desempenho de outras redes

Quando você faz a integração 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 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 enviado um conjunto inicial de algumas dezenas a uma centena de registros. 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 *delete* 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 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 cabeçalhos 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 exclusivo do parceiro 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>Média de visualizações por visualizador único.</td></tr><tr><td>Rejeições</td><td>Inteiro</td><td>Condicionalmente</td><td>A quantidade de assinantes que têm emails rejeitados, 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>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 quantidade de emails ou correspondências diretas entregues aos consumidores por meio da plataforma de terceiros durante a campanha de anúncio.</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 da Mercadoria.</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 quantidade de emails 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 emails ou correspondências diretas enviados aos consumidores por meio da plataforma de terceiros durante a campanha de anúncio.</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 spots de terceiros.</td></tr><tr><td>Unsubscribes</td><td>Inteiro</td><td>Condicionalmente</td><td>O número de assinantes que cancelaram a inscrição para receber emails 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 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 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 do anúncio de terceiros do anúncio que aciona 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 email 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 próximos 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 próximos 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 as pessoas que clicarem 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 da pessoa.</td></tr><tr><td>MatchType</td><td>String</td><td>Não</td><td>O tipo de correspondência obtido 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>Substituam</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 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 precificação 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 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 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 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 subafiliado ou Id do 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 que é 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 que é 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 que é 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 depois de enviar os dados não terá efeito.
{% endhint %}

Os mapeamentos personalizados de parceiros são obrigató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) **\[Engage] → Partners → Partners**.
2. Envie os mapeamentos personalizados de parceiros selecionando **Bulk Edit** no canto superior direito. Leia mais sobre [mapeamentos personalizados de parceiros](/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/platform-features/tracking/set-up-tracking/assign-custom-tracking-values-to-partners.md).

<div data-with-frame="true"><figure><img src="/files/4bae67a2c42f32ba88104106cf045e51f74a4b20" alt="" width="563"><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/sobre-o-que-voce-gostaria-de-aprender/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 etapa *Additional Setup* é 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: 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:

```
GET https://help.impact.com/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/account-administration/account-settings/send-data-to-impactcom/import-aggregate-performance-data-from-other-networks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.