Napojenie Sklik

Pre koho je Sklik#

Sklik je PPC platforma od Seznam.cz. Pokrýva Seznam.cz a Sklik partnerskú sieť. Tradičná voľba pre české a slovenské e-shopy.

Dve nezávislé napojenia#

V Margly môžete pripojiť dve samostatné časti Skliku:

1. Sklik (API Drak) — klasický reklamný účet (Search, Obsahová sieť, Retargeting). Pripojenie cez Sklik API token vygenerovaný v nastavení Sklik účtu.
2. Sklik Nákupy (Fénix API) — Shopping kampane na Seznam Zboží. Pripojenie cez samostatný Fénix API kľúč + ID prevádzkarne. Fénix API je v beta fáze — detailné produktové štatistiky budú plne dostupné po ukončení bety.

Obe napojenia sú nezávislé, môžete mať zapnuté len jedno z nich alebo obe.

Napojenie klasického Sklik účtu (API Drak)#

Sklik nepoužíva OAuth. Namiesto toho v Sklik administrácii vygenerujete API token pre Drak API (oficiálny názov Sklik API rozhrania) a vložíte ho do Margly.

1. 1

   Prihláste sa na sklik.cz

   Na www.sklik.cz sa prihláste e-mailom a heslom priamo ako používateľ, ktorý má prístup k vášmu reklamnému účtu. Pozor: „prevtelenie" do iného účtu (typické pre agentúry spravujúce viac klientov) nefunguje — Margly z technických dôvodov nemôže pracovať s agentnými (agency) tokenmi a vráti chybu. Prihláste sa preto rovno ako používateľ pod daný účet.

2. 2

   Vygenerujte API token

   Po prihlásení kliknite v Skliku na svoje meno vpravo hore → Nastavenia → API prístup. Uvidíte dve sekcie — pre toto napojenie vás zaujíma horná Prístup k API Drak. Vygenerujte tam nový API token a hneď ho skopírujte.

   

   Pozor: Sklik token zobrazí len raz. Pokiaľ ho stratíte, vygenerujete na rovnakom mieste nový.

3. 3

   Vložte token do Margly

   V Margly otvorte Napojenia → Sklik a vložte token do poľa API token. Kliknite na Pripojiť Sklik. Margly token okamžite otestuje cez Sklik API a načíta informácie o reklamnom účte.

4. 4

   Margly stiahne historické dáta

   Po úspešnom overení Margly stiahne posledných 365 dní (1 rok) historických denných štatistík a kampaňových dát. Pri bežných účtoch to trvá rádovo minúty.

Napojenie Sklik Nákupy (Fénix API)#

Pokiaľ bežia Shopping kampane na Seznam Zboží, môžete pripojiť aj Fénix API pre detailnejšie dáta o produktoch a kategóriách.

1. 1

   Vygenerujte Fénix API kľúč v Skliku

   V nastavení Skliku nájdite sekciu Správa API Fénix kľúčov a kliknite na Vygenerovať nový API kľúč. Skopírujte kľúč.

2. 2

   Nájdite ID prevádzkarne

   Fénix API potrebuje ID prevádzkarne — šesťmiestne číslo priradené vašej prevádzkarni s aktívnym typom kampane Kampaň Nákupy. Nájdete ho dvomi spôsobmi:

   • V Sklik administrácii na prehľade prevádzkarní (Sklik vám ho rovno ukáže pri každej prevádzkarni)
   • V administrácii zbozi.cz

   Fénix API nevie zoznam prevádzkarní enumerovať, takže ID musíte zadať ručne.

3. 3

   Vložte obidva do Margly

   V Margly v Napojenia → Sklik vyplňte sekciu Seznam Nákupy (Fénix API) — vložte Fénix kľúč a ID prevádzkarne, kliknite na Pripojiť. Margly kombináciu kľúč × ID prevádzkarne overí proti Sklik Fénix API.

Čo Margly zo Skliku reálne načíta#

Z klasického Sklik účtu (API Drak)#

Margly ukladá tri druhy dát:

1. Súhrnné denné štatistiky (za celý reklamný účet, denná granularita, okno celý sync rozsah):

   • Počet zobrazení (impresií), počet klikov, útrata, počet konverzií a ich hodnota
   • CTR (miera prokliku), priemerné CPC (cena za klik)
   • Dopočítaný ROAS (návratnosť reklamy)

2. Snapshot kampaní za posledných 30 dní (jeden riadok per kampaň):

   • ID kampane, názov, stav (aktívna / pozastavená)
   • Denný rozpočet
   • Súhrn za 30 dní: imprese, kliky, útrata, počet konverzií
   • (Tento snapshot neobsahuje hodnotu konverzií — pre detail pozri nasledujúci bod.)

3. Per-kampaň denné štatistiky (každá kampaň × každý deň, okno celý sync rozsah):

   • Imprese, kliky, útrata, počet konverzií a ich hodnota
   • Umožňujú v dashboarde filtrovať výkon kampane po dňoch

Plus aktuálny stav kreditu Sklik účtu.

Margly nenačíta detail kľúčových slov ani úroveň reklamnej zostavy (ad group) — pohľad je na úrovni kampane, nie reklamných zostav.

Zo Sklik Nákupy (Fénix)#

Margly ukladá:

1. Zoznam Nákupy kampaní (snapshot, jeden riadok per kampaň):

   • ID kampane, stav, ID prevádzkarne, typ riadenia ponúk (zbozi / feed / sklik), denný rozpočet, vyčerpaný diel rozpočtu dňa
   • (Fénix kampane nemajú na Sklik API vlastný názov — Margly preto zobrazí „Kampaň #ID".)

2. Per-produkt štatistiky za posledných 30 dní (každý produkt × každý deň):

   • ID a názov produktu, kategória
   • Rozpad na typ zariadenia (mobil / desktop / tablet) a typ webu (hlavné vyhľadávanie / partnerská sieť)
   • Imprese, kliky, útrata, konverzie, hodnota konverzií
   • Počet predaných kusov (items sold)
   • Priemerné CPC, CTR a PNO (podiel nákladov na obrate) per produkt

3. Per-kategória štatistiky za posledných 30 dní — súhrnné rovnaké metriky ako pri produktoch, len agregované po kategóriách.

4. Stav kreditu Fénix peňaženky.

DPH a mena#

Sklik (Seznam.cz, platca DPH) môže fakturovať reklamu aj slovenským firmám — fakturácia ale vyzerá rôzne podľa krajiny a stavu platcovstva DPH:

Čo s tým Margly robí:

• Ukladá útratu bez DPH tak, ako ju Sklik Drak API vráti
• Zároveň si dopočíta variantu s DPH podľa sadzby vašej krajiny podnikania (CZ ×1,21, SK ×1,23). Pri CZ tenantoch táto hodnota zodpovedá reálnej faktúre. Pri SK platcoch DPH slúži ako podklad pre samovymeranie — faktúra od Sklik je u nich bez DPH, ale účtovne si DPH dopočítate podľa slovenskej sadzby.
• V dashboarde potom zobrazí buď s DPH, alebo bez DPH, podľa vašej voľby v Fakturácia → Zobrazovať ceny s DPH

Mena: Sklik vracia útratu výhradne v CZK. Margly preto Sklik nepodporuje pre e-shopy v inej mene než CZK — connect Sklik v Margly odmietne (pozri callout vyššie). Slovenská firma s českým e-shopom v CZK ale Sklik napojiť môže, fakturácia potom prebehne v režime reverse charge podľa pravidiel vyššie.

Časté chyby#

• „Tento token nefunguje" — token bol zmazaný v Sklik nastavení alebo ste ho zle skopírovali (napr. s medzerou). Vygenerujte v Skliku nový.
• „Zadali ste agentný (agency) token" — vložili ste token agentúrneho účtu, ktorý spravuje viac inzerentských účtov. Margly taký token nedokáže rozdeliť na konkrétny účet — prihláste sa priamo ako používateľ inzerentského účtu a vygenerujte token tam.
• „Tento Sklik API token už používa iný účet v Margly" — rovnaký token nemožno priradiť dvom účtom v Margly. Najprv ho odpojte pri starom (Napojenia → Sklik → Odpojiť).
• „Sklik nevracia dáta" — Sklik napojenie prebehlo, ale účet vrátil prázdne dáta. Najčastejšie preto, že na účte reálne nebežia žiadne kampane, alebo token patrí účtu bez aktívnej reklamy. Skontrolujte priamo v Skliku, že kampane existujú a bežia.
• Fénix „Zadané ID obchodu k tomuto Fénix tokenu nepatrí" — kombinácia Fénix tokenu a ID prevádzkarne nesedí. Token patrí inému používateľovi alebo ID prevádzkarne je z iného obchodu — overte si ID na prehľade prevádzkarní v Sklik administrácii alebo v administrácii zbozi.cz.

Čo ďalej#

• Napojenie Heureka — ďalší český porovnávač tovaru, tiež cez API kľúč
• AI Poradca — porovnáva výnosnosť Skliku s Google Ads a Meta v analýze reklamy