# Importe Dados Agregados de Desempenho de Outras Redes

Ao iniciar sua jornada com a impact.com, você pode ter dados de desempenho agregados 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 de desempenho agregados de qualquer rede ou plataforma.

#### Pré-requisitos

* Somente dados agregados são suportados. Dados no nível de clique ou de 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.

#### Boas práticas

* Você deve adicionar os dados no formato correto.
* Após uma revisão técnica dos dados históricos mapeados, deve ser enviado primeiro um exemplo inicial de algumas dezenas a cem registros. Em seguida, os relatórios de desempenho precisam ser confirmados como precisos antes que um envio 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.
* Garanta 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 nos 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 a *referência de colunas* abaixo para obter mais informações sobre os cabeçalhos de coluna compatíveis.

<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 correspondente ao término 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 correspondente 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. Consulte <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>Condicionalmente</td><td>Média de visualizações 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 monitorado 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>Clicks</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>Cost</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 e-mails ou correspondências diretas entregues aos consumidores por meio da plataforma de terceiros durante a campanha do anúncio.</td></tr><tr><td>Discount</td><td>Decimal</td><td>Condicionalmente</td><td>O valor do desconto.</td></tr><tr><td>Impressions</td><td>Inteiro</td><td>Condicionalmente</td><td>Número de impressões do anúncio exibido.</td></tr><tr><td>Margin</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 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>Condicionalmente</td><td>O número de curtidas na página.</td></tr><tr><td>Revenue</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 enviados aos consumidores por meio da plataforma de terceiros durante a campanha do 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 e-mails promocionais ou correspondências diretas, conforme monitorado 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 action tracker).</td></tr><tr><td>AdCampaignGroupId</td><td>Inteiro</td><td>Não</td><td>O ID exclusivo associado ao grupo de campanha publicitária de terceiros.</td></tr><tr><td>AdCampaignGroupName</td><td>String</td><td>Não</td><td>O nome do grupo de campanha publicitária de terceiros. Os grupos de campanha publicitária 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, Pesquisa do 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 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 em que ordem 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 em que o usuário estava localizado quando o anúncio foi exibido.</td></tr><tr><td>Country</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 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 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óximas são as correspondências entre os elementos da sua campanha publicitária e as palavras-chave de pesquisa.</td></tr><tr><td>LandingPageRelevance</td><td>String</td><td>Não</td><td>Quão próximos são os elementos da sua página de destino das 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 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 da 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 na sua plataforma de busca paga.</td></tr><tr><td>Method</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>Uma sigla 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 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>Quantity</td><td>Inteiro</td><td>Não</td><td>A quantidade do produto disponibilizado 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>Region</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 digitado pelo usuário 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 da 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 busca 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 habilitar quaisquer mapeamentos personalizados de parceiros antes de tentar enviar seus dados. Atualizar os mapeamentos após o envio dos 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 parceiros nos 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. Saiba 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 de *Configuração adicional* é irrelevante e deve ser ignorado.
2. Antes de enviar seu 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: 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.