Napojení Sklik

Pro koho je Sklik#

Sklik je PPC platforma od Seznam.cz. Pokrývá Seznam.cz a Sklik partnerskou síť. Tradiční volba pro české a slovenské e-shopy.

Dvě nezávislá napojení#

V Margly můžete připojit dvě samostatné části Skliku:

1. Sklik (API Drak) — klasický reklamní účet (Search, Obsahová síť, Retargeting). Připojení přes Sklik API token vygenerovaný v nastavení Sklik účtu.
2. Sklik Nákupy (Fénix API) — Shopping kampaně na Seznam Zboží. Připojení přes samostatný Fénix API klíč + ID provozovny. Fénix API je v beta fázi — detailní produktové statistiky budou plně dostupné po ukončení beta.

Obě napojení jsou nezávislá, můžete mít zapnuté jen jedno z nich nebo obě.

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

Sklik nepoužívá OAuth. Místo toho v Sklik administraci vygenerujete API token pro Drak API (oficiální název Sklik API rozhraní) a vložíte ho do Margly.

1. 1

   Přihlaste se na sklik.cz

   Na www.sklik.cz se přihlaste e-mailem a heslem přímo jako uživatel, který má přístup k vašemu reklamnímu účtu. Pozor: „převtělení" do jiného účtu (typické pro agentury spravující více klientů) nefunguje — Margly z technických důvodů nemůže pracovat s agentními (agency) tokeny a vrátí chybu. Přihlaste se proto rovnou jako uživatel pod daný účet.

2. 2

   Vygenerujte API token

   Po přihlášení klikněte v Skliku na své jméno vpravo nahoře → Nastavení → API přístup. Uvidíte dvě sekce — pro toto napojení vás zajímá horní Přístup k API Drak. Vygenerujte tam nový API token a hned ho zkopírujte.

   

   Pozor: Sklik token zobrazí jen jednou. Pokud ho ztratíte, vygenerujete na stejném místě nový.

3. 3

   Vložte token do Margly

   V Margly otevřete Napojení → Sklik a vložte token do pole API token. Klikněte na Připojit Sklik. Margly token okamžitě otestuje přes Sklik API a načte informace o reklamním účtu.

4. 4

   Margly stáhne historická data

   Po úspěšném ověření Margly stáhne posledních 365 dní (1 rok) historických denních statistik a kampaňových dat. U běžných účtů to trvá řádově minuty.

Napojení Sklik Nákupy (Fénix API)#

Pokud běží Shopping kampaně na Seznam Zboží, můžete připojit i Fénix API pro detailnější data o produktech a kategoriích.

1. 1

   Vygenerujte Fénix API klíč ve Skliku

   V nastavení Skliku najděte sekci Správa API Fénix klíčů a klikněte na Vygenerovat nový API klíč. Zkopírujte klíč.

2. 2

   Najděte ID provozovny

   Fénix API potřebuje ID provozovny — šestimístné číslo přiřazené vaší provozovně s aktivním typem kampaně Kampaň Nákupy. Najdete ho dvěma způsoby:

   • V Sklik administraci na přehledu provozoven (Sklik vám ho rovnou ukáže u každé provozovny)
   • V administraci zbozi.cz

   Fénix API neumí seznam provozoven enumerovat, takže ID musíte zadat ručně.

3. 3

   Vložte obojí do Margly

   V Margly v Napojení → Sklik vyplňte sekci Seznam Nákupy (Fénix API) — vložte Fénix klíč a ID provozovny, klikněte na Připojit. Margly kombinaci klíč × ID provozovny ověří proti Sklik Fénix API.

Co Margly ze Skliku reálně načítá#

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

Margly ukládá tři druhy dat:

1. Souhrnné denní statistiky (za celý reklamní účet, denní granularita, okno celé sync rozpětí):

   • Počet zobrazení (impresí), počet kliků, útrata, počet konverzí a jejich hodnota
   • CTR (míra prokliku), průměrné CPC (cena za klik)
   • Dopočítaný ROAS (návratnost reklamy)

2. Snapshot kampaní za posledních 30 dní (jeden řádek per kampaň):

   • ID kampaně, název, stav (aktivní / pozastavená)
   • Denní rozpočet
   • Souhrn za 30 dní: imprese, kliky, útrata, počet konverzí
   • (Tento snapshot neobsahuje hodnotu konverzí — pro detail viz následující bod.)

3. Per-kampaň denní statistiky (každá kampaň × každý den, okno celé sync rozpětí):

   • Imprese, kliky, útrata, počet konverzí a jejich hodnota
   • Umožňují v dashboardu filtrovat výkon kampaně po dnech

Plus aktuální stav kreditu Sklik účtu.

Margly nenačítá detail klíčových slov ani úroveň reklamní sestavy (ad group) — pohled je na úrovni kampaně, ne reklamních sestav.

Ze Sklik Nákupy (Fénix)#

Margly ukládá:

1. Seznam Nákupy kampaní (snapshot, jeden řádek per kampaň):

   • ID kampaně, stav, ID provozovny, typ řízení nabídek (zbozi / feed / sklik), denní rozpočet, vyčerpaný díl rozpočtu dne
   • (Fénix kampaně nemají na Sklik API vlastní název — Margly proto zobrazí „Kampaň #ID".)

2. Per-produkt statistiky za posledních 30 dní (každý produkt × každý den):

   • ID a název produktu, kategorie
   • Rozpad na typ zařízení (mobil / desktop / tablet) a typ webu (hlavní vyhledávání / partnerská síť)
   • Imprese, kliky, útrata, konverze, hodnota konverzí
   • Počet prodaných kusů (items sold)
   • Průměrné CPC, CTR a PNO (podíl nákladů na obratu) per produkt

3. Per-kategorie statistiky za posledních 30 dní — souhrnné stejné metriky jako u produktů, jen agregované po kategoriích.

4. Stav kreditu Fénix peněženky.

DPH a měna#

Sklik (Seznam.cz, plátce DPH) může fakturovat reklamu i slovenským firmám — fakturace ale vypadá různě podle země a stavu plátcovství DPH:

Co s tím Margly dělá:

• Ukládá útratu bez DPH tak, jak ji Sklik Drak API vrátí
• Zároveň si dopočítá variantu s DPH podle sazby vaší země podnikání (CZ ×1,21, SK ×1,23). U CZ tenantů tahle hodnota odpovídá reálné faktuře. U SK plátců DPH slouží jako podklad pro samovyměření — faktura od Sklik je u nich bez DPH, ale účetně si DPH dopočtete podle slovenské sazby.
• V dashboardu pak zobrazí buď s DPH, nebo bez DPH, podle vaší volby v Fakturace → Zobrazovat ceny s DPH

Měna: Sklik vrací útratu výhradně v CZK. Margly proto Sklik nepodporuje pro e-shopy v jiné měně než CZK — connect Sklik v Margly odmítne (viz callout výše). Slovenská firma s českým e-shopem v CZK ale Sklik napojit může, fakturace pak proběhne v režimu reverse charge dle pravidel výše.

Časté chyby#

• „Tento token nefunguje" — token byl smazaný v Sklik nastavení nebo jste ho špatně zkopírovali (např. s mezerou). Vygenerujte v Skliku nový.
• „Zadali jste agentní (agency) token" — vložili jste token agenturního účtu, který spravuje víc inzerentních účtů. Margly takový token nedokáže rozdělit na konkrétní účet — přihlaste se přímo jako uživatel inzerentního účtu a vygenerujte token tam.
• „Tento Sklik API token už používá jiný účet v Margly" — stejný token nelze přiřadit dvěma účtům v Margly. Nejdřív ho odpojte u starého (Napojení → Sklik → Odpojit).
• „Sklik nevrací data" — Sklik napojení proběhlo, ale účet vrátil prázdná data. Nejčastěji proto, že na účtu reálně neběží žádné kampaně, nebo token patří účtu bez aktivní reklamy. Zkontrolujte přímo v Skliku, že kampaně existují a běží.
• Fénix „Zadané ID obchodu k tomuto Fénix tokenu nepatří" — kombinace Fénix tokenu a ID provozovny nesedí. Token patří jinému uživateli nebo ID provozovny je z jiného obchodu — ověřte si ID na přehledu provozoven v Sklik administraci nebo v administraci zbozi.cz.

Co dál#

• Napojení Heureka — další český srovnávač zboží, taky přes API klíč
• AI Poradce — porovnává výnosnost Skliku s Google Ads a Meta v analýze reklamy