Länka (förhandsversion)
Linkly är en länkförkortare och klickspårare. Skapa märkesbaserade korta länkar med anpassade domäner, lägg till UTM-parametrar och ommåla pixlar, rapportkonverteringar och dra klickanalys grupperat efter land, plattform, referent eller kampanj.
Den här anslutningsappen är tillgänglig i följande produkter och regioner:
| Tjänst | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alla Power Automate regioner förutom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Logiska appar | Standard | Alla Logic Apps-regioner utom följande: - Azure Government regioner - Azure kinaregioner - US Department of Defense (DoD) |
| Power Apps | Premium | Alla Power Apps regioner förutom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alla Power Automate regioner förutom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Länkstöd |
| URL | https://linklyhq.com/support |
| support@linklyhq.com |
| Metadata för anslutningsprogram | |
|---|---|
| Publisher | Länka |
| Webbplats | https://linklyhq.com |
| Sekretesspolicy | https://linklyhq.com/support/privacy |
| Kategorier | Marknadsföring; Webbplats |
Länka
Linkly är en länkförkortare och klickspårare. Den skapar märkesbaserade korta länkar på din egen domän, spårar varje klick med land, plattforms- och referensuppdelningar, utlöser retargeting-pixlar och registrerar konverteringar tillbaka till länken som producerade dem. Med den här anslutningsappen kan flöden skapa och hantera länkar, hämta klickanalys och rapportkonverteringar på en Linkly-arbetsyta.
Publisher: Länk
Prerequisites
Ett Linkly-konto . Den kostnadsfria planen räcker för att använda varje åtgärd i den här anslutningsappen. Rapportering och listning av konverteringar kräver också att funktionen Länkkonverteringsspårning är aktiverad på arbetsytan.
Åtgärder som stöds
Visa en lista över arbetsytor
Returnerar de arbetsytor som är tillgängliga för den här anslutningen. Använd den för att hitta den arbetsyta som andra åtgärder kräver.
Skapa eller uppdatera en länk
Skapar en ny kort länk eller uppdaterar en befintlig när ett länk-ID anges. Stöder anpassade domäner och sniglar, UTM-parametrar, retargeting pixels och Open Graph metadata.
Hämta en länk
Hämtar en enda länk med sitt ID, inklusive mål, kort URL och konfiguration.
Listlänkar
Returnerar en sidnumrerad lista över länkarna i en arbetsyta med klickstatistik. Stöder sökning och sortering.
Ta bort en länk
Flyttar en länk till papperskorgen. Den korta URL:en slutar omdirigeras och länken kan återställas senare från papperskorgen.
Hämta klickanalys
Returnerar antal klick över tid för en arbetsyta eller för specifika länkar, eventuellt filtrerade efter datumintervall, land, webbläsare, plattform, referent eller ISP.
Hämta antal klick per dimension
Returnerar klickantal grupperade efter en dimension, till exempel land, stad, plattform, referent eller UTM-parameter, ordnade efter antal fallande.
Lista anpassade domäner
Returnerar de anpassade domäner som konfigurerats för en arbetsyta. Dessa domännamn kan användas när du skapar länkar.
Rapportera en konvertering
Registrerar en konvertering, till exempel ett köp, en registrering eller en anpassad händelse, och tillskriver den till länken som klickades när en attributionstoken angavs.
Lista konverteringar
Returnerar de senaste konverteringarna som registrerats på arbetsytan.
Hämta autentiseringsuppgifter
Den här anslutningsappen använder OAuth 2.0. Ingen API-nyckel behövs.
- Om du inte har något Linkly-konto än registrerar du dig på https://linklyhq.com. Den kostnadsfria planen fungerar.
- När du skapar en anslutning väljer du Logga in med Linkly och loggar in med ditt Linkly-konto.
- Välj den arbetsyta som den här anslutningen ska använda när du uppmanas att göra det och godkänn sedan begäran.
Anslutningen är bunden till den arbetsyta som du har valt. Om du vill arbeta på en annan arbetsyta skapar du en andra anslutning.
Getting Started
- Skapa en anslutning enligt beskrivningen ovan.
- Lägg till åtgärden Skapa eller uppdatera en länk till ett flöde, ange mål-URL:en och, om du vill, en anpassad domän och en snigel. Åtgärden returnerar den korta URL:en och länk-ID:t.
- Använd Listlänkar, Hämta klickanalys eller Hämta antal klick per dimension för att läsa klicka på data. Med åtgärder som utför en arbetsyta kan du välja den från en lista, som fylls i av List-arbetsytor.
- Om du vill tilldela köp eller registreringar till länkar skickar
linkly_ciddu värdet från landningssidans URL till Rapportera en konvertering som attributtoken.
Kända problem och begränsningar
- En anslutning är bunden till en enda Linkly-arbetsyta, den som valdes när du loggar in. Skapa en anslutning per arbetsyta.
- Rapportera en konvertering och listkonverteringar kräver funktionen Länkkonverteringsspårning. Arbetsytor utan det får ett fel från dessa åtgärder.
- Realtidsklicka på webhooks exponeras inte som utlösare. Använd Linklys webhook-funktion med ett HTTP-utlöst flöde i stället.
- Masslänkskapande, länkexport och domänhantering är tillgängliga i Linkly API men ingår inte i den här anslutningsappen.
- API:et är hastighetsbegränsade. Get click counts by dimension returns a rate-limit error when the limit is exceeded; försök igen efter en kort fördröjning.
Vanliga frågor och svar
Vilken arbetsyta körs mina åtgärder i?
Åtgärder som utför en arbetsyteparameter visar en lista över de arbetsytor som är tillgängliga för anslutningen. Åtgärder utan en, till exempel Hämta en länk, Rapportera en konvertering och Listkonverteringar, använder arbetsytan som är bunden till anslutningen.
Hur använder jag en anpassad domän?
Lägg först till domänen i Linkly och skicka sedan dess namn i fältet Domän i Skapa eller uppdatera en länk. Listan med anpassade domäner returnerar de namn som är tillgängliga på en arbetsyta.
Tar ta bort en länk bort länken permanent?
No. Länken flyttas till papperskorgen och slutar omdirigeras. Den kan återställas från papperskorgen i Linkly.
Distributionsinstruktioner
- Öppna Anpassade anslutningsappar i maker-portalen, välj Ny anpassad anslutningsapp och sedan Importera en OpenAPI-fil. Välj
apiDefinition.swagger.json. - På fliken Säkerhet väljer du OAuth 2.0 med den generiska Oauth 2-identitetsprovidern . Ange klient-ID och klienthemlighet som utfärdats av Linkly, ange auktoriserings-URL:en till
https://app.linklyhq.com/oauth/authorizeoch ange både token-URL:en och uppdaterings-URL:en tillhttps://app.linklyhq.com/oauth/token. - Skapa anslutningsappen och kopiera sedan omdirigerings-URL:en som visas på fliken Säkerhet och registrera den med Linkly för det klient-ID:t.
- Skapa en anslutning genom att logga in med ditt Linkly-konto och testa sedan en åtgärd, till exempel Lista arbetsytor.
Åtgärder
| Hämta antal klick per dimension |
Returnerar klickantal grupperade efter en dimension, till exempel land, stad, plattform, referent eller UTM-parameter, ordnade efter antal fallande. |
| Hämta en länk |
Hämtar en enda länk med sitt ID, inklusive mål, kort URL och konfiguration. |
| Hämta klickanalys |
Returnerar antal klick över tid för en arbetsyta eller för specifika länkar, eventuellt filtrerade efter datumintervall, land, webbläsare, plattform, referent eller ISP. |
| Lista anpassade domäner |
Returnerar de anpassade domäner som konfigurerats för en arbetsyta. Dessa domännamn kan användas när du skapar länkar. |
| Lista konverteringar |
Returnerar de senaste konverteringarna som registrerats på arbetsytan. |
| Listlänkar |
Returnerar en sidnumrerad lista över länkarna i en arbetsyta med klickstatistik. Stöder sökning och sortering. |
| Rapportera en konvertering |
Registrerar en konvertering, till exempel ett köp, en registrering eller en anpassad händelse, och tillskriver den till länken som klickades när en attributionstoken angavs. |
| Skapa eller uppdatera en länk |
Skapar en ny kort länk eller uppdaterar en befintlig när ett länk-ID anges. Stöder anpassade domäner och sniglar, UTM-parametrar, retargeting pixels och Open Graph metadata. |
| Ta bort en länk |
Flyttar en länk till papperskorgen. Den korta URL:en slutar omdirigeras och länken kan återställas senare från papperskorgen. |
| Visa en lista över arbetsytor |
Returnerar de arbetsytor som är tillgängliga för den här anslutningen. Använd den för att hitta den arbetsyta som andra åtgärder kräver. |
Hämta antal klick per dimension
Returnerar klickantal grupperade efter en dimension, till exempel land, stad, plattform, referent eller UTM-parameter, ordnade efter antal fallande.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Arbetsytan som ska arbetas i. Välj det i listan eller ange dess ID. |
|
Dimension
|
counter | True | string |
Dimensionen som ska grupperas klickar efter, till exempel land, stad, plattform, referent eller utm_campaign. |
|
Länk-ID
|
link_id | string |
ID:t för en enda länk som ska filtreras efter. |
|
|
Länk-ID:t
|
link_ids | string |
En bindestrecksavgränsad lista över länk-ID:t som ska filtreras efter. |
|
|
Startdatum
|
start | string |
Början av datumintervallet i YYYY-MM-DD format. |
|
|
Slutdatum
|
end | string |
Slutet av datumintervallet i YYYY-MM-DD format. |
|
|
Country
|
country | string |
En landskod med två bokstäver, ISO 3166-1, till exempel USA. |
|
|
Inkludera robotar
|
bots | boolean |
Om du vill inkludera klick som identifieras som robotar. Ange till false för att exkludera dem. |
|
|
Endast unikt
|
unique | boolean |
Om endast unika klick ska räknas. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Total
|
total | integer |
Totalt antal klick i alla grupper, inklusive alla som inte returneras i värden. När resultatet trunkeras är detta större än summan av antalet i värden, så antalet/summan ger fortfarande en korrekt procentandel. |
|
Värden
|
values | array of object |
Grupperade antal, ordnade efter antal fallande. Trunkerade till de översta 10 000 värdena. Om dimensionen har fler distinkta värden än så returneras inte resten. |
|
Antal
|
values.count | integer |
Antalet klick för det här värdet. |
|
Value
|
values.value | string |
Värdet för dimensionen, till exempel en landskod. |
Hämta en länk
Hämtar en enda länk med sitt ID, inklusive mål, kort URL och konfiguration.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Länk-ID
|
id | True | string |
ID:t för länken. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Meta pixel-ID
|
fb_pixel_id | string |
Meta (Facebook) Pixel-ID som ska utlösas när länken klickas. |
|
LinkedIn Partner-ID
|
linkedin_partner_id | string |
Partner-ID:t LinkedIn Insight Tag när länken klickas. |
|
Microsoft UET-tagg-ID
|
microsoft_uet_tag_id | string |
Det Microsoft Advertising UET-tagg-ID som ska utlösas när länken klickas. |
|
Reddit Pixel-ID
|
reddit_pixel_id | string |
Reddit Pixel-ID:t som ska utlösas när länken klickas. |
|
TikTok Pixel-ID
|
tiktok_pixel_id | string |
Det TikTok Pixel-ID som ska utlösas när länken klickas. |
|
Dölj referens
|
hide_referrer | boolean |
Om du vill dölja referensen från målwebbplatsen. |
|
Förfallodatum
|
expiry_datetime | string |
När länken slutar fungera, i ISO 8601-format. |
|
Mål för förfallodatum
|
expiry_destination | uri |
URL:en som ska omdirigeras till när länken har upphört att gälla. Lämna tomt för att returnera en sida som inte hittades. |
|
X Pixel-ID
|
twitter_pixel_id | string |
X (Twitter) Pixel-ID som ska utlösas när länken klickas. |
|
Kamouflage
|
cloaking | boolean |
Om målet ska döljas genom att öppna det i en ram. |
|
Kort webbadress
|
full_url | uri |
Den fullständiga korta länk-URL:en. |
|
Beskrivning av Öppna diagram
|
og_description | string |
Beskrivningen som visas när länken delas på sociala medier. |
|
Hoppa över spårning av social crawlning
|
skip_social_crawler_tracking | boolean |
Om du vill undanta crawlare för förhandsversionen av sociala medier från klickspårning. |
|
Brödtexttaggar
|
body_tags | string |
Anpassade HTML- eller spårningstaggar som infogats i omdirigeringssidans brödtext. |
|
Öppna diagramrubrik
|
og_title | string |
Rubriken som visas när länken delas på sociala medier. |
|
Note
|
note | string |
En privat anteckning om länken. |
|
Name
|
name | string |
Ett smeknamn för länken som visas på instrumentpanelen. |
|
Länk-ID
|
id | integer |
Länkens unika identifierare. |
|
Google Tag Manager-ID
|
gtm_id | string |
Google Tag Manager-container-ID:t som ska läsas in när länken klickas. |
|
Öppna grafbild
|
og_image | string |
Bild-URL:en som visas när länken delas på sociala medier. |
|
Blockera robotar
|
block_bots | boolean |
Om du vill blockera kända robotar från att följa länken. |
|
Snapchat Pixel-ID
|
snapchat_pixel_id | string |
Snapchat Pixel-ID:t som ska avfyras när länken klickas. |
|
UTM-innehåll
|
utm_content | string |
Parametern utm_content som läggs till i mål-URL:en. |
|
Enabled
|
enabled | boolean |
Om länken är aktiv. |
|
Målwebbadress
|
url | uri |
Mål-URL:en som den korta länken omdirigeras till. |
|
Borttagen
|
deleted | boolean |
Om länken finns i papperskorgen. |
|
Webhooks
|
webhooks | array of string |
Webhook-URL:erna som prenumereras på klickar på den här länken. |
|
Utgångsklick
|
expiry_clicks | integer |
Antalet klick varefter länken slutar fungera. |
|
Meddela Slack
|
notify_slack | boolean |
Om du vill skicka ett Slack-meddelande när länken klickas. |
|
Arbetsyte-ID
|
workspace_id | integer |
Arbetsområdets ID. |
|
Offentlig analys
|
public_analytics | boolean |
Om analyssidan för länken kan visas offentligt. |
|
Pinterest-tagg-ID
|
pinterest_tag_id | string |
Pinterest-tagg-ID:t som ska utlösas när länken klickas. |
|
UTM-källa
|
utm_source | string |
Parametern utm_source som läggs till mål-URL:en. |
|
Slug
|
slug | string |
En anpassad sökväg för den korta länken. Det måste börja med ett snedstreck. |
|
Domän
|
domain | string |
Den anpassade domän som ska användas för den korta länken, utan ett avslutande snedstreck. |
|
Framåtparametrar
|
forward_params | boolean |
Om frågeparametrar ska vidarebefordras från den korta länken till målet. |
|
UTM Medium
|
utm_medium | string |
Parametern utm_medium som läggs till mål-URL:en. |
|
Huvudtaggar
|
head_tags | string |
Anpassade HTML- eller spårningstaggar som infogats i omdirigeringssidans huvud. |
|
Google Analytics 4-tagg-ID
|
ga4_tag_id | string |
Google Analytics 4-mått-ID:t som ska utlösas när länken klickas. |
|
UTM-term
|
utm_term | string |
Parametern utm_term som läggs till i mål-URL:en. |
|
UTM-kampanj
|
utm_campaign | string |
Parametern utm_campaign som läggs till mål-URL:en. |
Hämta klickanalys
Returnerar antal klick över tid för en arbetsyta eller för specifika länkar, eventuellt filtrerade efter datumintervall, land, webbläsare, plattform, referent eller ISP.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Arbetsytan som ska arbetas i. Välj det i listan eller ange dess ID. |
|
Länk-ID
|
link_id | string |
ID:t för en enda länk som ska filtreras efter. |
|
|
Länk-ID:t
|
link_ids | string |
En bindestrecksavgränsad lista över länk-ID:t som ska filtreras efter. |
|
|
Startdatum
|
start | string |
Början av datumintervallet i YYYY-MM-DD format. |
|
|
Slutdatum
|
end | string |
Slutet av datumintervallet i YYYY-MM-DD format. |
|
|
Country
|
country | string |
En landskod med två bokstäver, ISO 3166-1, till exempel USA. |
|
|
Webbläsare
|
browser | string |
Ett webbläsarnamn att filtrera efter, till exempel Chrome, Firefox eller Safari. |
|
|
Platform
|
platform | string |
En plattform eller ett operativsystem som ska filtreras efter, till exempel Windows, Mac, iOS eller Android. |
|
|
Hänvisningsadress
|
referer | string |
En refererande domän att filtrera efter. |
|
|
Internetleverantör (ISP)
|
isp | string |
Ett internetleverantörsnamn att filtrera efter. |
|
|
Inkludera robotar
|
bots | boolean |
Om du vill inkludera klick som identifieras som robotar. Ange till false för att exkludera dem. |
|
|
Endast unikt
|
unique | boolean |
Om endast unika klick ska räknas. |
|
|
Tidszon
|
timezone | string |
IANA-tidszonen som används för datumberäkningar, till exempel Europa/London. |
|
|
Frekvens
|
frequency | string |
Tidsseriernas kornighet, antingen dag eller timme. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Traffic
|
traffic | array of object |
Klickningen räknas över tid. |
|
Bucketstart
|
traffic.t | string |
Bucketstart: ÅÅÅÅ -MM-DD för dagliga bucketar eller ÅÅÅÅ-MM-DDTHH:MM:SS för tim bucketar. |
|
Klick
|
traffic.y | integer |
Antalet klick i bucketen. |
Lista anpassade domäner
Returnerar de anpassade domäner som konfigurerats för en arbetsyta. Dessa domännamn kan användas när du skapar länkar.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Arbetsytan som ska arbetas i. Välj det i listan eller ange dess ID. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Domains
|
domains | array of object |
De anpassade domänerna på arbetsytan. |
|
Domännamn
|
domains.name | string |
Domännamnet, till exempel go.yourcompany.com. |
Lista konverteringar
Returnerar de senaste konverteringarna som registrerats på arbetsytan.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Limit
|
limit | integer |
Det maximala antalet konverteringar som ska returneras, mellan 1 och 1 000. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Conversions
|
conversions | array of object |
Konverteringarna, den senaste först. |
|
Belopp (cent)
|
conversions.amount_cents | integer |
Värdet i den minsta valutaenheten. Kan vara negativt att registrera en återbetalning. |
|
Klicka på ID
|
conversions.click_id | string |
ID:t för det tillskrivna klicket. |
|
Country
|
conversions.country | string |
En landskod med två bokstäver, ISO 3166-1, till exempel USA. |
|
Valuta
|
conversions.currency | string |
Valutakoden ISO 4217. Standardvärdet är USD. |
|
Händelse-ID
|
conversions.event_id | string |
Din identifierare för händelsen. Att rapportera samma värde två gånger skapar inte en andra konvertering. |
|
Händelsenamn
|
conversions.event_name | string |
Vad hände, till exempel köp, registrering eller trial_started. |
|
Händelsetyp
|
conversions.event_type | string |
Den grova händelsetypen. Använd lead för att upprätta kundidentitet och försäljning för att registrera intäkter. Standardvärdet är anpassat. |
|
Kund-ID
|
conversions.external_id | string |
Din identifierare för kunden. Skicka den på varje händelse så att senare försäljning kan länkas till det ursprungliga klicket. |
|
Konverterings-ID
|
conversions.id | string |
Den unika identifieraren för konverteringen. ID:t sorteras kronologiskt. |
|
Infogad vid
|
conversions.inserted_at | date-time |
När konverteringen registrerades. |
|
IP-källa
|
conversions.ip_source | string |
Vars adress har registrerats: besökare, server eller okänd. Server innebär att anslutningsadressen tillhör din serverdel eller ett plattformsrelä, så den undantas från geografisk rapportering. |
|
Länk-ID
|
conversions.link_id | integer |
ID:t för den tillskrivna länken eller null om konverteringen inte kunde hänföras till en länk. |
|
Metadata
|
conversions.metadata | object |
Godtyckliga JSON-metadata, upp till 10 000 byte. |
|
Inträffade vid
|
conversions.occurred_at | date-time |
När konverteringen skedde i ISO 8601-format. Nuvarande standardläge. |
|
Source
|
conversions.source | string |
Vilken integrering rapporterade det. |
Listlänkar
Returnerar en sidnumrerad lista över länkarna i en arbetsyta med klickstatistik. Stöder sökning och sortering.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Arbetsytan som ska arbetas i. Välj det i listan eller ange dess ID. |
|
Search
|
search | string |
En sökterm för att filtrera länkar efter namn, URL eller snigel. |
|
|
Sida
|
page | integer |
Sidnumret som ska returneras från och med 1. |
|
|
Sidstorlek
|
page_size | integer |
Antalet länkar som ska returneras per sida. |
|
|
Sortera efter
|
sort_by | string |
Fältet som ska sorteras efter, till exempel clicks_total, namn eller inserted_at. |
|
|
Sorteringsriktning
|
sort_dir | string |
Sorteringsriktningen, antingen asc eller desc. |
|
|
Borttagen
|
deleted | boolean |
Om du vill returnera länkar som finns i papperskorgen i stället för aktiva länkar. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Links
|
links | array of object |
Länkarna på den här sidan. |
|
Meta pixel-ID
|
links.fb_pixel_id | string |
Meta (Facebook) Pixel-ID som ska utlösas när länken klickas. |
|
Totalt antal mänskliga klick
|
links.human_clicks_total | integer |
Livslängdsklick utan robotsignal; delmängden av clicks_total där varken en robotanvändare-agent eller en kategori för verifierad robot har identifierats. Inspelad från 2019 och framåt. |
|
Klick (30 dagar)
|
links.clicks_thirty_days | integer |
Klick under de senaste 30 dagarna, inklusive robottrafik. |
|
TikTok Pixel-ID
|
links.tiktok_pixel_id | string |
Det TikTok Pixel-ID som ska utlösas när länken klickas. |
|
Dölj referens
|
links.hide_referrer | boolean |
Om du vill dölja referensen från målwebbplatsen. |
|
Kamouflage
|
links.cloaking | boolean |
Om målet ska döljas genom att öppna det i en ram. |
|
Kort webbadress
|
links.full_url | uri |
Den fullständiga korta länk-URL:en. |
|
Klick i dag
|
links.clicks_today | integer |
Klick hittills i dag (UTC), inklusive robottrafik. |
|
Beskrivning av Öppna diagram
|
links.og_description | string |
Beskrivningen som visas när länken delas på sociala medier. |
|
Brödtexttaggar
|
links.body_tags | string |
Anpassade HTML- eller spårningstaggar som infogats i omdirigeringssidans brödtext. |
|
Öppna diagramrubrik
|
links.og_title | string |
Rubriken som visas när länken delas på sociala medier. |
|
Note
|
links.note | string |
En privat anteckning om länken. |
|
Name
|
links.name | string |
Ett smeknamn för länken som visas på instrumentpanelen. |
|
Länk-ID
|
links.id | integer |
Länkens unika identifierare. |
|
Google Tag Manager-ID
|
links.gtm_id | string |
Google Tag Manager-container-ID:t som ska läsas in när länken klickas. |
|
Öppna grafbild
|
links.og_image | string |
Bild-URL:en som visas när länken delas på sociala medier. |
|
Blockera robotar
|
links.block_bots | boolean |
Om du vill blockera kända robotar från att följa länken. |
|
Totalt antal klick
|
links.clicks_total | integer |
Livstidsklick, inklusive robottrafik. |
|
Mänskliga klick (30 dagar)
|
links.human_clicks_thirty_days | integer |
Klick under de senaste 30 dagarna utan robotsignal; delmängden av clicks_thirty_days. |
|
UTM-innehåll
|
links.utm_content | string |
Parametern utm_content som läggs till i mål-URL:en. |
|
Mänskliga klick idag
|
links.human_clicks_today | integer |
Klick hittills idag (UTC) utan robotsignal. |
|
Enabled
|
links.enabled | boolean |
Om länken är aktiv. |
|
Målwebbadress
|
links.url | uri |
Mål-URL:en som den korta länken omdirigeras till. |
|
Borttagen
|
links.deleted | boolean |
Om länken finns i papperskorgen. |
|
Arbetsyte-ID
|
links.workspace_id | integer |
Arbetsområdets ID. |
|
Offentlig analys
|
links.public_analytics | boolean |
Om analyssidan för länken kan visas offentligt. |
|
UTM-källa
|
links.utm_source | string |
Parametern utm_source som läggs till mål-URL:en. |
|
Slug
|
links.slug | string |
En anpassad sökväg för den korta länken. Det måste börja med ett snedstreck. |
|
Domän
|
links.domain | string |
Den anpassade domän som ska användas för den korta länken, utan ett avslutande snedstreck. |
|
Framåtparametrar
|
links.forward_params | boolean |
Om frågeparametrar ska vidarebefordras från den korta länken till målet. |
|
UTM Medium
|
links.utm_medium | string |
Parametern utm_medium som läggs till mål-URL:en. |
|
Huvudtaggar
|
links.head_tags | string |
Anpassade HTML- eller spårningstaggar som infogats i omdirigeringssidans huvud. |
|
Google Analytics 4-tagg-ID
|
links.ga4_tag_id | string |
Google Analytics 4-mått-ID:t som ska utlösas när länken klickas. |
|
UTM-term
|
links.utm_term | string |
Parametern utm_term som läggs till i mål-URL:en. |
|
UTM-kampanj
|
links.utm_campaign | string |
Parametern utm_campaign som läggs till mål-URL:en. |
|
Mänskliga klick igår
|
links.human_clicks_previous_day | integer |
Klick igår (UTC) utan robotsignal. |
|
Sidnummer
|
page_number | integer |
Det aktuella sidnumret. |
|
Sidstorlek
|
page_size | integer |
Antalet länkar som ska returneras per sida. |
|
Totalt antal poster
|
total_entries | integer |
Det totala antalet länkar som matchar begäran. |
|
Totalt antal sidor
|
total_pages | integer |
Det totala antalet tillgängliga sidor. |
|
Totalt antal rader
|
total_rows | integer |
Det totala antalet rader. |
|
Antal länkar till arbetsyta
|
workspace_link_count | integer |
Det totala antalet länkar i arbetsytan. |
Rapportera en konvertering
Registrerar en konvertering, till exempel ett köp, en registrering eller en anpassad händelse, och tillskriver den till länken som klickades när en attributionstoken angavs.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Belopp (cent)
|
amount_cents | integer |
Värde i den minsta valutaenheten. Kan vara negativt att registrera en återbetalning eller återbetalning, som netto mot tidigare intäkter. |
|
|
Country
|
country | string |
Landskod med två bokstäver för konverteringen. Härledd för anrop på webbläsarsidan; ange den uttryckligen från en integrering på serversidan, där anslutningsadressen är din egen infrastruktur snarare än kundens. |
|
|
Valuta
|
currency | string |
ISO 4217 valutakod. Standardvärdet är USD. |
|
|
Händelse-ID
|
event_id | string |
Din identifierare för den här händelsen. Används som en idempotensnyckel; om du rapporterar samma värde två gånger skapas ingen andra konvertering. Gäller för alla händelsetyper, inte bara inköp. |
|
|
Händelsenamn
|
event_name | True | string |
Vad hände, t.ex. köp, registrering, trial_started. |
|
Händelsetyp
|
event_type | string |
Grov typ som driver tratten. lead etablerar kundidentitet, försäljning registrerar intäkter. Standardvärdet är anpassat. |
|
|
Kund-ID
|
external_id | string |
Din identifierare för kunden. Skicka den på varje händelse: det är det som länkar en senare försäljning på serversidan tillbaka till det klick som skapade registreringen. |
|
|
Attributionstoken
|
linkly_cid | string |
Attributionstoken som hämtats från landningssidans URL. Utelämna om det inte är tillgängligt; konverteringen registreras sedan utan länkattribution. |
|
|
Metadata
|
metadata | object |
Godtycklig JSON, upp till 10 000 byte kodade. |
|
|
Inträffade vid
|
occurred_at | date-time |
När konverteringen skedde. Nuvarande standardläge. |
|
|
Besökarens IP-adress
|
visitor_ip | string |
Slutkunds-IP-adressen när servern har den. Utelämna om du inte gör det; för anrop på serversidan registrerar Linkly annars anslutningsadressen som din server, inte kunden, och utesluter den från geografisk rapportering. Att skicka detta hävdar att du har en laglig grund för att dela den. Returneras aldrig av API:et. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Belopp (cent)
|
amount_cents | integer |
Värdet i den minsta valutaenheten. Kan vara negativt att registrera en återbetalning. |
|
Klicka på ID
|
click_id | string |
ID:t för det tillskrivna klicket. |
|
Country
|
country | string |
En landskod med två bokstäver, ISO 3166-1, till exempel USA. |
|
Valuta
|
currency | string |
Valutakoden ISO 4217. Standardvärdet är USD. |
|
Händelse-ID
|
event_id | string |
Din identifierare för händelsen. Att rapportera samma värde två gånger skapar inte en andra konvertering. |
|
Händelsenamn
|
event_name | string |
Vad hände, till exempel köp, registrering eller trial_started. |
|
Händelsetyp
|
event_type | string |
Den grova händelsetypen. Använd lead för att upprätta kundidentitet och försäljning för att registrera intäkter. Standardvärdet är anpassat. |
|
Kund-ID
|
external_id | string |
Din identifierare för kunden. Skicka den på varje händelse så att senare försäljning kan länkas till det ursprungliga klicket. |
|
Konverterings-ID
|
id | string |
Den unika identifieraren för konverteringen. ID:t sorteras kronologiskt. |
|
Infogad vid
|
inserted_at | date-time |
När konverteringen registrerades. |
|
IP-källa
|
ip_source | string |
Vars adress har registrerats: besökare, server eller okänd. Server innebär att anslutningsadressen tillhör din serverdel eller ett plattformsrelä, så den undantas från geografisk rapportering. |
|
Länk-ID
|
link_id | integer |
ID:t för den tillskrivna länken eller null om konverteringen inte kunde hänföras till en länk. |
|
Metadata
|
metadata | object |
Godtyckliga JSON-metadata, upp till 10 000 byte. |
|
Inträffade vid
|
occurred_at | date-time |
När konverteringen skedde i ISO 8601-format. Nuvarande standardläge. |
|
Source
|
source | string |
Vilken integrering rapporterade det. |
Skapa eller uppdatera en länk
Skapar en ny kort länk eller uppdaterar en befintlig när ett länk-ID anges. Stöder anpassade domäner och sniglar, UTM-parametrar, retargeting pixels och Open Graph metadata.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Målwebbadress
|
url | uri |
Mål-URL:en som den korta länken omdirigeras till. Krävs för att skapa en ny länk. |
|
|
Länk-ID
|
id | integer |
ID:t för en befintlig länk som ska uppdateras. Lämna tomt för att skapa en ny länk. |
|
|
Name
|
name | string |
Ett smeknamn för länken som visas på instrumentpanelen. |
|
|
Domän
|
domain | string |
Den anpassade domän som ska användas för den korta länken, utan ett avslutande snedstreck. |
|
|
Slug
|
slug | string |
En anpassad sökväg för den korta länken. Det måste börja med ett snedstreck. |
|
|
Enabled
|
enabled | boolean |
Om länken är aktiv. |
|
|
Note
|
note | string |
En privat anteckning om länken. |
|
|
UTM-källa
|
utm_source | string |
Parametern utm_source som läggs till mål-URL:en. |
|
|
UTM Medium
|
utm_medium | string |
Parametern utm_medium som läggs till mål-URL:en. |
|
|
UTM-kampanj
|
utm_campaign | string |
Parametern utm_campaign som läggs till mål-URL:en. |
|
|
UTM-innehåll
|
utm_content | string |
Parametern utm_content som läggs till i mål-URL:en. |
|
|
UTM-term
|
utm_term | string |
Parametern utm_term som läggs till i mål-URL:en. |
|
|
Meta pixel-ID
|
fb_pixel_id | string |
Meta (Facebook) Pixel-ID som ska utlösas när länken klickas. |
|
|
Google Analytics 4-tagg-ID
|
ga4_tag_id | string |
Google Analytics 4-mått-ID:t som ska utlösas när länken klickas. |
|
|
Google Tag Manager-ID
|
gtm_id | string |
Google Tag Manager-container-ID:t som ska läsas in när länken klickas. |
|
|
Blockera robotar
|
block_bots | boolean |
Om du vill blockera kända robotar från att följa länken. |
|
|
Brödtexttaggar
|
body_tags | string |
Anpassade HTML- eller spårningstaggar som infogats i omdirigeringssidans brödtext. |
|
|
Kamouflage
|
cloaking | boolean |
Om målet ska döljas genom att öppna det i en ram. |
|
|
Framåtparametrar
|
forward_params | boolean |
Om frågeparametrar ska vidarebefordras från den korta länken till målet. |
|
|
Huvudtaggar
|
head_tags | string |
Anpassade HTML- eller spårningstaggar som infogats i omdirigeringssidans huvud. |
|
|
Dölj referens
|
hide_referrer | boolean |
Om du vill dölja referensen från målwebbplatsen. |
|
|
Beskrivning av Öppna diagram
|
og_description | string |
Beskrivningen som visas när länken delas på sociala medier. |
|
|
Öppna grafbild
|
og_image | string |
Bild-URL:en som visas när länken delas på sociala medier. |
|
|
Öppna diagramrubrik
|
og_title | string |
Rubriken som visas när länken delas på sociala medier. |
|
|
TikTok Pixel-ID
|
tiktok_pixel_id | string |
Det TikTok Pixel-ID som ska utlösas när länken klickas. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Meta pixel-ID
|
fb_pixel_id | string |
Meta (Facebook) Pixel-ID som ska utlösas när länken klickas. |
|
LinkedIn Partner-ID
|
linkedin_partner_id | string |
Partner-ID:t LinkedIn Insight Tag när länken klickas. |
|
Microsoft UET-tagg-ID
|
microsoft_uet_tag_id | string |
Det Microsoft Advertising UET-tagg-ID som ska utlösas när länken klickas. |
|
Reddit Pixel-ID
|
reddit_pixel_id | string |
Reddit Pixel-ID:t som ska utlösas när länken klickas. |
|
TikTok Pixel-ID
|
tiktok_pixel_id | string |
Det TikTok Pixel-ID som ska utlösas när länken klickas. |
|
Dölj referens
|
hide_referrer | boolean |
Om du vill dölja referensen från målwebbplatsen. |
|
Förfallodatum
|
expiry_datetime | string |
När länken slutar fungera, i ISO 8601-format. |
|
Mål för förfallodatum
|
expiry_destination | uri |
URL:en som ska omdirigeras till när länken har upphört att gälla. Lämna tomt för att returnera en sida som inte hittades. |
|
X Pixel-ID
|
twitter_pixel_id | string |
X (Twitter) Pixel-ID som ska utlösas när länken klickas. |
|
Kamouflage
|
cloaking | boolean |
Om målet ska döljas genom att öppna det i en ram. |
|
Kort webbadress
|
full_url | uri |
Den fullständiga korta länk-URL:en. |
|
Beskrivning av Öppna diagram
|
og_description | string |
Beskrivningen som visas när länken delas på sociala medier. |
|
Hoppa över spårning av social crawlning
|
skip_social_crawler_tracking | boolean |
Om du vill undanta crawlare för förhandsversionen av sociala medier från klickspårning. |
|
Brödtexttaggar
|
body_tags | string |
Anpassade HTML- eller spårningstaggar som infogats i omdirigeringssidans brödtext. |
|
Öppna diagramrubrik
|
og_title | string |
Rubriken som visas när länken delas på sociala medier. |
|
Note
|
note | string |
En privat anteckning om länken. |
|
Name
|
name | string |
Ett smeknamn för länken som visas på instrumentpanelen. |
|
Länk-ID
|
id | integer |
ID:t för en befintlig länk som ska uppdateras. Lämna tomt för att skapa en ny länk. |
|
Google Tag Manager-ID
|
gtm_id | string |
Google Tag Manager-container-ID:t som ska läsas in när länken klickas. |
|
Öppna grafbild
|
og_image | string |
Bild-URL:en som visas när länken delas på sociala medier. |
|
Blockera robotar
|
block_bots | boolean |
Om du vill blockera kända robotar från att följa länken. |
|
Snapchat Pixel-ID
|
snapchat_pixel_id | string |
Snapchat Pixel-ID:t som ska avfyras när länken klickas. |
|
UTM-innehåll
|
utm_content | string |
Parametern utm_content som läggs till i mål-URL:en. |
|
Enabled
|
enabled | boolean |
Om länken är aktiv. |
|
Målwebbadress
|
url | uri |
Mål-URL:en som den korta länken omdirigeras till. Krävs för att skapa en ny länk. |
|
Borttagen
|
deleted | boolean |
Om länken finns i papperskorgen. |
|
Webhooks
|
webhooks | array of string |
Webhook-URL:erna som prenumereras på klickar på den här länken. |
|
Utgångsklick
|
expiry_clicks | integer |
Antalet klick varefter länken slutar fungera. |
|
Meddela Slack
|
notify_slack | boolean |
Om du vill skicka ett Slack-meddelande när länken klickas. |
|
Arbetsyte-ID
|
workspace_id | integer |
Arbetsområdets ID. |
|
Offentlig analys
|
public_analytics | boolean |
Om analyssidan för länken kan visas offentligt. |
|
Pinterest-tagg-ID
|
pinterest_tag_id | string |
Pinterest-tagg-ID:t som ska utlösas när länken klickas. |
|
UTM-källa
|
utm_source | string |
Parametern utm_source som läggs till mål-URL:en. |
|
Slug
|
slug | string |
En anpassad sökväg för den korta länken. Det måste börja med ett snedstreck. |
|
Domän
|
domain | string |
Den anpassade domän som ska användas för den korta länken, utan ett avslutande snedstreck. |
|
Framåtparametrar
|
forward_params | boolean |
Om frågeparametrar ska vidarebefordras från den korta länken till målet. |
|
UTM Medium
|
utm_medium | string |
Parametern utm_medium som läggs till mål-URL:en. |
|
Huvudtaggar
|
head_tags | string |
Anpassade HTML- eller spårningstaggar som infogats i omdirigeringssidans huvud. |
|
Google Analytics 4-tagg-ID
|
ga4_tag_id | string |
Google Analytics 4-mått-ID:t som ska utlösas när länken klickas. |
|
UTM-term
|
utm_term | string |
Parametern utm_term som läggs till i mål-URL:en. |
|
UTM-kampanj
|
utm_campaign | string |
Parametern utm_campaign som läggs till mål-URL:en. |
Ta bort en länk
Flyttar en länk till papperskorgen. Den korta URL:en slutar omdirigeras och länken kan återställas senare från papperskorgen.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Arbetsytan som ska arbetas i. Välj det i listan eller ange dess ID. |
|
Länk-ID
|
id | True | integer |
ID:t för länken. |
Returer
Ett bekräftelsemeddelande.
- response
- string
Visa en lista över arbetsytor
Returnerar de arbetsytor som är tillgängliga för den här anslutningen. Använd den för att hitta den arbetsyta som andra åtgärder kräver.
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
|
array of object | ||
|
Arbetsyte-ID
|
id | integer |
Arbetsytans unika identifierare. |
|
Namn på arbetsytan
|
name | string |
Namnet på arbetsytan. |
Definitioner
string
Det här är den grundläggande datatypen "string".