Importar dados agregados de desempenho de outras redes

Quando você começa a usar o impact.com, 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. O 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 em 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 enviada uma amostra inicial de algumas dezenas a cem registros. Em seguida, os relatórios de desempenho precisam ser confirmados como precisos antes de realizar um envio em massa de fato.
• Se você precisar reverter as alterações, o arquivo original deve ser enviado para a excluir pasta ‘como está’, sem modificações.
• Certifique-se de que o tamanho final do arquivo de dados seja de 1 GB ou menos.

1

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

SubAccountName,Discount,Revenue,Quantity,AdId,Cost,ReferringURL,AdName,AdCampaignId,EventDateTimeStart,OperatingSystem,DeviceType,EventType,MediaValue1,EventDateTimeEnd,ProductCategory,CampaignId,MediaId
"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

Mapeie as colunas dos dados da sua plataforma ou rede para as colunas correspondentes no CSV. Consulte o Referência das colunas abaixo para obter mais informações sobre os cabeçalhos de coluna suportados.

Referência das colunas

Nome da coluna de destino	Tipo	Obrigatório	Descrição
CampaignId	Inteiro	Sim	ID do programa do impact.com.
EventDateTimeEnd	Data	Sim	DateTime correspondente ao fim do evento no seguinte formato: yyyyMMddd hh:mm:ss z (por exemplo: 2023-10-18 23:59:59 EST).
EventDateTimeStart	Data	Sim	O DateTime correspondente ao início do evento no seguinte formato: yyyyMMddd hh:mm:ss z (por exemplo: 2023-10-18 09:23:67 EST).
MediaId	Inteiro	Condicionalmente, se MediaValue1 não for fornecido	O ID exclusivo do parceiro associado ao impact.com.
MediaValue1	String	Condicionalmente, se MediaId não for fornecido	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 mapeamentos personalizados de parceiros abaixo para mais informações.
AvgViewsPerUniqueViewer	Inteiro	Condicionalmente	Média de visualizações por espectador único.
Rejeições	Inteiro	Condicionalmente	O número de assinantes que tiveram e-mails devolvidos, conforme rastreado pela plataforma de terceiros.
Calls	Inteiro	Condicionalmente	Número de chamadas.
cliques	Inteiro	Condicionalmente	O número de cliques no anúncio exibido.
Conversions	Inteiro	Condicionalmente	O número de conversões geradas pelo anúncio.
ConversionsRejected	Inteiro	Condicionalmente	O número de conversões rejeitadas após a validação.
Custo	Decimal	Condicionalmente	O valor do custo.
Entregas	Inteiro	Condicionalmente	A contagem de e-mails ou mala direta entregues aos consumidores por meio da plataforma de terceiros durante a campanha de anúncios.
Desconto	Decimal	Condicionalmente	O valor do desconto.
impressões	Inteiro	Condicionalmente	Número de impressões do anúncio exibido.
Margem	Decimal	Condicionalmente	Um campo de valor para ações padrão ou aprovadas, calculado como Valor da venda - Custo dos produtos.
OfferClicks	Inteiro	Condicionalmente	O número de cliques na oferta.
Aberturas	Inteiro	Condicionalmente	A contagem de e-mails abertos pelos consumidores por meio da plataforma de terceiros para a campanha.
PageLikes	Inteiro	Condicionalmente	O número de curtidas na página.
Receita	Decimal	Condicionalmente	O valor da receita.
Envios	Inteiro	Condicionalmente	O número de e-mails ou mala direta enviados aos consumidores por meio da plataforma de terceiros durante a campanha de anúncios.
SocialUniqueViewers	Inteiro	Condicionalmente	O número de espectadores sociais.
Spots	Inteiro	Condicionalmente	Os spots de terceiros.
Cancelamentos de assinatura	Inteiro	Condicionalmente	O número de assinantes que cancelaram o recebimento de e-mails promocionais ou mala direta, conforme rastreado pela plataforma de terceiros.
ViewThroughConversions	Inteiro	Condicionalmente	O número de conversões por visualização.
WebsiteClicks	Inteiro	Condicionalmente	O número de cliques no site.
ActionTrackerId	Inteiro	Não	O identificador exclusivo do tipo de evento (anteriormente conhecido como rastreador de ação).
AdCampaignGroupId	Inteiro	Não	O ID exclusivo associado ao grupo de campanha de anúncios de terceiros.
AdCampaignGroupName	String	Não	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.
AdCampaignId	Inteiro	Não	O ID exclusivo atribuído à campanha na plataforma de marketing de terceiros.
AdCampaignName	String	Não	O nome associado a cada uma das campanhas na plataforma de marketing de terceiros.
AdDistributionType	String	Não	O canal de distribuição de anúncios de terceiros, por exemplo, Google Search.
AdGroupId	Inteiro	Não	O ID exclusivo associado ao grupo de anúncios de terceiros.
AdGroupName	String	Não	O nome do grupo de anúncios de terceiros do anúncio que gerou o clique.
AdId	String	Não	O ID do anúncio de terceiros.
AdName	String	Não	O nome do anúncio na plataforma de terceiros.
AdNetwork	String	Não	O nome da rede de anúncios de terceiros na qual o anúncio foi exibido.
AdPlacement	String	Não	O posicionamento do anúncio de terceiros do anúncio que gerou o clique.
AdPosition	String	Não	A ordem em que seu anúncio aparece em uma página em relação a outros anúncios.
AdSize	String	Não	O tamanho do anúncio.
AdType	String	Não	O tipo de anúncio de terceiros.
AuctionCost	Decimal	Não	Custo do leilão.
AveragePosition	Inteiro	Não	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.
Navegador	String	Não	O navegador do dispositivo, por exemplo, Safari ou Firefox.
Cidade	String	Não	A cidade em que o usuário estava localizado quando o anúncio foi exibido.
País	String	Não	O país em que o usuário estava localizado quando o anúncio foi exibido.
CustomerEmail	String	Não	O e-mail do cliente.
CustomerId	String	Não	ID de terceiros do cliente.
CustomerSegment	String	Não	O segmento de terceiros ao qual o cliente é atribuído.
DataCost	Decimal	Não	O custo dos dados.
DeviceName	String	Não	O nome do dispositivo.
DeviceType	String	Não	O tipo de dispositivo ao qual o anúncio foi exibido.
EventName	String	Não	O nome do evento de terceiros.
EventType	String	Não	O tipo de evento que ocorreu.
ImpactAdId	Inteiro	Não	O ID do anúncio do impact.com.
Keyword	String	Não	A palavra-chave de lance que correspondeu à pesquisa.
KeywordId	Inteiro	Não	O ID da palavra-chave de lance de terceiros associado à palavra-chave de lance.
KeywordRelevance	String	Não	Quão de perto os elementos da sua campanha de anúncios correspondem às palavras-chave de pesquisa.
LandingPageRelevance	String	Não	Quão de perto os elementos da sua página de destino correspondem às palavras-chave de pesquisa.
LandingPageURL	String	Não	A URL da página de destino.
LandingPageUserExperience	String	Não	Uma medida que o AdWords usa para estimar o quão relevante e útil será a página de destino do seu site para pessoas que clicarem no seu anúncio. Páginas de destino com notas mais altas geralmente são bem organizadas e têm texto relacionado aos termos de pesquisa de uma pessoa.
MatchType	String	Não	O tipo de correspondência alcançado pelo mecanismo de busca.
MaxCPC	Inteiro	Não	Lance máximo que você está disposto a pagar por uma determinada campanha ou anúncio em sua plataforma de pesquisa paga.
Método	String	Não	O mecanismo usado para inserir o registro. Os métodos comumente usados são Inserir, Atualizar, Substituir, ou Excluir.
Money1	Decimal	Não	Um parâmetro monetário diverso.
Money2	Decimal	Não	Um parâmetro monetário diverso.
Money3	Decimal	Não	Um parâmetro monetário diverso.
MSA	String	Não	Acrônimo de Metropolitan Statistical Area: a área metropolitana do usuário, onde o anúncio foi exibido.
Numeric1	Inteiro	Não	Um parâmetro numérico diverso.
Numeric2	Inteiro	Não	Um parâmetro numérico diverso.
Numeric3	Inteiro	Não	Um parâmetro numérico diverso.
OperatingSystem	String	Não	O sistema operacional do dispositivo: iOS, Android, Windows, Mac.
Param1	String	Não	Um parâmetro de rastreamento diverso.
Param2	String	Não	Um parâmetro de rastreamento diverso.
Param3	String	Não	Um parâmetro de rastreamento diverso.
Param4	String	Não	Um parâmetro de rastreamento diverso.
PricingModel	String	Não	O modelo de preços empregado.
ProductCategory	String	Não	A categoria do produto.
ProductCategoryId	Inteiro	Não	O ID da categoria de produto de terceiros.
ProductId	String	Não	O ID do produto ou SKU do produto em destaque no anúncio clicado.
ProductSubCategory	String	Não	A subcategoria do produto.
QualityScore	Inteiro	Não	Uma estimativa da qualidade dos seus anúncios.
Quantidade	Inteiro	Não	A quantidade do produto disponibilizada no anúncio.
ReferringDomain	String	Não	O domínio que gerou a referência.
ReferringURL	String	Não	A URL de referência.
Região	String	Não	A região em que o usuário estava localizado quando o anúncio foi exibido.
SearchText	String	Não	O termo de pesquisa que o usuário inseriu no mecanismo de busca.
SharedId	String	Não	Um valor de rastreamento compartilhado com o anunciante.
SubAccountId	Inteiro	Não	O ID do subafiliado ou parceiro na plataforma impact.com.
SubAccountName	String	Não	O nome do subafiliado ou parceiro.
SubId1	String	Não	Um valor de rastreamento incluído nos relatórios do data warehouse.
SubId2	String	Não	Um valor de rastreamento incluído nos relatórios do data warehouse.
SubId3	String	Não	Um valor de rastreamento incluído nos relatórios do data warehouse.
TargetMarketSize	String	Não	Tamanho do mercado-alvo.
Text1	String	Não	Um parâmetro de texto diverso.
Text2	String	Não	Um parâmetro de texto diverso.
Text3	String	Não	Um parâmetro de texto diverso.
TrafficSource	String	Não	A fonte de tráfego do parceiro de mídia de pesquisa paga.
TrafficType	String	Não	A categoria ou tipo de tráfego, usado em CPC/CPL/CPA.
UniqueClicks	Inteiro	Não	O número de cliques únicos.
UniquePeopleConverting	Inteiro	Não	O número único de pessoas que convertem.
UniqueViewers	Inteiro	Não	O número único de espectadores.
UserAgent	String	Não	A string de user agent que rastreia o navegador do usuário.

Pelo menos uma das colunas marcadas como Condicionalmente obrigatórias deve ser incluída no seu arquivo.

2

(Condicional) Enviar mapeamentos personalizados de parceiros

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.

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

1. No menu de navegação à esquerda, selecione [Engage] → Parceiros → Parceiros.
2. Envie mapeamentos personalizados de parceiros selecionando Edição em massa no canto superior direito. Leia mais sobre mapeamentos personalizados de parceiros.

3

Enviar o arquivo

1. Siga as etapas em Criar uma conexão de upload de dados 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 Configuração adicional etapa de Configuração adicional é irrelevante e deve ser ignorada.
2. Antes de enviar seu arquivo CSV, entre em contato com suporte e trabalhe com um engenheiro de implementação do impact.com para verificar o arquivo.