Konverzní kódy

Tuhle funkci využijete pro odesílání informací o nákupech do analytických nástrojů jako jsou google analytics, google tag manager, facebook pixel aj.

Zpracování a odeslání dat z FAPI dělá jednoduchý script, který načte všechna data objednávky a ve zvoleném systému automaticky vytvoří konverzi.

Konverze si do analytických nástrojů můžete sestavit i sami a doplnit je o další informace, které vám pomohou k analýze vašich prodejů.

Také můžete odeslat konverze do nástrojů, pro které nemáme připravenou podporu. 


Nápověda platí jak pro vlastní děkovací stránky, tak pro FAPI děkovací stránky.

FAPI asistent

Chcete si nechat konverzní kódy nastavit? Využijte naši službu FAPI asistent.

Co je potřeba?

  1. Do vaší vlastní děkovací stránky je potřeba vložit kód, který načítá informace o objednávce.
  2. V úpravě prodejního formuláře (krok 5. děkovací stránka) je potřeba mít zaškrtnutý checkbox "Vkládat unikátní identifikátor objednávky do URL děkovací stránky.

  3. Váš web musí běžet na https, jinak se data objednávky nenačtou.
  4. Musíte mít na vašem webu inicializované analytické nástroje jako GTM, FB pixel, Google Analytics, jinak se data do těchto nástrojů nepošlou.
  5. Script a konverzní kódy vkládejte nejlépe do patičky vašeho webu.

Script, který je potřeba vložit na vaši vlastní děkovací stránku:

<script src="https://form.fapi.cz/js/sdk/fapi.js"></script>

POZOR: Kdykoliv je to možné, spouštějte analytické nástroje na stránce napřímo, a ne přes kontejnery a aplikace třetích stran. Typicky GTM se často inicializuje s velkým zpožděním, nebo vůbec. Konverze se pak nenačítají.

Skript se spojením s unikátním identifikátorem objednávky, zajišťuje stažení informací o objednávce z FAPI do vaší děkovací stránky. 

Díky tomu můžete konverze zaslat do jakéhokoliv analytického nástroje. 

Skript se nepoužívá pro FAPI děkovací stránky, ale pouze u vlastních děkovacích stránek.

Jak tyto funkce použít?

Ukázka zaslání dat do FB pixelu:
<script>
document.addEventListener('FapiSdkLoaded', function () {
	FAPI_CONVERSION.runConversion(function (fapiOrderData) {
		FAPI_CONVERSION.simpleFacebookPixelTransaction(fapiOrderData);
	});
});
</script>
<script src="https://form.fapi.cz/js/sdk/fapi.js"></script>
Ukázka zaslání dat do GA4:
<script>
document.addEventListener('FapiSdkLoaded', function () {
	FAPI_CONVERSION.runConversion(function (fapiOrderData) {
		FAPI_CONVERSION.simpleGA4Transaction(fapiOrderData);
	});
});
</script>
<script src="https://form.fapi.cz/js/sdk/fapi.js"></script>
Ukázka zaslání dat do GTM:
<script>
document.addEventListener('FapiSdkLoaded', function () {
	FAPI_CONVERSION.runConversion(function (fapiOrderData) {
		FAPI_CONVERSION.simpleGoogleTagManagerTransaction(fapiOrderData);
	});
});
</script>
<script src="https://form.fapi.cz/js/sdk/fapi.js"></script>
Ukázka zaslání dat do Google Analytics:
<script>
document.addEventListener('FapiSdkLoaded', function () {
	FAPI_CONVERSION.runConversion(function (fapiOrderData) {
		FAPI_CONVERSION.simpleGoogleAnalyticsEcommerceTransaction(fapiOrderData);
	});
});
</script>
<script src="https://form.fapi.cz/js/sdk/fapi.js"></script>
Ukázka zaslání dat do Google Ads:
<script>
document.addEventListener('FapiSdkLoaded', function () {
	FAPI_CONVERSION.runConversion(function (fapiOrderData) {
		FAPI_CONVERSION.simpleGoogleAdsTransaction(fapiOrderData, 'AW-***');
	});
});
</script>
script src="https://form.fapi.cz/js/sdk/fapi.js"></script>

