Konverzní kódy

Konverzní kódy slouží k odesílání informací o objednávkách z FAPI do analytických a reklamních nástrojů, například do Google Analytics, Google Tag Manageru, Meta Pixelu, Google Ads, Skliku nebo dalších systémů.

FAPI umí načíst data objednávky a pomocí jednoduchého skriptu je předat do zvoleného nástroje jako konverzi.

Konverzní kódy můžete využít například pro:

• měření objednávek,
• vyhodnocení kampaní,
• předávání hodnoty objednávky do reklamních systémů,
• vlastní analytiku,
• odesílání dat do nástrojů, pro které FAPI nemá připravenou hotovou integraci.

Jak správně nastavit konverzní kódy pro Facebook i jiné nástroje

Zde máte celý videonávod:

Jak konverzní kódy fungují

Aby se konverze správně odeslala, je potřeba rozlišit tři části:

• měřicí nástroj – například Meta Pixel, Google Analytics, Google Tag Manager nebo jiný nástroj,
• FAPI konverzní kód – odešle data objednávky do vybraného nástroje,
• FAPI SDK script – načte data objednávky z FAPI, používá se pouze u vlastní děkovací stránky.

FAPI konverzní kód nenahrazuje samotný měřicí nástroj. Pokud například na stránce nemáte načtený Meta Pixel, funkce pro odeslání konverze do Meta Pixelu nemá kam data odeslat.

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

Pokud používáte současně Meta Pixel a CAPI, věnujte pozornost části Meta Pixel a Facebook Conversion API níže.

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

Doporučení k měřicím nástrojům

Kdykoliv je to možné, spouštějte analytické nástroje na stránce napřímo, ne pouze přes kontejnery nebo aplikace třetích stran.

Typicky Google Tag Manager se může inicializovat se zpožděním nebo se nemusí načíst vůbec. V takovém případě se konverze nemusí správně odeslat.

Pozor na duplicitní měření konverzí

Konverzní kód se obvykle spouští při načtení děkovací stránky.

Pokud se stejná konverzní událost odešle více způsoby nebo vícekrát, může analytický nebo reklamní nástroj započítat jednu objednávku opakovaně.

K duplicitám může dojít například když:

• máte stejný konverzní event vložený přímo na děkovací stránce,
• stejnou událost odesíláte přes FAPI konverzní kód i přes vlastní kód,
• konverze se posílá současně přes Google Tag Manager i přímo vloženým kódem,
• používáte Meta Pixel i Facebook Conversion API bez správné deduplikace,
• zákazník znovu načte nebo obnoví děkovací stránku.

Pokud v reklamním nebo analytickém nástroji vidíte více konverzí, než kolik reálně vzniklo objednávek ve FAPI, zkontrolujte, zda se stejná událost neposílá vícekrát.

Meta Pixel a Facebook Conversion API

Pokud používáte současně Meta Pixel a Facebook Conversion API, je potřeba správně řešit deduplikaci.

Meta deduplikuje události podle společného Event ID. Ve FAPI/CAPI se jako Event ID používá variabilní symbol objednávky.

Aby deduplikace fungovala správně, musí do Mety odejít jak serverová část přes CAPI, tak browser část z webu nebo děkovací stránky.

Pokud deduplikace nefunguje správně, může Meta jednu objednávku započítat vícekrát.

Měřit všechny objednávky, nebo jen zaplacené

Ve FAPI můžete použít dva typy funkcí:

• funkce bez OnlyPaid   odešlou konverzi po vytvoření objednávky,
• funkce s OnlyPaid   odešlou konverzi pouze tehdy, pokud je objednávka zaplacená.

Příklad funkce pro odeslání objednávky bez ohledu na stav platby:

FAPI_CONVERSION.simpleFacebookPixelTransaction(fapiOrderData);

Příklad funkce pro odeslání pouze zaplacené objednávky:

FAPI_CONVERSION.simpleFacebookPixelTransactionOnlyPaid(fapiOrderData);

Před nastavením si proto ujasněte, zda chcete v daném nástroji měřit všechny vytvořené objednávky, nebo pouze zaplacené objednávky.

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>

Ukázka zaslání dat do GA4:

<script>
document.addEventListener('FapiSdkLoaded', function () {
	FAPI_CONVERSION.runConversion(function (fapiOrderData) {
		FAPI_CONVERSION.simpleGA4Transaction(fapiOrderData);
	});
});
</script>

Ukázka zaslání dat do Google Tag Manageru (GTM):

<script>
document.addEventListener('FapiSdkLoaded', function () {
	FAPI_CONVERSION.runConversion(function (fapiOrderData) {
		FAPI_CONVERSION.simpleGoogleTagManagerTransaction(fapiOrderData);
	});
});
</script>

Ukázka zaslání dat do Google Analytics:

<script>
document.addEventListener('FapiSdkLoaded', function () {
	FAPI_CONVERSION.runConversion(function (fapiOrderData) {
		FAPI_CONVERSION.simpleGoogleAnalyticsEcommerceTransaction(fapiOrderData);
	});
});
</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>

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>

Ukázka zaslání dat do TikTok Pixel:

<script>
document.addEventListener('FapiSdkLoaded', function () {
	FAPI_CONVERSION.runConversion(function (fapiOrderData) {
		FAPI_CONVERSION.simpleTikTokPixelTransaction(fapiOrderData);
	});
});
</script>

Ukázka zaslání dat do Pinterestu:

Pro odeslání dat do Pinterestu je potřeba nejprve propojit Pinterest s Google Tag Managerem.

<script>
document.addEventListener('FapiSdkLoaded', function () {
	FAPI_CONVERSION.runConversion(function (fapiOrderData) {
		FAPI_CONVERSION.simplePinterestTransaction(fapiOrderData);
	});
});
</script>

Ukázka zaslání konverzí do CJ:

<script>
document.addEventListener('FapiSdkLoaded', function () {
	FAPI_CONVERSION.runConversion(function (fapiOrderData) {
		FAPI_CONVERSION.simpleCJTransaction(fapiOrderData, 'enterpriseId', 'actionTrackerId', 'cjeventOrder');
	});
});
</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*/
var zboziId = 123456;/* Id provozovny zbozi.cz*/
		FAPI_CONVERSION.simpleSklikTransaction(fapiOrderData, sklikId, zboziId);
	});
});
</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>

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>

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>

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.

V dokumentaci najdete všechny dostupné parametry a vysvětlení, jaké hodnoty obsahují.

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

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

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římo 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 odešle konverzi do Google Analytics 4 pouze v případě, že je objednávka zaplacená. Data se neodešlou, pokud na stránce nemáte Google Analytics 4 správně nastavené.

FAPI_CONVERSION.simpleGA4TransactionOnlyPaid(fapiOrderData: object)

Tato funkce odešle konverzi do Google Analytics 4. Data se neodešlou, pokud na stránce nemáte Google Analytics 4 správně nastavené.

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.simpleGoogleAnalyticsEcommerceTransaction(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.simpleGoogleAnalyticsEcommerceTransactionOnlyPaid(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 Affilboxu - konverzní kódy a je to hodnota proměnné ab_kampan, kde hodnota 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 platformě 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 platformě 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 odešle konverzi do Google Ads pouze v případě, že je objednávka zaplacená.

Když data v analytickém nástroji nesedí

Po vložení konverzních kódů doporučujeme vytvořit testovací objednávku a ověřit v daném analytickém nebo reklamním nástroji, že se konverze odeslala pouze jednou.

Pokud v analytickém nebo reklamním nástroji vidíte jiné počty konverzí než ve FAPI, zkontrolujte hlavně:

• zda se konverzní kód nespouští vícekrát,
• zda není stejný event vložený na více místech,
• zda se konverze neposílá současně přes FAPI, vlastní kód a Google Tag Manager,
• zda se event znovu neodešle při obnovení děkovací stránky,
• zda máte správně načtený Meta Pixel, Google Analytics nebo jiný měřicí nástroj,
• zda u kombinace Meta Pixelu a Facebook Conversion API funguje deduplikace,
• zda používáte správnou funkci podle toho, jestli chcete měřit všechny objednávky, nebo jen zaplacené objednávky.

Shrnutí

Konverzní kódy ve FAPI umožňují odesílat data objednávek do analytických a reklamních nástrojů.

Při nastavení si vždy ověřte:

• zda používáte FAPI děkovací stránku, nebo vlastní děkovací stránku,
• zda máte správně načtené měřicí nástroje,
• zda neposíláte stejnou konverzi vícekrát,
• zda chcete měřit všechny objednávky, nebo pouze zaplacené,
• zda máte při použití Meta Pixelu a CAPI správně nastavenou deduplikaci.

Správné nastavení konverzních kódů pomůže tomu, aby data v reklamních a analytických nástrojích odpovídala skutečným objednávkám ve FAPI.