Virtue Mart 3

Virtue Mart 3-Integration

VirtueMart 3 ist eine kostenlose Open-Source-E-Commerce-Erweiterung für Joomla, mit der Sie Produkte online über ein flexibles Shopsystem verkaufen können. Post Affiliate Pro kann mit VirtueMart 3 integriert werden, um Affiliate-Verkäufe zu verfolgen, unabhängig davon, ob Bestellungen online oder offline bezahlt werden.

Diese Integrationsmethode ist für Virtue Mart Version 3. Wenn Sie eine ältere Version haben, wechseln Sie bitte zur Integrationsmethode „Virtue Mart 2“.

Benötigte Informationen

Bevor Sie beginnen, benötigen Sie:

• Post Affiliate Pro Account ID – wird im Tracking-Snippet verwendet.

• URL zum PAP-Tracking-Skript – normalerweise etwa: https://YOUR_POSTAFFILIATE_DOMAIN/scripts/trackjs.js

• Zugriff auf Ihre Joomla / VirtueMart 3-Installation – Sie müssen PHP-Dateien bearbeiten. Erstellen Sie immer ein Backup, bevor Sie Änderungen vornehmen.

Schritt-für-Schritt-Integration

Im Folgenden finden Sie die Schritte, die Sie laut offiziellem VirtueMart 3-Integrationsleitfaden von Post Affiliate Pro befolgen sollten. Alle Code-Snippets sind mit den jeweiligen Dateipfaden angegeben.

Offline-Zahlungen (Barzahlung) integrieren

Für Offline-Zahlungsmethoden sollte der Tracking-Code in das VirtueMart-Plugin eingefügt werden, das „Standard“- (Offline-) Zahlungen verarbeitet. Suchen Sie die Datei:

Öffnen Sie die Datei plugins/vmpayment/standard/standard.php und finden Sie die Funktion plgVmConfirmedOrder.

Am Ende finden Sie die Zeile $cart- >emptyCart – fügen Sie den folgenden Code darüber ein:

/* [Post Affiliate Pro](/ "Post Affiliate Pro bietet eine umfassende Affiliate-Software-Plattform zur Verwaltung mehrerer Affiliate-Programme mit Leichtigkeit. Keine Einrichtungsgebühren, 24/7 Kundensupport und einen kostenlosen 1-monatigen Testzeitraum. Ideal für kleine und große Unternehmen, mit präzisem Tracking, automatisierten Workflows und anpassbaren Tools, um Ihren Affiliate-Erfolg zu steigern. Probieren Sie es jetzt aus und optimieren Sie Ihr Affiliate-Management mühelos!") Integrations-Snippet */
$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 bietet eine umfassende Affiliate-Software-Plattform zur Verwaltung mehrerer Affiliate-Programme mit Leichtigkeit. Keine Einrichtungsgebühren, 24/7 Kundensupport und einen kostenlosen 1-monatigen Testzeitraum. Ideal für kleine und große Unternehmen, mit präzisem Tracking, automatisierten Workflows und anpassbaren Tools, um Ihren Affiliate-Erfolg zu steigern. Probieren Sie es jetzt aus und optimieren Sie Ihr Affiliate-Management mühelos!") Pro Integrations-Snippet */

Speichern Sie Ihre Änderungen.

Online-Zahlungen integrieren

Online-Zahlungen werden anders verarbeitet, insbesondere im VirtueMart-Plugin, das für bestätigte Zahlungsrückmeldungen zuständig ist.

Öffnen Sie die Datei administrator/components/com_virtuemart/plugins/vmpsplugin.php und suchen Sie die Funktion processConfirmedOrderPaymentResponse.

Fügen Sie zu Beginn dieser Funktion folgenden Code ein:

/* Post [Affiliate](/ "Post Affiliate Pro bietet eine umfassende Affiliate-Software-Plattform zur Verwaltung mehrerer Affiliate-Programme mit Leichtigkeit. Keine Einrichtungsgebühren, 24/7 Kundensupport und einen kostenlosen 1-monatigen Testzeitraum. Ideal für kleine und große Unternehmen, mit präzisem Tracking, automatisierten Workflows und anpassbaren Tools, um Ihren Affiliate-Erfolg zu steigern. Probieren Sie es jetzt aus und optimieren Sie Ihr Affiliate-Management mühelos!") Pro Integrations-Snippet */
$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 Integrations-Snippet */

Speichern Sie die Datei und testen Sie mit einer echten Online-Zahlungsmethode, um sicherzustellen, dass das Tracking nach Bestätigung der Zahlung korrekt ausgelöst wird.

Zusätzlicher Schritt: Click-Tracking

Nachdem Sie das Verkaufstracking (über die oben genannten Snippets) umgesetzt haben, müssen Sie auch das Click-Tracking integrieren, damit ein Affiliate-Klick ebenfalls erfasst wird. Ohne Click-Tracking können Verkäufe möglicherweise nicht korrekt Affiliates zugeordnet werden.

• Üblicherweise wird dazu ein Click-Tracking-Skript an einer Stelle eingebunden, die auf allen Seiten verfügbar ist (oft im Header oder über ein globales Template).
• Dadurch werden alle Affiliate-Klicks erfasst, bevor eine Bestellung aufgegeben wird.

Testen & Überprüfen Nachdem Sie die Snippets eingefügt haben:

1. Platzieren Sie eine Test-Offline-Bestellung: Überprüfen Sie, ob das Tracking-Skript im HTML erscheint, bevor der Warenkorb geleert wird.
2. Platzieren Sie eine Test-Online-Bestellung: Stellen Sie sicher, dass nach der Zahlung der Tracking-Code ausgeführt und die Daten an Ihr Post Affiliate Pro-Konto gesendet werden.
3. Testen Sie einen Affiliate-Referral-Link: Klicken Sie auf den Link, schließen Sie einen Kauf ab und prüfen Sie, ob der Verkauf dem Affiliate in den PAP-Berichten zugeordnet wird.

Fehlerbehebung

• Falls kein Tracking angezeigt wird, überprüfen Sie, ob Sie die richtigen Dateipfade (in Ihrer Joomla / VirtueMart-Installation) und Plugin-Namen verwendet haben.
• Vergewissern Sie sich, dass URL_TO_PostAffiliatePro und Account_ID durch Ihre echte Post Affiliate Pro-Skript-URL und Ihre echte Account-ID ersetzt wurden.
• Leeren Sie ggf. den Server- bzw. CDN-Cache nach Änderungen.
• Überprüfen Sie auf Syntaxfehler (insbesondere Anführungszeichen und Verkettungen) im PHP-Code beim Einfügen des Snippets.

Beispielcode kombiniert

Hier ein vereinfachtes Kombi-Snippet (Offline-Zahlungen-Beispiel):

// in plugins/vmpayment/standard/standard.php, innerhalb der Funktion plgVmConfirmedOrder
// … vorheriger Code

/* Post Affiliate Pro Integrations-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>";
/* Ende des Snippets */

// Warenkorb leeren
$cart->emptyCart();

Alternativen zu VirtueMart 3, die mit Post Affiliate Pro integriert werden können

Wenn Sie Alternativen zu VirtueMart 3 in Betracht ziehen, sind diese Plattformen ebenfalls mit Post Affiliate Pro kompatibel: