Analytics API Linkly

Programowo eksportuj dane kliknięć i raporty ruchu z Linkly za pomocą naszego Analytics API.

Powiązane: Link Shortening API | Webhooks

Zanim Zaczniesz

Linkly generuje żądania API w interfejsie, które możesz skopiować i wkleić do swoich aplikacji.

Oszczędź czas i pozwól nam robić trudną pracę. Nasze API jest w pełni dostępne dla maszyn.

Autoryzacja

Będziesz potrzebować swojego klucza API i identyfikatora obszaru roboczego. Możesz uzyskać te szczegóły z Linkly.

API Raportów Ruchu

Linkly automatycznie tworzy żądania API dla Ciebie wewnątrz raportów ruchu.

Raporty ruchu Linkly automatycznie budują żądania API dla Ciebie, na podstawie danych wyświetlanych na ekranie.

Te linki zawierają Twój klucz API i są łatwo dostosowywalne i mogą być używane w Twoich aplikacjach.

Formaty Wyjścia

Analytics API obsługuje trzy formaty wyjścia:

Tryb Pivot (Format Macierzy)

Domyślnie API zwraca dane szeregów czasowych z jednym wierszem na dzień. W trybie pivot możesz uzyskać ruch wszystkich swoich linków w jednym żądaniu jako macierz.

Użyj Eksportuj dane z listy rozwijanej w dowolnym raporcie ruchu, aby szybko wyeksportować dane według linku, lub dodaj pivot=link_id do swojego żądania API.

Dodaj pivot=link_id do swojego żądania, aby uzyskać dane z:

• Datami jako wierszami (jeden wiersz na dzień)
• Linkami jako kolumnami (jedna kolumna na link)

Przykład Wyjścia CSV/TSV Pivot

Przykład Wyjścia JSON Pivot

{
  "links": [
    {"id": 123, "name": "Mój Link", "full_url": "https://linkly.link/abc"},
    {"id": 456, "name": "Inny Link", "full_url": "https://linkly.link/xyz"}
  ],
  "data": [
    {"date": "2025-12-30", "clicks": {"123": 45, "456": 12}},
    {"date": "2025-12-31", "clicks": {"123": 52, "456": 8}}
  ]
}

Tryb pivot jest przydatny do:

• Porównywania ruchu na wielu linkach
• Importowania do arkuszy kalkulacyjnych do analizy
• Budowania dashboardów ze wszystkimi danymi linków w jednym wywołaniu

Surowe Dane Kliknięć

Surowe dane kliknięć, które rejestrujemy, w tym pełne parametry, znaczniki czasu i informacje o geolokalizacji, są dostępne.

Aby uzyskać dostęp do tych danych, kliknij Eksportuj z zakładek u dołu i wybierz swój format. Są to w pełni sformułowane żądania API, które możesz używać bezpośrednio w swojej aplikacji.

Uwagi dotyczące Eksportu Danych

• Rozważ najpierw filtrowanie danych w widoku, aby zmniejszyć ilość eksportowanych danych. Ta funkcja eksportuje bazowe dane używane do generowania raportu aktualnie wyświetlanego na ekranie.
• Te dane są buforowane przez maksymalnie 3 godziny. Powtórzone żądania do tego punktu końcowego nie będą generować danych w czasie rzeczywistym.

Powiadomienia o Kliknięciach w Czasie Rzeczywistym

Aby otrzymywać powiadomienia o kliknięciach w czasie rzeczywistym, zobacz Webhooks. Webhooks wysyłają żądanie POST na określony(-e) adres URL w momencie kliknięcia z szczegółowymi informacjami o kliknięciu.

Możesz również zarządzać webhookami za pośrednictwem API - zobacz specyfikację OpenAPI, aby uzyskać szczegóły.

Polityka Uczciwie Użytku

Limity Szybkości

Analytics API jest ograniczony do 50 żądań na godzinę na obszar roboczy.

Limity Użycia

Oprócz limitów szybkości, Analytics API ma limity użycia, które resetują się w każdym okresie rozliczeniowym:

Co Liczy Się Jako Użycie

• Żądania API: Każde wywołanie punktów końcowych Analytics API (/clicks, /counters, /export) liczy się jako jedno żądanie.
• Przeskanowane Dane: Ilość danych przetwarzanych przez naszą bazę danych analityki, aby spełnić Twoje żądanie. Większe zakresy dat i bardziej złożone zapytania skanują więcej danych.

Co Się Dzieje, Gdy Przekroczysz Limity

Jeśli przekroczysz limity użycia:

1. 1
   Żądania API zwrócą błąd 429 Too Many Requests
2. 2
   Twoje limity automatycznie zresetują się na początku następnego okresu rozliczeniowego
3. 3
   Twoje linki będą działać normalnie i śledzić kliknięcia

Porady, Aby Zmniejszyć Użycie

Większość użytkowników może uzyskać wszystkie swoje dane w jednym żądaniu API za pomocą trybu pivot (pivot=link_id), który zwraca ruch wszystkich linków jako macierz w jednym wywołaniu.

• Użyj trybu pivot: Dodaj pivot=link_id, aby uzyskać ruch dla wszystkich linków w jednym żądaniu zamiast pytać każdy link osobno
• Buforuj odpowiedzi: Przechowuj odpowiedzi API lokalnie zamiast pobierać te same dane wielokrotnie
• Użyj mniejszych zakresów dat: Pytaj tylko o daty, które Ci są potrzebne
• Grupuj żądania: Połącz wiele zapytań linku w jedno żądanie, używając parametru link_ids

Potrzebujesz Więcej?

Jeśli potrzebujesz wyższych limitów, skontaktuj się z nami za pośrednictwem widżetu pomocy.

Integracja BigQuery

W celu uzyskania wysokowolumenowych potrzeb analitycznych, Linkly oferuje integrację BigQuery, która zapewnia bezpośredni dostęp SQL do danych kliknięć.

• Dostęp do danych na żywo - Wysyłaj zapytania do danych kliknięć bezpośrednio w BigQuery z aktualizacjami w czasie rzeczywistym
• Nieograniczone zapytania - Brak limitów szybkości API; płacisz tylko za obliczenia BigQuery
• Niestandardowe raporty - Buduj dashboardy za pomocą Looker, Data Studio lub Tableau
• Konsolidacja danych - Łącz dane kliknięć z innymi wskaźnikami biznesowymi

Integracja BigQuery jest dostępna w planie Enterprise. Skontaktuj się z nami w celu uzyskania szczegółów.

Dowiedz się więcej o Integracji BigQuery →

Powiązane

• Link Shortening API - Twórz i aktualizuj linki programowo
• Webhooks - Powiadomienia o kliknięciach w czasie rzeczywistym
• BigQuery Integration - Bezpośredni dostęp SQL do danych kliknięć
• Zapier Integration - Integracje bez kodu