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
{
	"ident": "<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

"ident": "<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
{
	"ident": "<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
{
	"ident": "<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.

Skrz.cz s.r.o. (2024) Všeobecné obchodní podmínky | Pravidla pro zveřejňování nabídek