Je potřeba správně nastavit kód kampaně "AW-***".

Ukázka zaslání konverzí do Affilboxu:
<script>
document.addEventListener('FapiSdkLoaded', function () {
	FAPI_CONVERSION.runConversion(function (fapiOrderData) {
		FAPI_CONVERSION.simpleAffilboxTransaction(fapiOrderData, 'demo.affilbox.cz', '1');
	});
});
</script>
<script src="https://form.fapi.cz/js/sdk/fapi.js"></script>
Ukázka zaslání dat do TikTok Pixel:
<script>
document.addEventListener('FapiSdkLoaded', function () {
	FAPI_CONVERSION.runConversion(function (fapiOrderData) {
		FAPI_CONVERSION.simpleTikTokPixelTransaction(fapiOrderData);
	});
});
</script>
<script src="https://form.fapi.cz/js/sdk/fapi.js"></script>
Ukázka zaslání dat do Pinterest :

Je potřeba si nejprve propojit pinterest s Google Tag Managerem

<script>
document.addEventListener('FapiSdkLoaded', function () {
	FAPI_CONVERSION.runConversion(function (fapiOrderData) {
		FAPI_CONVERSION.simplePinterestTransaction(fapiOrderData);
	});
});
</script>
<script src="https://form.fapi.cz/js/sdk/fapi.js"></script>
Ukázka zaslání konverzí do CJ:
<script>
document.addEventListener('FapiSdkLoaded', function () {
	FAPI_CONVERSION.runConversion(function (fapiOrderData) {
		FAPI_CONVERSION.simpleCJTransaction(fapiOrderData, 'enterpriceId', 'actionTrackerId', 'cjeventOrder');
	});
});
</script>
<script src="https://form.fapi.cz/js/sdk/fapi.js"></script>
Ukázka zaslání konverzí do Sklik:
<script>
document.addEventListener('FapiSdkLoaded', function () {
	FAPI_CONVERSION.runConversion(function (fapiOrderData) {
                var sklikId = 123456;/* vložte Váš identifikátor konverze Sklik*/
		FAPI_CONVERSION.simpleSklikTransaction(fapiOrderData, sklikId);
	});
});
</script>
<script src="https://form.fapi.cz/js/sdk/fapi.js"></script>
Pokud chcete odeslat konverze do více nástrojů, můžete tyto kódy zjednodušit takto:
<script>
document.addEventListener('FapiSdkLoaded', function () {
	FAPI_CONVERSION.runConversion(function (fapiOrderData) {   
		FAPI_CONVERSION.simpleFacebookPixelTransaction(fapiOrderData);
		FAPI_CONVERSION.simpleGoogleTagManagerTransaction(fapiOrderData);
		FAPI_CONVERSION.simpleGoogleAnalyticsEcommerceTransaction(fapiOrderData);
		FAPI_CONVERSION.simpleGA4Transaction(fapiOrderData);

	});
});
</script>
<script src="https://form.fapi.cz/js/sdk/fapi.js"></script>
Dále se dají použít funkce, které pošlou data do analytických nástrojů jen když jsou dané objednávky zaplacené:
<script>
document.addEventListener('FapiSdkLoaded', function () {
	FAPI_CONVERSION.runConversion(function (fapiOrderData) {
		FAPI_CONVERSION.simpleFacebookPixelTransactionOnlyPaid(fapiOrderData);
		FAPI_CONVERSION.simpleGoogleTagManagerTransactionOnlyPaid(fapiOrderData);
		FAPI_CONVERSION.simpleGoogleAnalyticsEcommerceTransactionOnlyPaid(fapiOrderData);
		FAPI_CONVERSION.simpleGA4TransactionOnlyPaid(fapiOrderData);
	});
});
</script>
<script src="https://form.fapi.cz/js/sdk/fapi.js"></script>
V případě, že potřebujete data odeslat do nějakého jiného nástroje, pro který funkci nemáme, můžete si data objednávky namapovat do analytického nástroje sami. 
Ukázka pro sKlik.cz:
<script>
document.addEventListener('FapiSdkLoaded', function () {
FAPI_CONVERSION.runConversion(function (fapiOrderData) {
	var conversionConf = {
                id: 123456, /* váš identifikátor konverze Sklik*/
		orderId: fapiOrderData['number'], /* číslo objednávky */
		value: fapiOrderData['total_amount'], /* hodnota objednávky v Kč bez DPH*/
		consent: 1 /* souhlas od návštěvníka na odeslání konverzního hitu, povolené hodnoty: 0 (není souhlas) nebo 1 (je souhlas) */
	};
	// Ujistěte se, že metoda existuje, předtím než ji zavoláte
	if (window.rc && window.rc.conversionHit) {
		window.rc.conversionHit(conversionConf);
	}
});
});
</script>
<script src="https://form.fapi.cz/js/sdk/fapi.js"></script>

Jaká data jsou dostupná v proměnné fapiOrderData? 

Dostupné parametry a jejich vysvětlivky jsme popsali v API dokumentaci: https://web.fapi.cz/api-doc/#api-OrderConversion.

Zde najdete všechny dostupné parametry, se kterými můžete pracovat, i s vysvětlivkami, jaké hodnoty obsahují.

Jak vložit konverzní kódy do děkovací stránky FAPI?

Do děkovací stránky FAPI nemusíte vkládat koncový script:

<script src="https://form.fapi.cz/js/sdk/fapi.js"></script>

Ten je již součástí děkovací stránky, konverze by se mohly duplicitně odesílat.

Konverzní kódy je potřeba uložit do prodejního formuláře, konkrétně krok číslo 5. děkovací stránka - políčko konverzní kódy.

Je zapotřebí do konverzního kódu (HTML) nejprve vložit pixely od nástrojů, kam chcete odesílat konverze. Ať už je to Facebook, Google analytics 4, Instagram atd. Je potřeba prvně nahrát jejich startovací kód. A pod tento startovací a inicializační kód můžete vložit konverzní kódy FAPI.

Předdefinované funkce

Tento script vytvoří objekt FAPI_CONVERSION, který má přístupné tyto funkce:

FAPI_CONVERSION.runConversion(onSuccess: callback)

Toto je výchozí funkce pro získání dat objednávky a spuštění konverzních kódů.

Dále při spuštění této funkce vloží informace o objednávce do Google Tag Manageru. Pomocí eventu "fapiOrderDataLoaded" a data objednávky jsou následně uložena pod klíčem "fapiOrderData". Dále se tedy s objednávkou dá pracovat přimo v GTM.

Po načtení dat objednávky tato funkce také vyvolá event "fapiOrderDataLoaded", kde v detailu eventu pod klíčem "fapiOrderData", jsou uložena data objednávky. Použití je možné pro vlastní zpracování konverzí.


FAPI_CONVERSION.simpleFacebookPixelTransaction(fapiOrderData: object)

Tato funkce vytvoří konverzi ve Facebook pixelu. Data nejsou odeslaná do FB Pixelu, pokud na stránce nemáte FB Pixel nainstalovaný.

FAPI_CONVERSION.simpleFacebookPixelTransactionOnlyPaid(fapiOrderData: object)

Tato funkce vytvoří konverzi ve Facebook pixelu, pouze pokud je objednávka zaplacená. Data nejsou odeslaná, pokud na stránce nemáte FB Pixel nainstalovaný.

FAPI_CONVERSION.simpleGA4Transaction(fapiOrderData: object)

Tato funkce vytvoří konverzi ve Facebook pixelu. Data nejsou odeslaná do FB Pixelu, pokud na stránce nemáte FB Pixel nainstalovaný.

FAPI_CONVERSION.simpleGA4TransactionOnlyPaid(fapiOrderData: object)

Tato funkce vytvoří konverzi ve Facebook pixelu, pouze pokud je objednávka zaplacená. Data nejsou odeslaná, pokud na stránce nemáte FB Pixel nainstalovaný.

FAPI_CONVERSION.simpleGoogleTagManagerTransaction(fapiOrderData: object)

Tato funkce vytvoří konverzi v Google Tag Manageru. Data nejsou odeslaná do GTM pokud na stránce nemáte GTM nainstalovaný.

FAPI_CONVERSION.simpleGoogleTagManagerTransactionOnlyPaid(fapiOrderData: object)

Tato funkce vytvoří konverzi ve Google Tag Manageru, pouze pokud je objednávka zaplacená.  Data nejsou odeslaná do GTM pokud na stránce nemáte GTM nainstalovaný.

FAPI_CONVERSION.simpleGoogleAnalyticsEcommerceTransactionTransaction(fapiOrderData: object)

Tato funkce vytvoří konverzi v Google Analytics. Data nejsou odeslaná do Google Analytics pokud na stránce nemáte Google Analytics nainstalovaný.

FAPI_CONVERSION.simpleGoogleAnalyticsEcommerceTransactionTransactionOnlyPaid(fapiOrderData: object)

Tato funkce vytvoří konverzi ve Google Analytics, pouze pokud je objednávka zaplacená. Data nejsou odeslaná do Google Analytics pokud na stránce nemáte Google Analytics nainstalovaný.

FAPI_CONVERSION.simpleAffilboxTransaction(fapiOrderData: object, url: string, campaignId: string|int)

Tato funkce vytvoří konverzi v Affilboxu

Tato funkce narozdíl od výše uvedených přijmá 2 argumenty. Url adresu a ID kampaně:

  • url - tuto url najdete v administraci Affilboxu - konverzní kódy a je to hodnota proměnné "ab_instance", která bude v podobném tvaru: "demo.affiliate.cz"
  • campaignId - ID kampaně najdete také v administraci Affilixu - konverzní kódy a je to hodnoha proměnné ab_kampan, kde hodnova je číslo kampaně, například: '1'

FAPI_CONVERSION.simpleAffilboxTransactionOnlyPaid(fapiOrderData: object, url: string, campaignId: string|int)

Tato funkce vytvoří konverzi v Affilboxu, pouze pokud je objednávka zaplacená. 

Tato funkce má stejné fungování jako "simpleAffilboxTransaction".

FAPI_CONVERSION.simpleCJTransaction(fapiOrderData: object, enterpriseId, actionTrackerId, cjeventOrder)

Tato funkce vytvoří konverzi na platforma https://www.cj.com/. Do této funkce je potřeba doplnit 3 parametry, enterpriseId, actionTrackerId a cjeventOrder.

FAPI_CONVERSION.simpleCJTransactionOnlyPaid(fapiOrderData: object, enterpriseId, actionTrackerId, cjeventOrder)

Tato funkce vytvoří konverzi na platforme CJ, pouze pokud je objednávka zaplacená. 

Tato funkce má stejné fungování jako "simpleCJTransaction".

FAPI_CONVERSION.simpleSklikTransaction(fapiOrderData: object)

Tato funkce vytvoří konverzi na platformě Sklik.

FAPI_CONVERSION.simpleSklikTransactionOnlyPaid(fapiOrderData: object)

Tato funkce vytvoří konverzi na platformě Sklik, pouze pokud je objednávka zaplacená. 

FAPI_CONVERSION.simpleGoogleAdsTransaction(fapiOrderData: object, ADId string)Tato funkce vytvoří konverzi v Google Ads. 

Tato funkce narozdíl od výše uvedených přijmá 1 argument.

ADId - ID kampaně, které začíná na AW-

FAPI_CONVERSION.simpleGoogleAdsTransactionOnlyPaid(fapiOrderData: object, ADId string)Tato funkce vytvoří konverzi v Google Ads. 

Tato funkce vytvoří konverzi na Google Ads, pouze pokud je objednávka zaplacená. 

Našli jste odpověď? Děkujeme za zpětnou vazbu. Vaši zpětnou vazbu se nepodařilo odeslat. Zkuste to prosím později.

Potřebujete pomoc? Kontaktujte nás Kontaktujte nás