Virtue Mart 3

Integrazione Virtue Mart 3

VirtueMart 3 è un’estensione e-commerce gratuita e open source per Joomla, che ti consente di vendere prodotti online con un sistema di store flessibile. Post Affiliate Pro può essere integrato con VirtueMart 3 per tracciare le vendite degli affiliati, sia che gli ordini vengano pagati online che offline.

Questo metodo di integrazione è per Virtue Mart versione 3. Se possiedi una versione precedente, consulta il metodo di integrazione denominato “Virtue Mart 2”.

Informazioni necessarie

Prima di iniziare, ti occorre:

• ID account di Post Affiliate Pro – utilizzato nello snippet di tracciamento.

• URL allo script di tracciamento PAP – solitamente qualcosa come: https://YOUR_POSTAFFILIATE_DOMAIN/scripts/trackjs.js

• Accesso alla tua installazione di Joomla / VirtueMart 3 – dovrai modificare file PHP. Effettua sempre un backup dei file prima di apportare modifiche.

Integrazione passo dopo passo

Di seguito trovi i passaggi da seguire, basati sulla guida ufficiale di integrazione VirtueMart 3 di Post Affiliate Pro. Tutti gli snippet di codice sono forniti con i rispettivi percorsi dei file.

Integrare pagamenti offline (contanti)

Per i metodi di pagamento offline, il codice di tracciamento va aggiunto al plugin di VirtueMart che gestisce i pagamenti “standard” (offline). Individua il file:

Apri il file plugins/vmpayment/standard/standard.php e trova la funzione plgVmConfirmedOrder.

Al termine della funzione, c’è la riga $cart- >emptyCart – inserisci il seguente codice sopra di essa:

/* [Post Affiliate Pro](/ "Post Affiliate Pro offre una piattaforma di software di affiliazione completa per gestire con facilità più programmi di affiliazione. Nessun costo di attivazione, supporto clienti 24/7 e 1 mese di prova gratuita. Ideale per piccole e grandi imprese, offre tracciamento preciso, flussi di lavoro automatizzati e strumenti personalizzabili per potenziare il successo del tuo marketing affiliato. Provalo ora e semplifica la gestione delle tue affiliazioni!") integration snippet */
$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](/ "Post Affiliate Pro offre una piattaforma di software di affiliazione completa per gestire con facilità più programmi di affiliazione. Nessun costo di attivazione, supporto clienti 24/7 e 1 mese di prova gratuita. Ideale per piccole e grandi imprese, offre tracciamento preciso, flussi di lavoro automatizzati e strumenti personalizzabili per potenziare il successo del tuo marketing affiliato. Provalo ora e semplifica la gestione delle tue affiliazioni!") Pro integration snippet */

Salva le modifiche.

Integrare pagamenti online

I pagamenti online sono gestiti in modo differente, in particolare nel plugin di VirtueMart responsabile delle risposte di pagamento degli ordini confermati.

Apri il file administrator/components/com_virtuemart/plugins/vmpsplugin.php e trova la funzione processConfirmedOrderPaymentResponse.

Aggiungi il seguente codice all’inizio della funzione:

/* Post [Affiliate](/ "Post Affiliate Pro offre una piattaforma di software di affiliazione completa per gestire con facilità più programmi di affiliazione. Nessun costo di attivazione, supporto clienti 24/7 e 1 mese di prova gratuita. Ideale per piccole e grandi imprese, offre tracciamento preciso, flussi di lavoro automatizzati e strumenti personalizzabili per potenziare il successo del tuo marketing affiliato. Provalo ora e semplifica la gestione delle tue affiliazioni!") Pro integration snippet */
$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 Pro integration snippet */

Salva il file e testa con un vero metodo di pagamento online per assicurarti che il tracciamento venga attivato correttamente dopo la conferma del pagamento.

Passaggio aggiuntivo: Tracciamento dei click

Dopo aver implementato il tracciamento delle vendite (tramite gli snippet sopra), devi integrare anche il tracciamento dei click, così che quando viene cliccato un link affiliato, il click venga registrato. Senza il tracciamento dei click, le vendite potrebbero non essere attribuite correttamente agli affiliati.

• Solitamente ciò comporta l’inserimento di uno script di tracciamento dei click in un punto comune a tutte le pagine (spesso nell’header o tramite un template globale).
• Questo permette di catturare tutti i click affiliati prima che venga effettuato un ordine.

Test e verifica Una volta aggiunti gli snippet:

1. Effettua un ordine offline di test: verifica che lo script di tracciamento compaia nell’HTML prima che il carrello venga svuotato.
2. Effettua un ordine online di test: assicurati che, dopo il pagamento, il codice di tracciamento venga eseguito e invii i dati al tuo account Post Affiliate Pro.
3. Testa un link di referral affiliato: clicca sul link, completa un acquisto e verifica che la vendita venga attribuita all’affiliato nei report di PAP.

Risoluzione dei problemi

• Se il tracciamento non appare, ricontrolla di aver utilizzato i percorsi file corretti (nella tua installazione Joomla / VirtueMart) e i nomi corretti dei plugin di VirtueMart.
• Assicurati che URL_TO_PostAffiliatePro e Account_ID siano stati sostituiti con il vero URL dello script di Post Affiliate Pro e il tuo reale ID account.
• Verifica che la cache (su server / CDN) sia stata svuotata dopo le modifiche.
• Controlla la presenza di errori di sintassi (specialmente apici e concatenazioni) in PHP quando aggiungi lo snippet.

Esempio di codice combinato

Ecco uno snippet combinato semplificato (esempio per pagamenti offline):

// in plugins/vmpayment/standard/standard.php, dentro la funzione plgVmConfirmedOrder
// … codice precedente

/* Post Affiliate Pro integration snippet */
$html .= '<script id="pap_x2s6df8d" src="https://YOUR_POSTAFFILIATE_DOMAIN/scripts/trackjs.js" type="text/javascript"></script>
<script type="text/javascript">' . "PostAffTracker.setAccountId('YOUR_ACCOUNT_ID');
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>";
/* End of snippet */

// Procedi a svuotare il carrello
$cart->emptyCart();

Alternative a VirtueMart 3 che si integrano con Post Affiliate Pro

Se stai valutando alternative a VirtueMart 3, anche queste piattaforme sono compatibili con Post Affiliate Pro: