Co je rozšíření Symlink Stork?#

Symlink Stork je rozšíření, které slouží k bezpečnému sdílení a správě přístupu k datovým feedům. Funguje jako prostředník, který pro původní existující URL adresu souboru vytvoří jednu nebo více nových unikátních adres, tzv. symlinků. Vytvořené symlinky pak můžete sdílet se svými partnery a kontrolovat, kdo k nim má přístup.

Hlavním účelem je mít pod kontrolou, kdo k datům přistupuje, a mít možnost konkrétnímu subjektu přístup kdykoliv zneplatnit, aniž by to ovlivnilo ostatní subjekty, které potřebují mít přístup ke stejným datům.

Rozšíření podporuje běžné datové soubory jako XML, CSV nebo ZIP. Není primárně určena pro HTML stránky, u kterých by se mohly špatně načítat CSS styly a grafika.

Rozšíření je ideální pro:

  • Velkoobchody, které poskytují produktová data mnoha maloobchodníkům.
  • Affiliate marketing, kde hrozí zneužití feedů konkurencí nebo bývalými partnery.
  • Marketingové specialisty, kteří spravují napojení e-shopů na různé reklamní a externí systémy.

Cena a fakturace#

Cena rozšíření je:

  • 286 Kč za měsíc při měsíční fakturaci,
  • 228,80 Kč za měsíc při roční fakturaci.

Cena je stanovena pro jeden e-shop (v Mergadu) a je fixní, bez ohledu na počet vytvořených symlinků v rámci daného e-shopu.

Vzhledem k technické návaznosti je rozšíření fakturováno v souladu se zvolenou frekvencí fakturace v Mergado Editoru. Pro jednotlivé služby nelze zvolit různé frekvence fakturace.

Rozšíření Symlink Stork má 30denní zkušební dobu zdarma.

Symlink Stork je možné používat i bez placeného projektu v Mergadu. Je však nutné vytvořit si v Mergadu účet pro autorizaci uživatelů a fakturaci a e-shop pro správu přístupů uživatelů. Obojí lze v Mergadu vytvořit zdarma i bez placeného projektu.

  • Symlink – Nová, unikátní a těžko odhadnutelná URL adresa vytvořená pro soubor na původní adrese.
  • Persona – Pojmenovaná identita „návštěvníka“ (systému nebo uživatele) symlinku, kterou rozšíření rozpozná na základě IP adresy a User Agenta.
  • User Agent – Označení softwaru, který přistupuje k odkazu (např. konkrétní prohlížeč nebo bot).
  • Účet v Mergado Editoru a v něm vytvořený e-shop.
  • Existující datový soubor dostupný na veřejné URL adrese (např. výstupní feed z Mergada, ale může jít i o soubor z jakéhokoliv jiného systému).

Technické informace#

Symlink Stork stahuje data z původní URL na svých serverech a výsledek předává na symlink. Pokud máte původní soubor chráněný whitelistem IP adres, je nutné na whitelist přidat IP adresu 178.238.44.138, ze které Symlink Stork k souboru přistupuje.

