Nahrávač čte ze souboru dva sloupce: adresu a požadovaný alias. Všechno ostatní — skupinu, značky, UTM parametry — nastavíte jednou pro celou dávku ve formuláři, ne po řádcích.

To je hlavní věc, kterou je dobré vědět, než soubor začnete skládat. Vyplývá z ní formát, limity i polovina důvodů, proč pak řádky odpadají.

Dále: jak postavit soubor, který projde celý; co dělat, když odkazy potřebují různé parametry; kolik řádků odejde na jeden zátah; a jak číst výsledek, když se část odkazů nevytvoří.

Jaký soubor nahrávač přijme

Stačí CSV nebo obyčejný textový soubor. Rozbor je snášenlivý a několik detailů vám ušetří zbytečné přehazování.

Oddělovač se určí sám. Nahrávač se podívá na první řádek a z čárky, středníku a tabulátoru vybere ten, který se vyskytuje nejčastěji. To je důležité, protože Excel v českém prostředí ukládá CSV se středníkem a takový soubor není nutné předělávat. Export z Tabulek Google s čárkami projde stejně dobře, a stejně tak sloupec zkopírovaný přímo z tabulky, který přijde oddělený tabulátory.

Hlavička není povinná. Pokud první řádek začíná slovem url, alias nebo link, považuje se za hlavičku a do dávky nejde. Bez hlavičky je první sloupec adresa a druhý alias.

Jeden sloupec je v pořádku. Seznam adres, na každém řádku jedna, bez jakýchkoli oddělovačů, se přijme tak, jak je.

url;alias
https://example.com/katalog/sleva/obuv-2026;obuv
https://example.com/katalog/sleva/kabelky-2026;kabelky
https://example.com/katalog/sleva/kabaty-2026

Adresu s čárkou uvnitř je třeba dát do uvozovek. Je to běžné chování CSV, ale právě na tom exporty s parametry klopýtají:

"https://example.com/hledat?tags=sleva,nove";sleva-nove

Bez uvozovek se řádek na té čárce rozpadne a část adresy skončí v aliasu. Zdvojená uvozovka uvnitř hodnoty ("") znamená uvozovku doslovnou — opět standardní CSV.

Prázdné řádky se přeskakují, takže zbytečné konce řádků na konci souboru uklízet nemusíte.

Aliasy lze nechávat prázdné výběrově: třetí odkaz v příkladu žádný nemá a kód se mu vygeneruje. Míchat řádky s aliasem a bez něj je dovoleno.

Když odkazy potřebují různé parametry

Skupina, značky a UTM parametry se uplatní na celou dávku naráz. Příjemné, když nahráváte jeden katalog nebo jednu rozesílku; omezením se to stane ve chvíli, kdy seznam zahrnuje několik kampaní.

Dvě cesty, které obstojí.

Zapsat parametry přímo do adres. UTM značky jsou obyčejné parametry dotazu, takže se mohou lišit řádek po řádku, pokud je připojíte do adres samotných:

url
https://example.com/a?utm_source=newsletter&utm_campaign=cerven
https://example.com/b?utm_source=telegram&utm_campaign=cerven

Složit takový sloupec v tabulce je otázka jednoho spojovacího vzorce.

Rozdělit na několik dávek. Jedna dávka na kampaň: každá se svými značkami a svou skupinou, a statistiku pak čtete po skupinách místo rozebírání jednoho dlouhého seznamu. Pokud je kampaní málo, bývá tato cesta čistší.

Kolik odkazů odejde na jeden zátah

Limity jsou tři a jsou různého druhu.

Kolik
Řádků v jednom nahrání 1000
Souběžných nahrání 3
Odkazů v jednom požadavku na API 100

Má-li soubor víc než tisíc řádků, rozdělte ho: řádky nad limit se do nahrání vůbec nedostanou. Tři souběžná nahrání jsou strop na nedokončené úlohy, nikoli denní kvóta — jakmile jedna dojede, můžete spustit další.

Měsíční objem je jiná věc a závisí na tarifu. V bezplatném tarifu hromadné zkracování není vůbec. Pro dovoluje 100 odkazů za měsíc, což stačí vyzkoušet to na skutečném seznamu a zjistit, zda objem potřebujete. Premium měsíční strop nemá, platí však denní hranice 30 000 odkazů.

Proč se část řádků nevytvoří

Jeden špatný řádek dávku neruší. Nahrávání jde až do konce a každý řádek nese svůj vlastní výsledek. Stavy jsou tři a rozlišovat je se vyplatí, protože se řeší různě.

Zamítnuto při kontrole. Řádek neprošel kontrolami, a to je vidět hned po rozboru souboru, ještě než se cokoli zkrátí. Obvykle rozbitá adresa, příliš dlouhý alias nebo nesmysl tam, kde má být URL.

Nevytvořeno. Řádek byl v pořádku, ale odkaz nevznikl — například proto, že požadovaný alias už byl obsazený.

Vytvořeno. Hotovo, krátký odkaz stojí proti řádku.

Typické příčiny a co s nimi:

Co je vidět O co jde Co udělat
Řádek zamítnut, adresa vypadá normálně chybí schéma — example.com místo https://example.com doplnit https:// vzorcem na celý sloupec
Zamítnut každý druhý řádek adresy s čárkami nejsou v uvozovkách dát hodnoty do uvozovek nebo soubor uložit se středníkem
V aliasu skončil úryvek odkazu stejná příčina: řádek se rozpadl na oddělovači totéž
Alias zkrácen alias je delší než povolené zkrátit na 10 znaků
Nevytvořeno, alias obsazen tento kód už existuje změnit alias nebo pole nechat prázdné
Nahrálo se méně řádků, než soubor obsahuje soubor má víc než 1000 řádků rozdělit soubor

Zvyk, který se vyplatí: pusťte nejdřív prvních deset řádků souboru. Systematická chyba v exportu — jiné schéma, jiný oddělovač, sloupec navíc — se na deseti řádcích projeví stejně jako na tisíci, rozmotá se však mnohem rychleji.

Když seznam vytváří program

Pokud odkazy připravuje váš kód, a ne člověk nad tabulkou, existuje v API dávková metoda: až 100 odkazů v jednom požadavku, odpověď po položkách se stejným dělením na vytvořené, nevytvořené a zamítnuté.

Skrývá se tu nenápadná podrobnost, na kterou se dá snadno narazit. Dávka spotřebuje limit požadavků podle počtu odkazů, ne jako jeden požadavek. Dávka o 100 odkazech odečte 100 jednotek. Jinak by se dávková metoda stala způsobem, jak obejít omezení frekvence, a jeden klient by mohl vytvářet tisíce odkazů za minutu. Nepokryje-li zbývající limit celou dávku, požadavek se zamítne celý a nic se nevytvoří — zbytek se tedy kontroluje před odesláním, ne po něm.

Společné parametry se chovají jako ve formuláři: blok defaults se vlije do každého řádku a pole samotného řádku jej přebijí. Prázdná hodnota v řádku znamená „neuvedeno", takže se vezme hodnota z defaults, přesně jako prázdná buňka v exportu. Endpoint i schéma odpovědi jsou popsané v dokumentaci API.

Co s hotovým seznamem

Krátké odkazy z dávky se ničím neliší od těch vytvořených po jednom: každý má vlastní statistiku přechodů, geografii a zdroje. Pokud jste dávce přiřadili společnou skupinu, je pohodlné číst statistiku po této skupině — je vidět, jak si celý katalog nebo celá rozesílka vedly jako jeden celek.

Pokud vás před dalšími kroky zajímá, jak zkracování funguje uvnitř, je to rozebrané v článku o tom, jak fungují zkracovače odkazů. Dvě věci se vyplatí právě u velkých seznamů: vlastní doména, protože u dávky o tisíci odkazech se jméno domény potká se čtenářem tisíckrát; a značkování před nahráním, ne po něm, protože měnit UTM parametry u tisíce již existujících odkazů je dražší než předem složit označený sloupec v tabulce.

Krátce

Postavte soubor z jednoho nebo dvou sloupců, adresy se schématem https://, hodnoty s čárkami v uvozovkách. Společné parametry nastavte na dávku; ty, které se liší, zapište do adres nebo je rozneste do několika nahrání. Vyzkoušejte na deseti řádcích, pak nahrajte zbytek a přečtěte si výsledek po řádcích.

Samotná sekce a postup krok za krokem jsou na stránce hromadné zkracování odkazů; hromadné nahrávání je k dispozici v platených tarifech, na první dávku je tedy potřeba účet s Pro nebo vyšším.