--- title: "Integrace pro sledovatelné odkazy s vlastní doménou" url: https://uselinkpilot.com/cs/blog/developer-integration-for-creating-trackable-branded-links description: "Jak zabudovat vytváření odkazů do produktu: klíče API, volání pro vytvoření, idempotence, UTM, okrajové případy přesměrování, webhooky a testy." lang: cs --- Sledování odkazů (https://uselinkpilot.com/cs/blog/category/link-tracking) # Integrace pro vývojáře k vytváření sledovatelných odkazů s vlastní doménou: praktický návod Jak zabudovat vytváření odkazů do produktu: klíče API, volání pro vytvoření, idempotence, UTM, okrajové případy přesměrování, webhooky a testy. LinkPilot Team (https://uselinkpilot.com/cs/author/linkpilot-team) · Lidé, kteří vyvíjejí a provozují LinkPilot ve společnosti TetraCore, LLC 26. října 2026 · O LinkPilotu (https://uselinkpilot.com/cs/about) V určité chvíli tým přestane vytvářet odkazy ručně. Produkt potřebuje odkaz ke sdílení pro každého uživatele, CMS má při publikování článku vytvořit krátkou URL, nástroj pro kampaně chce sledovaný odkaz pro každou kreativu. Integrace pro vývojáře k vytváření sledovatelných odkazů s vlastní doménou udělá ze zkracovače funkci, kterou vaše systémy volají. Tento návod prochází integraci od začátku do konce: co rozhodnout, než začnete psát kód, jak funguje ověřování a volání pro vytvoření odkazu, jak udělat odkazy sledovatelné, aniž byste rozbili atribuci, které okrajové případy přesměrování vás potrápí, kam patří webhooky a jak vše otestovat. Jako příklad slouží API LinkPilotu, stejný postup platí pro většinu platforem. ## Nejdřív rozhodněte o architektuře Čtyři rozhodnutí, udělaná jednou, ušetří většinu přepracování. - **Které systémy odkazy vytvářejí** a při jaké události: publikování, akce uživatele, uložení záznamu kampaně. - **Která pole volající ovládá.** Obvykle cílovou adresu a štítky, někdy koncovku odkazu. Doménu jen výjimečně, ta má být nastavením pracovního prostoru nebo klienta. - **Jak se data kampaně promítnou do sledování.** Kampaň, kanál a umístění ve vašem systému se stanou štítky odkazu a parametry UTM cílové adresy. Rozhodněte o tomto převodu a dejte ho do jedné funkce. - **Přímý odkaz, deep link, nebo náhradní stránka.** Odkaz do mobilní aplikace potřebuje webovou náhradu pro lidi, kteří aplikaci nemají. Rozhodněte, zda to řeší zkracovač, nebo cílová stránka. Zapište si to. Integrace je hlavně lepidlo a lepidlo má být nudné. ## Ověřování pomocí klíčů s omezeným rozsahem API LinkPilotu ověřuje požadavky klíči typu bearer, které začínají `lp_live_`. Vytvoříte je v řídicím panelu a jsou dostupné v každém tarifu včetně Free. Každý klíč patří k jednomu pracovnímu prostoru, takže integrace agentury používá jeden klíč pro každý pracovní prostor klienta a odkazy už z principu skončí na správném místě. ```bash curl https://uselinkpilot.com/api/v1/me \ -H "Authorization: Bearer lp_live_..." ``` `GET /me` vrací pracovní prostor, tarif, limity, aktuální využití a rozpočet požadavků klíče. Volejte ho při spuštění a limity zapisujte do vlastních logů, abyste se o stropu dozvěděli dřív než kampaň. S klíčem zacházejte jako s produkčními přihlašovacími údaji: uložte ho do správce tajných údajů, nikdy do repozitáře ani do balíčku pro frontend, a když ho musíte předat někomu, kdo integraci staví, pošlete ho přes jednorázový tajný odkaz (https://uselinkpilot.com/cs/tools/free-secret-link-generator). Předání a rotaci popisuje návod ke klíčům API (https://uselinkpilot.com/cs/blog/how-to-share-api-keys-securely). ## Vytvoření odkazu Volání pro vytvoření přijímá cílovou adresu a několik volitelných polí. ```bash curl -X POST https://uselinkpilot.com/api/v1/links \ -H "Authorization: Bearer lp_live_..." \ -H "Content-Type: application/json" \ -d '{ "url": "https://example.com/launch?utm_source=newsletter&utm_medium=email&utm_campaign=oct-launch", "slug": "oct-launch-email", "domain": "go.example.com", "title": "October launch, newsletter", "tags": ["oct-launch", "email"] }' ``` Odpověď obsahuje ID odkazu, krátkou URL a metadata, která jste poslali. ID si uložte k vlastnímu záznamu, budete podle něj odkaz později číst, upravovat nebo mazat. `GET /links` vypisuje odkazy od nejnovějších se stránkováním pomocí kurzoru (`{ data, next_cursor }`) a `GET /links/{id}` a `DELETE /links/{id}` pracují s jedním odkazem. Několik pravidel, díky kterým integrace zůstane poctivá: - **Cílovou URL sestavujte v kódu** i se značkami UTM, z polí kampaně. Ručně psané značky se časem rozcházejí. Pravidla nastavuje příručka k UTM (https://uselinkpilot.com/cs/blog/utm-parameters-complete-playbook). - **Koncovky odkazů nechte generovat platformu**, pokud je nebude číst člověk. Když je nastavujete sami, odvoďte je z kampaně, kanálu a umístění, malými písmeny se spojovníky, a konflikt řešte přidáním krátké přípony a jedním novým pokusem. - **Vytváření udělejte idempotentní.** Každé vytvoření svažte s ID vlastního záznamu, aby opakovaný pokus po vypršení časového limitu našel existující odkaz a nevytvořil druhý. Pokud platforma klíč idempotence nenabízí, zkontrolujte před vytvořením v `GET /links` svůj štítek nebo koncovku. - **Hromadné vytváření je smyčka s postupným zpomalováním.** Dodržujte rozpočet požadavků z `/me`, při 429 zpomalte a každé selhání zapište do logu i se záznamem, ke kterému patřilo. Pro skripty a místní nástroje obaluje stejná volání CLI `linkpilot` z npm a server `@uselinkpilot/mcp` je zpřístupňuje AI agentům. Obojí je open source na GitHubu pod TetraCoreHQ. ## Sledovatelné odkazy bez rozbité atribuce Každé kliknutí na odkaz vytvořený přes API se zaznamená stejně jako u odkazu z řídicího panelu: čas, zdroj odkazu (referrer), zařízení, prohlížeč, země, region, označení bota a místo IP adresy hash se solí. Tak získáte počet kliknutí na úrovni odkazu. Atribuce na cílovém webu ale dál závisí na tom, zda URL dorazí neporušená. - **Zachovejte parametry dotazu i po přesměrování.** Otestujte odkaz kontrolou přesměrování (https://uselinkpilot.com/cs/tools/redirect-checker) a ověřte, že výsledná URL značky UTM obsahuje. - **Vyhněte se řetězcům.** Krátký odkaz, který přesměruje na další přesměrování, ztrácí parametry i rychlost. Odkazujte přímo na cílovou stránku. - **Rozhodněte, co sbíráte.** Země a zařízení jsou souhrnné statistiky. Odkaz pro jednoho uživatele spojený se záznamem zákazníka je osobní údaj. Moderní průvodce sledováním odkazů (https://uselinkpilot.com/cs/blog/modern-link-tracking) uvádí, co se zaznamenává a co záměrně ne. - **Nastavte očekávání v produktu.** Počet kliknutí není počet konverzí. Zobrazujte obojí s popisky. ## Okrajové případy přesměrování - **Ověření cílové adresy.** Ještě před vytvořením odkazu odmítněte cílové adresy bez HTTPS, vlastní doménu zkracovače a vše, co je na seznamu blokovaných. Otevřené přesměrování pod vaší značkou je nástroj pro phishing. - **Odkazy s vypršelou platností, vypnuté nebo neexistující.** Náhradní stránku určete a nastavte při vytváření odkazu, aby mrtvý odkaz z kampaně vedl na domovskou stránku, a ne na chybu. U tištěných odkazů raději měňte cílovou adresu, než abyste nechali platnost vypršet. - **Deep linky.** Použijte cílovou adresu, která aplikaci rozpozná a jinak přejde na web, nebo funkci platformy, která to umí. Otestujte na obou operačních systémech s nainstalovanou aplikací i bez ní. - **Kódování.** Cílovou adresu zakódujte pro URL dřív, než ji vložíte do JSON, zvlášť když má vlastní řetězec dotazu. Obvyklou chybou je dvojité kódování. - **Lokalizace.** Pokud jeden krátký odkaz slouží několika jazykům, rozpoznávejte jazyk na cílové stránce, ne v koncovce odkazu. ## Webhooky pro důležité události Webhooky umožní zbytku vašeho systému reagovat na dění kolem odkazů bez dotazování. LinkPilot každé doručení podepisuje hlavičkou s podpisem HMAC a posílá události životního cyklu odkazu (`link.created`, `link.updated`, `link.deleted`) a životního cyklu tajné zprávy (`secret.created`, `secret.viewed`, `secret.burned`). Podpis ověřte před parsováním, příjem potvrďte rychle, zpracování veďte přes frontu a ukládejte ID událostí, aby opakované doručení nic nepokazilo. Data o kliknutích jsou proud pro vykazování, ne webhook. Čtěte je přes statistiky a exporty. Stavbu přijímače popisuje návod k webhookovým integracím (https://uselinkpilot.com/cs/blog/how-to-choose-and-use-a-link-tracking-platform-with-webhook-integrations). ## Otestujte vše od začátku do konce a pak dál sledujte Než integrace sáhne na skutečnou kampaň: 1. Vytvořte odkaz se svými testovacími štítky v testovacím pracovním prostoru. 2. Ověřte, že odpověď obsahuje očekávané ID a krátkou URL. 3. Klikněte na odkaz z telefonu a z notebooku. Ověřte přesměrování, značky UTM po příchodu a dvě kliknutí ve statistikách se správnými typy zařízení. 4. Vytvořte stejný záznam znovu a ověřte, že dostanete stejný odkaz, ne duplikát. 5. Odkaz smažte a ověřte, že na váš koncový bod webhooku dorazí `link.deleted`, pokud webhook používáte. V provozu sledujte tři věci: chybovost API podle stavového kódu, latenci přesměrování ze syntetické kontroly a týdenní porovnání počtu odkazů mezi vašimi záznamy a `GET /links`. Klíč API pravidelně rotujte a také pokaždé, když z týmu, který ho má, někdo odejde. Integraci zdokumentujte jako interní produkt: jaká pole přijímá, pravidlo pro koncovky, chování náhradní stránky, limity z `/me` a koho volat, když kampaň hlásí nula kliknutí. Další člověk, který na ni sáhne, bude rád, a často to budete vy. ## Související články - Srovnání API zkracovačů odkazů: Bitly, Dub, Short.io, TinyURL: https://uselinkpilot.com/cs/blog/url-shortener-api-comparison - Jak vybrat a používat platformu pro sledování odkazů s webhookovými integracemi: https://uselinkpilot.com/cs/blog/how-to-choose-and-use-a-link-tracking-platform-with-webhook-integrations - Jak bezpečně sdílet klíče API: https://uselinkpilot.com/cs/blog/how-to-share-api-keys-securely - Parametry UTM: kompletní příručka pro rok 2026: https://uselinkpilot.com/cs/blog/utm-parameters-complete-playbook ## Nástroje k tomuto článku Bezplatný zkracovač odkazů Zkraťte dlouhou URL a zvolte si vlastní koncovku. https://uselinkpilot.com/cs/tools/url-shortener Verze: Zkracovač odkazů pro bio na TikToku (https://uselinkpilot.com/cs/tools/url-shortener/tiktok-bio) · Zkracovač odkazů pro bio na Instagramu (https://uselinkpilot.com/cs/tools/url-shortener/instagram-bio) · Zkracovač odkazů pro příspěvky na LinkedInu (https://uselinkpilot.com/cs/tools/url-shortener/linkedin-post) · Zkracovač odkazů pro X (Twitter) (https://uselinkpilot.com/cs/tools/url-shortener/twitter) Generátor UTM Vytvořte URL s parametry kampaně během pár sekund. https://uselinkpilot.com/cs/tools/utm-builder Verze: Generátor UTM pro LinkedIn (https://uselinkpilot.com/cs/tools/utm-builder/linkedin) · Generátor UTM pro Facebook (https://uselinkpilot.com/cs/tools/utm-builder/facebook) · Generátor UTM pro e-maily (https://uselinkpilot.com/cs/tools/utm-builder/email) · Generátor UTM pro Instagram (https://uselinkpilot.com/cs/tools/utm-builder/instagram) · Generátor UTM pro TikTok (https://uselinkpilot.com/cs/tools/utm-builder/tiktok) · Generátor UTM pro YouTube (https://uselinkpilot.com/cs/tools/utm-builder/youtube) · Generátor UTM pro Google Ads (https://uselinkpilot.com/cs/tools/utm-builder/google-ads) · Generátor UTM pro X (Twitter) (https://uselinkpilot.com/cs/tools/utm-builder/twitter) · Generátor UTM pro Reddit (https://uselinkpilot.com/cs/tools/utm-builder/reddit) · Generátor UTM pro Pinterest (https://uselinkpilot.com/cs/tools/utm-builder/pinterest) Kontrola přesměrování Sledujte celý řetězec přesměrování libovolné URL. https://uselinkpilot.com/cs/tools/redirect-checker Verze: Kontrola přesměrování affiliate odkazů (https://uselinkpilot.com/cs/tools/redirect-checker/affiliate-links) · SEO audit přesměrování (https://uselinkpilot.com/cs/tools/redirect-checker/seo-audit) Kontrola kliknutí na odkaz Podívejte se na kliknutí, odkazující weby a místa u krátkého odkazu. https://uselinkpilot.com/cs/tools/link-analytics Chytré návrhy pro odkazy Návrhy od AI pro pojmenování, pořádek v UTM a domény se značkou. https://uselinkpilot.com/cs/tools/smart-link-suggestions ## Časté dotazy ### Co je sledovatelný odkaz s vlastní doménou? ### Jaká pole má API pro vytváření odkazů přijímat? ### Jak má integrace řešit duplicitní koncovky odkazů? ### Proč testovat parametry dotazu po přesměrování? ### Co se má stát, když platnost odkazu vyprší nebo je odkaz smazán? ### Dokazují kliknutí na odkaz, že konverzi způsobila kampaň? ## Chytřejší odkazy s LinkPilotem Sledování, UTM, QR kódy, přehledy od AI a reporty pod vlastní značkou v jednom pracovním prostoru. Začátek je zdarma. Vytvořit účet zdarma (https://uselinkpilot.com/signup) ## Čtěte dál Sledování odkazů ### Vlastní sledování odkazů pro týmy customer success: praktický návod k zavedení Kam patří odkazy v customer success, jak je sledovat po účtech bez osobních údajů v URL, jak číst kliknutí vedle adopce a jaká platí pravidla soukromí. https://uselinkpilot.com/cs/blog/custom-link-tracking-for-customer-success-teams Sledování odkazů ### Zkracovač odkazů s vlastní doménou a přehledy kliknutí: výběr a nastavení Co hledat u zkracovače odkazů s vlastní doménou a přehledy kliknutí, jak doménu připojit záznamem CNAME a jak číst statistiky odkazů s vlastní doménou. https://uselinkpilot.com/cs/blog/custom-domain-link-shortener-with-click-reports Sledování odkazů ### Jak propojit zkracovač odkazů s vlastní doménou se Slackem Nastavte svou doménu, nainstalujte aplikaci pro Slack, která zkracuje odkazy a mění vložená hesla v jednorázové odkazy, opravte náhledy a čtěte kliknutí. https://uselinkpilot.com/cs/blog/how-to-integrate-a-branded-link-shortener-with-slack ## Structured data ```json [ { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Domů", "item": "https://uselinkpilot.com/cs" }, { "@type": "ListItem", "position": 2, "name": "Blog", "item": "https://uselinkpilot.com/cs/blog" }, { "@type": "ListItem", "position": 3, "name": "Integrace pro vývojáře: sledovatelné odkazy s vlastní doménou v praxi", "item": "https://uselinkpilot.com/cs/blog/developer-integration-for-creating-trackable-branded-links" } ] }, { "@context": "https://schema.org", "@type": "BlogPosting", "@id": "https://uselinkpilot.com/cs/blog/developer-integration-for-creating-trackable-branded-links#article", "headline": "Integrace pro vývojáře: sledovatelné odkazy s vlastní doménou v praxi", "description": "Jak zabudovat vytváření odkazů do produktu: klíče API, volání pro vytvoření, idempotence, UTM, okrajové případy přesměrování, webhooky a testy.", "inLanguage": "cs", "datePublished": "2026-10-26", "dateModified": "2026-10-26", "image": "https://uselinkpilot.com/logo-512.png", "author": { "@type": "Organization", "@id": "https://uselinkpilot.com/author/linkpilot-team#organization", "name": "LinkPilot Team", "url": "https://uselinkpilot.com/cs/author/linkpilot-team" }, "publisher": { "@type": "Organization", "name": "LinkPilot", "url": "https://uselinkpilot.com", "logo": { "@type": "ImageObject", "url": "https://uselinkpilot.com/logo-512.png", "width": 512, "height": 512 } }, "mainEntityOfPage": { "@type": "WebPage", "@id": "https://uselinkpilot.com/cs/blog/developer-integration-for-creating-trackable-branded-links" } }, { "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Co je sledovatelný odkaz s vlastní doménou?", "acceptedAnswer": { "@type": "Answer", "text": "Krátká URL na doméně, kterou spravujete. Přesměruje na cílovou adresu a cestou zaznamená každé kliknutí: čas, zdroj odkazu (referrer), zařízení, zemi a označení bota. Odkaz vytvořený přes API je stejný objekt jako odkaz vytvořený v řídicím panelu." } }, { "@type": "Question", "name": "Jaká pole má API pro vytváření odkazů přijímat?", "acceptedAnswer": { "@type": "Answer", "text": "Cílovou URL, volitelnou koncovku odkazu, doménu, na které má odkaz běžet, název a štítky. Vše ostatní, například parametry UTM, patří do cílové URL, kterou předáváte. POST /links v LinkPilotu přijímá přesně tato pole." } }, { "@type": "Question", "name": "Jak má integrace řešit duplicitní koncovky odkazů?", "acceptedAnswer": { "@type": "Answer", "text": "Konflikt koncovky berte jako běžnou odpověď, ne jako chybu, na které aplikace spadne. Buď nechte koncovku vygenerovat platformu, nebo při konfliktu přidejte krátkou příponu a zkuste to jednou znovu. Existující odkaz nikdy potichu nepřepisujte." } }, { "@type": "Question", "name": "Proč testovat parametry dotazu po přesměrování?", "acceptedAnswer": { "@type": "Answer", "text": "Protože řetězec přesměrování, cílový web, který URL normalizuje, nebo platforma, která odstraňuje neznámé parametry, mohou značky UTM zahodit. Pak se žádné kliknutí nikam nepřipíše. Jeden test s kontrolou přesměrování to odhalí." } }, { "@type": "Question", "name": "Co se má stát, když platnost odkazu vyprší nebo je odkaz smazán?", "acceptedAnswer": { "@type": "Answer", "text": "Krátká URL má vést na rozumnou náhradní stránku, ne na holou chybovou hlášku. Náhradní stránku určete už při vytváření odkazu. U odkazů v tištěných materiálech raději měňte cílovou adresu, než abyste nechali platnost vypršet." } }, { "@type": "Question", "name": "Dokazují kliknutí na odkaz, že konverzi způsobila kampaň?", "acceptedAnswer": { "@type": "Answer", "text": "Ne. Kliknutí ukazuje, že někdo byl poslán na cílovou adresu. Konverze se měří na cílovém webu a spojují se podle názvu kampaně nebo podepsaného identifikátoru. Obojí vykazujte vedle sebe." } } ], "inLanguage": "cs" }, { "@context": "https://schema.org", "@type": "SoftwareApplication", "@id": "https://uselinkpilot.com/#software", "name": "LinkPilot", "applicationCategory": "BusinessApplication", "operatingSystem": "Web", "description": "LinkPilot is a secure link management platform for creating branded short links, tracking engagement, and sharing secrets with expiring, protected, self-destructing links.", "url": "https://uselinkpilot.com", "offers": [ { "@type": "Offer", "name": "Free", "price": "0", "priceCurrency": "USD", "url": "https://uselinkpilot.com/pricing" }, { "@type": "Offer", "name": "Pro", "price": "29", "priceCurrency": "USD", "priceSpecification": { "@type": "UnitPriceSpecification", "price": "29", "priceCurrency": "USD", "billingDuration": "P1M" }, "url": "https://uselinkpilot.com/pricing" }, { "@type": "Offer", "name": "Agency", "price": "299", "priceCurrency": "USD", "priceSpecification": { "@type": "UnitPriceSpecification", "price": "299", "priceCurrency": "USD", "billingDuration": "P1M" }, "url": "https://uselinkpilot.com/pricing" }, { "@type": "Offer", "name": "Agency Plus", "price": "799", "priceCurrency": "USD", "priceSpecification": { "@type": "UnitPriceSpecification", "price": "799", "priceCurrency": "USD", "billingDuration": "P1M" }, "url": "https://uselinkpilot.com/pricing" }, { "@type": "Offer", "name": "Pro (yearly)", "price": "288", "priceCurrency": "USD", "priceSpecification": { "@type": "UnitPriceSpecification", "price": "288", "priceCurrency": "USD", "billingDuration": "P1Y" }, "url": "https://uselinkpilot.com/pricing" }, { "@type": "Offer", "name": "Agency (yearly)", "price": "2988", "priceCurrency": "USD", "priceSpecification": { "@type": "UnitPriceSpecification", "price": "2988", "priceCurrency": "USD", "billingDuration": "P1Y" }, "url": "https://uselinkpilot.com/pricing" }, { "@type": "Offer", "name": "Agency Plus (yearly)", "price": "7980", "priceCurrency": "USD", "priceSpecification": { "@type": "UnitPriceSpecification", "price": "7980", "priceCurrency": "USD", "billingDuration": "P1Y" }, "url": "https://uselinkpilot.com/pricing" }, { "@type": "Offer", "name": "Enterprise", "priceSpecification": { "@type": "PriceSpecification", "priceCurrency": "USD" }, "url": "https://uselinkpilot.com/pricing" } ] }, { "@context": "https://schema.org", "@type": "Organization", "@id": "https://uselinkpilot.com/#organization", "name": "LinkPilot", "alternateName": "LinkPilot by TetraCore", "url": "https://uselinkpilot.com", "contactPoint": { "@type": "ContactPoint", "contactType": "customer support", "email": "support@uselinkpilot.com", "url": "https://uselinkpilot.com/support" }, "parentOrganization": { "@type": "Organization", "@id": "https://tetracorehq.com/#organization", "name": "TetraCore", "url": "https://tetracorehq.com/" }, "logo": { "@type": "ImageObject", "url": "https://uselinkpilot.com/logo-512.png", "width": 512, "height": 512 }, "description": "LinkPilot is a secure link management platform for creating branded short links, tracking engagement, and sharing secrets with expiring, protected, self-destructing links.", "sameAs": [ "https://x.com/uselinkpilot", "https://www.linkedin.com/company/uselinkpilot", "https://facebook.com/uselinkpilot", "https://github.com/TetraCoreHQ/linkpilot-cli", "https://github.com/TetraCoreHQ/linkpilot-mcp", "https://www.npmjs.com/package/linkpilot", "https://www.npmjs.com/package/@uselinkpilot/sdk", "https://www.npmjs.com/package/@uselinkpilot/mcp", "https://chromewebstore.google.com/detail/linkpilot-short-links-and/mnmppadihpcncicldpkmgknhnjkondad", "https://addons.mozilla.org/en-US/firefox/addon/uselinkpilot/" ] }, { "@context": "https://schema.org", "@type": "WebSite", "name": "LinkPilot", "url": "https://uselinkpilot.com", "potentialAction": { "@type": "SearchAction", "target": "https://uselinkpilot.com/blog?q={search_term_string}", "query-input": "required name=search_term_string" } } ] ```