Virtue Mart 3

Integração do Virtue Mart 3

O VirtueMart 3 é uma extensão gratuita e open-source de e-commerce para Joomla, permitindo vender produtos online com um sistema de loja flexível. O Post Affiliate Pro pode ser integrado ao VirtueMart 3 para rastrear vendas de afiliados, seja para pedidos pagos online ou offline.

Este método de integração é para a versão 3 do Virtue Mart. Se você possui uma versão anterior, acesse o método de integração chamado “Virtue Mart 2”.

Informações necessárias

Antes de começar, você precisará de:

• ID da Conta do Post Affiliate Pro – utilizado no trecho de rastreamento.

• URL do script de rastreamento do PAP – normalmente algo como: https://SEU_DOMINIO_POSTAFFILIATE/scripts/trackjs.js

• Acesso à sua instalação do Joomla / VirtueMart 3 – será necessário editar arquivos PHP. Sempre faça backup dos arquivos antes de qualquer alteração.

Integração passo a passo

Abaixo estão os passos que você deve seguir, conforme o guia oficial de integração do VirtueMart 3 pelo Post Affiliate Pro. Todos os trechos de código indicam seus respectivos locais de inserção.

Integre pagamentos offline (dinheiro)

Para métodos de pagamento offline, o código de rastreamento deve ser adicionado ao plugin do VirtueMart que lida com pagamentos “standard” (offline). Localize o arquivo:

Abra o arquivo plugins/vmpayment/standard/standard.php e encontre a função plgVmConfirmedOrder.

Ao final dela, existe a linha $cart- >emptyCart – coloque o código a seguir acima dessa linha:

/* [Post Affiliate Pro](/ "O Post Affiliate Pro oferece uma plataforma completa de software de afiliados para gerenciar múltiplos programas com facilidade. Aproveite sem taxas de configuração, suporte ao cliente 24/7 e um teste grátis de 1 mês. Ideal para pequenas e grandes empresas, oferece rastreamento preciso, fluxos de trabalho automatizados e ferramentas personalizáveis para impulsionar seu marketing de afiliados. Experimente agora e otimize suas operações de afiliados com facilidade!") trecho de integração */
$html .= '<script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/trackjs.js" type="text/javascript"></script>
<script type="text/javascript">'."{$SetAccountJs}
{$CreateSaleJs}
sale.setTotalCost('".$order['details']['BT']->order_subtotal."');
sale.setOrderID('".$order['details']['BT']->order_number."');
sale.setData1('".$order['details']['BT']->email."');
PostAffTracker.register();
</script>";
/* [Post Affiliate](/ "O Post Affiliate Pro oferece uma plataforma completa de software de afiliados para gerenciar múltiplos programas com facilidade. Aproveite sem taxas de configuração, suporte ao cliente 24/7 e um teste grátis de 1 mês. Ideal para pequenas e grandes empresas, oferece rastreamento preciso, fluxos de trabalho automatizados e ferramentas personalizáveis para impulsionar seu marketing de afiliados. Experimente agora e otimize suas operações de afiliados com facilidade!") Pro trecho de integração */

Salve suas alterações.

Integre pagamentos online

Pagamentos online são tratados de forma diferente, especialmente no plugin do VirtueMart responsável pelo retorno de pagamento de pedidos confirmados.

Abra o arquivo administrator/components/com_virtuemart/plugins/vmpsplugin.php e localize a função processConfirmedOrderPaymentResponse.

Adicione o código a seguir no início da função:

/* Post [Affiliate](/ "O Post Affiliate Pro oferece uma plataforma completa de software de afiliados para gerenciar múltiplos programas com facilidade. Aproveite sem taxas de configuração, suporte ao cliente 24/7 e um teste grátis de 1 mês. Ideal para pequenas e grandes empresas, oferece rastreamento preciso, fluxos de trabalho automatizados e ferramentas personalizáveis para impulsionar seu marketing de afiliados. Experimente agora e otimize suas operações de afiliados com facilidade!") Pro trecho de integração */
$html .= '<script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/trackjs.js" type="text/javascript"></script>
<script type="text/javascript">'."{$SetAccountJs}
{$CreateSaleJs}
sale.setTotalCost('".$order['details']['BT']->order_subtotal."');
sale.setOrderID('".$order['details']['BT']->order_number."');
sale.setData1('".$order['details']['BT']->email."');
PostAffTracker.register();
</script>";
/* Trecho de integração Post Affiliate Pro */

Salve o arquivo e teste com um método de pagamento online real para garantir que o rastreamento seja acionado corretamente após a confirmação do pagamento.

Passo adicional: Rastreamento de cliques

Após implementar o rastreamento de vendas (com os trechos acima), você também deve integrar o rastreamento de cliques, para que, ao clicar em um link de afiliado, o clique seja registrado. Sem o rastreamento de cliques, as vendas podem não ser atribuídas corretamente aos afiliados.

• Normalmente, isso envolve colocar um script de rastreamento de cliques em um local comum a todas as páginas (geralmente no cabeçalho ou em um template global).
• Isso captura todos os cliques de afiliados antes de um pedido ser realizado.

Testes & Verificação Depois de adicionar os trechos:

1. Faça um pedido offline de teste: verifique se o script de rastreamento aparece no HTML antes do esvaziamento do carrinho.
2. Faça um pedido online de teste: certifique-se de que, após o pagamento, o código de rastreamento é executado e envia os dados para sua conta do Post Affiliate Pro.
3. Teste um link de indicação de afiliado: clique no link, conclua uma compra e confira se a venda é atribuída ao afiliado nos relatórios do PAP.

Solução de problemas

• Se o rastreamento não aparecer, confira se usou os caminhos de arquivos corretos (em sua instalação Joomla / VirtueMart) e os nomes corretos dos plugins do VirtueMart.
• Certifique-se de que URL_TO_PostAffiliatePro e Account_ID foram substituídos pela URL real do seu script do Post Affiliate Pro e seu ID de conta real.
• Certifique-se de que o cache (do servidor / CDN) foi limpo após as alterações.
• Verifique se há erros de sintaxe (especialmente aspas, concatenação) no PHP ao adicionar o trecho.

Código de exemplo combinado

Veja um trecho combinado simplificado (exemplo para pagamentos offline):

// em plugins/vmpayment/standard/standard.php, dentro da função plgVmConfirmedOrder
// … código anterior

/* Trecho de integração Post Affiliate Pro */
$html .= '<script id="pap_x2s6df8d" src="https://SEU_DOMINIO_POSTAFFILIATE/scripts/trackjs.js" type="text/javascript"></script>
<script type="text/javascript">' . "PostAffTracker.setAccountId('SEU_ID_CONTA');
var sale = PostAffTracker.createSale();
sale.setTotalCost('" . $order['details']['BT']->order_subtotal . "');
sale.setOrderID('" . $order['details']['BT']->order_number . "');
sale.setData1('" . $order['details']['BT']->email . "');
PostAffTracker.register();
</script>";
/* Fim do trecho */

// Prossiga para esvaziar o carrinho
$cart->emptyCart();

Alternativas ao VirtueMart 3 que integram com o Post Affiliate Pro

Se você está considerando alternativas ao VirtueMart 3, estas plataformas também são compatíveis com o Post Affiliate Pro: