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.

1

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.

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 a referência de colunas abaixo para obter mais informações sobre os cabeçalhos de coluna compatíveis.

referência de colunas

Nome da coluna de destino	Tipo	Obrigatório	Descrição
CampaignId	Inteiro	Sim	ID do programa da impact.com.
EventDateTimeEnd	Data	Sim	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).
EventDateTimeStart	Data	Sim	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).
MediaId	Inteiro	Condicionalmente, se MediaValue1 não for fornecido	O ID exclusivo do parceiro associado à 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. Consulte mapeamentos personalizados de parceiros abaixo para obter mais informações.
AvgViewsPerUniqueViewer	Inteiro	Condicionalmente	Média de visualizações por visualizador único.
Bounces	Inteiro	Condicionalmente	O número de assinantes que tiveram e-mails devolvidos, conforme monitorado pela plataforma de terceiros.
Calls	Inteiro	Condicionalmente	Número de chamadas.
Clicks	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.
Cost	Decimal	Condicionalmente	O valor do custo.
Delivers	Inteiro	Condicionalmente	A quantidade de e-mails ou correspondências diretas entregues aos consumidores por meio da plataforma de terceiros durante a campanha do anúncio.
Discount	Decimal	Condicionalmente	O valor do desconto.
Impressions	Inteiro	Condicionalmente	Número de impressões do anúncio exibido.
Margin	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.
Opens	Inteiro	Condicionalmente	A quantidade 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.
Revenue	Decimal	Condicionalmente	O valor da receita.
Sends	Inteiro	Condicionalmente	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.
SocialUniqueViewers	Inteiro	Condicionalmente	O número de visualizadores sociais.
Spots	Inteiro	Condicionalmente	Os spots de terceiros.
Unsubscribes	Inteiro	Condicionalmente	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.
ViewThroughConversions	Inteiro	Condicionalmente	O número de conversões view-through.
WebsiteClicks	Inteiro	Condicionalmente	O número de cliques no site.
ActionTrackerId	Inteiro	Não	O identificador exclusivo do tipo de evento (anteriormente conhecido como action tracker).
AdCampaignGroupId	Inteiro	Não	O ID exclusivo associado ao grupo de campanha publicitária de terceiros.
AdCampaignGroupName	String	Não	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.
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, Pesquisa do Google.
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 acionou 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 veiculado.
AdPlacement	String	Não	O posicionamento de anúncio de terceiros do anúncio que acionou 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.
Browser	String	Não	O navegador do dispositivo, por exemplo, Safari ou Firefox.
City	String	Não	A cidade em que o usuário estava localizado quando o anúncio foi exibido.
Country	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 está 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 da 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 próximas são as correspondências entre os elementos da sua campanha publicitária e as palavras-chave de pesquisa.
LandingPageRelevance	String	Não	Quão próximos são os elementos da sua página de destino das 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 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.
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 na sua plataforma de busca paga.
Method	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	Uma sigla para 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 precificação utilizado.
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.
Quantity	Inteiro	Não	A quantidade do produto disponibilizado no anúncio.
ReferringDomain	String	Não	O domínio que fez a referência.
ReferringURL	String	Não	A URL de referência.
Region	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 digitado pelo usuário 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 da 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 busca 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 visualizadores.
UserAgent	String	Não	A string do 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 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.

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

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 etapa de Configuração adicional é irrelevante e deve ser ignorado.

2. Antes de enviar seu arquivo CSV, entre em contato com o suporte e trabalhe com um engenheiro de implementação da impact.com para verificar o arquivo.