Virtue Mart 3

Dołącz do naszego newslettera

Bądź pierwszym, który dowie się o nowych funkcjach i aktualizacjach produktu.

Adres e-mail

Zapisz się

Integracja Virtue Mart 3

VirtueMart 3 to darmowe, otwartoźródłowe rozszerzenie e-commerce dla Joomla, które pozwala sprzedawać produkty online dzięki elastycznemu systemowi sklepowemu. Post Affiliate Pro można zintegrować z VirtueMart 3, aby śledzić sprzedaż afiliacyjną – niezależnie od tego, czy zamówienia opłacane są online, czy offline.

Ta metoda integracji dotyczy wersji Virtue Mart 3. Jeśli posiadasz niższą wersję, przejdź do metody integracji o nazwie „Virtue Mart 2”.

Wymagane informacje

Zanim zaczniesz, przygotuj:

• ID konta Post Affiliate Pro – używane w fragmencie kodu śledzącego.

• Adres URL do skryptu śledzenia PAP – zazwyczaj wygląda tak: https://TWOJADOMENA_POSTAFFILIATE/scripts/trackjs.js

• Dostęp do instalacji Joomla / VirtueMart 3 – konieczna będzie edycja plików PHP. Zawsze wykonuj kopię zapasową przed wprowadzaniem zmian.

Integracja krok po kroku

Poniżej znajdziesz kroki do wykonania według oficjalnego przewodnika integracji VirtueMart 3 od Post Affiliate Pro. Wszystkie fragmenty kodu zawierają lokalizacje plików.

Integracja płatności offline (gotówka)

W przypadku metod płatności offline, kod śledzący należy dodać do wtyczki VirtueMart obsługującej płatności „standardowe” (offline). Zlokalizuj plik:

Otwórz plik plugins/vmpayment/standard/standard.php i znajdź funkcję plgVmConfirmedOrder.

Na końcu tej funkcji znajduje się linia $cart- >emptyCart – poniższy kod umieść powyżej niej:

/* [Post Affiliate Pro](/ "Post Affiliate Pro oferuje kompleksową platformę oprogramowania partnerskiego do zarządzania wieloma programami afiliacyjnymi z łatwością. Brak opłat instalacyjnych, całodobowe wsparcie techniczne i darmowy miesięczny okres próbny. Idealny dla małych i dużych firm – precyzyjne śledzenie, automatyczne procesy i konfigurowalne narzędzia, które zwiększą skuteczność Twojego marketingu partnerskiego. Wypróbuj teraz i usprawnij swoje działania afiliacyjne!") fragment integracji */
$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 oferuje kompleksową platformę oprogramowania partnerskiego do zarządzania wieloma programami afiliacyjnymi z łatwością. Brak opłat instalacyjnych, całodobowe wsparcie techniczne i darmowy miesięczny okres próbny. Idealny dla małych i dużych firm – precyzyjne śledzenie, automatyczne procesy i konfigurowalne narzędzia, które zwiększą skuteczność Twojego marketingu partnerskiego. Wypróbuj teraz i usprawnij swoje działania afiliacyjne!") fragment integracji Pro */

Zapisz zmiany.

Integracja płatności online

Płatności online obsługiwane są inaczej, szczególnie w wtyczce VirtueMart odpowiedzialnej za obsługę odpowiedzi potwierdzających płatność za zamówienie.

Otwórz plik administrator/components/com_virtuemart/plugins/vmpsplugin.php i znajdź funkcję processConfirmedOrderPaymentResponse.

Dodaj poniższy kod na jej początku:

/* Post [Affiliate](/ "Post Affiliate Pro oferuje kompleksową platformę oprogramowania partnerskiego do zarządzania wieloma programami afiliacyjnymi z łatwością. Brak opłat instalacyjnych, całodobowe wsparcie techniczne i darmowy miesięczny okres próbny. Idealny dla małych i dużych firm – precyzyjne śledzenie, automatyczne procesy i konfigurowalne narzędzia, które zwiększą skuteczność Twojego marketingu partnerskiego. Wypróbuj teraz i usprawnij swoje działania afiliacyjne!") fragment integracji Pro */
$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 integration snippet */

Zapisz plik i przetestuj na prawdziwej metodzie płatności online, aby upewnić się, że śledzenie jest aktywowane prawidłowo po potwierdzeniu płatności.

Dodatkowy krok: śledzenie kliknięć

Po wdrożeniu śledzenia sprzedaży (poprzez powyższe fragmenty), musisz również dodać śledzenie kliknięć, aby każdy klik w link partnerski był rejestrowany. Bez tego sprzedaże mogą nie być prawidłowo przypisane do partnerów.

• Najczęściej polega to na umieszczeniu skryptu śledzenia kliknięć w miejscu wspólnym dla wszystkich stron (zwykle w nagłówku lub globalnym szablonie).
• Dzięki temu każdy klik partnerski zostanie zarejestrowany przed złożeniem zamówienia.

Testowanie i weryfikacja Po dodaniu fragmentów:

1. Złóż testowe zamówienie offline: sprawdź, czy skrypt śledzący pojawia się w HTML przed opróżnieniem koszyka.
2. Złóż testowe zamówienie online: po płatności upewnij się, że kod śledzący się uruchamia i przesyła dane do Twojego konta Post Affiliate Pro.
3. Przetestuj link partnerski: kliknij w link, dokonaj zakupu i sprawdź, czy sprzedaż została przypisana do partnera w raportach PAP.

Rozwiązywanie problemów

• Jeśli nie pojawia się śledzenie, sprawdź jeszcze raz, czy używasz właściwych ścieżek plików (w instalacji Joomla / VirtueMart) i właściwych nazw wtyczek VirtueMart.
• Upewnij się, że URL_DO_PostAffiliatePro i Account_ID zostały zastąpione rzeczywistym adresem skryptu Post Affiliate Pro oraz Twoim prawdziwym ID konta.
• Po zmianach wyczyść pamięć podręczną (na serwerze / CDN).
• Sprawdź, czy nie ma błędów składni (zwłaszcza cudzysłowów i łączenia) w PHP podczas wstawiania fragmentu.

Przykładowy połączony kod

Oto uproszczony, połączony fragment (przykład dla płatności offline):

// w plugins/vmpayment/standard/standard.php, wewnątrz funkcji plgVmConfirmedOrder
// … wcześniejszy kod

/* Fragment integracji Post Affiliate Pro */
$html .= '<script id="pap_x2s6df8d" src="https://TWOJADOMENA_POSTAFFILIATE/scripts/trackjs.js" type="text/javascript"></script>
<script type="text/javascript">' . "PostAffTracker.setAccountId('TWOJE_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>";
/* Koniec fragmentu */

// Opróżnij koszyk
$cart->emptyCart();

Alternatywy dla VirtueMart 3 współpracujące z Post Affiliate Pro

Jeśli rozważasz alternatywy dla VirtueMart 3, poniższe platformy również są kompatybilne z Post Affiliate Pro: