Dokumentace - zástupci pro konverzní kódy

Základní informace ke konverzním kódům najdete v nápovědě Konverzní kódy

Dynamičtí zástupci

Dokumentace nových dynamických zástupců pro konverzní kódy. Všichni dynamičtí zástupci jsou globální javascriptové proměnné. Lze tedy využít jakékoliv funkce z javascriptu.

Objekt upgates je javascriptový objekt, který je globálně dostupný a vytváří se v hlavičce stránky. Je tedy možné k němu přistoupit z jakéhokoliv javascriptu. Ať je vložený do vlastních konverzních kódů, nebo do editoru kódu.

Při vložení tracking kódů, které se skládají z pixelové a javascriptové části, je potřeba kód vypsat přes funkci document.write. Např:

<script>
    document.write('<img id="abc" src="https://URL.adresa&orderId=' + upgates.order.number + '&orderAmount=' + upgates.order.prices.items.withVat + '" width="1" height="1" />');
</script>

Pro zjištění aktuálních údajů obsažených v objektu upgates lze použít funkci console.log(upgates);.

Dynamičtí zástupci stránky

  • upgates.language - Jazyk aktuální stránky.
  • upgates.currency - Měna aktuální stránky.
  • upgates.pageType - Typ aktuální stránky. Možné hodnoty:
    • advisor.detail
    • advisor.list
    • article
    • category
    • compare
    • customer.communication
    • customer.favourites
    • customer.orders
    • customer.orders.detail
    • customer.login
    • customer.password
    • customer.profile
    • customer.rating
    • customer.review
    • customer.registration
    • customer.watchdog
    • homepage
    • manufacturer
    • news.detail
    • news.list
    • newsletter
    • order.cart
    • order.checkout
    • order.recieved
    • order.shipment
    • order.summary
    • page
    • product
    • search
    • sitemap

Dynamičtí zástupci produktu

  • upgates.product - Informace o produktu. Dostupné pouze na stránce detailu produktu. Jinde je null.
    • upgates.product.id - ID produktu.
    • upgates.product.code - Kód produktu.
    • upgates.product.title - Název produktu.
    • upgates.product.manufacturer - Výrobce produktu.
    • upgates.product.price.withVat - Cena (s DPH).
    • upgates.product.price.withoutVat - Cena (bez DPH).
    • upgates.product.price.vat - DPH (hodnota).
    • upgates.product.price.vatRate - DPH (hodnota v procentech).
    • upgates.product.options[] - Pole variant produktu.
      • upgates.product.options[].id - ID varianty.
      • upgates.product.options[].code - Kód varianty.
      • upgates.product.options[].price - Informace o ceně varianty (výchozí nebo podle aktuálně přihlášeného zákazníka).
        • upgates.product.options[].price.withVat - Cena (s DPH).
        • upgates.product.options[].price.withoutVat - Cena (bez DPH).
        • upgates.product.options[].price.vat - DPH (hodnota).
        • upgates.product.options[].price.vatRate - DPH (procenta).

Dynamičtí zástupci kategorie

  • upgates.category - Informace o kategorii. Dostupné pouze na hlavní stránce a v detailu kategorie. Jinde je null.
    • upgates.category.id - ID kategorie.
    • upgates.category.code - Kód kategorie.
    • upgates.category.title - Název kategorie.
    • upgates.category.path[] - Pole s jednotlivými prvky cesty ke kategorii. Např. produkt zanořený do kategorií Hodinky / Pánské / Kovové bude obsahovat pole se 3 prvky. Každý prvek je název jedné z těchto kategorií.

Dynamičtí zástupci objednávky

  • upgates.order - Informace o objednávce. Dostupné pouze na stránce dokončení objednávky. Jinde je null.
    • upgates.order.number - Číslo objednávky.
    • upgates.order.id - ID objednávky.
    • upgates.order.currency - Měna objednávky.
    • upgates.order.paid - Příznak zda už je objednávka zaplacena (true|false).
    • upgates.order.customer.email - Email zákazníka z objednávky.
    • upgates.order.payment.name - Název platby z objednávky.
    • upgates.order.payment.price.withVat - Cena platby z objednávky (s DPH).
    • upgates.order.payment.price.withoutVat - Cena platby z objednávky (bez DPH).
    • upgates.order.payment.price.vat - DPH platby z objednávky (hodnota).
    • upgates.order.payment.price.vatRate - DPH platby z objednávky (procenta).
    • upgates.order.shipment.name - Název dopravy z objednávky.
    • upgates.order.shipment.price.withVat - Cena dopravy z objednávky (s DPH).
    • upgates.order.shipment.price.withoutVat - Cena dopravy z objednávky (s DPH).
    • upgates.order.shipment.price.vat - DPH dopravy z objednávky (hodnota).
    • upgates.order.shipment.price.vatRate - DPH dopravy z objednávky (procenta).
    • upgates.order.prices.products - Součet cen produktů objednávky.
      • upgates.order.prices.products.withVat - S DPH.
      • upgates.order.prices.products.withoutVat - Bez DPH.
      • upgates.order.prices.products.vat - DPH.
    • upgates.order.prices.items - Součet cen produktů a slev objednávky.
      • upgates.order.prices.items.withVat - S DPH.
      • upgates.order.prices.items.withoutVat - Bez DPH.
      • upgates.order.prices.items.vat - DPH.
    • upgates.order.prices.total - Součet cen produktu, slev, ceny dopravy, ceny platby (výsledná cena).
      • upgates.order.prices.total.withVat - S DPH.
      • upgates.order.prices.total.withoutVat - Bez DPH.
      • upgates.order.prices.total.vat - DPH.
    • upgates.order.discounts.voucher.code - Kód slevového kupónu.
      • upgates.order.discounts.voucher.prices[] - Hodnota slevového kupónu se rozpočítává mezi všechna DPH v objednávce. Proto je to pole. Možné hodnoty:
        • upgates.order.discounts.voucher.prices[].withVat
        • upgates.order.discounts.voucher.prices[].withoutVat
        • upgates.order.discounts.voucher.prices[].vat
        • upgates.order.discounts.voucher.prices[].vatRate
    • Pole s objednanými produkty:
      • upgates.order.products[].id - ID objednaného produktu.
      • upgates.order.products[].code - Kód objednaného produktu|varianty.
      • upgates.order.products[].title - Název objednaného produktu|varianty.
      • upgates.order.products[].quantity - Počet jednotek objednaného produktu|varianty.
      • upgates.order.products[].category - Informace o kategorii objednaného produktu|varianty.
        • upgates.order.products[].category.id - ID kategorie objednaného produktu|varianty.
        • upgates.order.products[].category.code - Kód kategorie objednaného produktu|varianty.
        • upgates.order.products[].category.title - Název kategorie objednaného produktu|varianty.
        • upgates.order.products[].category.path[] - Pole s jednotlivými prvky cesty ke kategorii objednaného produktu|varianty. Např. produkt zanořený do kategorií Hodinky / Pánské / Kovové bude obsahovat pole se 3 prvky. Každý prvek je název jedné z těchto kategorií.
      • upgates.order.products[].price - Informace o ceně objednaného produktu|varianty.
      • upgates.order.products[].price.withVat - Cena objednaného produktu|varianty (s DPH).
      • upgates.order.products[].price.withoutVat - Cena objednaného produktu|varianty (bez DPH).
      • upgates.order.products[].price.vat - DPH objednaného produktu|varianty (hodnota).
      • upgates.order.products[].price.vatRate - DPH objednaného produktu|varianty (procenta).
      • upgates.order.products[].option - Informace o variantě objednaného produktu (pokud byla objednána varianta).
        • upgates.order.products[].option.id - ID varianty objednaného produktu.

Dynamičtí zástupci zákazníka

  • upgates.customer - Informace o přihlášeném zákazníkovi. Dostupné pouze pokud je zákazník přihlášený. Jinak je hodnota null.
    • upgates.customer.email - Email přihlášeného zákazníka.

