Konverze na vlastní děkovací stránce

convertor-usage-example.md

Funkce Konverzního scriptu

runConversionWithDuplicityProtection

Funkce spustí vámi vytvořený konverzní kód. Funkce má v sobě ochranu proti duplicitnímu vytvoření konverzí, která funguje na základě cookie hodnot. Pokud by se tedy váš zákazník dostal několikrát na děkovací stránku tetéž objednávky, konverze se spustí pouze při prvním zobrazení stránky.

runConversion

Funkce je stejná jako runConversionWithDuplicityProtection s tím rozdílem, že se konverze spustí při každém zobrazení stránky, tedy není zde žádná ochrana protí vytvoření duplicitních konverzí.

simpleFacebookPixelTransaction

Funkce vytvoří základní transakci do Facebook Pixelu.

simpleFacebookPixelTransactionOnlyPaid

Funkce vytvoří základní transakci do Facebook Pixelu. Funkce vytvoří transakci pouze pokud je objednávka zaplacená.

simpleGoogleAnalyticsEcommerceTransaction

Funkce vytvoří základní transakci do Google Analytics Ecommerce.

simpleGoogleAnalyticsEcommerceTransactionOnlyPaid

Funkce vytvoří základní transakci do Google Analytics Ecommerce. Funkce vytvoří transakci pouze pokud je objednávka zaplacená.

simpleGoogleTagManagerTransaction

Funkce vytvoří základní transakci do Google Tag Manager.

simpleGoogleTagManagerTransactionOnlyPaid

Funkce vytvoří základní transakci do Google Tag Manager. Funkce vytvoří transakci pouze pokud je objednávka zaplacená.

Tvorba konverzního kódu

Spuštení konverze po načtení konverzního scriptu

Protože se konvezní kód načitá paralelně s děkovací stránkou, je potřeba zajistit aby se kód spusil, po načtení konvezního scriptu. Konverzní script po úspěšném načtení a zpřistupnění konverzních funkci vyvolá event FapiConversionLoaded, na tento event je potřeba naslouchat.

<script>
  document.addEventListener('FapiConversionLoaded', function () {
    // Konverzní script byl načtený
  });
</script>  

Vyvolání konverze s daty objednávky

Po úspěšném načtení konverzního scriptu se nám spustí náš kód. Aby jsme získaly data faktury a mohli zaslat data do trackovacího nástroje, je zapotřebí spustit funkce konverzního scriptu runConversion nebo runConversionWithDuplicityProtection. Tato funkce jako první argument přijmá vaší konverzní funkci. Tuto konverzní funkci spustí a předá vám zde data objednávky.

<script>
	document.addEventListener('FapiConversionLoaded', function () {
		FAPI_CONVERSION.runConversionWithDuplicityProtection(function (orderData) {
			// orderData - data aktuální objednávky
      			// zaslání dat do trackingových nástrojů
		});
	});
</script>

nebo

<script>
	document.addEventListener('FapiConversionLoaded', function () {
		FAPI_CONVERSION.runConversion(function (orderData) {
			// orderData - data aktuální objednávky
      			// zaslání dat do trackingových nástrojů
		});
	});
</script>

Vytvoření konverze

Tady už stačí do scriptu vložit vlastní konverzní kód a nebo použít FAPI definovanou konverzi.

Celá ukázka

Aby jste mohli vytvářet konverze na vlastní děkovací stránce je k tomu potřeba zapotřebí dvě věci:

1. Konverzní kód
2. Do děkovací stránky vložit script, který spustí konverzní kód a data z FAPI

<script>
	document.addEventListener('FapiConversionLoaded', function () {
		FAPI_CONVERSION.runConversionWithDuplicityProtection(function (orderData) {
			FAPI_CONVERSION.simpleFacebookPixelTransaction(orderData); // basic FB Pixel transaction
      			// nebo
			FAPI_CONVERSION.simpleGoogleAnalyticsEcommerceTransaction(orderData); // basic Google Analytics transaction
      			// nebo
			FAPI_CONVERSION.simpleGoogleTagManagerTransaction(orderData); // basic Google Tag manager transaction
			// nebo
			// vlastní konverzní kód
		});
	});
</script>
<script src="https://web.fapi.cz/js/order-conversion/order-conversion.js"></script>

Nastavení prodejního formuláře

Aby script mohl fungovat správně a věděl o jakou objednávku se jedná. Je potřeba do URL adresy děkovací stránky dostat unikátní kód objednávky. Na to má již FAPI připravenou funkci, naleznete jí v úpravě prodejního formuláře -> 5 Děkovací stránka, kde stačí zaškrtnout checkbox Vkládat unikátní identifikátor objednávky do URL děkovací stránky