# 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>

![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media) 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 ![](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. Envie 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/sobre-o-que-voce-gostaria-de-aprender/platform-features/tracking/set-up-tracking/assign-custom-tracking-values-to-partners).

<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%2Fgit-blob-90b0659aed7fa5e272b491f310474c39de8890d4%2Fcfeabebd2a7e0fcc725dc4e56426e4c11a3fff1daa51d96ed7a6a089ae0187ff.png?alt=media" 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](https://help.impact.com/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/account-administration/account-settings/send-data-to-impactcom/create-a-data-upload-connection) 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 %}