Při stahování se rozšíření identifikuje User Agentem SymlinkStorkBot/1.0 (+https://store.mergado.com/detail/symlinkstork/). Tento řetězec uvidíte v serverových lozích původního souboru. Nejde tedy o cizí přístup, ale o samotné rozšíření, které data načítá a předává na vytvořený symlink.

Hlavní funkce#

1. Vytváření symlinků#

Symlink Stork umožňuje vytvářet pro jednu původní URL neomezené množství nových, unikátních adres, tzv. symlinků. Každý váš partner (např. maloobchodník, affiliate síť nebo reklamní platforma) tak od vás může dostat svou vlastní, unikátní adresu. Z této adresy bude stahovat stejná data jako z původního zdroje, ale nedozví se skutečnou (původní) adresu. To chrání vaše interní data před odhalením a zneužitím.

2. Správa symlinků#

Správa symlinků vám dává plnou kontrolu nad distribucí dat, kterou běžné e-shopové systémy neumožňují.

  • Smazání nebo dočasná deaktivace symlinku – Pokud například s partnerem ukončíte spolupráci, můžete jeho konkrétní symlink smazat nebo dočasně deaktivovat, aniž by to ovlivnilo další partnery, kteří mají své vlastní symlinky.

  • Pokročilé řízení přístupu u každého symlinku – Přímo v detailu každého symlinku určujete jeho bezpečnostní režim. Můžete nastavit, že k datům z konkrétního odkazu bude mít přístup pouze schválená osoba/osoby (persona), nebo naopak zakázat přístup konkrétním nežádoucím personám. Přístup lze navíc zabezpečit heslem, které musí stahující systém zadat.

3. Změna zdroje bez změny symlinku#

U vytvořeného symlinku můžete kdykoliv změnit původní zdrojovou adresu, zatímco partnerovi zůstane stále stejný funkční symlink.

Příklad využití: Máte vytvořený symlink pro partnera. Rozhodnete se mu začít posílat jiný sortiment nebo data z jiného systému. U tohoto symlinku vyměníte původní adresu za novou, ale partnerovi zůstane stále stejný funkční odkaz. Nemusí tedy u sebe nic přenastavovat.

4. Identifikace přístupů pomocí person#

Možnost identifikovat a pojmenovat si konkrétní partnery, roboty (např. Googlebot) nebo přístupy z vlastní kanceláře. Identifikace probíhá na základě IP adresy a User Agenta.

5. Sledování historie stahování dat#

Symlink Stork automaticky zaznamenává historii všech přístupů k vašim unikátním odkazům, což vám poskytuje okamžitý přehled o tom, kdo, kdy a jak často vaše data stahoval. U každého záznamu uvidíte také informaci o tom, zda byl přístup povolen nebo systémem zablokován.

Tato funkce slouží jako zásadní analytický a diagnostický nástroj, díky kterému můžete například odhalit technické chyby na straně partnerů (nedaří se jim stahovat vaše data) nebo identifikovat a následně zakázat přístup podezřelým systémům (systému vytvoříte personu a zakáže jí přístup).

V affiliate marketingu poskytují reklamní sítě URL adresu vašeho datového feedu svým publisherům. Hlavním rizikem je fakt, že publisherem se může stát prakticky kdokoliv, včetně vašeho přímého konkurenta.

Pokud inzerent poskytne přímý odkaz na svůj feed (např. ve tvaru mujshop.cz/heureka.xml), vystavuje se těmto hrozbám:

  • Nekontrolovaný data mining – Konkurent si může adresu feedu poznačit a vaše data (cenotvorbu, sortiment, parametry) stahovat a analyzovat i poté, co feed z katalogu affiliate sítě odstraníte.
  • Snadné zneužití dat – Data z feedu se zpracovávají mnohem jednodušeji než automatizované procházení (crawlování) webových stránek.
  • Nemožnost selektivního zablokování – Bez symlinku nemůžete ukončit přístup jednomu konkrétnímu partnerovi, aniž byste změnili adresu pro všechny ostatní.

Symlink Stork tento problém řeší tím, že pro každou affiliate síť nebo partnera vytvoříte unikátní symlink. Pokud spolupráci ukončíte nebo zjistíte zneužití dat, konkrétní odkaz jednoduše smažete a přístup je okamžitě a trvale zrušen, zatímco ostatní partneři mohou data nadále stahovat.

Aktivaci rozšíření provede v Mergado Storu: Chci aktivovat → vyberte e-shop, pro který chcete rozšíření zapnout → Zapnout.

V rozhraní rozšíření Symlink Stork uvidíte v menu tři hlavní sekce: Odkazy, Historie, Persony.

Odkazy#

Sekce Odkazy je hlavní pracovní plochou rozšíření Symlink Stork, kde probíhá veškerá správa distribuce vašich dat. V této části vidíte seznam všech vytvořených aktivních i neaktivních symlinků. U každého odkazu jsou zobrazeny tyto informace:

  • Název – Vaše interní pojmenování pro snadnou orientaci.
  • Původní adresa – URL zdrojového souboru, ze kterého se čerpají data.
  • Nová adresa – Vygenerovaný symlink, který poskytujete partnerům.
  • Stav přístupu – Ikona informující o aktuálním nastavení přístupu. Zelený puntík pro volný přístup („všichni kromě“) nebo zámek pro omezení na konkrétní persony („nikdo kromě“).
  • Poslední návštěva – Datum a čas, kdy byl symlink naposledy použit ke stažení dat.

Přímo z tohoto seznamu můžete s odkazy provádět další akce pomocí ikon:

  • Editace (ikona tužky) – Umožňuje měnit nastavení přístupu, název nebo zdrojovou URL.
  • Deaktivace/Aktivace – Odkaz můžete dočasně vypnout, aniž byste ho museli mazat.
  • Duplikace – Užitečné pro rychlé vytvoření více podobných symlinků se stejným zdrojem, ale jiným nastavením person.
  • Smazání – Trvalé odstranění odkazu. Po smazání přestane URL adresa partnerovi okamžitě fungovat. Tento krok je nevratný.
  1. V záložce Odkazy klikněte na tlačítko Vytvořit nový odkaz.
  2. Zadejte Název – Pojmenujte odkaz tak, abyste ihned měli přehled, komu je určen (např. „XML feed pro partnera ABC“).
  3. Vložte Původní adresu – Do kolonky zkopírujte URL adresu zdrojového souboru (např. adresu výstupního feedu z vašeho projektu v Mergadu, ale i z jakéhokoliv jiného systému).
  4. Definujte Novou adresu – Určete koncovou část odkazu. Pro zajištění maximální bezpečnosti a neuhodnutelnosti adresy doporučujeme vytvořit vlastní systém pojmenování, například kombinaci názvu partnera a náhodného „tajného“ klíče (např. /partner_xy-f5t8z2). Konkrétní podoba je na vás, využít můžete také znak tečky.
  5. Přidejte Poznámku (volitelné) – Můžete doplnit doplňující informace pro vlastní potřebu.
  6. Nastavte omezení přístupu – V pravé části formuláře zvolte jeden ze dvou režimů zabezpečení pomocí Person:
    a. Přístup na symlink mají všichni kromě uvedených person – Funguje jako blacklist, kdy zakážete přístup konkrétním personám, které vybere a zakliknete v poli níže.
    b. Přístup nemá nikdo kromě uvedených person – Funguje jako whitelist, kdy povolíte přístup pouze konkrétním personám, které vybere a zakliknete v poli níže.
  7. Zabezpečení heslem (volitelné) – Přístup k datům můžete navíc podmínit zadáním hesla v poli Omezit přístup heslem.
  8. Kliknutím na tlačítko Uložit odkaz se symlink aktivuje a je připraven k odeslání partnerovi.

Po uložení se nový symlink objeví v seznamu, odkud si můžete jeho novou URL adresu zkopírovat. Jakmile partner na tento odkaz poprvé přistoupí, uvidíte tento záznam v sekci Historie.

Historie#

Sekce Historie v rozšíření Symlink Stork slouží k detailnímu sledování všech přístupů k vytvořeným symlinkům. Funguje jako zásadní analytický a diagnostický nástroj, který vám dává přehled o tom, co se s vašimi sdílenými daty děje.

U každého pokusu o přístup k unikátnímu odkazu Symlink Stork zaznamenává tyto klíčové údaje:

  • Kdo – Zobrazuje IP adresu a User Agenta (označení softwaru nebo prohlížeče) návštěvníka. Pokud je vybraná IP adresa nebo User Agent již přiřazen ke konkrétní personě, uvidíte v přehledu její název.
  • Kdy – Datum a přesný čas stažení dat nebo pokusu o jejich stažení.
  • Stav přístupu – Symlink Stork rozlišuje mezi povoleným a zamítnutým přístupem k odkazu. Zablokované pokusy o stažení jsou označeny červeným puntíkem, úspěšná stažení jsou označena zeleným puntíkem.

Pro lepší přehlednost, zejména pokud spravujete velké množství odkazů, umožňuje rozšíření v historii filtrovat záznamy pro jeden konkrétní symlink.

Praktické využití Historie v reálných situacích

Informace z historie můžete využít například pro:

  • Řešení technických sporů a problémů – Pokud partner (např. maloobchodník) tvrdí, že nemá aktuální produktová data, můžete v historii snadno ověřit, kdy si jeho systém soubor naposledy skutečně stáhl. Pokud v historii uvidíte, že poslední stažení proběhlo například před měsícem, je jasné, že chyba je v automatizaci na straně partnera.
  • Ochrana dat – Historie vám umožňuje odhalit podezřelé systémy nebo neznámé IP adresy, které k vašim feedům přistupují. Následně pro tyto systémy jednoduše vytvoříte persony a zakážete jim přístup.
  • Analytika stahování – Umožňuje sledovat, jak často a v jakých časech jsou vaše data stahována.

Vytvoření persony přímo z Historie

Pokud v seznamu uvidíte nepojmenovaný přístup, který chcete identifikovat, stačí u daného řádku kliknout na ikonu tužky (editace). Rozšíření vám umožní z tohoto konkrétního „otisku“ (IP adresy a User Agenta) rovnou vytvořit a pojmenovat novou personu.

Pokud konkrétní symlink sami otevřete v prohlížeči, svůj vlastní „otisk“ v historii uvidíte také.

⚠️ Historie je vázána na aktivní stav rozšíření. Pokud Symlink Stork vypnete, dojde k okamžitému a nevratnému smazání celé historie i všech vytvořených symlinků.

Persony#

Sekce Persony v rozšíření Symlink Stork slouží k identifikaci a pojmenování konkrétních uživatelů nebo automatizovaných systémů (botů), které přistupují k vašim datům (symlinkům). Díky personám můžete anonymní přístupy z historie přeměnit na srozumitelný přehled konkrétních subjektů, jako jsou obchodní partneři, roboti nebo vaši zaměstnanci. Následně můžete vybraným personám povolit nebo zakázat přístup k vytvořeným symlinkům.

Co jsou Persony?#

Persona je uživatelem definovaná identita, která představuje buď software ovládaný člověkem (např. internetový prohlížeč), nebo systém běžící samostatně na serveru (např. e-shopový systém partnera, skladové hospodářství nebo boti jako Googlebot). Přiřazením konkrétního jména získáte lepší kontrolu nad zabezpečením a analytikou svých dat.

Jak personu vytvořit?

Existují dva způsoby, jak novou personu do systému přidat:

  • Na záložce Persony kliknutím na tlačítko Vytvořit personu a vyplněním identifikačních údajů.
  • Na záložce Historie kliknutím na ikonu tužky u konkrétního řádku v historii přístupů. Rozšíření v tomto případě automaticky předvyplní zjištěnou IP adresu a User Agenta, vy pouze doplníte název.

Parametry identifikace persony

Pro správné rozpoznání persony využívá Symlink Stork dva technické parametry:

  • IP adresa – Rozšíření podporuje standard IPv4. Identifikace podle IP je spolehlivá u subjektů s pevnou (statickou) adresou, jako jsou firemní sítě nebo datacentra.
  • User Agent – Textový řetězec, kterým se software při komunikaci sám identifikuje (např. označení konkrétního bota nebo prohlížeče).

Při nastavování můžete uvést pouze jeden z údajů, nebo oba současně. Pokud vyplníte oba parametry, musí být pro úspěšné rozpoznání persony splněny obě podmínky naráz. Rozšíření vyžaduje přesnou shodu, nepodporuje zadávání rozsahů IP adres ani vyhledávání částí textu v User Agentovi.

Prioritizace přiřazení přístupů k personám

Pokud by jeden přístup odpovídal nastavení více person najednou, Symlink Stork je identifikuje podle této priority:

  1. Shoduje se IP adresa i User Agent.
  2. Shoduje se pouze IP adresa.
  3. Shoduje se pouze User Agent.

Využití person v praxi

Vytvořené persony jsou nezbytným předpokladem pro pokročilé funkce rozšíření:

  • Řízení přístupu (Whitelist/Blacklist) – U každého odkazu můžete nastavit, zda k němu mají přístup všechny persony kromě vybraných (např. blokování konkrétních botů), nebo zda k němu nemá přístup nikdo kromě vybraných schválených person,.
  • Interní analytika – Pojmenováním persony „Kancelář“ nebo „Domov“ odlišíte vlastní testovací přístupy od stahování dat partnery.
  • Identifikace botů – Pomocí User Agenta můžete rozpoznat a pojmenovat automatizované systémy (např. Googlebot, Seznambot) a sledovat jejich aktivitu.
  • Diagnostika pro partnery – Pokud má partner problém s neaktuálností dat, můžete v historii pod jeho jménem (personou) snadno ověřit, kdy naposledy data skutečně stáhl.

Tip: Pokud potřebujete zjistit svou vlastní IP adresu pro vytvoření persony, stačí navštívit váš symlink v prohlížeči a následně v sekci Historie uvidíte svůj aktuální „otisk“, který můžete jedním kliknutím převést na personu.

FAQ#

Symlink Stork je rozšíření Mergado Editoru, které vám umožní bezpečně sdílet datové feedy s obchodními partnery. Místo toho, abyste partnerům dávali přímý odkaz na váš soubor, vytvoříte pro každého z nich unikátní adresu (symlink). Partneři stahují stejná data, která jsou na původní adrese, ale vy máte možnost přístup konkrétnímu partnerovi kdykoliv zrušit, aniž by to ovlivnilo ostatní.

Při běžném sdílení přímého odkazu nemáte žádnou kontrolu nad tím, kdo a jak dlouho k vašim datům přistupuje. Adresu feedu si může kdokoliv uložit a stahovat data i poté, co spolupráci ukončíte. Symlink Stork tento problém řeší. Každý partner má vlastní adresu, kterou můžete kdykoliv deaktivovat nebo smazat, a původní adresa vašeho souboru zůstane skrytá.

Ne. Symlink Stork lze používat i bez placeného projektu v Mergadu. Stačí mít bezplatný Mergado účet a v něm vytvořený e-shop, což slouží pro správu přístupů a fakturaci.

Ne. Rozšíření funguje s jakýmkoliv souborem dostupným na veřejné URL adrese, bez ohledu na to, odkud soubor pochází. Může jít o výstupní feed z Mergada, ale i o soubor z vašeho e-shopového systému, skladového hospodářství nebo jiného zdroje.

Rozšíření podporuje běžné datové formáty – XML, CSV, ZIP a obecně jakýkoliv soubor s vlastní URL adresou. Není ale primárně určeno pro HTML stránky, u kterých by se mohly špatně načítat CSS styly nebo grafika.

Cena je 286 Kč za měsíc při měsíční fakturaci, nebo 228,80 Kč za měsíc při fakturaci roční. Cena je fixní pro jeden e-shop v Mergadu, bez ohledu na počet vytvořených symlinků.

Ano. Rozšíření má 30denní zkušební dobu zdarma, během které máte přístup ke všem funkcím. Pokud rozšíření v této době vypnete, nic neplatíte.

Kolik symlinků mohu pro jeden soubor vytvořit?#

Neomezený počet. Z jedné původní URL můžete vytvořit libovolné množství unikátních symlinků – každý pro jiného partnera nebo účel.

Dozví se partner, jaká je původní adresa mého souboru?#

Ne. Partnerovi předáte pouze symlink. Data stahuje přes server Symlink Stork, který původní adresu skrývá. Partner ji ze symlinku nezjistí.

Ano. U každého symlinku lze kdykoliv změnit název, poznámku, nastavení přístupu nebo původní zdrojovou URL adresu.

Mohu změnit zdrojový soubor, aniž bych musel partnerovi posílat novou adresu?#

Ano. U existujícího symlinku stačí v editaci vyměnit původní adresu za novou. Partnerovi zůstane jeho symlink funkční.

Jak rychle se projeví smazání nebo deaktivace symlinku?#

Okamžitě. Jakmile symlink smažete nebo deaktivujete, přestane URL adresa partnerovi fungovat bez jakéhokoliv zpoždění.

Jaký je rozdíl mezi smazáním a deaktivací symlinku?#

Deaktivace je dočasná – symlink i jeho nastavení zůstane uloženo a kdykoliv ho lze znovu zapnout. Smazání je nevratné – symlink i jeho adresa zaniknou trvale. Pokud si nejste jistí, zda budete symlink znovu potřebovat, volte deaktivaci.

Co je persona?#

Persona je vámi pojmenovaná identita přistupujícího systému nebo uživatele. Rozšíření ji rozpozná podle IP adresy, User Agenta, nebo obou parametrů naráz. Díky personám vidíte v historii přístupů srozumitelná jména (např. „Partner ABC“, „Kancelář“) místo anonymních IP adres a jednotlivým personám můžete následně povolit nebo zakázat přístup k vybraným symlinkům.

Identifikace probíhá na základě IP adresy a/nebo User Agenta. Vyžadována je vždy přesná shoda – rozšíření nepodporuje rozsahy IP adres ani částečné shody v textu User Agenta. Pokud jeden přístup odpovídá více personám, platí tato priorita: nejprve shoda IP i User Agenta, poté shoda pouze IP, nakonec shoda pouze User Agenta.

Ano. U každého symlinku lze přístup omezit pomocí person. Nejprve si partnera jako personu pojmenujete a definujete jeho IP adresu nebo User Agenta. Pak u symlinku nastavíte režim „přístup nemá nikdo kromě uvedených person“ a vyberete právě jeho personu. Od té chvíle data úspěšně stáhne pouze tento partner. Ostatní přístupy budou blokovány. Jako alternativu lze nastavit i opačný režim „přístup mají všichni kromě konkrétních vybraných person“, což se hodí například pro blokování nechtěných botů nebo bývalých partnerů.

Mohu personám přiřadit pouze IP adresu bez User Agenta?#

Ano. Při vytváření persony stačí vyplnit jen jeden z parametrů. Pokud vyplníte pouze IP adresu, persona pokryje všechny přístupy z tohoto umístění bez ohledu na to, jaký software přistupuje.

Co všechno zjistím z historie?#

U každého přístupu k symlinku Symlink Stork zaznamenává IP adresu a User Agenta přistupujícího systému, datum a čas přístupu a výsledek, tedy zda byl přístup povolen (zelený puntík), nebo zablokován (červený puntík). Pokud je přistupující systém přiřazen k personě, zobrazí se místo anonymních údajů její název.

Partner říká, že nemá aktuální data. Jak to ověřím?#

V sekci Historie si vyfiltrujte záznamy pro symlink daného partnera. Uvidíte přesné datum a čas posledního stažení. Pokud je poslední úspěšný přístup starý několik dní nebo týdnů, problém bude pravděpodobně na straně automatizace partnera, nikoliv v samotném symlinku.

Rozšíření přistupuje k původní URL z IP adresy 178.238.44.138. Pokud máte původní soubor chráněný whitelistem IP adres, je nutné tuto adresu na whitelist přidat, jinak Symlink Stork data nenačte.

Při stahování dat z původní URL se rozšíření identifikuje User Agentem SymlinkStorkBot/1.0 (+https://store.mergado.com/detail/symlinkstork/). Pokud tento řetězec uvidíte v lozích svého serveru, jde o standardní chování rozšíření, nikoliv o cizí přístup.

Dojde k okamžitému a nevratnému smazání všech vytvořených symlinků i celé historie. Partnerům přestanou jejich adresy fungovat okamžitě. Při opětovném zapnutí bude rozšíření prázdné a vše je nutné nastavit znovu.

Byl tento článek užitečný?
Backward Symlink Stork Mergado Agencies Forward