Koppeling (preview)
Linkly is een kortere koppeling en klik op tracker. Maak korte koppelingen met aangepaste domeinen, voeg UTM-parameters toe en voeg pixels, rapportconversies en pull-klikanalyses gegroepeerd op land, platform, referrer of campagne toe.
Deze connector is beschikbaar in de volgende producten en regio's:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate regio's behalve: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logische apps | Standard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government regio's - Azure China-regio's - Us Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps regio's behalve: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate regio's behalve: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contactpersoon | |
|---|---|
| Name | Koppelingsondersteuning |
| URL | https://linklyhq.com/support |
| support@linklyhq.com |
| Connectormetagegevens | |
|---|---|
| Publisher | Koppeling |
| Website | https://linklyhq.com |
| Privacybeleid | https://linklyhq.com/support/privacy |
| Categorieën | Marketing; Website |
Koppeling
Linkly is een kortere koppeling en klik op tracker. Het maakt merk korte koppelingen op uw eigen domein, houdt elke klik bij met land- en platform- en referrer-uitsplitsingen, brandt retargeting pixels en registreert conversies terug naar de koppeling die ze heeft geproduceerd. Met deze connector kunnen stromen koppelingen maken en beheren, klikken op analyses en rapportconversies ophalen in een Koppelingswerkruimte.
Publisher: Koppeling
Prerequisites
Een koppelingsaccount . Het gratis abonnement is voldoende om elke actie in deze connector te gebruiken. Voor rapportage- en vermeldingsconversies moet ook de functie Koppelingsconversie bijhouden zijn ingeschakeld in de werkruimte.
Ondersteunde bewerkingen
Werkruimten weergeven
Retourneert de werkruimten die beschikbaar zijn voor deze verbinding. Gebruik deze om de werkruimte te vinden die andere acties vereisen.
Een koppeling maken of bijwerken
Hiermee maakt u een nieuwe korte koppeling of werkt u een bestaande koppeling bij wanneer er een koppelings-id wordt opgegeven. Ondersteunt aangepaste domeinen en slugs, UTM-parameters, het opnieuw instellen van pixels en Open Graph-metagegevens.
Koppeling ophalen
Hiermee wordt één koppeling opgehaald op basis van de id, inclusief het doel, de korte URL en de configuratie.
Lijstkoppelingen
Retourneert een gepagineerde lijst met de koppelingen in een werkruimte, met klikstatistieken. Ondersteunt zoeken en sorteren.
Een koppeling verwijderen
Hiermee verplaatst u een koppeling naar de prullenbak. De korte URL wordt niet meer omgeleid en de koppeling kan later vanuit de prullenbak worden hersteld.
Klikanalyse ophalen
Retourneert het aantal klikken in de loop van de tijd voor een werkruimte of voor specifieke koppelingen, eventueel gefilterd op datumbereik, land, browser, platform, referrer of internetprovider.
Aantal klikken per dimensie ophalen
Retourneert het aantal klikken gegroepeerd op een dimensie, zoals land, plaats, platform, referrer of UTM-parameter, gesorteerd op aflopend aantal.
Aangepaste domeinen weergeven
Retourneert de aangepaste domeinen die zijn geconfigureerd voor een werkruimte. Deze domeinnamen kunnen worden gebruikt bij het maken van koppelingen.
Een conversie rapporteren
Registreert een conversie zoals een aankoop, registratie of aangepaste gebeurtenis en kenmerken deze aan de koppeling waarop is geklikt toen een toeschrijvingstoken werd opgegeven.
Lijstconversies
Retourneert de meest recente conversies die zijn vastgelegd in de werkruimte.
Referenties verkrijgen
Deze connector maakt gebruik van OAuth 2.0. Er is geen API-sleutel nodig.
- Als u nog geen Linkly-account hebt, meldt u zich aan bij https://linklyhq.com. Het gratis abonnement werkt.
- Wanneer u een verbinding maakt, kiest u Aanmelden met Linkly en meldt u zich aan met uw Linkly-account.
- Kies de werkruimte die deze verbinding moet gebruiken wanneer hierom wordt gevraagd en keur vervolgens de aanvraag goed.
De verbinding is gebonden aan de werkruimte die u hebt gekozen. Als u in een andere werkruimte wilt werken, maakt u een tweede verbinding.
Getting Started
- Maak een verbinding zoals hierboven beschreven.
- Voeg de koppelingsactie Maken of bijwerken toe aan een stroom, voer de doel-URL in en eventueel een aangepast domein en een slug. De actie retourneert de korte URL en de koppelings-id.
- Gebruik lijstkoppelingen, Klikanalyse ophalen of Aantal klikken ophalen per dimensie om klikgegevens te lezen. Met acties die een werkruimte uitvoeren, kunt u deze kiezen uit een lijst, die wordt gevuld door werkruimten lijst.
- Als u aankopen of aanmeldingen wilt toewijzen aan koppelingen, geeft u de waarde van de
linkly_cidURL van de landingspagina door aan een conversie rapporteren als het toeschrijvingstoken.
Bekende problemen en beperkingen
- Een verbinding is gebonden aan één Koppelingswerkruimte, de werkruimte die is gekozen bij het aanmelden. Maak één verbinding per werkruimte.
- Voor het rapporteren van conversies en lijstconversies is de functie Voor het bijhouden van koppelingsconversies vereist. Werkruimten zonder dat er een fout optreedt bij deze acties.
- Realtime klikken op webhooks worden niet weergegeven als triggers. Gebruik in plaats daarvan de webhookfunctie van Linkly met een door HTTP geactiveerde stroom.
- Het maken van bulkkoppelingen, het exporteren van koppelingen en domeinbeheer zijn beschikbaar in de Linkly-API, maar zijn niet opgenomen in deze connector.
- De API is beperkt. Klikaantallen ophalen per dimensie retourneert een snelheidslimietfout wanneer de limiet wordt overschreden; probeer het opnieuw na een korte vertraging.
Veelgestelde vragen
In welke werkruimte worden mijn acties uitgevoerd?
Acties die een werkruimteparameter uitvoeren, bevatten een lijst met de werkruimten die beschikbaar zijn voor de verbinding. Acties zonder een koppeling, zoals Een koppeling ophalen, een conversie rapporteren en lijstconversies, gebruiken de werkruimte die is gebonden aan de verbinding.
Hoe gebruik ik een aangepast domein?
Voeg eerst het domein toe in Linkly en geef vervolgens de naam door in het veld Domein van Een koppeling maken of bijwerken. Lijst met aangepaste domeinen retourneert de namen die beschikbaar zijn in een werkruimte.
Verwijdert u een koppeling definitief?
No. De koppeling wordt verplaatst naar de prullenbak en stopt met omleiden. Het kan worden hersteld uit de prullenbak in Linkly.
Implementatie-instructies
- Open aangepaste connectors in de makerportal, kies Nieuwe aangepaste connector en importeer vervolgens een OpenAPI-bestand. Selecteer
apiDefinition.swagger.json. - Kies op het tabblad BeveiligingOAuth 2.0 met de id-provider Generic Oauth 2 . Voer de client-id en het clientgeheim in die zijn uitgegeven door Linkly, stel de autorisatie-URL
https://app.linklyhq.com/oauth/authorizein op en stel zowel de token-URL als de vernieuwings-URL in ophttps://app.linklyhq.com/oauth/token. - Maak de connector en kopieer de omleidings-URL die wordt weergegeven op het tabblad Beveiliging en registreer deze bij Linkly voor die client-id.
- Maak een verbinding door u aan te melden met uw Linkly-account en test vervolgens een actie zoals Werkruimten weergeven.
Acties
| Aangepaste domeinen weergeven |
Retourneert de aangepaste domeinen die zijn geconfigureerd voor een werkruimte. Deze domeinnamen kunnen worden gebruikt bij het maken van koppelingen. |
| Aantal klikken per dimensie ophalen |
Retourneert het aantal klikken gegroepeerd op een dimensie, zoals land, plaats, platform, referrer of UTM-parameter, gesorteerd op aflopend aantal. |
| Een conversie rapporteren |
Registreert een conversie zoals een aankoop, registratie of aangepaste gebeurtenis en kenmerken deze aan de koppeling waarop is geklikt toen een toeschrijvingstoken werd opgegeven. |
| Een koppeling maken of bijwerken |
Hiermee maakt u een nieuwe korte koppeling of werkt u een bestaande koppeling bij wanneer er een koppelings-id wordt opgegeven. Ondersteunt aangepaste domeinen en slugs, UTM-parameters, het opnieuw instellen van pixels en Open Graph-metagegevens. |
| Een koppeling verwijderen |
Hiermee verplaatst u een koppeling naar de prullenbak. De korte URL wordt niet meer omgeleid en de koppeling kan later vanuit de prullenbak worden hersteld. |
| Klikanalyse ophalen |
Retourneert het aantal klikken in de loop van de tijd voor een werkruimte of voor specifieke koppelingen, eventueel gefilterd op datumbereik, land, browser, platform, referrer of internetprovider. |
| Koppeling ophalen |
Hiermee wordt één koppeling opgehaald op basis van de id, inclusief het doel, de korte URL en de configuratie. |
| Lijstconversies |
Retourneert de meest recente conversies die zijn vastgelegd in de werkruimte. |
| Lijstkoppelingen |
Retourneert een gepagineerde lijst met de koppelingen in een werkruimte, met klikstatistieken. Ondersteunt zoeken en sorteren. |
| Werkruimten weergeven |
Retourneert de werkruimten die beschikbaar zijn voor deze verbinding. Gebruik deze om de werkruimte te vinden die andere acties vereisen. |
Aangepaste domeinen weergeven
Retourneert de aangepaste domeinen die zijn geconfigureerd voor een werkruimte. Deze domeinnamen kunnen worden gebruikt bij het maken van koppelingen.
Parameters
| Naam | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
De werkruimte waarin moet worden gewerkt. Kies deze in de lijst of voer de id in. |
Retouren
| Naam | Pad | Type | Description |
|---|---|---|---|
|
Domains
|
domains | array of object |
De aangepaste domeinen in de werkruimte. |
|
Domeinnaam
|
domains.name | string |
De domeinnaam, bijvoorbeeld go.yourcompany.com. |
Aantal klikken per dimensie ophalen
Retourneert het aantal klikken gegroepeerd op een dimensie, zoals land, plaats, platform, referrer of UTM-parameter, gesorteerd op aflopend aantal.
Parameters
| Naam | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
De werkruimte waarin moet worden gewerkt. Kies deze in de lijst of voer de id in. |
|
Dimensie
|
counter | True | string |
De dimensie voor het groeperen van klikken op bijvoorbeeld land, plaats, platform, referer of utm_campaign. |
|
Koppelings-id
|
link_id | string |
De id van één koppeling om op te filteren. |
|
|
Koppelings-id's
|
link_ids | string |
Een door afbreekstreepjes gescheiden lijst met koppelings-id's om op te filteren. |
|
|
begindatum
|
start | string |
Het begin van het datumbereik, in de indeling JJJJ-MM-DD. |
|
|
Einddatum
|
end | string |
Het einde van het datumbereik, in de indeling JJJJ-MM-DD. |
|
|
Country
|
country | string |
Een ISO 3166-1-landcode van twee letters, bijvoorbeeld VS. |
|
|
Bots opnemen
|
bots | boolean |
Of klikken moeten worden opgenomen die zijn geïdentificeerd als bots. Ingesteld op onwaar om ze uit te sluiten. |
|
|
Alleen uniek
|
unique | boolean |
Of u alleen unieke klikken wilt tellen. |
Retouren
| Naam | Pad | Type | Description |
|---|---|---|---|
|
Total
|
total | integer |
Totaal aantal klikken in alle groepen, inclusief eventuele niet-geretourneerde waarden. Wanneer het resultaat wordt afgekapt, is dit groter dan de som van het aantal in waarden, dus aantal/totaal geeft nog steeds een nauwkeurig percentage. |
|
Values
|
values | array of object |
Gegroepeerde aantallen, gesorteerd op aflopend aantal. Afgekapt tot de top 10.000 waarden; als de dimensie meer afzonderlijke waarden heeft dan dat, worden de rest niet geretourneerd. |
|
Aantal
|
values.count | integer |
Het aantal klikken voor deze waarde. |
|
Value
|
values.value | string |
De waarde van de dimensie, bijvoorbeeld een landcode. |
Een conversie rapporteren
Registreert een conversie zoals een aankoop, registratie of aangepaste gebeurtenis en kenmerken deze aan de koppeling waarop is geklikt toen een toeschrijvingstoken werd opgegeven.
Parameters
| Naam | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Bedrag (centen)
|
amount_cents | integer |
Waarde in de kleinste valuta-eenheid. Kan negatief zijn om een restitutie of terugstorting vast te leggen, die netto's ten opzichte van eerdere inkomsten. |
|
|
Country
|
country | string |
Landcode van twee letters voor de conversie. Afgeleid voor aanroepen aan de browserzijde; geef deze expliciet op vanuit een integratie aan de serverzijde, waarbij het verbindingsadres uw eigen infrastructuur is in plaats van de klant. |
|
|
Valuta
|
currency | string |
ISO 4217 valutacode. Standaard ingesteld op USD. |
|
|
Gebeurtenis-id
|
event_id | string |
Uw id voor deze gebeurtenis. Wordt gebruikt als een idempotentiesleutel; als u dezelfde waarde twee keer rapporteert, wordt er geen tweede conversie gemaakt. Is van toepassing op elk gebeurtenistype, niet alleen op aankopen. |
|
|
Gebeurtenisnaam
|
event_name | True | string |
Wat er is gebeurd, bijvoorbeeld kopen, registreren, trial_started. |
|
Gebeurtenistype
|
event_type | string |
Grof type dat de trechter aanrijdt. lead brengt klantidentiteit, omzet verkooprecords vast. De standaardinstelling is aangepast. |
|
|
Klant-id
|
external_id | string |
Uw id voor de klant. Verzend het op elke gebeurtenis: het is wat een latere verkoop aan de serverzijde weer koppelt aan de klik die de registratie heeft geproduceerd. |
|
|
Toeschrijvingstoken
|
linkly_cid | string |
Het toeschrijvingstoken dat is vastgelegd op basis van de URL van de landingspagina. Weglaten indien niet beschikbaar; de conversie wordt vervolgens vastgelegd zonder een koppelingsvermelding. |
|
|
Metadata
|
metadata | object |
Willekeurige JSON, maximaal 10.000 bytes gecodeerd. |
|
|
Opgetreden op
|
occurred_at | date-time |
Toen de conversie is gebeurd. De standaardwaarde is nu. |
|
|
Ip-adres van bezoeker
|
visitor_ip | string |
Het IP-adres van de eindklant, wanneer de server deze heeft. Laat weg tenzij u dat doet; voor aanroepen aan de serverzijde registreert koppelingly het verbindingsadres als uw server, niet de klant, en sluit het uit van geografische rapportage. Als u deze beweringen verzendt, hebt u een rechtmatige basis om het te delen. Nooit geretourneerd door de API. |
Retouren
| Naam | Pad | Type | Description |
|---|---|---|---|
|
Bedrag (centen)
|
amount_cents | integer |
De waarde in de kleinste valuta-eenheid. Kan negatief zijn om een restitutie vast te leggen. |
|
Klik op Id
|
click_id | string |
De id van de toegeschreven klik. |
|
Country
|
country | string |
Een ISO 3166-1-landcode van twee letters, bijvoorbeeld VS. |
|
Valuta
|
currency | string |
De ISO 4217-valutacode. Standaard ingesteld op USD. |
|
Gebeurtenis-id
|
event_id | string |
Uw id voor de gebeurtenis. Als u dezelfde waarde twee keer rapporteert, wordt er geen tweede conversie gemaakt. |
|
Gebeurtenisnaam
|
event_name | string |
Wat er is gebeurd, bijvoorbeeld aankoop, registratie of trial_started. |
|
Gebeurtenistype
|
event_type | string |
Het grof gebeurtenistype. Gebruik lead om klantidentiteit en verkoop vast te stellen om omzet vast te leggen. De standaardinstelling is aangepast. |
|
Klant-id
|
external_id | string |
Uw id voor de klant. Verzend deze op elke gebeurtenis, zodat latere verkoop kan worden gekoppeld aan de oorspronkelijke klik. |
|
Conversie-id
|
id | string |
De unieke id van de conversie. Id's sorteren chronologisch. |
|
Ingevoegd op
|
inserted_at | date-time |
Toen de conversie werd vastgelegd. |
|
IP-bron
|
ip_source | string |
Wiens adres is vastgelegd: bezoeker, server of onbekend. Server betekent dat het verbindingsadres deel uitmaakt van uw back-end of een platformrelay, zodat het wordt uitgesloten van geografische rapportage. |
|
Koppelings-id
|
link_id | integer |
De id van de toegeschreven koppeling of null als de conversie niet kan worden toegeschreven aan een koppeling. |
|
Metadata
|
metadata | object |
Willekeurige JSON-metagegevens, maximaal 10.000 bytes. |
|
Opgetreden op
|
occurred_at | date-time |
Wanneer de conversie is uitgevoerd, in ISO 8601-indeling. De standaardwaarde is nu. |
|
Source
|
source | string |
Welke integratie het heeft gerapporteerd. |
Een koppeling maken of bijwerken
Hiermee maakt u een nieuwe korte koppeling of werkt u een bestaande koppeling bij wanneer er een koppelings-id wordt opgegeven. Ondersteunt aangepaste domeinen en slugs, UTM-parameters, het opnieuw instellen van pixels en Open Graph-metagegevens.
Parameters
| Naam | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Doel-URL
|
url | uri |
De doel-URL waarnaar de korte koppeling wordt omgeleid. Vereist om een nieuwe koppeling te maken. |
|
|
Koppelings-id
|
id | integer |
De id van een bestaande koppeling die moet worden bijgewerkt. Laat leeg om een nieuwe koppeling te maken. |
|
|
Name
|
name | string |
Een bijnaam voor de koppeling, weergegeven in het dashboard. |
|
|
Domein
|
domain | string |
Het aangepaste domein dat moet worden gebruikt voor de korte koppeling, zonder een afsluitende slash. |
|
|
slug
|
slug | string |
Een aangepast pad voor de korte koppeling. Het moet beginnen met een slash. |
|
|
Ingeschakeld
|
enabled | boolean |
Of de koppeling actief is. |
|
|
Note
|
note | string |
Een persoonlijke opmerking over de koppeling. |
|
|
UTM-bron
|
utm_source | string |
De parameter utm_source toegevoegd aan de doel-URL. |
|
|
UTM Medium
|
utm_medium | string |
De parameter utm_medium toegevoegd aan de doel-URL. |
|
|
UTM-campagne
|
utm_campaign | string |
De parameter utm_campaign toegevoegd aan de doel-URL. |
|
|
UTM-inhoud
|
utm_content | string |
De parameter utm_content toegevoegd aan de doel-URL. |
|
|
UTM-term
|
utm_term | string |
De parameter utm_term toegevoegd aan de doel-URL. |
|
|
Meta Pixel-id
|
fb_pixel_id | string |
De Pixel-id van de Meta (Facebook) om te worden geactiveerd wanneer op de koppeling wordt geklikt. |
|
|
Google Analytics 4-tag-id
|
ga4_tag_id | string |
De google Analytics 4-meet-id die moet worden geactiveerd wanneer op de koppeling wordt geklikt. |
|
|
Google Tag Manager-id
|
gtm_id | string |
De container-id van Google Tag Manager die moet worden geladen wanneer op de koppeling wordt geklikt. |
|
|
Bots blokkeren
|
block_bots | boolean |
Of bekende bots niet kunnen worden gevolgd door de koppeling. |
|
|
Hoofdteksttags
|
body_tags | string |
Aangepaste HTML- of traceringstags die zijn ingevoegd in de hoofdtekst van de omleidingspagina. |
|
|
Cloaking
|
cloaking | boolean |
Of u de bestemming wilt verbergen door deze binnen een frame te openen. |
|
|
Parameters doorsturen
|
forward_params | boolean |
Hiermee wordt aangegeven of u queryparameters vanaf de korte koppeling naar de bestemming wilt doorsturen. |
|
|
Hoofdtags
|
head_tags | string |
Aangepaste HTML- of traceringstags die zijn ingevoegd in de kop van de omleidingspagina. |
|
|
Verwijsfunctie verbergen
|
hide_referrer | boolean |
Hiermee wordt aangegeven of de verwijzende functie van de doelsite moet worden verborgen. |
|
|
Beschrijving van open grafiek
|
og_description | string |
De beschrijving die wordt weergegeven wanneer de koppeling wordt gedeeld op sociale media. |
|
|
Grafiekafbeelding openen
|
og_image | string |
De afbeeldings-URL die wordt weergegeven wanneer de koppeling wordt gedeeld op sociale media. |
|
|
Grafiektitel openen
|
og_title | string |
De titel die wordt weergegeven wanneer de koppeling wordt gedeeld op sociale media. |
|
|
TikTok Pixel ID
|
tiktok_pixel_id | string |
De TikTok Pixel-id die moet worden geactiveerd wanneer op de koppeling wordt geklikt. |
Retouren
| Naam | Pad | Type | Description |
|---|---|---|---|
|
Meta Pixel-id
|
fb_pixel_id | string |
De Pixel-id van de Meta (Facebook) om te worden geactiveerd wanneer op de koppeling wordt geklikt. |
|
LinkedIn partner-id
|
linkedin_partner_id | string |
De id van de LinkedIn Insight Tag-partner die moet worden geactiveerd wanneer op de koppeling wordt geklikt. |
|
Microsoft UET-tag-id
|
microsoft_uet_tag_id | string |
De Microsoft Advertising UET-tag-id die moet worden geactiveerd wanneer op de koppeling wordt geklikt. |
|
Reddit Pixel ID
|
reddit_pixel_id | string |
De Reddit Pixel-id die moet worden geactiveerd wanneer op de koppeling wordt geklikt. |
|
TikTok Pixel ID
|
tiktok_pixel_id | string |
De TikTok Pixel-id die moet worden geactiveerd wanneer op de koppeling wordt geklikt. |
|
Verwijsfunctie verbergen
|
hide_referrer | boolean |
Hiermee wordt aangegeven of de verwijzende functie van de doelsite moet worden verborgen. |
|
Vervaldatum
|
expiry_datetime | string |
Wanneer de koppeling niet meer werkt, in ISO 8601-indeling. |
|
Verloopbestemming
|
expiry_destination | uri |
De URL waarnaar moet worden omgeleid nadat de koppeling is verlopen. Laat leeg om een niet-gevonden pagina te retourneren. |
|
X Pixel ID
|
twitter_pixel_id | string |
De X -pixel-id (Twitter) die moet worden geactiveerd wanneer op de koppeling wordt geklikt. |
|
Cloaking
|
cloaking | boolean |
Of u de bestemming wilt verbergen door deze binnen een frame te openen. |
|
Korte URL
|
full_url | uri |
De volledige URL van de korte koppeling. |
|
Beschrijving van open grafiek
|
og_description | string |
De beschrijving die wordt weergegeven wanneer de koppeling wordt gedeeld op sociale media. |
|
Tracering van sociale verkenning overslaan
|
skip_social_crawler_tracking | boolean |
Of u preview-verkenningen voor sociale media wilt uitsluiten van klikken bijhouden. |
|
Hoofdteksttags
|
body_tags | string |
Aangepaste HTML- of traceringstags die zijn ingevoegd in de hoofdtekst van de omleidingspagina. |
|
Grafiektitel openen
|
og_title | string |
De titel die wordt weergegeven wanneer de koppeling wordt gedeeld op sociale media. |
|
Note
|
note | string |
Een persoonlijke opmerking over de koppeling. |
|
Name
|
name | string |
Een bijnaam voor de koppeling, weergegeven in het dashboard. |
|
Koppelings-id
|
id | integer |
De id van een bestaande koppeling die moet worden bijgewerkt. Laat leeg om een nieuwe koppeling te maken. |
|
Google Tag Manager-id
|
gtm_id | string |
De container-id van Google Tag Manager die moet worden geladen wanneer op de koppeling wordt geklikt. |
|
Grafiekafbeelding openen
|
og_image | string |
De afbeeldings-URL die wordt weergegeven wanneer de koppeling wordt gedeeld op sociale media. |
|
Bots blokkeren
|
block_bots | boolean |
Of bekende bots niet kunnen worden gevolgd door de koppeling. |
|
Snapchat Pixel ID
|
snapchat_pixel_id | string |
De Snapchat Pixel ID die moet worden geactiveerd wanneer op de koppeling wordt geklikt. |
|
UTM-inhoud
|
utm_content | string |
De parameter utm_content toegevoegd aan de doel-URL. |
|
Ingeschakeld
|
enabled | boolean |
Of de koppeling actief is. |
|
Doel-URL
|
url | uri |
De doel-URL waarnaar de korte koppeling wordt omgeleid. Vereist om een nieuwe koppeling te maken. |
|
Verwijderd
|
deleted | boolean |
Of de koppeling zich in de prullenbak bevindt. |
|
Webhooks
|
webhooks | array of string |
De webhook-URL's die zijn geabonneerd om op deze koppeling te klikken. |
|
Verloopklikken
|
expiry_clicks | integer |
Het aantal klikken waarna de koppeling niet meer werkt. |
|
Slack waarschuwen
|
notify_slack | boolean |
Of u een Slack-melding wilt verzenden wanneer op de koppeling wordt geklikt. |
|
Werkruimte-id
|
workspace_id | integer |
De ID van de werkruimte. |
|
Openbare analyse
|
public_analytics | boolean |
Of de analysepagina voor de koppeling openbaar kan worden weergegeven. |
|
Pinterest-tag-id
|
pinterest_tag_id | string |
De Pinterest-tag-id die moet worden geactiveerd wanneer op de koppeling wordt geklikt. |
|
UTM-bron
|
utm_source | string |
De parameter utm_source toegevoegd aan de doel-URL. |
|
slug
|
slug | string |
Een aangepast pad voor de korte koppeling. Het moet beginnen met een slash. |
|
Domein
|
domain | string |
Het aangepaste domein dat moet worden gebruikt voor de korte koppeling, zonder een afsluitende slash. |
|
Parameters doorsturen
|
forward_params | boolean |
Hiermee wordt aangegeven of u queryparameters vanaf de korte koppeling naar de bestemming wilt doorsturen. |
|
UTM Medium
|
utm_medium | string |
De parameter utm_medium toegevoegd aan de doel-URL. |
|
Hoofdtags
|
head_tags | string |
Aangepaste HTML- of traceringstags die zijn ingevoegd in de kop van de omleidingspagina. |
|
Google Analytics 4-tag-id
|
ga4_tag_id | string |
De google Analytics 4-meet-id die moet worden geactiveerd wanneer op de koppeling wordt geklikt. |
|
UTM-term
|
utm_term | string |
De parameter utm_term toegevoegd aan de doel-URL. |
|
UTM-campagne
|
utm_campaign | string |
De parameter utm_campaign toegevoegd aan de doel-URL. |
Een koppeling verwijderen
Hiermee verplaatst u een koppeling naar de prullenbak. De korte URL wordt niet meer omgeleid en de koppeling kan later vanuit de prullenbak worden hersteld.
Parameters
| Naam | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
De werkruimte waarin moet worden gewerkt. Kies deze in de lijst of voer de id in. |
|
Koppelings-id
|
id | True | integer |
De id van de koppeling. |
Retouren
Een bevestigingsbericht.
- response
- string
Klikanalyse ophalen
Retourneert het aantal klikken in de loop van de tijd voor een werkruimte of voor specifieke koppelingen, eventueel gefilterd op datumbereik, land, browser, platform, referrer of internetprovider.
Parameters
| Naam | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
De werkruimte waarin moet worden gewerkt. Kies deze in de lijst of voer de id in. |
|
Koppelings-id
|
link_id | string |
De id van één koppeling om op te filteren. |
|
|
Koppelings-id's
|
link_ids | string |
Een door afbreekstreepjes gescheiden lijst met koppelings-id's om op te filteren. |
|
|
begindatum
|
start | string |
Het begin van het datumbereik, in de indeling JJJJ-MM-DD. |
|
|
Einddatum
|
end | string |
Het einde van het datumbereik, in de indeling JJJJ-MM-DD. |
|
|
Country
|
country | string |
Een ISO 3166-1-landcode van twee letters, bijvoorbeeld VS. |
|
|
Webbrowser
|
browser | string |
Een browsernaam waarop u wilt filteren, bijvoorbeeld Chrome, Firefox of Safari. |
|
|
Platform
|
platform | string |
Een platform of besturingssysteem waarop u wilt filteren, bijvoorbeeld Windows, Mac, iOS of Android. |
|
|
Verwijzer
|
referer | string |
Een verwijzend domein om op te filteren. |
|
|
ISP (Internet Service Provider)
|
isp | string |
Een internetprovidernaam om op te filteren. |
|
|
Bots opnemen
|
bots | boolean |
Of klikken moeten worden opgenomen die zijn geïdentificeerd als bots. Ingesteld op onwaar om ze uit te sluiten. |
|
|
Alleen uniek
|
unique | boolean |
Of u alleen unieke klikken wilt tellen. |
|
|
Tijdzone
|
timezone | string |
De IANA-tijdzone die wordt gebruikt voor datumberekeningen, bijvoorbeeld Europa/Londen. |
|
|
Frequentie
|
frequency | string |
De granulariteit van de tijdreeks, dag of uur. |
Retouren
| Naam | Pad | Type | Description |
|---|---|---|---|
|
Traffic
|
traffic | array of object |
Het aantal klikken in de loop van de tijd. |
|
Bucket starten
|
traffic.t | string |
De bucket begint: JJJJ-MM-DD voor dagelijkse buckets of JJJJ-MM-DDTHH:MM:SS voor buckets per uur. |
|
Klikken
|
traffic.y | integer |
Het aantal klikken in de bucket. |
Koppeling ophalen
Hiermee wordt één koppeling opgehaald op basis van de id, inclusief het doel, de korte URL en de configuratie.
Parameters
| Naam | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Koppelings-id
|
id | True | string |
De id van de koppeling. |
Retouren
| Naam | Pad | Type | Description |
|---|---|---|---|
|
Meta Pixel-id
|
fb_pixel_id | string |
De Pixel-id van de Meta (Facebook) om te worden geactiveerd wanneer op de koppeling wordt geklikt. |
|
LinkedIn partner-id
|
linkedin_partner_id | string |
De id van de LinkedIn Insight Tag-partner die moet worden geactiveerd wanneer op de koppeling wordt geklikt. |
|
Microsoft UET-tag-id
|
microsoft_uet_tag_id | string |
De Microsoft Advertising UET-tag-id die moet worden geactiveerd wanneer op de koppeling wordt geklikt. |
|
Reddit Pixel ID
|
reddit_pixel_id | string |
De Reddit Pixel-id die moet worden geactiveerd wanneer op de koppeling wordt geklikt. |
|
TikTok Pixel ID
|
tiktok_pixel_id | string |
De TikTok Pixel-id die moet worden geactiveerd wanneer op de koppeling wordt geklikt. |
|
Verwijsfunctie verbergen
|
hide_referrer | boolean |
Hiermee wordt aangegeven of de verwijzende functie van de doelsite moet worden verborgen. |
|
Vervaldatum
|
expiry_datetime | string |
Wanneer de koppeling niet meer werkt, in ISO 8601-indeling. |
|
Verloopbestemming
|
expiry_destination | uri |
De URL waarnaar moet worden omgeleid nadat de koppeling is verlopen. Laat leeg om een niet-gevonden pagina te retourneren. |
|
X Pixel ID
|
twitter_pixel_id | string |
De X -pixel-id (Twitter) die moet worden geactiveerd wanneer op de koppeling wordt geklikt. |
|
Cloaking
|
cloaking | boolean |
Of u de bestemming wilt verbergen door deze binnen een frame te openen. |
|
Korte URL
|
full_url | uri |
De volledige URL van de korte koppeling. |
|
Beschrijving van open grafiek
|
og_description | string |
De beschrijving die wordt weergegeven wanneer de koppeling wordt gedeeld op sociale media. |
|
Tracering van sociale verkenning overslaan
|
skip_social_crawler_tracking | boolean |
Of u preview-verkenningen voor sociale media wilt uitsluiten van klikken bijhouden. |
|
Hoofdteksttags
|
body_tags | string |
Aangepaste HTML- of traceringstags die zijn ingevoegd in de hoofdtekst van de omleidingspagina. |
|
Grafiektitel openen
|
og_title | string |
De titel die wordt weergegeven wanneer de koppeling wordt gedeeld op sociale media. |
|
Note
|
note | string |
Een persoonlijke opmerking over de koppeling. |
|
Name
|
name | string |
Een bijnaam voor de koppeling, weergegeven in het dashboard. |
|
Koppelings-id
|
id | integer |
De unieke id van de koppeling. |
|
Google Tag Manager-id
|
gtm_id | string |
De container-id van Google Tag Manager die moet worden geladen wanneer op de koppeling wordt geklikt. |
|
Grafiekafbeelding openen
|
og_image | string |
De afbeeldings-URL die wordt weergegeven wanneer de koppeling wordt gedeeld op sociale media. |
|
Bots blokkeren
|
block_bots | boolean |
Of bekende bots niet kunnen worden gevolgd door de koppeling. |
|
Snapchat Pixel ID
|
snapchat_pixel_id | string |
De Snapchat Pixel ID die moet worden geactiveerd wanneer op de koppeling wordt geklikt. |
|
UTM-inhoud
|
utm_content | string |
De parameter utm_content toegevoegd aan de doel-URL. |
|
Ingeschakeld
|
enabled | boolean |
Of de koppeling actief is. |
|
Doel-URL
|
url | uri |
De doel-URL waarnaar de korte koppeling wordt omgeleid. |
|
Verwijderd
|
deleted | boolean |
Of de koppeling zich in de prullenbak bevindt. |
|
Webhooks
|
webhooks | array of string |
De webhook-URL's die zijn geabonneerd om op deze koppeling te klikken. |
|
Verloopklikken
|
expiry_clicks | integer |
Het aantal klikken waarna de koppeling niet meer werkt. |
|
Slack waarschuwen
|
notify_slack | boolean |
Of u een Slack-melding wilt verzenden wanneer op de koppeling wordt geklikt. |
|
Werkruimte-id
|
workspace_id | integer |
De ID van de werkruimte. |
|
Openbare analyse
|
public_analytics | boolean |
Of de analysepagina voor de koppeling openbaar kan worden weergegeven. |
|
Pinterest-tag-id
|
pinterest_tag_id | string |
De Pinterest-tag-id die moet worden geactiveerd wanneer op de koppeling wordt geklikt. |
|
UTM-bron
|
utm_source | string |
De parameter utm_source toegevoegd aan de doel-URL. |
|
slug
|
slug | string |
Een aangepast pad voor de korte koppeling. Het moet beginnen met een slash. |
|
Domein
|
domain | string |
Het aangepaste domein dat moet worden gebruikt voor de korte koppeling, zonder een afsluitende slash. |
|
Parameters doorsturen
|
forward_params | boolean |
Hiermee wordt aangegeven of u queryparameters vanaf de korte koppeling naar de bestemming wilt doorsturen. |
|
UTM Medium
|
utm_medium | string |
De parameter utm_medium toegevoegd aan de doel-URL. |
|
Hoofdtags
|
head_tags | string |
Aangepaste HTML- of traceringstags die zijn ingevoegd in de kop van de omleidingspagina. |
|
Google Analytics 4-tag-id
|
ga4_tag_id | string |
De google Analytics 4-meet-id die moet worden geactiveerd wanneer op de koppeling wordt geklikt. |
|
UTM-term
|
utm_term | string |
De parameter utm_term toegevoegd aan de doel-URL. |
|
UTM-campagne
|
utm_campaign | string |
De parameter utm_campaign toegevoegd aan de doel-URL. |
Lijstconversies
Retourneert de meest recente conversies die zijn vastgelegd in de werkruimte.
Parameters
| Naam | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Limit
|
limit | integer |
Het maximum aantal conversies dat moet worden geretourneerd, tussen 1 en 1000. |
Retouren
| Naam | Pad | Type | Description |
|---|---|---|---|
|
Conversions
|
conversions | array of object |
De conversies, de meest recente eerste. |
|
Bedrag (centen)
|
conversions.amount_cents | integer |
De waarde in de kleinste valuta-eenheid. Kan negatief zijn om een restitutie vast te leggen. |
|
Klik op Id
|
conversions.click_id | string |
De id van de toegeschreven klik. |
|
Country
|
conversions.country | string |
Een ISO 3166-1-landcode van twee letters, bijvoorbeeld VS. |
|
Valuta
|
conversions.currency | string |
De ISO 4217-valutacode. Standaard ingesteld op USD. |
|
Gebeurtenis-id
|
conversions.event_id | string |
Uw id voor de gebeurtenis. Als u dezelfde waarde twee keer rapporteert, wordt er geen tweede conversie gemaakt. |
|
Gebeurtenisnaam
|
conversions.event_name | string |
Wat er is gebeurd, bijvoorbeeld aankoop, registratie of trial_started. |
|
Gebeurtenistype
|
conversions.event_type | string |
Het grof gebeurtenistype. Gebruik lead om klantidentiteit en verkoop vast te stellen om omzet vast te leggen. De standaardinstelling is aangepast. |
|
Klant-id
|
conversions.external_id | string |
Uw id voor de klant. Verzend deze op elke gebeurtenis, zodat latere verkoop kan worden gekoppeld aan de oorspronkelijke klik. |
|
Conversie-id
|
conversions.id | string |
De unieke id van de conversie. Id's sorteren chronologisch. |
|
Ingevoegd op
|
conversions.inserted_at | date-time |
Toen de conversie werd vastgelegd. |
|
IP-bron
|
conversions.ip_source | string |
Wiens adres is vastgelegd: bezoeker, server of onbekend. Server betekent dat het verbindingsadres deel uitmaakt van uw back-end of een platformrelay, zodat het wordt uitgesloten van geografische rapportage. |
|
Koppelings-id
|
conversions.link_id | integer |
De id van de toegeschreven koppeling of null als de conversie niet kan worden toegeschreven aan een koppeling. |
|
Metadata
|
conversions.metadata | object |
Willekeurige JSON-metagegevens, maximaal 10.000 bytes. |
|
Opgetreden op
|
conversions.occurred_at | date-time |
Wanneer de conversie is uitgevoerd, in ISO 8601-indeling. De standaardwaarde is nu. |
|
Source
|
conversions.source | string |
Welke integratie het heeft gerapporteerd. |
Lijstkoppelingen
Retourneert een gepagineerde lijst met de koppelingen in een werkruimte, met klikstatistieken. Ondersteunt zoeken en sorteren.
Parameters
| Naam | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
De werkruimte waarin moet worden gewerkt. Kies deze in de lijst of voer de id in. |
|
Search
|
search | string |
Een zoekterm voor het filteren van koppelingen op naam, URL of slug. |
|
|
Page
|
page | integer |
Het paginanummer dat moet worden geretourneerd, beginnend bij 1. |
|
|
Paginagrootte
|
page_size | integer |
Het aantal koppelingen dat per pagina moet worden geretourneerd. |
|
|
Sorteren op
|
sort_by | string |
Het veld waarop u wilt sorteren, bijvoorbeeld clicks_total, naam of inserted_at. |
|
|
Sorteerrichting
|
sort_dir | string |
De sorteerrichting, asc of desc. |
|
|
Verwijderd
|
deleted | boolean |
Of u koppelingen wilt retourneren die zich in de prullenbak bevinden in plaats van actieve koppelingen. |
Retouren
| Naam | Pad | Type | Description |
|---|---|---|---|
|
Links
|
links | array of object |
De koppelingen op deze pagina. |
|
Meta Pixel-id
|
links.fb_pixel_id | string |
De Pixel-id van de Meta (Facebook) om te worden geactiveerd wanneer op de koppeling wordt geklikt. |
|
Totaal van menselijke klikken
|
links.human_clicks_total | integer |
Levensduur klikt zonder botsignaal; de subset van clicks_total waarbij noch een botgebruikeragent noch een geverifieerde botcategorie is gedetecteerd. Opgenomen vanaf 2019. |
|
Klikken (30 dagen)
|
links.clicks_thirty_days | integer |
Klik in de afgelopen 30 dagen, inclusief botverkeer. |
|
TikTok Pixel ID
|
links.tiktok_pixel_id | string |
De TikTok Pixel-id die moet worden geactiveerd wanneer op de koppeling wordt geklikt. |
|
Verwijsfunctie verbergen
|
links.hide_referrer | boolean |
Hiermee wordt aangegeven of de verwijzende functie van de doelsite moet worden verborgen. |
|
Cloaking
|
links.cloaking | boolean |
Of u de bestemming wilt verbergen door deze binnen een frame te openen. |
|
Korte URL
|
links.full_url | uri |
De volledige URL van de korte koppeling. |
|
Klik vandaag op
|
links.clicks_today | integer |
Klik tot nu toe (UTC), inclusief botverkeer. |
|
Beschrijving van open grafiek
|
links.og_description | string |
De beschrijving die wordt weergegeven wanneer de koppeling wordt gedeeld op sociale media. |
|
Hoofdteksttags
|
links.body_tags | string |
Aangepaste HTML- of traceringstags die zijn ingevoegd in de hoofdtekst van de omleidingspagina. |
|
Grafiektitel openen
|
links.og_title | string |
De titel die wordt weergegeven wanneer de koppeling wordt gedeeld op sociale media. |
|
Note
|
links.note | string |
Een persoonlijke opmerking over de koppeling. |
|
Name
|
links.name | string |
Een bijnaam voor de koppeling, weergegeven in het dashboard. |
|
Koppelings-id
|
links.id | integer |
De unieke id van de koppeling. |
|
Google Tag Manager-id
|
links.gtm_id | string |
De container-id van Google Tag Manager die moet worden geladen wanneer op de koppeling wordt geklikt. |
|
Grafiekafbeelding openen
|
links.og_image | string |
De afbeeldings-URL die wordt weergegeven wanneer de koppeling wordt gedeeld op sociale media. |
|
Bots blokkeren
|
links.block_bots | boolean |
Of bekende bots niet kunnen worden gevolgd door de koppeling. |
|
Totaal aantal klikken
|
links.clicks_total | integer |
Levensduurklikken, inclusief botverkeer. |
|
Menselijke klikken (30 dagen)
|
links.human_clicks_thirty_days | integer |
Klik in de afgelopen 30 dagen zonder botsignaal; de subset van clicks_thirty_days. |
|
UTM-inhoud
|
links.utm_content | string |
De parameter utm_content toegevoegd aan de doel-URL. |
|
Menselijke klikken vandaag
|
links.human_clicks_today | integer |
Klik tot nu toe (UTC) zonder botsignaal. |
|
Ingeschakeld
|
links.enabled | boolean |
Of de koppeling actief is. |
|
Doel-URL
|
links.url | uri |
De doel-URL waarnaar de korte koppeling wordt omgeleid. |
|
Verwijderd
|
links.deleted | boolean |
Of de koppeling zich in de prullenbak bevindt. |
|
Werkruimte-id
|
links.workspace_id | integer |
De ID van de werkruimte. |
|
Openbare analyse
|
links.public_analytics | boolean |
Of de analysepagina voor de koppeling openbaar kan worden weergegeven. |
|
UTM-bron
|
links.utm_source | string |
De parameter utm_source toegevoegd aan de doel-URL. |
|
slug
|
links.slug | string |
Een aangepast pad voor de korte koppeling. Het moet beginnen met een slash. |
|
Domein
|
links.domain | string |
Het aangepaste domein dat moet worden gebruikt voor de korte koppeling, zonder een afsluitende slash. |
|
Parameters doorsturen
|
links.forward_params | boolean |
Hiermee wordt aangegeven of u queryparameters vanaf de korte koppeling naar de bestemming wilt doorsturen. |
|
UTM Medium
|
links.utm_medium | string |
De parameter utm_medium toegevoegd aan de doel-URL. |
|
Hoofdtags
|
links.head_tags | string |
Aangepaste HTML- of traceringstags die zijn ingevoegd in de kop van de omleidingspagina. |
|
Google Analytics 4-tag-id
|
links.ga4_tag_id | string |
De google Analytics 4-meet-id die moet worden geactiveerd wanneer op de koppeling wordt geklikt. |
|
UTM-term
|
links.utm_term | string |
De parameter utm_term toegevoegd aan de doel-URL. |
|
UTM-campagne
|
links.utm_campaign | string |
De parameter utm_campaign toegevoegd aan de doel-URL. |
|
Menselijke klikken gisteren
|
links.human_clicks_previous_day | integer |
Klik gisteren (UTC) zonder botsignaal. |
|
Paginanummer
|
page_number | integer |
Het huidige paginanummer. |
|
Paginagrootte
|
page_size | integer |
Het aantal koppelingen dat per pagina moet worden geretourneerd. |
|
Totaal aantal vermeldingen
|
total_entries | integer |
Het totale aantal koppelingen dat overeenkomt met de aanvraag. |
|
Totaal aantal pagina's
|
total_pages | integer |
Het totale aantal pagina's dat beschikbaar is. |
|
Totale rijen
|
total_rows | integer |
Het totale aantal rijen. |
|
Aantal werkruimtekoppelingen
|
workspace_link_count | integer |
Het totale aantal koppelingen in de werkruimte. |
Werkruimten weergeven
Retourneert de werkruimten die beschikbaar zijn voor deze verbinding. Gebruik deze om de werkruimte te vinden die andere acties vereisen.
Retouren
| Naam | Pad | Type | Description |
|---|---|---|---|
|
|
array of object | ||
|
Werkruimte-id
|
id | integer |
De unieke id van de werkruimte. |
|
Werkruimte naam
|
name | string |
De naam van de werkruimte. |
Definities
tekenreeks
Dit is het basisgegevenstype 'tekenreeks'.