Importar Dados Agregados de Desempenho de Outras Redes

Quando você ingressa na impact.com, pode ter dados agregados de desempenho em outra rede ou plataforma que deseja importar. Dados de desempenho permitem que você monitore e compare 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 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. Cobriremos essas etapas abaixo.

Mapear dados da tabela

Crie um novo arquivo .csv e adicione cabeçalhos que correspondam às colunas dos seus dados. Veja o CSV de amostra abaixo para ter uma ideia de como o conteúdo do arquivo .csv pode ser.

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 nos dados da sua plataforma ou rede para colunas correspondentes no CSV. Consulte o Referência de colunas abaixo para mais informações sobre os cabeçalhos de coluna suportados.

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	DateTime correspondente ao fim do evento no seguinte formato: yyyyMMddd hh:mm:ss z (ex: 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 (ex: 2023-10-18 09:23:67 EST).
AvgViewsPerUniqueViewer	Inteiro	Condicionalmente	Visualizações médias por espectador único.
Rejeições (bounces)	Inteiro	Condicionalmente	O número de assinantes que tiveram e-mails rejeitados (bounce), conforme rastreado pela plataforma de terceiros.
Chamadas	Inteiro	Condicionalmente	Número de chamadas.
Cliques	Inteiro	Condicionalmente	O número de cliques no anúncio que foi exibido.
Conversões	Inteiro	Condicionalmente	O número de conversões geradas pelo anúncio.
ConversionsRejected	Inteiro	Condicionalmente	O número de conversões rejeitadas após validação.
Custo	Decimal	Condicionalmente	O valor do custo.
Delivers	Inteiro	Condicionalmente	A contagem de e-mails ou correspondências entregues aos consumidores por meio da plataforma de terceiros durante a campanha publicitária.
Desconto	Decimal	Condicionalmente	O valor do desconto.
Impressões	Inteiro	Condicionalmente	Número de impressões do anúncio que foram exibidas.
Margem	Decimal	Condicionalmente	Um campo de valor para ações padrão ou aprovadas, calculado como Valor da Venda - Custo das Mercadorias.
OfferClicks	Inteiro	Condicionalmente	O número de cliques na oferta.
Opens	Inteiro	Condicionalmente	A contagem de e-mails abertos por 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.
Sends	Inteiro	Condicionalmente	O número de e-mails ou correspondências que foram enviados aos consumidores por meio da plataforma de terceiros durante a campanha publicitária.
SocialUniqueViewers	Inteiro	Condicionalmente	O número de espectadores sociais.
Spots	Inteiro	Condicionalmente	Os spots de terceiros.
Unsubscribes	Inteiro	Condicionalmente	O número de assinantes que cancelaram a assinatura de receber e-mails promocionais ou correspondências 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 único do tipo de evento (anteriormente conhecido como rastreador de ação).
AdCampaignGroupId	Inteiro	Não	O Id único associado ao grupo de campanhas publicitárias de terceiros.
AdCampaignGroupName	String	Não	O nome do grupo de campanhas publicitárias de terceiros. Grupos de campanhas publicitárias são usados para simplificar o gerenciamento de campanhas agrupando-as.
AdCampaignId	Inteiro	Não	O Id único 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 do anúncio de terceiros, por exemplo Google Search.
AdGroupId	Inteiro	Não	O Id único 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 veiculado.
AdPlacement	String	Não	O posicionamento do anúncio de terceiros 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 geralmente se posiciona em relação a outros anúncios. Essa posiçã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 terceiro 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 da impact.com.
Palavra-chave	String	Não	A palavra-chave do 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óximos os elementos da sua campanha publicitária correspondem às palavras-chave de pesquisa.
LandingPageRelevance	String	Não	Quão próximos os elementos da sua página de destino estão 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 a página de destino do seu site será 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 que se relaciona aos termos de pesquisa de uma pessoa.
MatchType	String	Não	O tipo de correspondência que é alcançado pelo mecanismo de pesquisa.
MaxCPC	Inteiro	Não	Lance máximo que você está disposto a pagar por uma campanha ou anúncio específico na sua plataforma de pesquisa paga.
MediaId	Inteiro	Não	O Id único do parceiro de mídia na plataforma impact.com. É necessário inserir ou o MediaId, ou o Id de terceiros na coluna MediaValue1.
MediaValue1	String	Não	Id único do parceiro de mídia de terceiros. Ou o MediaId ou o MediaValue1 de terceiros é obrigatório. Se você preencher MediaValue1, veja o mapeamentos personalizados de parceiro abaixo.
Método	String	Não	O mecanismo usado para inserir o registro. Métodos comumente usados são Inserir, Atualizar, Substituam, 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	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 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 apresentado 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 fez o referenciamento.
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 que é incluído nos relatórios do data warehouse.
SubId2	String	Não	Um valor de rastreamento que é incluído nos relatórios do data warehouse.
SubId3	String	Não	Um valor de rastreamento que é 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 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.

Enviar mapeamentos personalizados de parceiro

Aviso: Você deve habilitar quaisquer mapeamentos personalizados de parceiro antes de tentar enviar seus dados. Atualizar mapeamentos após o envio dos dados não terá efeito.

Mapeamentos personalizados de parceiro são necessários se você não puder fornecer à impact.com os Ids dos parceiros em seus dados.

1. No menu de navegação à esquerda, selecione [Engage] → Partners → Partners.

2. Envie mapeamentos personalizados de parceiro selecionando Edição em massa no canto superior direito. Leia mais sobre mapeamentos personalizados de parceiro.

   

Enviar o arquivo

1. Siga os passos neste artigo para criar uma conexão SFTP.

   • O tipo de dado 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 o Configuração Adicional etapa é 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 da impact.com para verificar o arquivo.

Melhores práticas

• É muito importante que você adicione os dados no formato correto.

• Após uma revisão técnica dos dados históricos mapeados, uma amostra inicial de algumas dezenas a cem registros deve ser enviada primeiro. Os relatórios de desempenho então 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 excluir pasta 'como está', sem modificações.

• Garanta que o tamanho final do arquivo de dados seja de 1 GB ou menos.