Virtue Mart 3

Virtue Mart 3-integratie

VirtueMart 3 is een gratis, open-source e-commerce extensie voor Joomla, waarmee je online producten kunt verkopen met een flexibel winkelsysteem. Post Affiliate Pro kan worden geïntegreerd met VirtueMart 3 om affiliate verkopen te traceren, ongeacht of bestellingen online of offline worden betaald.

Deze integratiemethode is voor Virtue Mart versie 3. Heb je een lagere versie, navigeer dan naar de integratiemethode genaamd “Virtue Mart 2”.

Vereiste informatie

Voordat je begint, heb je het volgende nodig:

• Post Affiliate Pro Account ID – wordt gebruikt in het trackingfragment.

• URL naar PAP tracking script – meestal iets als: https://JOUW_POSTAFFILIATE_DOMEIN/scripts/trackjs.js

• Toegang tot je Joomla / VirtueMart 3-installatie – je moet PHP-bestanden bewerken. Maak altijd een back-up van bestanden voordat je wijzigingen aanbrengt.

Stapsgewijze integratie

Hieronder vind je de stappen die je moet volgen, gebaseerd op de officiële VirtueMart 3-integratiehandleiding van Post Affiliate Pro. Alle codefragmenten worden geleverd met hun bestandslocaties.

Offline betalingen integreren (contant)

Voor offline betaalmethoden moet de trackingcode worden toegevoegd aan de VirtueMart-plugin die “standaard” (offline) betalingen afhandelt. Zoek het bestand:

Open het bestand plugins/vmpayment/standard/standard.php en zoek de functie plgVmConfirmedOrder.

Aan het einde hiervan staat de regel $cart- >emptyCart – plaats de volgende code hierboven:

/* [Post Affiliate Pro](/ "Post Affiliate Pro biedt een uitgebreid affiliate softwareplatform om eenvoudig meerdere affiliateprogramma's te beheren. Geen opstartkosten, 24/7 klantenservice en een gratis proefperiode van 1 maand. Ideaal voor kleine en grote bedrijven, met nauwkeurige tracking, geautomatiseerde workflows en aanpasbare tools om je affiliate marketing te verbeteren. Probeer het nu en stroomlijn je affiliate activiteiten moeiteloos!") integratiefragment */
$html .= '<script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/trackjs.js" type="text/javascript"></script>
<script type="text/javascript">'."PostAffTracker.setAccountId('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>";
/* [Post Affiliate](/ "Post Affiliate Pro biedt een uitgebreid affiliate softwareplatform om eenvoudig meerdere affiliateprogramma's te beheren. Geen opstartkosten, 24/7 klantenservice en een gratis proefperiode van 1 maand. Ideaal voor kleine en grote bedrijven, met nauwkeurige tracking, geautomatiseerde workflows en aanpasbare tools om je affiliate marketing te verbeteren. Probeer het nu en stroomlijn je affiliate activiteiten moeiteloos!") Pro integratiefragment */

Sla je wijzigingen op.

Online betalingen integreren

Online betalingen worden anders afgehandeld, met name in de VirtueMart-plugin die verantwoordelijk is voor bevestigde betalingsresponsen van bestellingen.

Open het bestand administrator/components/com_virtuemart/plugins/vmpsplugin.php en zoek de functie processConfirmedOrderPaymentResponse.

Voeg de volgende code toe aan het begin hiervan:

/* Post [Affiliate](/ "Post Affiliate Pro biedt een uitgebreid affiliate softwareplatform om eenvoudig meerdere affiliateprogramma's te beheren. Geen opstartkosten, 24/7 klantenservice en een gratis proefperiode van 1 maand. Ideaal voor kleine en grote bedrijven, met nauwkeurige tracking, geautomatiseerde workflows en aanpasbare tools om je affiliate marketing te verbeteren. Probeer het nu en stroomlijn je affiliate activiteiten moeiteloos!") Pro integratiefragment */
$html .= '<script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/trackjs.js" type="text/javascript"></script>
<script type="text/javascript">'."PostAffTracker.setAccountId('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>";
/* Post Affiliate Pro integratiefragment */

Sla het bestand op en test met een echte online betaalmethode om te garanderen dat de tracking correct werkt nadat de betaling is bevestigd.

Extra stap: Kliktracking

Na het implementeren van verkooptracking (via bovenstaande fragmenten), moet je ook kliktracking integreren, zodat wanneer een affiliate link wordt aangeklikt, de klik wordt geregistreerd. Zonder kliktracking worden verkopen mogelijk niet correct aan affiliates toegewezen.

• Dit houdt meestal in dat je een kliktracking script plaatst op een plek die op alle pagina’s voorkomt (vaak in de header of via een sitebrede template).
• Hiermee worden alle affiliate kliks geregistreerd voordat een bestelling wordt geplaatst.

Testen & Verifiëren Nadat je de fragmenten hebt toegevoegd:

1. Plaats een test offline bestelling: controleer of het tracking script in de HTML verschijnt voordat de winkelwagen geleegd wordt.
2. Plaats een test online bestelling: controleer na de betaling of de trackingcode wordt uitgevoerd en gegevens naar je Post Affiliate Pro-account stuurt.
3. Test een affiliate verwijzingslink: klik op de link, voltooi een aankoop en controleer of de verkoop is toegewezen aan de affiliate in de PAP-rapporten.

Probleemoplossing

• Als er geen tracking zichtbaar is, controleer dan of je de juiste bestandslocaties (in jouw Joomla / VirtueMart-installatie) en juiste virtuemart pluginnamen hebt gebruikt.
• Zorg dat URL_TO_PostAffiliatePro en Account_ID zijn vervangen door de echte Post Affiliate Pro script-URL en jouw echte account-ID.
• Zorg dat caching (op de server / CDN) is geleegd na wijzigingen.
• Controleer op syntaxisfouten (vooral aanhalingstekens, concatenatie) in PHP bij het toevoegen van het fragment.

Voorbeeldcode gecombineerd

Hier is een vereenvoudigd gecombineerd fragment (voorbeeld voor offline betalingen):

// in plugins/vmpayment/standard/standard.php, binnen de plgVmConfirmedOrder functie
// … eerdere code

/* Post Affiliate Pro integratiefragment */
$html .= '<script id="pap_x2s6df8d" src="https://JOUW_POSTAFFILIATE_DOMEIN/scripts/trackjs.js" type="text/javascript"></script>
<script type="text/javascript">' . "PostAffTracker.setAccountId('JOUW_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>";
/* Einde fragment */

// Winkelwagen vervolgens legen
$cart->emptyCart();

Alternatieven voor VirtueMart 3 die met Post Affiliate Pro integreren

Overweeg je alternatieven voor VirtueMart 3, dan zijn deze platforms ook compatibel met Post Affiliate Pro: