Enviar Dados de Conversão via FTP ou E-mail

Faça o curso PXA

Se você estiver coletando dados de conversão (ou seja, ações) no lado do servidor ou por meio de um cookie, será necessário enviar seus dados para a impact.com para poder visualizar o desempenho do seu programa, atribuir crédito aos parceiros e modificar ou reverter quaisquer ações antes que elas sejam bloqueadas.

Este documento orienta você no formato e envio dos seus dados de conversão e pressupõe que você já tenha começado a coletar dados.

Antes de começar

• Se precisar de ajuda para coletar dados de conversão com rastreamento não baseado em pixel, entre em contato com seu CSM ou contate o suporte. Para saber mais sobre seu método de rastreamento e integração, recomendamos consultar o Plano de Integração Técnica original fornecido a você pela nossa equipe de Serviços Técnicos.

• Se você tiver Conexões ativadas para sua conta, configurar um pipeline de dados de conversão ficará diferente para você. Saiba como criar uma Conexão.

• Os parâmetros obrigatórios para ações web e ações em aplicativos móveis são diferentes. Veja Parâmetros Específicos para Mobile para mais informações sobre o envio de conversões de aplicativos móveis.

Aviso: Recomendamos fortemente não enviar ações com mais de 88 dias, pois a impact.com atualmente não processa conversões enviadas por FTP com datas de evento fora desse intervalo. Conversões com até 398 dias podem ser processadas, mas somente se a atribuição for feita usando MediaId.

Etapa 1: Prepare seus dados

Siga as instruções abaixo para visualizar um arquivo de modelo, inserir seus dados de conversão e salvá-lo no formato .csv. O modelo que você precisa depende se você está rastreando conversões no nível de item (ou seja, incluindo o SKU, quantidade etc. de cada item em um pedido) ou no nível de pedido (ou seja, apenas rastreando os próprios pedidos, não os itens dentro deles). Você também pode enviar dados de ação encadeada .

1. Selecione um dos links abaixo para visualizar o modelo de arquivo .csv que corresponde ao nível em que você rastreia ações.

   • Modelo de Dados/Ações em Nível de Item

   • Modelo de Dados/Ações em Nível de Pedido

   • Modelo de Dados de Ações Encadeadas

2. Adicione seus dados de conversão ao arquivo.

   • Veja o documento de Referência de Ações e Dados de Conversão da impact.com para exemplos, e use este arquivo como referência para os parâmetros aceitos. Entre em contato com seu CSM para descobrir quais parâmetros seriam melhores para incluir no seu modelo de dados de conversão.

3. Anexe quaisquer parâmetros opcionais que deseje relatar como novas colunas no seu arquivo.

4. Salve seu arquivo em formato .CSV com um título e data facilmente identificáveis (por exemplo, 2020-01-01_ActionData.csv).

   Observação: Para arquivos em lote em nível de item, IDs de pedido que tenham vários SKUs associados devem ser listados consecutivamente. Não agrupar itens com a mesma ID de pedido e SKUs diferentes resultará em um ERRO OID_DUPLICATE para os SKUs listados mais abaixo no arquivo.

Etapa 2: Envie seu arquivo de dados

Enviar via FTP/SFTP

• Recomendamos dividir arquivos FTP/SFTP para manter o número máximo de entradas por arquivo abaixo de 10000.

• Para enviar um arquivo ao servidor FTP/SFTP da impact.com, você precisará recuperar as credenciais da conta primeiro. Siga as instruções abaixo para saber como receber suas credenciais por e-mail.

1. Na barra de navegação superior, selecione [Perfil do usuário] → Configurações.

2. Na coluna direita, em Rastreamento, selecione Tipos de Evento.

3. Passe o cursor sobre o tipo de evento para o qual você deseja enviar dados de rastreamento de ações no lado do servidor, selecione [Mais] à direita e selecione Visualizar / Editar.

4. Ao lado de Processamento de Devoluções, selecione [Editar].

5. Selecione Automatizar o processamento de devoluções (avançado) → Enviar arquivo para o servidor FTP do sistema.

6. Selecione Enviar por e-mail Nome de usuário e senha do FTP e Salvar.

   • Depois de receber suas credenciais FTP/SFTP, use um cliente FTP/SFTP para se conectar à impact.com com as seguintes informações:

   	FTP	SFTP
   Servidor	batch.impact.com	sftp://batch.impact.com
   Porta	21	22
   Nome de usuário	(Seu nome de usuário FTP da impact.com sensível a maiúsculas/minúsculas.)	(Seu nome de usuário SFTP da impact.com sensível a maiúsculas/minúsculas.)
   Senha	(Sua senha FTP da impact.com sensível a maiúsculas/minúsculas.)	(Sua senha SFTP da impact.com sensível a maiúsculas/minúsculas.)

7. Uma vez conectado, envie seu arquivo para o diretório principal do servidor. Após um envio bem-sucedido, vá para a Etapa 3: Reveja o envio do arquivo seção abaixo.

   Observação: Se você não recebeu o e-mail com as credenciais FTP/SFTP, entre em contato com a pessoa que criou sua conta na impact.com. Alternativamente, contate o suporte.

Buscar arquivo via FTP/SFTP

Anexar arquivo por e-mail

Etapa 3: Reveja o envio do arquivo

1. Na barra de navegação superior, selecione [Perfil do usuário] → Configurações.

2. Na coluna esquerda, na seção Técnica , selecione Envios de Arquivo.

3. Use a tabela para revisar envios de arquivo recentes que a impact.com recebeu, incluindo o status atual de processamento.

   • Abaixo, você pode ver vários erros que pode encontrar ao revisar envios de arquivo e ações que pode tomar para corrigi-los.

Erros ao revisar envios de arquivo

Alguns erros comuns ao revisar envios de arquivo podem incluir:

Problema	Ação a tomar
Coluna de registros mostra 0	Certifique-se de que a extensão do arquivo seja .CSV ou .XML.
ActionTrackerId: Valor inválido	O ActionTrackerId não pertence ao Tipo de Evento enviado. 1. Navegue até [Perfil do usuário] → Configurações → Rastreamento. 2. Selecione Tipos de Evento e verifique o Tipo de Evento.
NO_REFERRERS_FOUND ou um dos seguintes parâmetros é obrigatório: • ClickId • CustomerId • CustomProfileId • CustomClickId • OrderPromoCode • MediaPartnerId • UniqueUrl • CallerId • GoogAId • AndroidId • AppleIfa • AppleIfv • WinId • PhoneNumber • Odin1 • DeviceId • OpenUdId • Mac • MacMd5 é obrigatório	Você não forneceu nenhum parâmetro relacionado à atribuição. Forneça pelo menos um parâmetro de atribuição, para que o sistema possa identificar a qual parceiro atribuir.
OID_Duplicate	O OID já está no sistema da impact.com. Forneça um tipo de evento exclusivo. Observação: Se você está tentando enviar conversões não atribuídas que já foram relatadas para nós no passado, use um OID ligeiramente diferente. Ex.: xxxxxx _1.
CLICK_AFTER_CONVERSION_EVENT	O clickid enviado ocorreu após o evento de conversão. Por favor, verifique se os ClickId e EventDate enviados estão corretos.
NO_VALID_REFERRERS_FOUND ACTIONTERMS_NOT_FOUND	O contrato com o parceiro ativo durante o EventDate não inclui este tipo específico de evento. Certifique-se de verificar seu contrato com o parceiro em [Engage] → Contratos → Contratos.
NO_VALID_REFERRERS _ FOUND CONTRACT_NOT_FOUND	Não há contrato ativo com o parceiro durante o EventDate. • Selecione [Engage] → Contratos → Contratos para verificar o histórico de contratos.
NO_VALID_REFERNO_VALID_REFERRERS_FOUND OUTSIDE_ASSOCIATION_WINDOW	A conversão está fora da janela de encaminhamento por clique indicada nos termos do contrato. A configuração padrão é 30 dias. • Selecione [Engage] → Contratos → Contratos para verificar a janela de encaminhamento para um parceiro específico.