Linkly (wersja zapoznawcza)
Linkly to skrócony link i kliknięcie trackera. Utwórz krótkie linki oznaczone marką za pomocą domen niestandardowych, dodaj parametry UTM i retargeting pikseli, konwersje raportów i ściągnąć analizy kliknięć pogrupowane według kraju, platformy, odwołań lub kampanii.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate - narzędzie do automatyzacji procesów | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt biznesowy | |
|---|---|
| Name | Obsługa linków |
| adres URL | https://linklyhq.com/support |
| support@linklyhq.com |
| Metadane łącznika | |
|---|---|
| Publisher | Link |
| Witryna internetowa | https://linklyhq.com |
| Zasady ochrony prywatności | https://linklyhq.com/support/privacy |
| Kategorie | Marketing; Witryna internetowa |
Link
Linkly to skrócony link i kliknięcie trackera. Tworzy on krótkie linki markowe we własnej domenie, śledzi każde kliknięcie za pomocą podziałów kraju, platformy i odwołań, uruchamia retargeting pikseli i rejestruje konwersje z powrotem do linku, który je wygenerował. Ten łącznik umożliwia przepływom tworzenie linków i zarządzanie nimi, ściąganie konwersji analiz i raportów w obszarze roboczym Linkly.
Publisher: Linkly
Prerequisites
Konto linkowe. Bezpłatny plan wystarczy, aby użyć każdej akcji w tym łączniku. Konwersje raportów i list również wymagają włączenia funkcji śledzenia konwersji linków w obszarze roboczym.
Obsługiwane operacje
Lista obszarów roboczych
Zwraca obszary robocze dostępne dla tego połączenia. Użyj go, aby znaleźć obszar roboczy, którego wymagają inne akcje.
Tworzenie lub aktualizowanie linku
Tworzy nowy krótki link lub aktualizuje istniejący po podaniu identyfikatora linku. Obsługuje domeny niestandardowe i ślimaki, parametry UTM, retargeting pikseli i metadane programu Open Graph.
Uzyskaj link
Pobiera pojedynczy link według jego identyfikatora, w tym jego miejsca docelowego, krótkiego adresu URL i konfiguracji.
Łącza listy
Zwraca listę linków podzielonych na strony w obszarze roboczym z użyciem statystyk kliknięć. Obsługuje wyszukiwanie i sortowanie.
Usuń link
Przenosi link do kosza. Jego krótki adres URL zatrzymuje przekierowywanie, a link można przywrócić później z kosza.
Pobieranie analizy kliknięć
Zwraca liczbę kliknięć w czasie dla obszaru roboczego lub dla określonych linków, opcjonalnie filtrowane według zakresu dat, kraju, przeglądarki, platformy, odwołań lub usługodawców internetowych.
Pobieranie liczby kliknięć według wymiaru
Zwraca liczby kliknięć pogrupowane według wymiaru, takiego jak kraj, miasto, platforma, odwołanie lub parametr UTM, uporządkowane według liczby malejącej.
Wyświetlanie listy domen niestandardowych
Zwraca domeny niestandardowe skonfigurowane dla obszaru roboczego. Te nazwy domen mogą być używane podczas tworzenia łączy.
Zgłaszanie konwersji
Rejestruje konwersję, taką jak zakup, rejestracja lub zdarzenie niestandardowe oraz atrybuty go do linku, który został kliknięty po podaniu tokenu autorstwa.
Konwersje listy
Zwraca najnowsze konwersje zarejestrowane w obszarze roboczym.
Uzyskiwanie poświadczeń
Ten łącznik używa protokołu OAuth 2.0. Nie jest wymagany żaden klucz interfejsu API.
- Jeśli nie masz jeszcze konta Linkly, zarejestruj się pod adresem https://linklyhq.com. Plan bezpłatny działa.
- Podczas tworzenia połączenia wybierz pozycję Zaloguj się za pomocą linku i zaloguj się przy użyciu konta Linkly.
- Wybierz obszar roboczy, którego ma używać to połączenie po wyświetleniu monitu, a następnie zatwierdź żądanie.
Połączenie jest powiązane z wybranym obszarem roboczym. Aby pracować w innym obszarze roboczym, utwórz drugie połączenie.
Wprowadzenie
- Utwórz połączenie zgodnie z powyższym opisem.
- Dodaj akcję Utwórz lub zaktualizuj łącze do przepływu, wprowadź docelowy adres URL i, opcjonalnie, domenę niestandardową i ślimak. Akcja zwraca krótki adres URL i identyfikator linku.
- Użyj linków listy, kliknij pozycję Analiza lub Pobierz liczbę kliknięć według wymiaru , aby odczytać dane. Akcje, które podejmują obszar roboczy , umożliwiają wybranie go z listy, która jest wypełniana przez obszary robocze listy.
- Aby przypisywać zakupy lub rejestrować się w linkach, przekaż
linkly_cidwartość z adresu URL strony docelowej do raportu konwersji jako tokenu autorstwa.
Znane problemy i ograniczenia
- Połączenie jest powiązane z pojedynczym obszarem roboczym Linkly wybranym podczas logowania. Utwórz jedno połączenie na obszar roboczy.
- Zgłaszanie konwersji i konwersji listy wymaga funkcji śledzenia konwersji linków. Obszary robocze bez tego błędu są wyświetlane z tych akcji.
- Elementy webhook kliknięć w czasie rzeczywistym nie są widoczne jako wyzwalacze. Zamiast tego użyj funkcji elementu webhook linkly z przepływem wyzwalanym przez protokół HTTP.
- Tworzenie linków zbiorczych, eksportowanie linków i zarządzanie domenami są dostępne w interfejsie API Linkly, ale nie są uwzględnione w tym łączniku.
- Interfejs API jest ograniczony szybkością. Pobieranie liczby kliknięć według wymiaru zwraca błąd limitu szybkości po przekroczeniu limitu; ponów próbę po krótkim opóźnieniu.
Często zadawane pytania
W którym obszarze roboczym są uruchamiane akcje?
Akcje, które przyjmują parametr Obszaru roboczego , pokazują listę obszarów roboczych dostępnych dla połączenia. Akcje bez jednego, takie jak pobieranie linku, zgłaszanie konwersji i konwersji listy, używają obszaru roboczego powiązanego z połączeniem.
Jak używać domeny niestandardowej?
Najpierw dodaj domenę w linku, a następnie przekaż jej nazwę w polu Domena w obszarze Tworzenie lub aktualizowanie łącza. Lista domen niestandardowych zwraca nazwy dostępne w obszarze roboczym.
Czy usunięcie linku powoduje trwałe usunięcie łącza?
No. Link zostanie przeniesiony do kosza i zatrzyma przekierowanie. Można go przywrócić z kosza w linkly.
Instrukcje dotyczące wdrażania
- W portalu producenta otwórz pozycję Łączniki niestandardowe, wybierz pozycję Nowy łącznik niestandardowy , a następnie zaimportuj plik OpenAPI. Wybierz opcję
apiDefinition.swagger.json. - Na karcie Zabezpieczenia wybierz pozycję OAuth 2.0 z ogólnym dostawcą tożsamości Oauth 2 . Wprowadź identyfikator klienta i klucz tajny klienta wystawiony przez linkly, ustaw adres URL autoryzacji na
https://app.linklyhq.com/oauth/authorize, a następnie ustaw adres URL tokenu i odśwież adres URL nahttps://app.linklyhq.com/oauth/token. - Utwórz łącznik, a następnie skopiuj adres URL przekierowania widoczny na karcie Zabezpieczenia i zarejestruj go w linkly dla tego identyfikatora klienta.
- Utwórz połączenie, logując się przy użyciu konta Linkly, a następnie przetestuj akcję, taką jak Wyświetlanie listy obszarów roboczych.
Akcje
| Konwersje listy |
Zwraca najnowsze konwersje zarejestrowane w obszarze roboczym. |
| Lista obszarów roboczych |
Zwraca obszary robocze dostępne dla tego połączenia. Użyj go, aby znaleźć obszar roboczy, którego wymagają inne akcje. |
| Pobieranie analizy kliknięć |
Zwraca liczbę kliknięć w czasie dla obszaru roboczego lub dla określonych linków, opcjonalnie filtrowane według zakresu dat, kraju, przeglądarki, platformy, odwołań lub usługodawców internetowych. |
| Pobieranie liczby kliknięć według wymiaru |
Zwraca liczby kliknięć pogrupowane według wymiaru, takiego jak kraj, miasto, platforma, odwołanie lub parametr UTM, uporządkowane według liczby malejącej. |
| Tworzenie lub aktualizowanie linku |
Tworzy nowy krótki link lub aktualizuje istniejący po podaniu identyfikatora linku. Obsługuje domeny niestandardowe i ślimaki, parametry UTM, retargeting pikseli i metadane programu Open Graph. |
| Usuń link |
Przenosi link do kosza. Jego krótki adres URL zatrzymuje przekierowywanie, a link można przywrócić później z kosza. |
| Uzyskaj link |
Pobiera pojedynczy link według jego identyfikatora, w tym jego miejsca docelowego, krótkiego adresu URL i konfiguracji. |
| Wyświetlanie listy domen niestandardowych |
Zwraca domeny niestandardowe skonfigurowane dla obszaru roboczego. Te nazwy domen mogą być używane podczas tworzenia łączy. |
| Zgłaszanie konwersji |
Rejestruje konwersję, taką jak zakup, rejestracja lub zdarzenie niestandardowe oraz atrybuty go do linku, który został kliknięty po podaniu tokenu autorstwa. |
| Łącza listy |
Zwraca listę linków podzielonych na strony w obszarze roboczym z użyciem statystyk kliknięć. Obsługuje wyszukiwanie i sortowanie. |
Konwersje listy
Zwraca najnowsze konwersje zarejestrowane w obszarze roboczym.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Limit
|
limit | integer |
Maksymalna liczba konwersji do zwrócenia z zakresu od 1 do 1000. |
Zwraca
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Conversions
|
conversions | array of object |
Konwersje, ostatnio używane jako pierwsze. |
|
Kwota (centy)
|
conversions.amount_cents | integer |
Wartość w najmniejszej jednostce walutowej. Może być ujemna, aby zarejestrować zwrot kosztów. |
|
Kliknij identyfikator
|
conversions.click_id | string |
Identyfikator przypisanego kliknięcia. |
|
Country
|
conversions.country | string |
Dwuliterowy kod kraju ISO 3166-1, na przykład USA. |
|
Waluta
|
conversions.currency | string |
Kod waluty ISO 4217. Wartość domyślna to USD. |
|
Identyfikator zdarzenia
|
conversions.event_id | string |
Identyfikator zdarzenia. Raportowanie tej samej wartości dwukrotnie nie powoduje utworzenia drugiej konwersji. |
|
Nazwa zdarzenia
|
conversions.event_name | string |
Co się stało, na przykład zakup, rejestracja lub trial_started. |
|
Typ zdarzenia
|
conversions.event_type | string |
Typ zdarzenia grubego. Użyj potencjalnych klientów, aby ustanowić tożsamość klienta i sprzedaż w celu rejestrowania przychodów. Wartości domyślne do niestandardowych. |
|
Identyfikator klienta
|
conversions.external_id | string |
Identyfikator klienta. Wyślij je na każde zdarzenie, aby później można było połączyć sprzedaż z oryginalnym kliknięciem. |
|
Identyfikator konwersji
|
conversions.id | string |
Unikatowy identyfikator konwersji. Identyfikatory sortuje chronologicznie. |
|
Wstawiono o
|
conversions.inserted_at | date-time |
Po zarejestrowaniu konwersji. |
|
Źródło adresu IP
|
conversions.ip_source | string |
Którego adres został zarejestrowany: odwiedzający, serwer lub nieznany. Serwer oznacza, że adres połączenia należy do zaplecza lub przekaźnika platformy, więc jest wykluczony z raportowania geograficznego. |
|
Identyfikator łącza
|
conversions.link_id | integer |
Identyfikator linku przypisanego lub wartość null, jeśli konwersja nie może być przypisana linkowi. |
|
Metadata
|
conversions.metadata | object |
Dowolne metadane JSON, do 10 000 bajtów. |
|
Wystąpił o
|
conversions.occurred_at | date-time |
Po zakończeniu konwersji w formacie ISO 8601. Domyślnie ustawione na teraz. |
|
Source
|
conversions.source | string |
Która integracja go zgłosiła. |
Lista obszarów roboczych
Zwraca obszary robocze dostępne dla tego połączenia. Użyj go, aby znaleźć obszar roboczy, którego wymagają inne akcje.
Zwraca
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
|
array of object | ||
|
Identyfikator obszaru roboczego
|
id | integer |
Unikatowy identyfikator obszaru roboczego. |
|
Nazwa obszaru roboczego
|
name | string |
Nazwa obszaru roboczego. |
Pobieranie analizy kliknięć
Zwraca liczbę kliknięć w czasie dla obszaru roboczego lub dla określonych linków, opcjonalnie filtrowane według zakresu dat, kraju, przeglądarki, platformy, odwołań lub usługodawców internetowych.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Obszar roboczy do pracy. Wybierz ją z listy lub wprowadź jej identyfikator. |
|
Identyfikator łącza
|
link_id | string |
Identyfikator pojedynczego linku do filtrowania według. |
|
|
Identyfikatory łączy
|
link_ids | string |
Rozdzielona łącznikami lista identyfikatorów linków do filtrowania według. |
|
|
Data rozpoczęcia
|
start | string |
Początek zakresu dat w formacie RRRR-MM-DD. |
|
|
Data zakończenia
|
end | string |
Koniec zakresu dat w formacie RRRR-MM-DD. |
|
|
Country
|
country | string |
Dwuliterowy kod kraju ISO 3166-1, na przykład USA. |
|
|
Przeglądarka
|
browser | string |
Nazwa przeglądarki do filtrowania według, na przykład Chrome, Firefox lub Safari. |
|
|
Platform
|
platform | string |
Platforma lub system operacyjny do filtrowania według, na przykład Windows, Mac, iOS lub Android. |
|
|
Odsyłacz
|
referer | string |
Domena odwołująca się do filtrowania według. |
|
|
usługodawca internetowy
|
isp | string |
Nazwa dostawcy usług internetowych do filtrowania według. |
|
|
Dołączanie botów
|
bots | boolean |
Czy należy uwzględnić kliknięcia zidentyfikowane jako boty. Ustaw wartość false, aby je wykluczyć. |
|
|
Tylko unikatowe
|
unique | boolean |
Czy należy liczyć tylko unikatowe kliknięcia. |
|
|
Strefa czasowa
|
timezone | string |
Strefa czasowa IANA używana do obliczeń dat, na przykład Europa/Londyn. |
|
|
Częstotliwość
|
frequency | string |
Stopień szczegółowości szeregu czasowego, dnia lub godziny. |
Zwraca
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Traffic
|
traffic | array of object |
Liczba kliknięć w czasie. |
|
Początek zasobnika
|
traffic.t | string |
Początek zasobnika: RRRR-MM-DD dla zasobników dziennych lub RRRR-MM-DDTHH:MM:SS dla zasobników godzinowych. |
|
Kliknięcia
|
traffic.y | integer |
Liczba kliknięć w zasobniku. |
Pobieranie liczby kliknięć według wymiaru
Zwraca liczby kliknięć pogrupowane według wymiaru, takiego jak kraj, miasto, platforma, odwołanie lub parametr UTM, uporządkowane według liczby malejącej.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Obszar roboczy do pracy. Wybierz ją z listy lub wprowadź jej identyfikator. |
|
Wymiar
|
counter | True | string |
Wymiar do grupowania kliknięć według, na przykład kraj, miasto, platforma, referer lub utm_campaign. |
|
Identyfikator łącza
|
link_id | string |
Identyfikator pojedynczego linku do filtrowania według. |
|
|
Identyfikatory łączy
|
link_ids | string |
Rozdzielona łącznikami lista identyfikatorów linków do filtrowania według. |
|
|
Data rozpoczęcia
|
start | string |
Początek zakresu dat w formacie RRRR-MM-DD. |
|
|
Data zakończenia
|
end | string |
Koniec zakresu dat w formacie RRRR-MM-DD. |
|
|
Country
|
country | string |
Dwuliterowy kod kraju ISO 3166-1, na przykład USA. |
|
|
Dołączanie botów
|
bots | boolean |
Czy należy uwzględnić kliknięcia zidentyfikowane jako boty. Ustaw wartość false, aby je wykluczyć. |
|
|
Tylko unikatowe
|
unique | boolean |
Czy należy liczyć tylko unikatowe kliknięcia. |
Zwraca
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Total
|
total | integer |
Łączna liczba kliknięć we wszystkich grupach, w tym żadnych nie zwracanych wartości. Gdy wynik zostanie obcięty, jest to większe niż suma liczby wartości, więc liczba / suma nadal daje dokładną wartość procentową. |
|
Values
|
values | array of object |
Pogrupowane liczby uporządkowane według liczby malejącej. Obcięte do pierwszych 10 000 wartości; jeśli wymiar ma więcej odrębnych wartości, pozostałe nie są zwracane. |
|
Liczba
|
values.count | integer |
Liczba kliknięć dla tej wartości. |
|
Value
|
values.value | string |
Wartość wymiaru, na przykład kod kraju. |
Tworzenie lub aktualizowanie linku
Tworzy nowy krótki link lub aktualizuje istniejący po podaniu identyfikatora linku. Obsługuje domeny niestandardowe i ślimaki, parametry UTM, retargeting pikseli i metadane programu Open Graph.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Docelowy adres URL
|
url | uri |
Docelowy adres URL, do którego przekierowuje krótki link. Wymagane do utworzenia nowego linku. |
|
|
Identyfikator łącza
|
id | integer |
Identyfikator istniejącego linku do aktualizacji. Pozostaw pole puste, aby utworzyć nowy link. |
|
|
Name
|
name | string |
Pseudonim linku pokazanego na pulpicie nawigacyjnym. |
|
|
Domain
|
domain | string |
Domena niestandardowa do użycia dla krótkiego linku bez końcowego ukośnika. |
|
|
Slug
|
slug | string |
Ścieżka niestandardowa krótkiego linku. Musi zaczynać się od ukośnika. |
|
|
Enabled
|
enabled | boolean |
Czy link jest aktywny. |
|
|
Note
|
note | string |
Prywatna notatka dotycząca linku. |
|
|
Źródło UTM
|
utm_source | string |
Parametr utm_source dołączony do docelowego adresu URL. |
|
|
UtM — średni rozmiar
|
utm_medium | string |
Parametr utm_medium dołączony do docelowego adresu URL. |
|
|
Kampania UTM
|
utm_campaign | string |
Parametr utm_campaign dołączony do docelowego adresu URL. |
|
|
Zawartość utM
|
utm_content | string |
Parametr utm_content dołączony do docelowego adresu URL. |
|
|
Termin UTM
|
utm_term | string |
Parametr utm_term dołączony do docelowego adresu URL. |
|
|
Identyfikator meta piksela
|
fb_pixel_id | string |
Meta (Facebook) Pixel ID do uruchomienia po kliknięciu linku. |
|
|
Identyfikator tagu usługi Google Analytics 4
|
ga4_tag_id | string |
Identyfikator pomiaru 4 usługi Google Analytics do uruchomienia po kliknięciu linku. |
|
|
Identyfikator menedżera tagów Google
|
gtm_id | string |
Identyfikator kontenera Usługi Google Tag Manager do załadowania po kliknięciu linku. |
|
|
Blokuj boty
|
block_bots | boolean |
Czy zablokować znane boty z poziomu linku. |
|
|
Tagi treści
|
body_tags | string |
Niestandardowe tagi HTML lub śledzenia wstawione do treści strony przekierowania. |
|
|
Maskowanie
|
cloaking | boolean |
Czy ukryć miejsce docelowe, otwierając go wewnątrz ramki. |
|
|
Parametry przekazywania
|
forward_params | boolean |
Czy przekazywać parametry zapytania z krótkiego linku do miejsca docelowego. |
|
|
Tagi głowy
|
head_tags | string |
Niestandardowe tagi HTML lub śledzenia wstawione do nagłówka strony przekierowania. |
|
|
Ukryj odwołanie
|
hide_referrer | boolean |
Czy ukryć odwołanie w lokacji docelowej. |
|
|
Otwórz opis grafu
|
og_description | string |
Opis wyświetlany po udostępnieniu linku w mediach społecznościowych. |
|
|
Otwórz obraz programu Graph
|
og_image | string |
Adres URL obrazu wyświetlany po udostępnieniu linku w mediach społecznościowych. |
|
|
Otwórz tytuł grafu
|
og_title | string |
Tytuł wyświetlany po udostępnieniu linku w mediach społecznościowych. |
|
|
Identyfikator piksela TikTok
|
tiktok_pixel_id | string |
Identyfikator piksela TikTok do uruchomienia po kliknięciu linku. |
Zwraca
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator meta piksela
|
fb_pixel_id | string |
Meta (Facebook) Pixel ID do uruchomienia po kliknięciu linku. |
|
identyfikator partnera LinkedIn
|
linkedin_partner_id | string |
Identyfikator partnera tagu usługi LinkedIn Insight do uruchomienia po kliknięciu linku. |
|
identyfikator tagu UET Microsoft
|
microsoft_uet_tag_id | string |
Identyfikator tagu UET Microsoft Advertising do uruchomienia po kliknięciu linku. |
|
Identyfikator reddit pixel
|
reddit_pixel_id | string |
Identyfikator Reddit Pixel do uruchomienia po kliknięciu linku. |
|
Identyfikator piksela TikTok
|
tiktok_pixel_id | string |
Identyfikator piksela TikTok do uruchomienia po kliknięciu linku. |
|
Ukryj odwołanie
|
hide_referrer | boolean |
Czy ukryć odwołanie w lokacji docelowej. |
|
Data wygaśnięcia
|
expiry_datetime | string |
Gdy link przestanie działać, w formacie ISO 8601. |
|
Miejsce docelowe wygaśnięcia
|
expiry_destination | uri |
Adres URL do przekierowania do adresu po wygaśnięciu linku. Pozostaw pole puste, aby zwrócić nieznaną stronę. |
|
Identyfikator X pikseli
|
twitter_pixel_id | string |
X (Twitter) Pixel ID do uruchomienia po kliknięciu linku. |
|
Maskowanie
|
cloaking | boolean |
Czy ukryć miejsce docelowe, otwierając go wewnątrz ramki. |
|
Krótki adres URL
|
full_url | uri |
Pełny krótki adres URL linku. |
|
Otwórz opis grafu
|
og_description | string |
Opis wyświetlany po udostępnieniu linku w mediach społecznościowych. |
|
Pomiń śledzenie przeszukiwarki społecznościowej
|
skip_social_crawler_tracking | boolean |
Czy wykluczyć przeszukiwarki z podglądu mediów społecznościowych z śledzenia kliknięć. |
|
Tagi treści
|
body_tags | string |
Niestandardowe tagi HTML lub śledzenia wstawione do treści strony przekierowania. |
|
Otwórz tytuł grafu
|
og_title | string |
Tytuł wyświetlany po udostępnieniu linku w mediach społecznościowych. |
|
Note
|
note | string |
Prywatna notatka dotycząca linku. |
|
Name
|
name | string |
Pseudonim linku pokazanego na pulpicie nawigacyjnym. |
|
Identyfikator łącza
|
id | integer |
Identyfikator istniejącego linku do aktualizacji. Pozostaw pole puste, aby utworzyć nowy link. |
|
Identyfikator menedżera tagów Google
|
gtm_id | string |
Identyfikator kontenera Usługi Google Tag Manager do załadowania po kliknięciu linku. |
|
Otwórz obraz programu Graph
|
og_image | string |
Adres URL obrazu wyświetlany po udostępnieniu linku w mediach społecznościowych. |
|
Blokuj boty
|
block_bots | boolean |
Czy zablokować znane boty z poziomu linku. |
|
Snapchat Pixel ID
|
snapchat_pixel_id | string |
Identyfikator piksela Snapchata do uruchomienia po kliknięciu linku. |
|
Zawartość utM
|
utm_content | string |
Parametr utm_content dołączony do docelowego adresu URL. |
|
Enabled
|
enabled | boolean |
Czy link jest aktywny. |
|
Docelowy adres URL
|
url | uri |
Docelowy adres URL, do którego przekierowuje krótki link. Wymagane do utworzenia nowego linku. |
|
Usunięto
|
deleted | boolean |
Czy link znajduje się w koszu. |
|
Webhooks
|
webhooks | array of string |
Subskrybowane adresy URL elementów webhook umożliwiają kliknięcie tego linku. |
|
Kliknięcia wygasania
|
expiry_clicks | integer |
Liczba kliknięć, po których link przestaje działać. |
|
Powiadamianie usługi Slack
|
notify_slack | boolean |
Czy wysłać powiadomienie usługi Slack po kliknięciu linku. |
|
Identyfikator obszaru roboczego
|
workspace_id | integer |
Identyfikator obszaru roboczego. |
|
Analiza publiczna
|
public_analytics | boolean |
Czy strona analizy linku jest publicznie widoczna. |
|
Identyfikator tagu Pinezka
|
pinterest_tag_id | string |
Identyfikator tagu Na Pintereście, który ma być uruchamiany po kliknięciu linku. |
|
Źródło UTM
|
utm_source | string |
Parametr utm_source dołączony do docelowego adresu URL. |
|
Slug
|
slug | string |
Ścieżka niestandardowa krótkiego linku. Musi zaczynać się od ukośnika. |
|
Domain
|
domain | string |
Domena niestandardowa do użycia dla krótkiego linku bez końcowego ukośnika. |
|
Parametry przekazywania
|
forward_params | boolean |
Czy przekazywać parametry zapytania z krótkiego linku do miejsca docelowego. |
|
UtM — średni rozmiar
|
utm_medium | string |
Parametr utm_medium dołączony do docelowego adresu URL. |
|
Tagi głowy
|
head_tags | string |
Niestandardowe tagi HTML lub śledzenia wstawione do nagłówka strony przekierowania. |
|
Identyfikator tagu usługi Google Analytics 4
|
ga4_tag_id | string |
Identyfikator pomiaru 4 usługi Google Analytics do uruchomienia po kliknięciu linku. |
|
Termin UTM
|
utm_term | string |
Parametr utm_term dołączony do docelowego adresu URL. |
|
Kampania UTM
|
utm_campaign | string |
Parametr utm_campaign dołączony do docelowego adresu URL. |
Usuń link
Przenosi link do kosza. Jego krótki adres URL zatrzymuje przekierowywanie, a link można przywrócić później z kosza.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Obszar roboczy do pracy. Wybierz ją z listy lub wprowadź jej identyfikator. |
|
Identyfikator łącza
|
id | True | integer |
Identyfikator linku. |
Zwraca
Komunikat potwierdzający.
- response
- string
Uzyskaj link
Pobiera pojedynczy link według jego identyfikatora, w tym jego miejsca docelowego, krótkiego adresu URL i konfiguracji.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator łącza
|
id | True | string |
Identyfikator linku. |
Zwraca
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator meta piksela
|
fb_pixel_id | string |
Meta (Facebook) Pixel ID do uruchomienia po kliknięciu linku. |
|
identyfikator partnera LinkedIn
|
linkedin_partner_id | string |
Identyfikator partnera tagu usługi LinkedIn Insight do uruchomienia po kliknięciu linku. |
|
identyfikator tagu UET Microsoft
|
microsoft_uet_tag_id | string |
Identyfikator tagu UET Microsoft Advertising do uruchomienia po kliknięciu linku. |
|
Identyfikator reddit pixel
|
reddit_pixel_id | string |
Identyfikator Reddit Pixel do uruchomienia po kliknięciu linku. |
|
Identyfikator piksela TikTok
|
tiktok_pixel_id | string |
Identyfikator piksela TikTok do uruchomienia po kliknięciu linku. |
|
Ukryj odwołanie
|
hide_referrer | boolean |
Czy ukryć odwołanie w lokacji docelowej. |
|
Data wygaśnięcia
|
expiry_datetime | string |
Gdy link przestanie działać, w formacie ISO 8601. |
|
Miejsce docelowe wygaśnięcia
|
expiry_destination | uri |
Adres URL do przekierowania do adresu po wygaśnięciu linku. Pozostaw pole puste, aby zwrócić nieznaną stronę. |
|
Identyfikator X pikseli
|
twitter_pixel_id | string |
X (Twitter) Pixel ID do uruchomienia po kliknięciu linku. |
|
Maskowanie
|
cloaking | boolean |
Czy ukryć miejsce docelowe, otwierając go wewnątrz ramki. |
|
Krótki adres URL
|
full_url | uri |
Pełny krótki adres URL linku. |
|
Otwórz opis grafu
|
og_description | string |
Opis wyświetlany po udostępnieniu linku w mediach społecznościowych. |
|
Pomiń śledzenie przeszukiwarki społecznościowej
|
skip_social_crawler_tracking | boolean |
Czy wykluczyć przeszukiwarki z podglądu mediów społecznościowych z śledzenia kliknięć. |
|
Tagi treści
|
body_tags | string |
Niestandardowe tagi HTML lub śledzenia wstawione do treści strony przekierowania. |
|
Otwórz tytuł grafu
|
og_title | string |
Tytuł wyświetlany po udostępnieniu linku w mediach społecznościowych. |
|
Note
|
note | string |
Prywatna notatka dotycząca linku. |
|
Name
|
name | string |
Pseudonim linku pokazanego na pulpicie nawigacyjnym. |
|
Identyfikator łącza
|
id | integer |
Unikatowy identyfikator linku. |
|
Identyfikator menedżera tagów Google
|
gtm_id | string |
Identyfikator kontenera Usługi Google Tag Manager do załadowania po kliknięciu linku. |
|
Otwórz obraz programu Graph
|
og_image | string |
Adres URL obrazu wyświetlany po udostępnieniu linku w mediach społecznościowych. |
|
Blokuj boty
|
block_bots | boolean |
Czy zablokować znane boty z poziomu linku. |
|
Snapchat Pixel ID
|
snapchat_pixel_id | string |
Identyfikator piksela Snapchata do uruchomienia po kliknięciu linku. |
|
Zawartość utM
|
utm_content | string |
Parametr utm_content dołączony do docelowego adresu URL. |
|
Enabled
|
enabled | boolean |
Czy link jest aktywny. |
|
Docelowy adres URL
|
url | uri |
Docelowy adres URL, do którego przekierowuje krótki link. |
|
Usunięto
|
deleted | boolean |
Czy link znajduje się w koszu. |
|
Webhooks
|
webhooks | array of string |
Subskrybowane adresy URL elementów webhook umożliwiają kliknięcie tego linku. |
|
Kliknięcia wygasania
|
expiry_clicks | integer |
Liczba kliknięć, po których link przestaje działać. |
|
Powiadamianie usługi Slack
|
notify_slack | boolean |
Czy wysłać powiadomienie usługi Slack po kliknięciu linku. |
|
Identyfikator obszaru roboczego
|
workspace_id | integer |
Identyfikator obszaru roboczego. |
|
Analiza publiczna
|
public_analytics | boolean |
Czy strona analizy linku jest publicznie widoczna. |
|
Identyfikator tagu Pinezka
|
pinterest_tag_id | string |
Identyfikator tagu Na Pintereście, który ma być uruchamiany po kliknięciu linku. |
|
Źródło UTM
|
utm_source | string |
Parametr utm_source dołączony do docelowego adresu URL. |
|
Slug
|
slug | string |
Ścieżka niestandardowa krótkiego linku. Musi zaczynać się od ukośnika. |
|
Domain
|
domain | string |
Domena niestandardowa do użycia dla krótkiego linku bez końcowego ukośnika. |
|
Parametry przekazywania
|
forward_params | boolean |
Czy przekazywać parametry zapytania z krótkiego linku do miejsca docelowego. |
|
UtM — średni rozmiar
|
utm_medium | string |
Parametr utm_medium dołączony do docelowego adresu URL. |
|
Tagi głowy
|
head_tags | string |
Niestandardowe tagi HTML lub śledzenia wstawione do nagłówka strony przekierowania. |
|
Identyfikator tagu usługi Google Analytics 4
|
ga4_tag_id | string |
Identyfikator pomiaru 4 usługi Google Analytics do uruchomienia po kliknięciu linku. |
|
Termin UTM
|
utm_term | string |
Parametr utm_term dołączony do docelowego adresu URL. |
|
Kampania UTM
|
utm_campaign | string |
Parametr utm_campaign dołączony do docelowego adresu URL. |
Wyświetlanie listy domen niestandardowych
Zwraca domeny niestandardowe skonfigurowane dla obszaru roboczego. Te nazwy domen mogą być używane podczas tworzenia łączy.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Obszar roboczy do pracy. Wybierz ją z listy lub wprowadź jej identyfikator. |
Zwraca
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Domains
|
domains | array of object |
Domeny niestandardowe w obszarze roboczym. |
|
Nazwa domeny
|
domains.name | string |
Nazwa domeny, na przykład go.yourcompany.com. |
Zgłaszanie konwersji
Rejestruje konwersję, taką jak zakup, rejestracja lub zdarzenie niestandardowe oraz atrybuty go do linku, który został kliknięty po podaniu tokenu autorstwa.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Kwota (centy)
|
amount_cents | integer |
Wartość w najmniejszej jednostce walutowej. Może być ujemna, aby zarejestrować zwrot lub obciążenie zwrotne, które są netto w stosunku do wcześniejszych przychodów. |
|
|
Country
|
country | string |
Dwuliterowy kod kraju konwersji. Wnioskowane w przypadku wywołań po stronie przeglądarki; podaj ją jawnie z integracji po stronie serwera, gdzie adres łączący jest twoją własną infrastrukturą, a nie z klientem. |
|
|
Waluta
|
currency | string |
Kod waluty ISO 4217. Wartość domyślna to USD. |
|
|
Identyfikator zdarzenia
|
event_id | string |
Identyfikator tego zdarzenia. Używany jako klucz idempotentności; dwukrotne raportowanie tej samej wartości nie spowoduje utworzenia drugiej konwersji. Dotyczy dowolnego typu zdarzenia, a nie tylko zakupów. |
|
|
Nazwa zdarzenia
|
event_name | True | string |
Co się stało, np. zakup, rejestracja, trial_started. |
|
Typ zdarzenia
|
event_type | string |
Gruba typ jazdy lejka. lead ustanawia tożsamość klienta, rekordy sprzedaży przychodów. Wartości domyślne do niestandardowych. |
|
|
Identyfikator klienta
|
external_id | string |
Identyfikator klienta. Wyślij je na każde zdarzenie: łączy późniejszą sprzedaż po stronie serwera z powrotem do kliknięcia, który wygenerował rejestrację. |
|
|
Token autorstwa
|
linkly_cid | string |
Token autorstwa przechwycony z adresu URL strony docelowej. Pomiń, jeśli jest niedostępny; konwersja jest następnie rejestrowana bez przypisania linku. |
|
|
Metadata
|
metadata | object |
Dowolny kod JSON, do 10 000 bajtów zakodowanych. |
|
|
Wystąpił o
|
occurred_at | date-time |
Po zakończeniu konwersji. Domyślnie ustawione na teraz. |
|
|
Adres IP gościa
|
visitor_ip | string |
Adres IP klienta końcowego, gdy serwer go ma. Pomiń, chyba że to zrobisz; w przypadku wywołań po stronie serwera Linkly w przeciwnym razie rejestruje adres połączenia jako serwer, a nie klienta i wyklucza go z raportowania geograficznego. Wysłanie tego potwierdzenia oznacza, że masz zgodną z prawem podstawę do jego udostępnienia. Interfejs API nigdy nie zwracał. |
Zwraca
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Kwota (centy)
|
amount_cents | integer |
Wartość w najmniejszej jednostce walutowej. Może być ujemna, aby zarejestrować zwrot kosztów. |
|
Kliknij identyfikator
|
click_id | string |
Identyfikator przypisanego kliknięcia. |
|
Country
|
country | string |
Dwuliterowy kod kraju ISO 3166-1, na przykład USA. |
|
Waluta
|
currency | string |
Kod waluty ISO 4217. Wartość domyślna to USD. |
|
Identyfikator zdarzenia
|
event_id | string |
Identyfikator zdarzenia. Raportowanie tej samej wartości dwukrotnie nie powoduje utworzenia drugiej konwersji. |
|
Nazwa zdarzenia
|
event_name | string |
Co się stało, na przykład zakup, rejestracja lub trial_started. |
|
Typ zdarzenia
|
event_type | string |
Typ zdarzenia grubego. Użyj potencjalnych klientów, aby ustanowić tożsamość klienta i sprzedaż w celu rejestrowania przychodów. Wartości domyślne do niestandardowych. |
|
Identyfikator klienta
|
external_id | string |
Identyfikator klienta. Wyślij je na każde zdarzenie, aby później można było połączyć sprzedaż z oryginalnym kliknięciem. |
|
Identyfikator konwersji
|
id | string |
Unikatowy identyfikator konwersji. Identyfikatory sortuje chronologicznie. |
|
Wstawiono o
|
inserted_at | date-time |
Po zarejestrowaniu konwersji. |
|
Źródło adresu IP
|
ip_source | string |
Którego adres został zarejestrowany: odwiedzający, serwer lub nieznany. Serwer oznacza, że adres połączenia należy do zaplecza lub przekaźnika platformy, więc jest wykluczony z raportowania geograficznego. |
|
Identyfikator łącza
|
link_id | integer |
Identyfikator linku przypisanego lub wartość null, jeśli konwersja nie może być przypisana linkowi. |
|
Metadata
|
metadata | object |
Dowolne metadane JSON, do 10 000 bajtów. |
|
Wystąpił o
|
occurred_at | date-time |
Po zakończeniu konwersji w formacie ISO 8601. Domyślnie ustawione na teraz. |
|
Source
|
source | string |
Która integracja go zgłosiła. |
Łącza listy
Zwraca listę linków podzielonych na strony w obszarze roboczym z użyciem statystyk kliknięć. Obsługuje wyszukiwanie i sortowanie.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Obszar roboczy do pracy. Wybierz ją z listy lub wprowadź jej identyfikator. |
|
Search
|
search | string |
Termin wyszukiwania do filtrowania łączy według nazwy, adresu URL lub ślimaka. |
|
|
Strona
|
page | integer |
Numer strony do zwrócenia, począwszy od 1. |
|
|
Rozmiar strony
|
page_size | integer |
Liczba łączy zwracanych na stronę. |
|
|
Sortuj wg
|
sort_by | string |
Pole do sortowania według, na przykład clicks_total, nazwy lub inserted_at. |
|
|
Kierunek sortowania
|
sort_dir | string |
Kierunek sortowania, asc lub desc. |
|
|
Usunięto
|
deleted | boolean |
Czy zwracać linki, które znajdują się w koszu zamiast aktywnych linków. |
Zwraca
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Links
|
links | array of object |
Linki na tej stronie. |
|
Identyfikator meta piksela
|
links.fb_pixel_id | string |
Meta (Facebook) Pixel ID do uruchomienia po kliknięciu linku. |
|
Łączna liczba kliknięć ludzkich
|
links.human_clicks_total | integer |
Klikanie okresu istnienia bez sygnału bota; podzbiór clicks_total, w którym nie wykryto ani bota user-agent, ani kategorii zweryfikowanego bota. Zarejestrowane od 2019 roku. |
|
Kliknięcia (30 dni)
|
links.clicks_thirty_days | integer |
Klika w ciągu ostatnich 30 dni, w tym ruch botów. |
|
Identyfikator piksela TikTok
|
links.tiktok_pixel_id | string |
Identyfikator piksela TikTok do uruchomienia po kliknięciu linku. |
|
Ukryj odwołanie
|
links.hide_referrer | boolean |
Czy ukryć odwołanie w lokacji docelowej. |
|
Maskowanie
|
links.cloaking | boolean |
Czy ukryć miejsce docelowe, otwierając go wewnątrz ramki. |
|
Krótki adres URL
|
links.full_url | uri |
Pełny krótki adres URL linku. |
|
Klika dzisiaj
|
links.clicks_today | integer |
Kliknięcia do tej pory dzisiaj (UTC), w tym ruch bota. |
|
Otwórz opis grafu
|
links.og_description | string |
Opis wyświetlany po udostępnieniu linku w mediach społecznościowych. |
|
Tagi treści
|
links.body_tags | string |
Niestandardowe tagi HTML lub śledzenia wstawione do treści strony przekierowania. |
|
Otwórz tytuł grafu
|
links.og_title | string |
Tytuł wyświetlany po udostępnieniu linku w mediach społecznościowych. |
|
Note
|
links.note | string |
Prywatna notatka dotycząca linku. |
|
Name
|
links.name | string |
Pseudonim linku pokazanego na pulpicie nawigacyjnym. |
|
Identyfikator łącza
|
links.id | integer |
Unikatowy identyfikator linku. |
|
Identyfikator menedżera tagów Google
|
links.gtm_id | string |
Identyfikator kontenera Usługi Google Tag Manager do załadowania po kliknięciu linku. |
|
Otwórz obraz programu Graph
|
links.og_image | string |
Adres URL obrazu wyświetlany po udostępnieniu linku w mediach społecznościowych. |
|
Blokuj boty
|
links.block_bots | boolean |
Czy zablokować znane boty z poziomu linku. |
|
Łączna liczba kliknięć
|
links.clicks_total | integer |
Kliknięcia okresu istnienia, w tym ruch bota. |
|
Kliknięcia człowieka (30 dni)
|
links.human_clicks_thirty_days | integer |
Klika w ciągu ostatnich 30 dni bez sygnału bota; podzbiór clicks_thirty_days. |
|
Zawartość utM
|
links.utm_content | string |
Parametr utm_content dołączony do docelowego adresu URL. |
|
Ludzkie kliknięcia dzisiaj
|
links.human_clicks_today | integer |
Klika do tej pory dzisiaj (UTC) bez sygnału bota. |
|
Enabled
|
links.enabled | boolean |
Czy link jest aktywny. |
|
Docelowy adres URL
|
links.url | uri |
Docelowy adres URL, do którego przekierowuje krótki link. |
|
Usunięto
|
links.deleted | boolean |
Czy link znajduje się w koszu. |
|
Identyfikator obszaru roboczego
|
links.workspace_id | integer |
Identyfikator obszaru roboczego. |
|
Analiza publiczna
|
links.public_analytics | boolean |
Czy strona analizy linku jest publicznie widoczna. |
|
Źródło UTM
|
links.utm_source | string |
Parametr utm_source dołączony do docelowego adresu URL. |
|
Slug
|
links.slug | string |
Ścieżka niestandardowa krótkiego linku. Musi zaczynać się od ukośnika. |
|
Domain
|
links.domain | string |
Domena niestandardowa do użycia dla krótkiego linku bez końcowego ukośnika. |
|
Parametry przekazywania
|
links.forward_params | boolean |
Czy przekazywać parametry zapytania z krótkiego linku do miejsca docelowego. |
|
UtM — średni rozmiar
|
links.utm_medium | string |
Parametr utm_medium dołączony do docelowego adresu URL. |
|
Tagi głowy
|
links.head_tags | string |
Niestandardowe tagi HTML lub śledzenia wstawione do nagłówka strony przekierowania. |
|
Identyfikator tagu usługi Google Analytics 4
|
links.ga4_tag_id | string |
Identyfikator pomiaru 4 usługi Google Analytics do uruchomienia po kliknięciu linku. |
|
Termin UTM
|
links.utm_term | string |
Parametr utm_term dołączony do docelowego adresu URL. |
|
Kampania UTM
|
links.utm_campaign | string |
Parametr utm_campaign dołączony do docelowego adresu URL. |
|
Ludzkie kliknięcia wczoraj
|
links.human_clicks_previous_day | integer |
Klika wczoraj (UTC) bez sygnału bota. |
|
Numer strony
|
page_number | integer |
Bieżący numer strony. |
|
Rozmiar strony
|
page_size | integer |
Liczba łączy zwracanych na stronę. |
|
Łączna liczba wpisów
|
total_entries | integer |
Całkowita liczba łączy pasujących do żądania. |
|
Łączna liczba stron
|
total_pages | integer |
Całkowita liczba dostępnych stron. |
|
Łączna liczba wierszy
|
total_rows | integer |
Całkowita liczba wierszy. |
|
Liczba łączy obszaru roboczego
|
workspace_link_count | integer |
Całkowita liczba łączy w obszarze roboczym. |
Definicje
ciąg
Jest to podstawowy typ danych "string".