Enviar Dados de Conversão via FTP ou Email

Faça o curso PXA

Se você está coletando dados de conversão (ou seja, ações) no servidor ou através de um cookie, será necessário enviar seus dados para a impact.com para que você possa 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ê sobre como formatar e enviar seus dados de conversão e pressupõe que você já tenha começado a coletar dados.

Antes de começar

• Se você 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 terá um aspecto diferente para você. Saiba como criar uma Conexão.

• Os parâmetros exigidos para ações na web e ações de aplicativos móveis são diferentes. Veja Parâmetros Específicos para Mobile para obter 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 além desse período. Conversões com até 398 dias podem ser processadas, mas somente se a atribuição for feita usando MediaId.

1

Etapa 1: Prepare seus dados

Siga as instruções abaixo para visualizar um arquivo de modelo, adicionar seus dados de conversão e salvá-lo em formato .csv. O modelo que você precisa depende se você está rastreando conversões no nível do item (ou seja, incluindo o SKU, quantidade, etc. de cada item em um pedido) ou no nível do 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 no qual você rastreia as ações.

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

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

   • Modelo de Dados de Ações Encadeadas

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

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

3. Anexe quaisquer parâmetros opcionais que você deseje relatar como novas colunas em 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 no nível de item, IDs de pedido que têm múltiplos SKUs associados devem ser listados consecutivamente. Não agrupar itens de linha com o mesmo ID de pedido e SKUs diferentes resultará em um OID_DUPLICATE erro para os SKUs listados mais abaixo no arquivo.

2

Etapa 2: Envie seu arquivo de dados

Envie via FTP/SFTP

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

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

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 Ver / Editar.

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

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

6. Selecione Enviar Nome de Usuário e Senha FTP por E-mail e Salvar.

   • Depois de receber suas credenciais FTP/SFTP, use um cliente FTP/SFTP para conectar-se à 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, carregue seu arquivo para o diretório principal do servidor. Após um upload bem-sucedido, vá para a Etapa 3: Revise a submissão 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.

Puxar arquivo via FTP/SFTP

Anexar arquivo por e-mail

3

Etapa 3: Revise a submissão do arquivo

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

2. Na coluna esquerda, na seção Técnico selecione Submissões de Arquivo.

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

   1. Abaixo, você pode visualizar vários erros que podem ocorrer ao revisar submissões de arquivo e ações que você pode tomar para corrigi-los.

Erros ao revisar submissões de arquivo

Alguns erros comuns ao revisar submissões de arquivo podem incluir:

Problema	Ação a tomar
A coluna 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 é exigido: • 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á nos foram relatadas 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. Verifique se a ClickId e EventDate enviada está correta.
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] → Contracts → Contratos.
NO_VALID_REFERRERS _ FOUND CONTRACT_NOT_FOUND	Não há contrato ativo com o parceiro durante o EventDate. • Selecione [Engage] → Contracts → 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 referência de clique indicada nos termos do contrato. A configuração padrão é 30 dias. • Selecione [Engage] → Contracts → Contratos para verificar a janela de referência para um parceiro específico.