Dynamičtí zástupci košíku

  • upgates.cart - Informace o košíku.
    • upgates.cart.products[].id - ID produktu v košíku.
    • upgates.cart.products[].option - Informace o variantě objednaného produktu (pokud byla objednána varianta).
      • upgates.cart.products[].option.id - ID varianty objednaného produktu.
    • upgates.cart.products[].code - Kód objednaného produktu|varianty.
    • upgates.cart.products[].title - Název objednaného produktu|varianty.
    • upgates.cart.products[].quantity - Počet jednotek objednaného produktu|varianty.
    • upgates.cart.products[].price - Informace o ceně objednaného produktu|varianty.
      • upgates.cart.products[].price.withVat - Cena objednaného produktu|varianty (s DPH).
      • upgates.cart.products[].price.withoutVat - Cena objednaného produktu|varianty (bez DPH).
      • upgates.cart.products[].price.vat - DPH objednaného produktu|varianty (hodnota).
      • upgates.cart.products[].price.vatRate - DPH objednaného produktu|varianty (procenta).

Dynamičtí zástupci vyhledávání

  • upgates.search - Informace o vyhledávání. Dostupné pouze pokud je stránka vyhledávání. Jinak je hodnota null.
    • upgates.search.phrase - Vyhledaná fráze.

Dynamičtí zástupci události

  • page.view - Zavolá se při zobrazení každé stránky. V kombinaci s upgates.pageType možno určovat specifické možnosti.
upgates.on('page.view', function() {

});

upgates.on('page.view', function() {
    if (upgates.pageType === 'order.cart') {
        /* ViewCart */
    }
});

upgates.on('page.view', function() {
    if (upgates.pageType === 'product') {
        /* ViewContent */
    }
});

upgates.on('page.view', function() {
    if (upgates.pageType === 'search') {
        /* Search */
        alert(upgates.search.phrase);
    }
});
  • cart.add - Zavolá se při přidání produktu do košíku (informace o přidaném produktu se pošlou do funkce jako parametr).
upgates.on('cart.add', function(product) {
    product.id - ID produktu přidaného do košíku.
    product.code - Kód produktu|varianty přidaného do košíku.
    product.title - Název produktu|varianty přidaného do košíku.
    product.quantity - Počet jednotek přidaného produktu|varianty.
    product.price - Informace o ceně přidaného produktu|varianty.
        product.price.withVat - Cena přidaného produktu|varianty (s DPH).
        product.price.withoutVat - Cena přidaného produktu|varianty (bez DPH).
        product.price.vat - DPH přidaného produktu|varianty (hodnota).
        product.price.vatRate - DPH přidaného produktu|varianty (procenta).
    product.option - Informace o variantě přidaného produktu (pokud byla přidána varianta).
        product.option.id - ID varianty přidaného produktu.
});
  • cart.remove - Zavolá se při odebrání produktu z košíku (informace o oderaném produktu se pošlou do funkce jako parametr).
upgates.on('cart.remove', function(product) {
    product.id - ID produktu přidaného do košíku.
    product.code - Kód produktu|varianty přidaného do košíku.
    product.title - Název produktu|varianty přidaného do košíku.
    product.quantity - Počet jednotek přidaného produktu|varianty.
    product.price - Informace o ceně přidaného produktu|varianty.
        product.price.withVat - Cena přidaného produktu|varianty (s DPH).
        product.price.withoutVat - Cena přidaného produktu|varianty (bez DPH).
        product.price.vat - DPH přidaného produktu|varianty (hodnota).
        product.price.vatRate - DPH přidaného produktu|varianty (procenta).
    product.option - Informace o variantě přidaného produktu (pokud byla přidána varianta).
        product.option.id - ID varianty přidaného produktu.
});
  • login - Zavolá se po přihlášení.
upgates.on('login', function() {

});
  • signup - Zavolá se po registraci.
upgates.on('signup', function() {

});
  • subscribe - Zavolá se po přihlášení do newsletteru.
upgates.on('subscribe', function() {

});

Nahrazení původních dynamických zástupců

Ve stávajících konverzních kódech je potřeba všechny staré dynamické zástupce {$...} nahradit novými dynamickými zástupci pro javascript. Viz následující ukázka.

  • Zápis využívající staré dynamické zástupce:
'amount':{$order_total_without_shipment_payment_vat},
'orderNum':{$order_number},
'promoCode': {$voucher_code}
  • Zápis využívající nové dynamické zástupce:
'amount': upgates.order.prices.items.withoutVat,
'orderNum': upgates.order.number,
'promoCode': upgates.order.discounts.voucher.code

Seznam původních dynamických zástupců

  • {$customer_invoice_city} - Město ve fakturační adrese zákazníka.
  • {$customer_invoice_country} - Země ve fakturační adrese zákazníka (např. Česká republika).
  • {$customer_invoice_state} - Stát nebo kraj ve fakturační adrese zákazníka (např. Alabama).
  • {$customer_email} - Emailová adresa zákazníka.
  • {$homepage_link} - URL adresa projektu ve tvaru http://www.domena.cz
  • {$order_currency} - Měna v objednávce.
  • {$order_number} - Číslo objednávky.
  • {$paid_yn} - Zaplaceno
  • {$order_total} - Celková hodnota objednávky v dané měně (včetně DPH, ceny za způsob platby a způsob dopravy).
  • {$order_total_currency} - Celková hodnota objednávky (včetně DPH, ceny za způsob platby a dopravy) zformátovaná podle nastavení měny.
  • {$order_total_vat} - Hodnota DPH (pouze produkty, bez hodnoty DPH dopravy a platby).
  • {$order_total_vat_currency} - Hodnota DPH (pouze produkty, bez hodnoty DPH dopravy a platby) zformátovaná podle nastavení měny.
  • {$order_total_without_shipment_payment_vat} - Celková hodnota objednávky (bez DPH, bez ceny za způsob platby a dopravy).
  • {$order_total_without_shipment_payment_vat_currency} - Celková hodnota objednávky (bez DPH, bez ceny za způsob platby a dopravy) zformátovaná podle nastavení měny.
  • {payment_name} - Název platby
  • {$payment_price} - Cena způsobu platby s DPH.
  • {$payment_price_currency} - Cena způsobu platby s DPH zformátovaná podle nastavení měny.
  • {$shipment_name} - Název dopravy
  • {$shipment_price} - Cena způsobu dopravy s DPH
  • {$shipment_price_currency} - Cena způsobu dopravy s DPH zformátovaná podle nastavení měny.
  • {$shipment_payment_price} - Cena způsobu dopravy s DPH + cena způsobu platby s DPH.
  • {$shipment_payment_price_currency} - Cena způsobu dopravy s DPH + cena způsobu platby s DPH, zformátovano podle nastavení měny.
  • {$voucher_code} - voucher_code-desc

Cyklus v rámci každé položky objednávky

{foreach $products as $product}
  • {$product->category_title} - Název hlavní kategorie, do které je produkt zařazen.
  • {$product->code} - Kód produktu
  • {$product->price} - Cena produktu.
  • {$product->priceWithoutVat} - product->priceWithoutVat-desc
  • {$product->product_id} - ID produktu (systémové číslo)
  • {$product->quantity} - Počet objednaných kusů daného produktu.
  • {$product->title} - Název produktu
{/foreach}

Dynamický remarketing

  • {!$dyn_rem_pid} - ID produktu, ID produktů v košíku
  • {$dyn_rem_page_type} - Typ stránky
  • {!$dyn_rem_pvalue} - Cena produktu
  • {!$dyn_rem_total_value} - Celková cena produktů v košíku
  • {$dyn_rem_category} - Název kategorie
  • {$dyn_rem_pbrand} - Výrobce produktu
  • {$dyn_rem_pname} - Název produktu
Na této stránce
Zpět

Další zdroje informací

Facebook poradna

Výměna zkušeností, rady a tipy mezi provozovateli e-shopů na systému UPgates.

Přejít do poradny

Akademie

Získejte znalosti od našich specialistů na marketing, obchod, právo a podnikání.

Přejít do akademie

Novinky z Blogu

Co nového jsme pro vás připravili nebo chystáme najdete na blogu.

Přejít do blogu

Nepodařilo se Vám najít tu správnou odpověď?

Kontaktujte naši technickou podporu, která je tu pro vás od pondělí do pátku 8:00 až 16:00 hod.

Zákaznická podpora