Sistema de Importação/Exportação

Disponível em:

• Post Affiliate Pro
• Post Affiliate Pro Ultimate
• Post Affiliate Network

Visão Geral

O Sistema de Importação/Exportação no Post Affiliate Pro fornece ferramentas poderosas para operações de dados em massa. Seja você migrando de outra plataforma, gerenciando grandes conjuntos de dados ou sincronizando dados entre sistemas, a funcionalidade de importação/exportação economiza tempo e reduz erros manuais.

O sistema suporta importação e exportação de:

• Afiliados - Contas de usuário com todos os dados de perfil e opções de pagamento
• Campanhas - Configurações de campanha, tipos de comissão, grupos e taxas
• Banners - Definições de banner e materiais promocionais
• Transações - Vendas, comissões e registros de transação
• Temas - Temas e templates personalizados do painel

Importação/Exportação de Afiliados

Exportando Afiliados

O recurso de exportação de afiliados cria um arquivo CSV abrangente contendo todos os dados de afiliados da sua instalação. A exportação inclui:

Campos Principais de Afiliado:

• ID de Usuário (identificador único)
• ID de Referência (refid)
• Username (email)
• Nome e Sobrenome
• Status da Conta (pendente, aprovado, recusado)
• Data de Inserção e Data de Aprovação
• ID de Usuário Pai (para estruturas multinível)
• Limite Mínimo de Pagamento
• Notas e Foto

Campos de Dados Personalizados:

• Data1 até Data25 (campos de afiliado personalizados)

Opções de Pagamento: A exportação também inclui uma seção separada para opções de pagamento, contendo:

• ID de Usuário
• Nome do campo de pagamento
• Valor do campo de pagamento

Importando Afiliados

Ao importar afiliados, o sistema processa o arquivo CSV e cria novas contas de afiliado ou atualiza existentes baseado no ID de Usuário.

Campos Obrigatórios:

• !USERID - O identificador único para o afiliado

Comportamentos Chave:

• Se um afiliado com o ID de Usuário especificado existe, o registro é atualizado
• Se o ID de Usuário não existe, uma nova conta de afiliado é criada
• Campos de status vazios usam “Aprovado” como padrão
• O sistema lida automaticamente com relacionamentos de usuário pai para estruturas multinível
• Senhas podem ser importadas com ou sem criptografia salt

Mapeamento de Campos: A linha de cabeçalho do CSV define nomes de campos usando o formato !NOMEDOCAMPO. Por exemplo:

!USERID,!REFID,!USERNAME,!FIRSTNAME,!LASTNAME,!STATUS

Exemplo de Formato CSV

!USERID,!REFID,!USERNAME,!FIRSTNAME,!LASTNAME,!STATUS,!MINIMUMPAYOUT
abc12345,REF001,joao@example.com,João,Silva,A,50.00
def67890,REF002,maria@example.com,Maria,Santos,A,100.00

Valores de status:

• A - Aprovado
• P - Pendente
• D - Recusado

Importação/Exportação de Campanhas

O Que é Exportado

A exportação de campanha cria um backup abrangente da sua estrutura de campanha incluindo:

Campanhas:

• ID da Campanha, Nome e Descrição
• Tipo e Status
• Data de Inserção
• Ordem de Exibição
• Configurações de Vida Útil e Sobrescrita de Cookie
• Configurações de Geo-targeting (países, regras de exibição)
• Configurações de intervalo de datas válidas
• URL do Logo e ID do Produto

Tipos de Comissão:

• ID do Tipo de Comissão
• Tipo (venda, lead, clique, etc.)
• Nome e Código
• Status e configurações de Aprovação
• Configurações de preset de recorrência
• Opções de tratamento de comissão zero
• Restrições de país e cidade

Grupos de Comissão:

• ID e Nome do Grupo
• Associação de campanha
• Flag de grupo padrão

Comissões:

• ID da Comissão
• Nível
• Tipo de comissão (porcentagem, fixo)
• Valor
• Associação a tipos de comissão e grupos

Importando Campanhas

A importação de campanha suporta criar ou atualizar campanhas com todas as suas estruturas de comissão associadas.

Campos Obrigatórios por Seção:

• Campanhas: !CAMPAIGNID
• Tipos de Comissão: !COMMTYPEID
• Grupos de Comissão: !COMMISSIONGROUPID
• Comissões: !COMMISSIONID

A importação processa cada seção sequencialmente, garantindo relacionamentos adequados entre campanhas, tipos de comissão, grupos e taxas de comissão.

Importação/Exportação de Banners

Estrutura de Dados de Banner

A importação/exportação de banner lida com os metadados e configuração dos seus materiais promocionais:

Campos Exportados:

• ID do Banner
• ID da Conta e ID da Campanha
• Tipo de Banner (imagem, HTML, link de texto, etc.)
• Status (ativo/inativo)
• Nome e Descrição
• URL de Destino
• Dimensões de tamanho
• Campos de dados (Data1-Data4) para conteúdo específico do tipo
• Ordem de Exibição
• String SEO
• ID do Wrapper
• Data de Inserção

Nota Importante: A importação/exportação de banner lida apenas com definições, não com os arquivos físicos de imagem ou assets. Garanta que as imagens referenciadas estejam disponíveis nas URLs especificadas após a importação.

Campo Obrigatório:

• !BANNERID - Identificador único do banner

Exemplo de Formato CSV

!BANNERID,!CAMPAIGNID,!TYPE,!NAME,!DESTINATIONURL,!STATUS
ban12345,camp001,I,Banner Promoção Verão,https://exemplo.com/promocao,A
ban67890,camp001,T,Link Texto Promo,https://exemplo.com/promo,A

Tipos de banner:

• I - Banner de imagem
• T - Link de texto
• H - Banner HTML
• E outros tipos suportados

Importação de Transações

Visão Geral

A importação de transações é um recurso poderoso para carregar em massa vendas, comissões e outros registros de transação. Isso é particularmente útil para:

• Migrar dados históricos de outras plataformas
• Importar vendas offline
• Processamento em lote de atualizações de transações
• Sincronização com sistemas externos

Campos Disponíveis

A importação de transações suporta um conjunto abrangente de campos:

Campos Principais de Transação:

• ID da Transação
• ID da Conta
• ID de Usuário (afiliado) - suporta ID, refid ou username
• ID do Banner e ID do Banner Pai
• ID da Campanha
• ID do Pedido e ID do Produto
• Status (pendente, aprovado, recusado)
• Tipo (venda, lead, clique, reembolso, chargeback)
• Data de Inserção e Data de Aprovação
• Valor da comissão
• Custo Total e Custo Fixo
• Nível

Informações de Rastreamento:

• Código do País
• Endereço IP
• Navegador
• URL de Referência
• Método de Rastreamento
• Contagem de Cliques
• Canal
• ID do Visitante

Dados Adicionais:

• Campos de Dados Extras (Data1-Data5)
• Nota do Comerciante e Nota do Sistema
• ID ou Código do Cupom
• Informações de moeda (ID, valor, taxa)
• ID do Tipo de Comissão e ID do Grupo
• Taxa de Rede
• ID da Venda e informações de Split

Opções de Importação

Correspondência de Transação: A importação pode corresponder transações existentes por:

• ID do Pedido - Atualiza transações com ID do pedido correspondente
• ID da Transação - Atualiza transação específica por ID
• ID do Pedido (Todos os Níveis) - Atualiza todas as transações de nível para um pedido

Cálculo Automático de Comissão: Habilite computação automática de comissão para que o sistema calcule valores de comissão baseado em:

• Configurações de comissão da campanha
• Grupo de comissão do afiliado
• Valor do custo total
• Regras do tipo de comissão

Geração de Comissão Multinível: Quando habilitado, a importação cria automaticamente comissões de nível baseadas na estrutura de upline do afiliado e configurações da campanha.

Tratamento de Status:

• Defina um status específico para todas as transações importadas
• Use status do arquivo (valor do campo)
• Preserve status original ao atualizar transações existentes

Presets de Formato de Importação

Você pode salvar e reutilizar configurações de formato de importação:

• Defina mapeamentos de colunas
• Configure opções de importação
• Salve como presets nomeados para importações recorrentes

Exemplo de Formato CSV

userid,campaignid,totalcost,orderid,rstatus,dateinserted
aff12345,camp001,99.99,PED-001,A,2025-01-10 10:30:00
aff67890,camp001,149.99,PED-002,P,2025-01-10 11:45:00

Tratando Reembolsos e Chargebacks

Ao importar reembolsos ou chargebacks:

• Defina o tipo de transação como reembolso (R) ou chargeback (H)
• Forneça o ID da transação pai ou ID do pedido para referência
• Valores de comissão são automaticamente calculados como valores negativos ao usar computação automática

Importação/Exportação de Temas

Exportação de Tema

Exporte seus temas personalizados como pacotes completos para backup ou migração:

O Que é Exportado:

• Configuração do tema (configurações theme.php)
• Todos os arquivos de template (.tpl e .stpl)
• Arquivos CSS personalizados (custom.css, custom_colors.css)
• Assets de imagem (JPEG, PNG, GIF, BMP)

A exportação cria um arquivo ZIP contendo a estrutura completa do tema.

Configuração do Tema Inclui:

• Nome e descrição do tema
• Autor e URL
• Módulo (painel comerciante/afiliado)
• Modo de exibição (single/window)
• Configurações de wallpaper padrão
• Imagem de miniatura
• Configurações de override CSS
• Referência do tema original

Importação de Tema

Importe temas de pacotes ZIP para implantar rapidamente designs personalizados:

Requisitos:

• Arquivo ZIP válido com configuração theme.php
• Sintaxe de template adequada (validada durante a importação)
• Referência de tema original válida
• Imagem de miniatura especificada

Validação: O processo de importação valida:

• Completude da configuração do tema
• Sintaxe de template Smarty
• Existência do tema original
• Restrições de tipo de arquivo (apenas extensões permitidas)

Tipos de Arquivo Suportados:

• Templates: .tpl, .stpl
• Estilos: .css (apenas custom.css, custom_colors.css)
• Imagens: .jpg, .jpeg, .png, .gif, .bmp

Requisitos de Formato de Dados

Estrutura de Arquivo CSV

Requisitos Gerais:

• Use codificação UTF-8 para tratamento adequado de caracteres
• A primeira linha deve conter cabeçalhos de colunas
• Delimitador consistente em todo o arquivo (vírgula, ponto e vírgula ou tab)
• Caracteres especiais devidamente escapados

Formato de Nome de Campo:

• Campos obrigatórios são prefixados com ! (ex.: !USERID)
• Nomes de campos não são sensíveis a maiúsculas/minúsculas
• Mapeamento personalizado permite ordenação flexível de colunas

Formato de Data: Datas devem estar em um formato reconhecível:

• AAAA-MM-DD HH:MM:SS (recomendado)
• Formatos de data padrão são automaticamente parseados

Valores Numéricos:

• Use ponto (.) como separador decimal
• Sem separadores de milhares
• Valores negativos suportados (ex.: para reembolsos)

Arquivos Multi-Seção

Algumas exportações (afiliados, campanhas) incluem múltiplas seções de dados:

[[AFFILIATES]]
!USERID,!REFID,!USERNAME
...

[[Payout options]]
!USERID,name,value
...

Cada seção é identificada por um marcador de cabeçalho e tem sua própria estrutura de colunas.

Melhores Práticas para Operações em Massa

Antes de Importar

1. Crie um Backup Sempre exporte seus dados atuais antes de realizar importações em massa, especialmente ao usar a opção de exclusão.

2. Valide Seus Dados

   • Verifique IDs duplicados
   • Verifique se campos obrigatórios estão presentes
   • Garanta que formatos de data são consistentes
   • Valide códigos de status e tipo

3. Teste com Conjunto de Dados Pequeno Importe alguns registros primeiro para verificar mapeamento e comportamento antes de processar arquivos grandes.

4. Verifique Dependências

   • Garanta que campanhas referenciadas existem antes de importar banners
   • Verifique se contas de afiliados existem antes de importar transações
   • Confirme que tipos de comissão estão configurados antes de importar comissões

Durante a Importação

5. Monitore o Progresso A importação executa como uma tarefa em background com rastreamento de progresso. Verifique as notificações de tarefa para atualizações de status e mensagens de erro.

6. Trate Erros com Elegância O sistema registra erros para registros individuais enquanto continua processando entradas válidas. Revise o log de importação para tratar registros que falharam.

Após Importar

7. Verifique os Resultados

   • Verifique registros importados por amostragem
   • Verifique se totais e contagens correspondem às expectativas
   • Teste logins de afiliados se senhas foram importadas

8. Atualize Registros Relacionados Algumas importações podem requerer ações de acompanhamento:

   • Atribuir afiliados a campanhas
   • Fazer upload de imagens de banner
   • Configurar taxas de comissão

Considerações de Desempenho

9. Tratamento de Arquivos Grandes O sistema de importação processa dados em lotes para prevenir timeouts. Arquivos muito grandes podem levar vários minutos para completar.

10. Agende Durante Baixa Atividade Para melhor desempenho, agende importações grandes durante horários de menor movimento quando a carga do sistema é menor.

Notas de Segurança

11. Dados Sensíveis

    • Campos de senha são tratados com segurança com criptografia salt
    • Evite importar informações sensíveis de pagamento através de canais não seguros
    • Revise arquivos de importação para exposição não intencional de dados

12. Controle de Acesso Funções de importação/exportação requerem permissões apropriadas de administrador comerciante.

Casos de Uso Comuns

Migrando de Outra Plataforma

1. Exporte dados da sua plataforma existente em formato CSV
2. Mapeie colunas para nomes de campos do Post Affiliate Pro
3. Importe afiliados primeiro para estabelecer contas de usuário
4. Importe campanhas e estruturas de comissão
5. Importe transações históricas
6. Faça upload de banners e materiais promocionais

Sincronização Mensal de Transações

1. Crie um preset de formato de importação para seu sistema externo
2. Exporte transações da sua plataforma de e-commerce
3. Importe usando correspondência de ID do Pedido para atualizar transações existentes
4. Revise o log de importação para quaisquer discrepâncias

Backup e Implantação de Tema

1. Personalize seu tema em um ambiente de desenvolvimento
2. Exporte o tema como um pacote ZIP
3. Importe na instalação de produção
4. Verifique aparência e funcionalidade do tema

Atualizações em Massa de Afiliados

1. Exporte dados atuais de afiliados
2. Modifique o arquivo CSV com informações atualizadas
3. Importe com correspondência por ID de Usuário
4. Verifique se as atualizações foram aplicadas corretamente