Odkazly (Preview)
Linkly je zkrácený odkaz a klikněte na sledování. Vytvořte značkové krátké odkazy s vlastními doménami, přidejte parametry UTM a retargeting pixels, report conversions a pull click analytics grouped by country, platform, referrer nebo campaign.
Tento konektor je dostupný v následujících produktech a oblastech:
| Služba | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Všechny oblasti Power Automate kromě následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Logické aplikace | Standard | Všechny oblasti Logic Apps s výjimkou následujících: – Azure Government oblastí – Oblasti Azure China - Ministerstvo obrany USA (DoD) |
| Power Apps | Premium | Všechny oblasti Power Apps s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Automatizace napájení | Premium | Všechny oblasti Power Automate kromě následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Kontakt | |
|---|---|
| Name | Linkly Support |
| URL | https://linklyhq.com/support |
| support@linklyhq.com |
| Metadata konektoru | |
|---|---|
| Vydavatel | Odkazly |
| Internetová stránka | https://linklyhq.com |
| Zásady ochrany osobních údajů | https://linklyhq.com/support/privacy |
| Kategorie | Marketing; Internetová stránka |
Odkazly
Linkly je zkrácený odkaz a klikněte na sledování. Vytvoří značkové krátké odkazy ve vaší vlastní doméně, sleduje každé kliknutí se zemí, rozpisy platforem a referrerů, aktivuje přesměrování cílení pixelů a záznamy zpět na odkaz, který je vytvořil. Tento konektor umožňuje tokům vytvářet a spravovat odkazy, vyžádat kliknutím na analýzy a převody sestav v pracovním prostoru Linkly.
Publisher: Propojení
Prerequisites
Účet Linkly . Bezplatný plán stačí k použití všech akcí v tomto konektoru. Vytváření sestav a výpis převodů také vyžaduje, aby byla v pracovním prostoru povolená funkce sledování převodu odkazů.
Podporované operace
Výpis pracovních prostorů
Vrátí pracovní prostory dostupné pro toto připojení. Použijte ho k vyhledání pracovního prostoru, který vyžadují jiné akce.
Vytvoření nebo aktualizace odkazu
Vytvoří nový krátký odkaz nebo aktualizuje existující odkaz při zadání ID odkazu. Podporuje vlastní domény a slugy, parametry UTM, retargeting pixely a metadata Open Graphu.
Získat odkaz
Načte jeden odkaz podle id, včetně cíle, krátké adresy URL a konfigurace.
Odkazy na seznam
Vrátí stránkovaný seznam odkazů v pracovním prostoru s kliknutím na statistiku. Podporuje vyhledávání a řazení.
Odstranění odkazu
Přesune odkaz do koše. Jeho krátká adresa URL se zastaví přesměrování a odkaz lze obnovit později z koše.
Získání analýzy kliknutí
Vrátí počet kliknutí v průběhu času pro pracovní prostor nebo pro konkrétní odkazy, volitelně filtrované podle rozsahu dat, země, prohlížeče, platformy, refereru nebo isP.
Získání počtu kliknutí podle dimenze
Vrátí počty kliknutí seskupené podle dimenze, jako je země, město, platforma, referrer nebo parametr UTM seřazené sestupně podle počtu.
Výpis vlastních domén
Vrátí vlastní domény nakonfigurované pro pracovní prostor. Tyto názvy domén lze použít při vytváření odkazů.
Nahlášení převodu
Zaznamenává převod, jako je nákup, registrace nebo vlastní událost, a přiřazuje ho k odkazu, na který se kliklo při zadání tokenu přiřazení.
Převody seznamů
Vrátí nejnovější převody zaznamenané v pracovním prostoru.
Získání přihlašovacích údajů
Tento konektor používá OAuth 2.0. Není potřeba žádný klíč rozhraní API.
- Pokud ještě nemáte účet Linkly, zaregistrujte se na adrese https://linklyhq.com. Bezplatný plán funguje.
- Když vytvoříte připojení, zvolte Přihlásit se pomocí Linkly a přihlaste se pomocí svého účtu Linkly.
- Zvolte pracovní prostor, který má toto připojení použít, když se zobrazí výzva, a pak žádost schválíte.
Připojení je vázané na vámi zvolený pracovní prostor. Pokud chcete pracovat v jiném pracovním prostoru, vytvořte druhé připojení.
Začínáme
- Vytvořte připojení, jak je popsáno výše.
- Přidejte akci Vytvořit nebo aktualizovat odkaz do toku, zadejte cílovou adresu URL a volitelně vlastní doménu a slug. Akce vrátí krátkou adresu URL a ID odkazu.
- Použijte odkazy na seznam, Získejte analýzu kliknutím nebo Získejte počty kliknutí podle dimenze , abyste mohli číst data. Akce, které provádějí pracovní prostor , vám umožní vybrat ho ze seznamu, který je naplněný pracovními prostory seznamu.
- Pokud chcete přiřazovat nákupy nebo registrace k odkazům, předejte
linkly_cidhodnotu z adresy URL cílové stránky a nahlásit převod jako token pro přisuzování.
Známé problémy a omezení
- Připojení je vázané na jeden pracovní prostor Linkly, který se vybere při přihlašování. Vytvořte jedno připojení na pracovní prostor.
- Sestava převodů a převodů seznamů vyžaduje funkci sledování převodu linkly. Pracovní prostory bez nich obdrží chybu z těchto akcí.
- Webhooky kliknutí v reálném čase se nezobrazují jako triggery. Místo toho použijte funkci webhooku linkly s tokem aktivovaným protokolem HTTP.
- Hromadné vytváření odkazů, export propojení a správa domén jsou k dispozici v rozhraní API Linkly, ale nejsou součástí tohoto konektoru.
- Rozhraní API je omezené rychlostí. Získání počtu kliknutí podle dimenze vrátí chybu limitu rychlosti při překročení limitu. zopakujte akci po krátké prodlevě.
Nejčastější dotazy
Ve kterém pracovním prostoru se moje akce spouštějí?
Akce, které provádějí parametr pracovního prostoru , zobrazují seznam pracovních prostorů dostupných pro připojení. Akce bez nich, například Získat odkaz, Vytvořit sestavu převodu a Převod seznamů, používají pracovní prostor svázaný s připojením.
Jak se používá vlastní doména?
Nejprve přidejte doménu do linkly a pak předejte její název do pole Doménav poli Vytvořit nebo aktualizovat odkaz. Vypsat vlastní domény vrátí názvy dostupné v pracovním prostoru.
Odstraní odkaz trvale?
No. Odkaz se přesune do koše a zastaví přesměrování. Dá se obnovit z koše v Linkly.
Pokyny k nasazení
- Na portálu maker otevřete vlastní konektory, zvolte Nový vlastní konektor a pak importujte soubor OpenAPI. Vyberte možnost
apiDefinition.swagger.json. - Na kartě Zabezpečení zvolte OAuth 2.0 se zprostředkovatelem identity Generic Oauth 2 . Zadejte ID klienta a tajný klíč klienta vydaný linkly, nastavte autorizační adresu URL na
https://app.linklyhq.com/oauth/authorizea nastavte adresu URL tokenu i adresu URL aktualizace nahttps://app.linklyhq.com/oauth/token. - Vytvořte konektor a zkopírujte adresu URL pro přesměrování zobrazenou na kartě Zabezpečení a zaregistrujte ho pomocí odkazu pro toto ID klienta.
- Vytvořte připojení tak, že se přihlásíte pomocí svého účtu Linkly a pak otestujete akci, jako je seznam pracovních prostorů.
Akce
| Nahlášení převodu |
Zaznamenává převod, jako je nákup, registrace nebo vlastní událost, a přiřazuje ho k odkazu, na který se kliklo při zadání tokenu přiřazení. |
| Odkazy na seznam |
Vrátí stránkovaný seznam odkazů v pracovním prostoru s kliknutím na statistiku. Podporuje vyhledávání a řazení. |
| Odstranění odkazu |
Přesune odkaz do koše. Jeho krátká adresa URL se zastaví přesměrování a odkaz lze obnovit později z koše. |
| Převody seznamů |
Vrátí nejnovější převody zaznamenané v pracovním prostoru. |
| Vytvoření nebo aktualizace odkazu |
Vytvoří nový krátký odkaz nebo aktualizuje existující odkaz při zadání ID odkazu. Podporuje vlastní domény a slugy, parametry UTM, retargeting pixely a metadata Open Graphu. |
| Výpis pracovních prostorů |
Vrátí pracovní prostory dostupné pro toto připojení. Použijte ho k vyhledání pracovního prostoru, který vyžadují jiné akce. |
| Výpis vlastních domén |
Vrátí vlastní domény nakonfigurované pro pracovní prostor. Tyto názvy domén lze použít při vytváření odkazů. |
| Získat odkaz |
Načte jeden odkaz podle id, včetně cíle, krátké adresy URL a konfigurace. |
| Získání analýzy kliknutí |
Vrátí počet kliknutí v průběhu času pro pracovní prostor nebo pro konkrétní odkazy, volitelně filtrované podle rozsahu dat, země, prohlížeče, platformy, refereru nebo isP. |
| Získání počtu kliknutí podle dimenze |
Vrátí počty kliknutí seskupené podle dimenze, jako je země, město, platforma, referrer nebo parametr UTM seřazené sestupně podle počtu. |
Nahlášení převodu
Zaznamenává převod, jako je nákup, registrace nebo vlastní událost, a přiřazuje ho k odkazu, na který se kliklo při zadání tokenu přiřazení.
Parametry
| Název | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Amount (Cents)
|
amount_cents | integer |
Hodnota v nejmenší měně. Může to být záporné pro zaznamenání refundace nebo vrácení peněz, což je čisté oproti dřívějším výnosům. |
|
|
Country
|
country | string |
Dvoumísmenný kód země pro převod. Odvozeno pro volání na straně prohlížeče; zadejte ji explicitně z integrace na straně serveru, kde je adresa pro připojení vaší vlastní infrastrukturou, a ne ze strany zákazníka. |
|
|
Měna
|
currency | string |
Kód měny ISO 4217. Výchozí hodnota je USD. |
|
|
ID události
|
event_id | string |
Váš identifikátor pro tuto událost. Používá se jako idempotentní klíč; při generování sestavy stejné hodnoty dvakrát se nevytváří druhý převod. Platí pro všechny typy událostí, nejen nákupy. |
|
|
Název události
|
event_name | True | string |
Co se stalo, například nákup, registrace, trial_started. |
|
Typ události
|
event_type | string |
Hrubý typ řídí trychtýř. lead vytváří identitu zákazníka, zaznamenává tržby za prodej. Výchozí hodnota je vlastní. |
|
|
ID zákazníka
|
external_id | string |
Váš identifikátor zákazníka. Odešlete ho na každou událost: to je to, co odkazuje na pozdější prodej na straně serveru zpět na kliknutí, které vytvořilo registraci. |
|
|
Token přisuzování
|
linkly_cid | string |
Token přisuzování zachycený z adresy URL cílové stránky. Vynechání, pokud není k dispozici; převod se pak zaznamená bez přisuzování propojení. |
|
|
Metadata
|
metadata | object |
Libovolný KÓD JSON, kódovaný až 10 000 bajtů. |
|
|
Došlo k
|
occurred_at | date-time |
Když došlo k převodu. Výchozí hodnota je teď. |
|
|
IP adresa návštěvníka
|
visitor_ip | string |
IP adresa koncového zákazníka, když ji váš server má. Vymižte, dokud neuděláte; v případě volání na straně serveru linkly jinak zaznamenává připojovací adresu jako váš server, nikoli zákazníka, a vylučuje ji z geografického hlášení. Odesláním tohoto tvrzení máte zákonný základ pro jeho sdílení. Rozhraní API nikdy nevrácené. |
Návraty
| Název | Cesta | Typ | Description |
|---|---|---|---|
|
Amount (Cents)
|
amount_cents | integer |
Hodnota v nejmenší měně. Může být negativní pro zaznamenání refundace. |
|
Klikněte na ID.
|
click_id | string |
ID atributu kliknutí. |
|
Country
|
country | string |
Dvoumísmenný kód země ISO 3166-1, například USA. |
|
Měna
|
currency | string |
Kód měny ISO 4217. Výchozí hodnota je USD. |
|
ID události
|
event_id | string |
Váš identifikátor události. Při generování zprávy o stejné hodnotě dvakrát nedojde k vytvoření druhého převodu. |
|
Název události
|
event_name | string |
Co se stalo, například nákup, registrace nebo trial_started. |
|
Typ události
|
event_type | string |
Hrubý typ události. Použijte potenciálního zákazníka k vytvoření identity zákazníka a prodeje za účelem zaznamenání výnosů. Výchozí hodnota je vlastní. |
|
ID zákazníka
|
external_id | string |
Váš identifikátor zákazníka. Odešlete ji při každé události, aby bylo možné později propojit prodej s původním kliknutím. |
|
ID převodu
|
id | string |
Jedinečný identifikátor převodu. ID se řadí chronologicky. |
|
Vloženo do
|
inserted_at | date-time |
Po zaznamenání převodu. |
|
Zdroj IP adres
|
ip_source | string |
Jejíž adresa byla zaznamenána: návštěvník, server nebo neznámý. Server znamená, že připojovací adresa patří do vašeho back-endu nebo přenosu platformy, takže je vyloučená z geografického hlášení. |
|
ID odkazu
|
link_id | integer |
ID atributového odkazu nebo null, pokud převod nelze přiřadit propojení. |
|
Metadata
|
metadata | object |
Libovolná metadata JSON, až 10 000 bajtů |
|
Došlo k
|
occurred_at | date-time |
Při převodu ve formátu ISO 8601. Výchozí hodnota je teď. |
|
Source
|
source | string |
Která integrace ji ohlásila. |
Odkazy na seznam
Vrátí stránkovaný seznam odkazů v pracovním prostoru s kliknutím na statistiku. Podporuje vyhledávání a řazení.
Parametry
| Název | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Pracovní prostor, ve který se má pracovat. Vyberte ho ze seznamu nebo zadejte jeho ID. |
|
Search
|
search | string |
Hledaný termín pro filtrování odkazů podle názvu, adresy URL nebo slug |
|
|
Stránka
|
page | integer |
Číslo stránky, které se má vrátit, začíná číslem 1. |
|
|
Velikost stránky
|
page_size | integer |
Počet odkazů, které se mají vrátit na stránku. |
|
|
Řadit podle
|
sort_by | string |
Pole, podle které chcete řadit, například clicks_total, název nebo inserted_at. |
|
|
Směr řazení
|
sort_dir | string |
Směr řazení, asc nebo desc. |
|
|
Odstraněno
|
deleted | boolean |
Zda se mají vrátit odkazy, které jsou v koši místo aktivních odkazů. |
Návraty
| Název | Cesta | Typ | Description |
|---|---|---|---|
|
Links
|
links | array of object |
Odkazy na této stránce. |
|
ID meta pixelu
|
links.fb_pixel_id | string |
ID pixelu meta (Facebook) se aktivuje po kliknutí na odkaz. |
|
Celkový počet kliknutí člověka
|
links.human_clicks_total | integer |
Životnost kliknutí bez signálu robota; podmnožinu clicks_total, kdy se nezjistil ani uživatelský agent robota ani kategorie ověřeného robota. Zaznamenáno od roku 2019 dále. |
|
Kliknutí (30 dní)
|
links.clicks_thirty_days | integer |
Kliká za posledních 30 dnů, včetně provozu robota. |
|
ID pixelu TikTok
|
links.tiktok_pixel_id | string |
Id pixelu TikTok se aktivuje po kliknutí na odkaz. |
|
Skrýt referrer
|
links.hide_referrer | boolean |
Zda chcete skrýt odkazující z cílové lokality. |
|
Cloaking
|
links.cloaking | boolean |
Zda chcete cíl skrýt tak, že ho otevřete uvnitř rámce. |
|
Krátká adresa URL
|
links.full_url | uri |
Úplná krátká adresa URL odkazu. |
|
Kliká dnes
|
links.clicks_today | integer |
Až dosud klikněte (UTC), včetně provozu robota. |
|
Otevřít popis grafu
|
links.og_description | string |
Popis zobrazený při sdílení odkazu na sociálních sítích. |
|
Značky textu
|
links.body_tags | string |
Vlastní značky HTML nebo sledování vložené do textu stránky přesměrování |
|
Otevřít název grafu
|
links.og_title | string |
Název zobrazený při sdílení odkazu na sociálních sítích. |
|
Note
|
links.note | string |
Soukromá poznámka o odkazu. |
|
Name
|
links.name | string |
Přezdívka odkazu zobrazená na řídicím panelu |
|
ID odkazu
|
links.id | integer |
Jedinečný identifikátor odkazu. |
|
ID Správce značek Google
|
links.gtm_id | string |
ID kontejneru Správce značek Google, které se má načíst po kliknutí na odkaz. |
|
Otevřít obrázek grafu
|
links.og_image | string |
Adresa URL obrázku zobrazená při sdílení odkazu na sociálních sítích. |
|
Blokovat roboty
|
links.block_bots | boolean |
Jestli chcete blokovat známé roboty za odkazem. |
|
Total Clicks
|
links.clicks_total | integer |
Kliknutí na životnost, včetně provozu robota |
|
Kliknutí člověka (30 dní)
|
links.human_clicks_thirty_days | integer |
Kliknutí za posledních 30 dnů bez signálu robota; podmnožinu clicks_thirty_days. |
|
Obsah UTM
|
links.utm_content | string |
Parametr utm_content připojený k cílové adrese URL. |
|
Dnešní kliknutí člověka
|
links.human_clicks_today | integer |
Až dosud klikněte (UTC) bez signálu robota. |
|
Enabled
|
links.enabled | boolean |
Určuje, jestli je odkaz aktivní. |
|
Cílová adresa URL
|
links.url | uri |
Cílová adresa URL, na kterou se krátký odkaz přesměruje. |
|
Odstraněno
|
links.deleted | boolean |
Jestli je odkaz v koši. |
|
Identifikátor pracovního prostoru
|
links.workspace_id | integer |
Identifikátor pracovního prostoru. |
|
Veřejná analýza
|
links.public_analytics | boolean |
Určuje, jestli je analytická stránka odkazu veřejně zobrazitelná. |
|
Zdroj UTM
|
links.utm_source | string |
Parametr utm_source připojený k cílové adrese URL. |
|
Slug
|
links.slug | string |
Vlastní cesta pro krátký odkaz. Musí začínat lomítkem. |
|
Doména
|
links.domain | string |
Vlastní doména, která se má použít pro krátký odkaz, bez koncového lomítka. |
|
Předávané parametry
|
links.forward_params | boolean |
Určuje, jestli se mají parametry dotazu předávat z krátkého odkazu na cíl. |
|
UTM Medium
|
links.utm_medium | string |
Parametr utm_medium připojený k cílové adrese URL. |
|
Hlavní značky
|
links.head_tags | string |
Vlastní značky HTML nebo sledování vložené do hlavy stránky přesměrování |
|
ID značky Google Analytics 4
|
links.ga4_tag_id | string |
ID měření Google Analytics 4 se aktivuje po kliknutí na odkaz. |
|
Termín UTM
|
links.utm_term | string |
Parametr utm_term připojený k cílové adrese URL. |
|
Kampaň UTM
|
links.utm_campaign | string |
Parametr utm_campaign připojený k cílové adrese URL. |
|
Lidské kliknutí včera
|
links.human_clicks_previous_day | integer |
Klikne včera (UTC) bez signálu robota. |
|
Číslo stránky
|
page_number | integer |
Číslo aktuální stránky. |
|
Velikost stránky
|
page_size | integer |
Počet odkazů, které se mají vrátit na stránku. |
|
Celkový počet položek
|
total_entries | integer |
Celkový počet odkazů odpovídajících požadavku |
|
Total Pages
|
total_pages | integer |
Celkový počet dostupných stránek. |
|
Celkový počet řádků
|
total_rows | integer |
Celkový počet řádků. |
|
Počet propojení pracovního prostoru
|
workspace_link_count | integer |
Celkový počet odkazů v pracovním prostoru |
Odstranění odkazu
Přesune odkaz do koše. Jeho krátká adresa URL se zastaví přesměrování a odkaz lze obnovit později z koše.
Parametry
| Název | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Pracovní prostor, ve který se má pracovat. Vyberte ho ze seznamu nebo zadejte jeho ID. |
|
ID odkazu
|
id | True | integer |
ID odkazu. |
Návraty
Potvrzovací zpráva
- response
- string
Převody seznamů
Vrátí nejnovější převody zaznamenané v pracovním prostoru.
Parametry
| Název | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Limit
|
limit | integer |
Maximální počet převodů, které se mají vrátit, mezi 1 a 1000. |
Návraty
| Název | Cesta | Typ | Description |
|---|---|---|---|
|
Conversions
|
conversions | array of object |
Převody, poslední první. |
|
Amount (Cents)
|
conversions.amount_cents | integer |
Hodnota v nejmenší měně. Může být negativní pro zaznamenání refundace. |
|
Klikněte na ID.
|
conversions.click_id | string |
ID atributu kliknutí. |
|
Country
|
conversions.country | string |
Dvoumísmenný kód země ISO 3166-1, například USA. |
|
Měna
|
conversions.currency | string |
Kód měny ISO 4217. Výchozí hodnota je USD. |
|
ID události
|
conversions.event_id | string |
Váš identifikátor události. Při generování zprávy o stejné hodnotě dvakrát nedojde k vytvoření druhého převodu. |
|
Název události
|
conversions.event_name | string |
Co se stalo, například nákup, registrace nebo trial_started. |
|
Typ události
|
conversions.event_type | string |
Hrubý typ události. Použijte potenciálního zákazníka k vytvoření identity zákazníka a prodeje za účelem zaznamenání výnosů. Výchozí hodnota je vlastní. |
|
ID zákazníka
|
conversions.external_id | string |
Váš identifikátor zákazníka. Odešlete ji při každé události, aby bylo možné později propojit prodej s původním kliknutím. |
|
ID převodu
|
conversions.id | string |
Jedinečný identifikátor převodu. ID se řadí chronologicky. |
|
Vloženo do
|
conversions.inserted_at | date-time |
Po zaznamenání převodu. |
|
Zdroj IP adres
|
conversions.ip_source | string |
Jejíž adresa byla zaznamenána: návštěvník, server nebo neznámý. Server znamená, že připojovací adresa patří do vašeho back-endu nebo přenosu platformy, takže je vyloučená z geografického hlášení. |
|
ID odkazu
|
conversions.link_id | integer |
ID atributového odkazu nebo null, pokud převod nelze přiřadit propojení. |
|
Metadata
|
conversions.metadata | object |
Libovolná metadata JSON, až 10 000 bajtů |
|
Došlo k
|
conversions.occurred_at | date-time |
Při převodu ve formátu ISO 8601. Výchozí hodnota je teď. |
|
Source
|
conversions.source | string |
Která integrace ji ohlásila. |
Vytvoření nebo aktualizace odkazu
Vytvoří nový krátký odkaz nebo aktualizuje existující odkaz při zadání ID odkazu. Podporuje vlastní domény a slugy, parametry UTM, retargeting pixely a metadata Open Graphu.
Parametry
| Název | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Cílová adresa URL
|
url | uri |
Cílová adresa URL, na kterou se krátký odkaz přesměruje. Vyžaduje se k vytvoření nového odkazu. |
|
|
ID odkazu
|
id | integer |
ID existujícího odkazu, který se má aktualizovat. Pokud chcete vytvořit nový odkaz, ponechte prázdné. |
|
|
Name
|
name | string |
Přezdívka odkazu zobrazená na řídicím panelu |
|
|
Doména
|
domain | string |
Vlastní doména, která se má použít pro krátký odkaz, bez koncového lomítka. |
|
|
Slug
|
slug | string |
Vlastní cesta pro krátký odkaz. Musí začínat lomítkem. |
|
|
Enabled
|
enabled | boolean |
Určuje, jestli je odkaz aktivní. |
|
|
Note
|
note | string |
Soukromá poznámka o odkazu. |
|
|
Zdroj UTM
|
utm_source | string |
Parametr utm_source připojený k cílové adrese URL. |
|
|
UTM Medium
|
utm_medium | string |
Parametr utm_medium připojený k cílové adrese URL. |
|
|
Kampaň UTM
|
utm_campaign | string |
Parametr utm_campaign připojený k cílové adrese URL. |
|
|
Obsah UTM
|
utm_content | string |
Parametr utm_content připojený k cílové adrese URL. |
|
|
Termín UTM
|
utm_term | string |
Parametr utm_term připojený k cílové adrese URL. |
|
|
ID meta pixelu
|
fb_pixel_id | string |
ID pixelu meta (Facebook) se aktivuje po kliknutí na odkaz. |
|
|
ID značky Google Analytics 4
|
ga4_tag_id | string |
ID měření Google Analytics 4 se aktivuje po kliknutí na odkaz. |
|
|
ID Správce značek Google
|
gtm_id | string |
ID kontejneru Správce značek Google, které se má načíst po kliknutí na odkaz. |
|
|
Blokovat roboty
|
block_bots | boolean |
Jestli chcete blokovat známé roboty za odkazem. |
|
|
Značky textu
|
body_tags | string |
Vlastní značky HTML nebo sledování vložené do textu stránky přesměrování |
|
|
Cloaking
|
cloaking | boolean |
Zda chcete cíl skrýt tak, že ho otevřete uvnitř rámce. |
|
|
Předávané parametry
|
forward_params | boolean |
Určuje, jestli se mají parametry dotazu předávat z krátkého odkazu na cíl. |
|
|
Hlavní značky
|
head_tags | string |
Vlastní značky HTML nebo sledování vložené do hlavy stránky přesměrování |
|
|
Skrýt referrer
|
hide_referrer | boolean |
Zda chcete skrýt odkazující z cílové lokality. |
|
|
Otevřít popis grafu
|
og_description | string |
Popis zobrazený při sdílení odkazu na sociálních sítích. |
|
|
Otevřít obrázek grafu
|
og_image | string |
Adresa URL obrázku zobrazená při sdílení odkazu na sociálních sítích. |
|
|
Otevřít název grafu
|
og_title | string |
Název zobrazený při sdílení odkazu na sociálních sítích. |
|
|
ID pixelu TikTok
|
tiktok_pixel_id | string |
Id pixelu TikTok se aktivuje po kliknutí na odkaz. |
Návraty
| Název | Cesta | Typ | Description |
|---|---|---|---|
|
ID meta pixelu
|
fb_pixel_id | string |
ID pixelu meta (Facebook) se aktivuje po kliknutí na odkaz. |
|
ID partnera LinkedIn
|
linkedin_partner_id | string |
Po kliknutí na odkaz se aktivuje ID partnera LinkedIn Insight Tag. |
|
ID značky UET Microsoft
|
microsoft_uet_tag_id | string |
Id značky UET Microsoft Advertising se aktivuje po kliknutí na odkaz. |
|
ID pixelu Reddit
|
reddit_pixel_id | string |
ID reddit pixelu se aktivuje po kliknutí na odkaz. |
|
ID pixelu TikTok
|
tiktok_pixel_id | string |
Id pixelu TikTok se aktivuje po kliknutí na odkaz. |
|
Skrýt referrer
|
hide_referrer | boolean |
Zda chcete skrýt odkazující z cílové lokality. |
|
Datum vypršení platnosti
|
expiry_datetime | string |
Když propojení přestane fungovat, ve formátu ISO 8601. |
|
Cíl vypršení platnosti
|
expiry_destination | uri |
Adresa URL, na která se má přesměrovat po vypršení platnosti odkazu. Pokud chcete vrátit stránku, která nebyla nalezena, ponechte prázdnou hodnotu. |
|
X Pixel ID
|
twitter_pixel_id | string |
ID pixelu X (Twitter) se aktivuje po kliknutí na odkaz. |
|
Cloaking
|
cloaking | boolean |
Zda chcete cíl skrýt tak, že ho otevřete uvnitř rámce. |
|
Krátká adresa URL
|
full_url | uri |
Úplná krátká adresa URL odkazu. |
|
Otevřít popis grafu
|
og_description | string |
Popis zobrazený při sdílení odkazu na sociálních sítích. |
|
Přeskočit sledování prohledávacího modulu pro sociální sítě
|
skip_social_crawler_tracking | boolean |
Zda chcete vyloučit prohledávací moduly náhledu sociálních médií ze sledování kliknutí. |
|
Značky textu
|
body_tags | string |
Vlastní značky HTML nebo sledování vložené do textu stránky přesměrování |
|
Otevřít název grafu
|
og_title | string |
Název zobrazený při sdílení odkazu na sociálních sítích. |
|
Note
|
note | string |
Soukromá poznámka o odkazu. |
|
Name
|
name | string |
Přezdívka odkazu zobrazená na řídicím panelu |
|
ID odkazu
|
id | integer |
ID existujícího odkazu, který se má aktualizovat. Pokud chcete vytvořit nový odkaz, ponechte prázdné. |
|
ID Správce značek Google
|
gtm_id | string |
ID kontejneru Správce značek Google, které se má načíst po kliknutí na odkaz. |
|
Otevřít obrázek grafu
|
og_image | string |
Adresa URL obrázku zobrazená při sdílení odkazu na sociálních sítích. |
|
Blokovat roboty
|
block_bots | boolean |
Jestli chcete blokovat známé roboty za odkazem. |
|
Snapchat Pixel ID
|
snapchat_pixel_id | string |
Při kliknutí na odkaz se aktivuje ID funkce Snapchat Pixel. |
|
Obsah UTM
|
utm_content | string |
Parametr utm_content připojený k cílové adrese URL. |
|
Enabled
|
enabled | boolean |
Určuje, jestli je odkaz aktivní. |
|
Cílová adresa URL
|
url | uri |
Cílová adresa URL, na kterou se krátký odkaz přesměruje. Vyžaduje se k vytvoření nového odkazu. |
|
Odstraněno
|
deleted | boolean |
Jestli je odkaz v koši. |
|
Webhooks
|
webhooks | array of string |
Adresy URL webhooků, které se přihlásily k odběru kliknutí na tento odkaz. |
|
Kliknutí na konec platnosti
|
expiry_clicks | integer |
Počet kliknutí, po kterých odkaz přestane fungovat. |
|
Oznámit časovou rezervu
|
notify_slack | boolean |
Zda se má odeslat oznámení Slack po kliknutí na odkaz. |
|
Identifikátor pracovního prostoru
|
workspace_id | integer |
Identifikátor pracovního prostoru. |
|
Veřejná analýza
|
public_analytics | boolean |
Určuje, jestli je analytická stránka odkazu veřejně zobrazitelná. |
|
ID značky Pinterestu
|
pinterest_tag_id | string |
ID značky Pinterestu se aktivuje po kliknutí na odkaz. |
|
Zdroj UTM
|
utm_source | string |
Parametr utm_source připojený k cílové adrese URL. |
|
Slug
|
slug | string |
Vlastní cesta pro krátký odkaz. Musí začínat lomítkem. |
|
Doména
|
domain | string |
Vlastní doména, která se má použít pro krátký odkaz, bez koncového lomítka. |
|
Předávané parametry
|
forward_params | boolean |
Určuje, jestli se mají parametry dotazu předávat z krátkého odkazu na cíl. |
|
UTM Medium
|
utm_medium | string |
Parametr utm_medium připojený k cílové adrese URL. |
|
Hlavní značky
|
head_tags | string |
Vlastní značky HTML nebo sledování vložené do hlavy stránky přesměrování |
|
ID značky Google Analytics 4
|
ga4_tag_id | string |
ID měření Google Analytics 4 se aktivuje po kliknutí na odkaz. |
|
Termín UTM
|
utm_term | string |
Parametr utm_term připojený k cílové adrese URL. |
|
Kampaň UTM
|
utm_campaign | string |
Parametr utm_campaign připojený k cílové adrese URL. |
Výpis pracovních prostorů
Vrátí pracovní prostory dostupné pro toto připojení. Použijte ho k vyhledání pracovního prostoru, který vyžadují jiné akce.
Návraty
| Název | Cesta | Typ | Description |
|---|---|---|---|
|
|
array of object | ||
|
Identifikátor pracovního prostoru
|
id | integer |
Jedinečný identifikátor pracovního prostoru. |
|
Název pracovního prostoru
|
name | string |
Název pracovního prostoru. |
Výpis vlastních domén
Vrátí vlastní domény nakonfigurované pro pracovní prostor. Tyto názvy domén lze použít při vytváření odkazů.
Parametry
| Název | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Pracovní prostor, ve který se má pracovat. Vyberte ho ze seznamu nebo zadejte jeho ID. |
Návraty
| Název | Cesta | Typ | Description |
|---|---|---|---|
|
Domains
|
domains | array of object |
Vlastní domény v pracovním prostoru. |
|
Název domény
|
domains.name | string |
Název domény, například go.yourcompany.com. |
Získat odkaz
Načte jeden odkaz podle id, včetně cíle, krátké adresy URL a konfigurace.
Parametry
| Název | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID odkazu
|
id | True | string |
ID odkazu. |
Návraty
| Název | Cesta | Typ | Description |
|---|---|---|---|
|
ID meta pixelu
|
fb_pixel_id | string |
ID pixelu meta (Facebook) se aktivuje po kliknutí na odkaz. |
|
ID partnera LinkedIn
|
linkedin_partner_id | string |
Po kliknutí na odkaz se aktivuje ID partnera LinkedIn Insight Tag. |
|
ID značky UET Microsoft
|
microsoft_uet_tag_id | string |
Id značky UET Microsoft Advertising se aktivuje po kliknutí na odkaz. |
|
ID pixelu Reddit
|
reddit_pixel_id | string |
ID reddit pixelu se aktivuje po kliknutí na odkaz. |
|
ID pixelu TikTok
|
tiktok_pixel_id | string |
Id pixelu TikTok se aktivuje po kliknutí na odkaz. |
|
Skrýt referrer
|
hide_referrer | boolean |
Zda chcete skrýt odkazující z cílové lokality. |
|
Datum vypršení platnosti
|
expiry_datetime | string |
Když propojení přestane fungovat, ve formátu ISO 8601. |
|
Cíl vypršení platnosti
|
expiry_destination | uri |
Adresa URL, na která se má přesměrovat po vypršení platnosti odkazu. Pokud chcete vrátit stránku, která nebyla nalezena, ponechte prázdnou hodnotu. |
|
X Pixel ID
|
twitter_pixel_id | string |
ID pixelu X (Twitter) se aktivuje po kliknutí na odkaz. |
|
Cloaking
|
cloaking | boolean |
Zda chcete cíl skrýt tak, že ho otevřete uvnitř rámce. |
|
Krátká adresa URL
|
full_url | uri |
Úplná krátká adresa URL odkazu. |
|
Otevřít popis grafu
|
og_description | string |
Popis zobrazený při sdílení odkazu na sociálních sítích. |
|
Přeskočit sledování prohledávacího modulu pro sociální sítě
|
skip_social_crawler_tracking | boolean |
Zda chcete vyloučit prohledávací moduly náhledu sociálních médií ze sledování kliknutí. |
|
Značky textu
|
body_tags | string |
Vlastní značky HTML nebo sledování vložené do textu stránky přesměrování |
|
Otevřít název grafu
|
og_title | string |
Název zobrazený při sdílení odkazu na sociálních sítích. |
|
Note
|
note | string |
Soukromá poznámka o odkazu. |
|
Name
|
name | string |
Přezdívka odkazu zobrazená na řídicím panelu |
|
ID odkazu
|
id | integer |
Jedinečný identifikátor odkazu. |
|
ID Správce značek Google
|
gtm_id | string |
ID kontejneru Správce značek Google, které se má načíst po kliknutí na odkaz. |
|
Otevřít obrázek grafu
|
og_image | string |
Adresa URL obrázku zobrazená při sdílení odkazu na sociálních sítích. |
|
Blokovat roboty
|
block_bots | boolean |
Jestli chcete blokovat známé roboty za odkazem. |
|
Snapchat Pixel ID
|
snapchat_pixel_id | string |
Při kliknutí na odkaz se aktivuje ID funkce Snapchat Pixel. |
|
Obsah UTM
|
utm_content | string |
Parametr utm_content připojený k cílové adrese URL. |
|
Enabled
|
enabled | boolean |
Určuje, jestli je odkaz aktivní. |
|
Cílová adresa URL
|
url | uri |
Cílová adresa URL, na kterou se krátký odkaz přesměruje. |
|
Odstraněno
|
deleted | boolean |
Jestli je odkaz v koši. |
|
Webhooks
|
webhooks | array of string |
Adresy URL webhooků, které se přihlásily k odběru kliknutí na tento odkaz. |
|
Kliknutí na konec platnosti
|
expiry_clicks | integer |
Počet kliknutí, po kterých odkaz přestane fungovat. |
|
Oznámit časovou rezervu
|
notify_slack | boolean |
Zda se má odeslat oznámení Slack po kliknutí na odkaz. |
|
Identifikátor pracovního prostoru
|
workspace_id | integer |
Identifikátor pracovního prostoru. |
|
Veřejná analýza
|
public_analytics | boolean |
Určuje, jestli je analytická stránka odkazu veřejně zobrazitelná. |
|
ID značky Pinterestu
|
pinterest_tag_id | string |
ID značky Pinterestu se aktivuje po kliknutí na odkaz. |
|
Zdroj UTM
|
utm_source | string |
Parametr utm_source připojený k cílové adrese URL. |
|
Slug
|
slug | string |
Vlastní cesta pro krátký odkaz. Musí začínat lomítkem. |
|
Doména
|
domain | string |
Vlastní doména, která se má použít pro krátký odkaz, bez koncového lomítka. |
|
Předávané parametry
|
forward_params | boolean |
Určuje, jestli se mají parametry dotazu předávat z krátkého odkazu na cíl. |
|
UTM Medium
|
utm_medium | string |
Parametr utm_medium připojený k cílové adrese URL. |
|
Hlavní značky
|
head_tags | string |
Vlastní značky HTML nebo sledování vložené do hlavy stránky přesměrování |
|
ID značky Google Analytics 4
|
ga4_tag_id | string |
ID měření Google Analytics 4 se aktivuje po kliknutí na odkaz. |
|
Termín UTM
|
utm_term | string |
Parametr utm_term připojený k cílové adrese URL. |
|
Kampaň UTM
|
utm_campaign | string |
Parametr utm_campaign připojený k cílové adrese URL. |
Získání analýzy kliknutí
Vrátí počet kliknutí v průběhu času pro pracovní prostor nebo pro konkrétní odkazy, volitelně filtrované podle rozsahu dat, země, prohlížeče, platformy, refereru nebo isP.
Parametry
| Název | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Pracovní prostor, ve který se má pracovat. Vyberte ho ze seznamu nebo zadejte jeho ID. |
|
ID odkazu
|
link_id | string |
ID jednoho odkazu pro filtrování podle. |
|
|
ID odkazů
|
link_ids | string |
Seznam ID propojení oddělených spojovníkem, podle které chcete filtrovat. |
|
|
Počáteční datum
|
start | string |
Začátek rozsahu kalendářních dat ve formátu RRRR-MM-DD. |
|
|
Koncové datum
|
end | string |
Konec rozsahu dat ve formátu RRRR-MM-DD. |
|
|
Country
|
country | string |
Dvoumísmenný kód země ISO 3166-1, například USA. |
|
|
Browser
|
browser | string |
Název prohlížeče, podle který chcete filtrovat, například Chrome, Firefox nebo Safari. |
|
|
Platform
|
platform | string |
Platforma nebo operační systém, podle které se má filtrovat, například Windows, Mac, iOS nebo Android. |
|
|
Odkazující
|
referer | string |
Odkazující doména pro filtrování podle. |
|
|
poskytovatel internetových služeb
|
isp | string |
Název poskytovatele internetových služeb, podle které chcete filtrovat. |
|
|
Zahrnout roboty
|
bots | boolean |
Zda se mají zahrnout kliknutí identifikovaná jako roboti. Pokud je chcete vyloučit, nastavte na hodnotu false. |
|
|
Pouze jedinečné
|
unique | boolean |
Určuje, jestli se mají spočítat pouze jedinečná kliknutí. |
|
|
Časová zóna
|
timezone | string |
Časové pásmo IANA používané pro výpočty kalendářních dat, například Evropa/Londýn. |
|
|
Frekvence
|
frequency | string |
Členitost časové řady( den nebo hodina). |
Návraty
| Název | Cesta | Typ | Description |
|---|---|---|---|
|
Traffic
|
traffic | array of object |
Kliknutí se počítá v průběhu času. |
|
Bucket Start
|
traffic.t | string |
Začátek kbelíku: YYYY-MM-DD pro denní kbelíky nebo YYYY-MM-DDTHH:MM:SS pro hodinové kbelíky. |
|
Kliknutí
|
traffic.y | integer |
Počet kliknutí v kontejneru. |
Získání počtu kliknutí podle dimenze
Vrátí počty kliknutí seskupené podle dimenze, jako je země, město, platforma, referrer nebo parametr UTM seřazené sestupně podle počtu.
Parametry
| Název | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Pracovní prostor, ve který se má pracovat. Vyberte ho ze seznamu nebo zadejte jeho ID. |
|
Dimension
|
counter | True | string |
Dimenze pro seskupení kliknutí podle země, města, platformy, refereru nebo utm_campaign. |
|
ID odkazu
|
link_id | string |
ID jednoho odkazu pro filtrování podle. |
|
|
ID odkazů
|
link_ids | string |
Seznam ID propojení oddělených spojovníkem, podle které chcete filtrovat. |
|
|
Počáteční datum
|
start | string |
Začátek rozsahu kalendářních dat ve formátu RRRR-MM-DD. |
|
|
Koncové datum
|
end | string |
Konec rozsahu dat ve formátu RRRR-MM-DD. |
|
|
Country
|
country | string |
Dvoumísmenný kód země ISO 3166-1, například USA. |
|
|
Zahrnout roboty
|
bots | boolean |
Zda se mají zahrnout kliknutí identifikovaná jako roboti. Pokud je chcete vyloučit, nastavte na hodnotu false. |
|
|
Pouze jedinečné
|
unique | boolean |
Určuje, jestli se mají spočítat pouze jedinečná kliknutí. |
Návraty
| Název | Cesta | Typ | Description |
|---|---|---|---|
|
Total
|
total | integer |
Total clicks across all groups, including any not return in values. Pokud je výsledek zkrácený, je větší než součet počtu v hodnotách, takže počet / součet stále poskytuje přesné procento. |
|
Values
|
values | array of object |
Seskupené počty seřazené podle počtu sestupně. Zkráceno na prvních 10 000 hodnot; pokud má dimenze více jedinečných hodnot, zbytek se nevrátí. |
|
Počet
|
values.count | integer |
Počet kliknutí pro tuto hodnotu. |
|
Value
|
values.value | string |
Hodnota dimenze, například kód země. |
Definice
řetězec
Toto je základní datový typ String.