Virtue Mart 3

Integrácia Virtue Mart 3

VirtueMart 3 je bezplatné open-source rozšírenie e-shopu pre Joomla, ktoré vám umožňuje predávať produkty online cez flexibilný obchodný systém. Post Affiliate Pro je možné integrovať s VirtueMart 3 na sledovanie affiliate predajov, či už sú objednávky platené online alebo offline.

Táto metóda integrácie je určená pre Virtue Mart verziu 3. Ak máte nižšiu verziu, prejdite prosím na metódu integrácie s názvom „Virtue Mart 2“.

Požadované informácie

Pred začatím potrebujete:

• ID účtu Post Affiliate Pro – používa sa v sledovacom skripte.

• URL na PAP sledovací skript – zvyčajne vyzerá takto: https://YOUR_POSTAFFILIATE_DOMAIN/scripts/trackjs.js

• Prístup k vašej inštalácii Joomla / VirtueMart 3 – budete musieť upravovať PHP súbory. Pred zmenami vždy zálohujte súbory.

Postupná integrácia

Nižšie sú kroky, ktoré by ste mali nasledovať podľa oficiálneho integračného návodu VirtueMart 3 od Post Affiliate Pro. Všetky útržky kódu obsahujú aj umiestnenie súboru.

Integrácia offline platieb (hotovosť)

Pri offline platobných metódach treba sledovací kód pridať do VirtueMart pluginu, ktorý spracováva „štandardné“ (offline) platby. Nájdite súbor:

Otvorte súbor plugins/vmpayment/standard/standard.php a vyhľadajte funkciu plgVmConfirmedOrder.

Na jej konci sa nachádza riadok $cart- >emptyCart – nasledujúci kód vložte nad tento riadok:

/* [Post Affiliate Pro](/ "Post Affiliate Pro ponúka komplexnú affiliate softvérovú platformu na jednoduchú správu viacerých affiliate programov. Bez poplatkov za nastavenie, 24/7 zákaznícka podpora a mesačná skúšobná verzia zdarma. Ideálne pre malé aj veľké firmy – presné sledovanie, automatizované procesy a prispôsobiteľné nástroje na zvýšenie vášho affiliate marketingu. Vyskúšajte teraz a zjednodušte svoje affiliate operácie bez námahy!") integračný útržok */
$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 ponúka komplexnú affiliate softvérovú platformu na jednoduchú správu viacerých affiliate programov. Bez poplatkov za nastavenie, 24/7 zákaznícka podpora a mesačná skúšobná verzia zdarma. Ideálne pre malé aj veľké firmy – presné sledovanie, automatizované procesy a prispôsobiteľné nástroje na zvýšenie vášho affiliate marketingu. Vyskúšajte teraz a zjednodušte svoje affiliate operácie bez námahy!") Pro integračný útržok */

Uložte svoje zmeny.

Integrácia online platieb

Online platby sa spracovávajú odlišne, najmä v VirtueMart plugine zodpovednom za odpovede na platby potvrdených objednávok.

Otvorte súbor administrator/components/com_virtuemart/plugins/vmpsplugin.php a vyhľadajte funkciu processConfirmedOrderPaymentResponse.

Na jej začiatok vložte nasledujúci kód:

/* Post [Affiliate](/ "Post Affiliate Pro ponúka komplexnú affiliate softvérovú platformu na jednoduchú správu viacerých affiliate programov. Bez poplatkov za nastavenie, 24/7 zákaznícka podpora a mesačná skúšobná verzia zdarma. Ideálne pre malé aj veľké firmy – presné sledovanie, automatizované procesy a prispôsobiteľné nástroje na zvýšenie vášho affiliate marketingu. Vyskúšajte teraz a zjednodušte svoje affiliate operácie bez námahy!") Pro integračný útržok */
$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 integračný útržok */

Uložte súbor a otestujte s reálnou online platobnou metódou, či sa sledovanie po potvrdení platby správne spustí.

Dodatočný krok: Sledovanie kliknutí

Po implementácii sledovania predaja (pomocou vyššie uvedených útržkov) je potrebné integrovať aj sledovanie kliknutí, aby sa kliknutia na affiliate odkazy zaznamenali. Bez sledovania kliknutí nemusí byť predaj správne priradený affiliate partnerom.

• Väčšinou to znamená vložiť sledovací skript na miesto, ktoré je spoločné pre všetky stránky (často do hlavičky alebo cez šablónu webu).
• Takto sa zachytia všetky affiliate kliknutia ešte pred vytvorením objednávky.

Testovanie & Overenie Po pridaní útržkov:

1. Zrealizujte testovaciu offline objednávku: overte, že sledovací skript sa objaví v HTML pred vyprázdnením košíka.
2. Zrealizujte testovaciu online objednávku: overte, že po platbe sa spustí sledovací kód a odošle údaje do vášho účtu Post Affiliate Pro.
3. Otestujte affiliate odporúčací odkaz: kliknite na odkaz, dokončite nákup a skontrolujte, či je predaj správne priradený affiliate partnerovi v reportoch PAP.

Riešenie problémov

• Ak sa sledovanie nezobrazí, skontrolujte správnosť ciest k súborom (v inštalácii Joomla / VirtueMart) a názvy pluginov VirtueMart.
• Uistite sa, že URL_TO_PostAffiliatePro a Account_ID ste nahradili vašou skutočnou URL skriptu Post Affiliate Pro a vaším reálnym ID účtu.
• Po zmenách vymažte cache (na serveri / CDN).
• Skontrolujte chyby v syntaxi (najmä úvodzovky, spájanie) v PHP pri vkladaní útržku.

Ukážka kombinovaného kódu

Tu je zjednodušený kombinovaný útržok (príklad pre offline platby):

// v plugins/vmpayment/standard/standard.php, vo funkcii plgVmConfirmedOrder
// … predchádzajúci kód

/* Post Affiliate Pro integračný útržok */
$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>";
/* Koniec útržku */

// Pokračujte vyprázdnením košíka
$cart->emptyCart();

Alternatívy k VirtueMart 3 s integráciou na Post Affiliate Pro

Ak zvažujete alternatívy k VirtueMart 3, tieto platformy sú taktiež kompatibilné s Post Affiliate Pro: