Co je konverzní kód?

Konverzní kód v inzertním systému Můj.Skrz.cz funguje podobně jako např. konverzní kódy v Google Ads a Sklik - na stránce, kde je jisté, že zákazník dokončil objednávku (bez ohledu na její zdroj), provoláme server to server konverzi, který odešle informace o uskutečněné objednávce (vaše ID položek, jejich počet, cenu) do rozhraní Muj.Skrz.cz.

Díky tomu na Muj.Skrz.cz uvidíte přesně, které nabídky zákazníky zajímají, a přinesly Vám objednávky (obrat).

Systém Skrzu také bere v potaz, které nabídky pro vás mají nejvyšší prospěch, které vám přivedou nejvíce platících zákazníků. Takové nabídky samozřejmě bude zobrazovat více. A naopak, nabídky, které přínos nemají, upozadí, aby nevytvářely zbytečné náklady. Tato výhoda by bez konverzního kódu nefungovala.

Ukázka košíku

Zápis konverzního kódu hodně odpovídá tomu, jak vypadá klasický košík při nákupu na internetu. Zápis by měl reflektovat položky v košíku, co položka (další osoba, dítě, doprava, příplatek) to řádek. Řekněme, že zákazník koupil pobyt pro 2 dospělé a 1 dítě s dopravou. Košík bude vypadat následovně.

ID položky/objednávky	Název položky	Cena za položku	Počet položek	Celková cena
POBYT-0125-DOSPELY	Týdenní pobyt v Chorvatsku s all inclusive	2800 Kč	1 osoba	2800 Kč
POBYT-0125-DOSPELY	Týdenní pobyt v Chorvatsku s all inclusive	2800 Kč	1 osoba	2800 Kč
POBYT-0126-DITE	Týdenní pobyt v Chorvatsku varianta pro dítě	2000 Kč	1 osoba	2000 Kč
DOPRAVA-0128	Týdenní pobyt v Chorvatsku - doprava autobusem	1500 Kč		1500 Kč
OBJ-23412	Celkem			9100 Kč

Zákazník s takovým košíkem dokončí objednávku. Řekněme, že objednávka dostala ID OBJ-23412. Na stránku dokončení objednávky ("thank you page") je třeba udělat POST request na náš server:

POST https://hit.skrz.cz/cv/collect
{
	"server": "<IDENTIFIKÁTOR SERVERU>",
        "cookie": "<HODNOTA skrzcc3 cookie>",
	"items" : [
		{"itemId":"POBYT-0125-DOSPELY","unitPrice": "2800.00","quantity":"1","totalPrice":"2800.00"},
		{"itemId":"POBYT-0125-DOSPELY","unitPrice": "2800.00","quantity":"1","totalPrice":"2800.00"},
		{"itemId":"POBYT-0126-DITE","unitPrice":"2000.00","quantity": "1","totalPrice":"2000.00"},
		{"itemId":"DOPRAVA-0128","unitPrice":"1500.00","quantity": "1","totalPrice":"1500.00"}
	]
	"transactionId": "OBJ-23412",
	"isPaid": "1",
	"grandTotal": "9100.00",
	"currency": "CZK",
}

V Příkladu chybí položky jako "startDate/endDate", či "termID", které upřesňují termín rezervace, o těch si povíme v posledních dvou bodech!

Proberme si jednotlivé části kódu.

Identifikace

"server": "<IDENTIFIKÁTOR SERVERU>",
"cookie": "<HODNOTA skrzcc3 cookie>",

Property server nastavuje váš identifikátor. Řetězec <IDENTIFIKÁTOR SERVERU> nahraďte vaším reálným identifikátorem. Ten najdete v menu v sekci Nastavení > Nastavení analytiky.

Váš identifikátor uvidíte vpravo v boxu Nastavení analytiky.

Property cookie je obsah cookie skrzcc3 založený při příchodu na web

Přidávání položek

{"itemId":"POBYT-0125-DOSPELY","unitPrice": "2800.00","quantity":"1","totalPrice":"2800.00"},

Property items obsahuje pole položek objednávky. Jako argument bere JSON objekt s následujícími klíči:

Klíč	Příklad hodnoty	Popis
itemId	POBYT-0125-DOSPELY	ID položky. Musí se shodovat s ID položky, které posíláte v XML feedu (jinak nedokážeme napárovat správně položky objednávek na položky z XML feedů a nebudou sedět statistiky po položkách). ID položky může být libovolný řetězec z písmen, čísel, pomlček apod. Vždy dávejte kolem ID položky uvozovky ("). Předejdete tak problémům s funkčností.
unitPrice	2800.00	Cena za kus.
quantity	1	Každou osobu oddělte zvlášť jako samostatnou položku.
totalPrice	2800.00	Celková cena položky objednávky. Mělo by platit, že unitPrice * quantity == totalPrice.

Všechny hodnoty (i číselné) doporučujeme vždy dávat do uvozovek. Předejdete tak problémům s nefunkčností konverzního kódu.

{"itemId":"POBYT-0126-DITE","unitPrice": "2000.00","quantity":"1","totalPrice":"2000.00"},

Každou položku uvádějte zvlášť. Položek můžete přidat kolik chcete. Jedna položka by se měla rovnat jedné osobě. Tzn. pokud je pobyt zakoupen pro 2 dospělé osoby a 1 dítě, tak kód bude obsahovat položky minimálně 3. Různé doplatky prosím také uvádějte jako samostatnou položku

{"itemId":"POZNAVACI-ZAJEZD-VARSAVA","unitPrice": "490.00","quantity":"1","totalPrice":"490.00"},

Přes položky v items je třeba přidat všechny položky objednávky, které tvoří kompletní částku objednávky, aby grandTotal reflektoval konečnou cenu, kterou zákazník zaplatí.

Patička objednávky

{  
    ...
	"transactionId": "OBJ-23412",
	"isPaid": "1",
	"grandTotal": "9100.00",
	"currency": "CZK"
}

Patička se skládá z následujících klíčů:

Klíč	Příklad hodnoty	Popis
transactionId	OBJ-23412	ID objednávky. Může být libovolný řetězec z písmen, čísel, pomlček apod. Vždy dávejte kolem ID objednávky uvozovky ("). Předejdete tak problémům s funkčností.
isPaid	1, nebo 0	Určuje jestli byla objednávka zaplacena - např. při platbě kartou online. 1 znamená, že byla zaplacena. 0 znamená, že zaplacena nebyla. 1 použijte tehdy, když je již jisté, že byla objednávka zaplacena. Bude to tehdy, když zákazník použil nějakou online platební metodu (kreditní/debitní kartou online, Paypal, Paysec, PayU apod.).
grandTotal	7649.00	Celkový součet objednávky. Mělo by platit, že součet všech totalPrice z addItem volání dá dohromady grandTotal. Tato hodnota slouží hlavně k ověření, že je kód implementován správně.
currency	CZK	Třípísmený ISO kód měny, ve které jsou všechny ceny uvedené v objednávky. Pro Českou korunu použijte CZK.

Rezervace s termínem

V případě, že zákazník kupuje nabídku na konkrétní termín pomocí online rezervace na Vašich stránkách, rozšiřte kód následovně.

POST https://hit.skrz.cz/cv/collect
{
	"server": "<IDENTIFIKÁTOR SERVERU>",
        "cookie": "<HODNOTA skrzcc3 cookie>",
	"items" : [
		{"itemId":"CV5090","unitPrice":"639","quantity":"1","totalPrice":"639", "isReserved": "1", "startDate": "2017-07-01", "endDate": "2017-07-10"},
		{"itemId":"CV5091","unitPrice":"639","quantity":"1","totalPrice":"639", "isReserved": "1", "startDate": "2017-07-14", "endDate": "2017-07-20"}
	]
	"transactionId": "OBJ-23412",
	"isPaid": "1",
	"grandTotal": "9100.00",
	"currency": "CZK",
}

Hlavičku, identifikaci serveru, přidávání položek a odeslání objednávky jsme si již vysvětlili, pojďme se zaměřit na úpravy, které v kódu proběhly.

{"itemId":"CV5090","unitPrice":"639","quantity":"1","totalPrice":"639", "isReserved": "1", "startDate": "2017-07-01", "endDate": "2017-07-10"}

Item rozšíříme o následující:

Klíč	Příklad hodnoty	Popis
isReserved	1	Určuje jestli byla objednávka zakoupena na konkrétní termín. 1 znamená, že byla zakoupena na konkrétní termín. V případě, že nebyla, tyto 3 klíče vynechejte.
startDate	2017-07-01	Určuje datum příjezdu, na který byla objednávka zakoupena.
endDate	2017-07-10	Určuje datum odjezdu, na který byla objednávka zakoupena.

Může se stát, že v objednávce máte více objednávek, ale pouze jedna z nich bude zakoupena na konkrétní termín. Tyto 3 klíče tedy samozřejmě přidejte jen k té dané konverzi, která byla zakoupena s online rezervací

(například kdyby položka CV5091 z objednávky 9915663502 nebyla koupena s online rezervací, klíče isReserved, startDate a endDate vynechejte a u nás se správně připíší pouze ke konverzi CV5090).

Přidání term_id (sdovolená feed)

V případě, že používáte sdovolená feed, připojte ke konverzi také term_id z Vašeho feedu přes parametr termId. Slouží pro rozpoznání konkrétního termínu. Kód rozšiřte následovně.

POST https://hit.skrz.cz/cv/collect
{
	"server": "<IDENTIFIKÁTOR SERVERU>",
        "cookie": "<HODNOTA skrzcc3 cookie>",
	"items" : [
		{"itemId":"CV5090","termId":"5248955","unitPrice":"639","quantity":"1","totalPrice":"639"},
                {"itemId":"CV5091","termId":"5842687","unitPrice":"639","quantity":"1","totalPrice":"639"}
	]
	"transactionId": "9915663502",
	"isPaid": "1",
	"grandTotal": "639",
	"currency": "CZK",
}

Klíč	Příklad hodnoty	Popis
termId	5423364	Označuje konkrétní termín, který se prodal. Použijte term_id z Vašeho sdovolená XML feedu.