Linkly'nin Analytics API'si

Linkly'den Analytics API'mizi kullanarak tıklama verilerini ve trafik raporlarını programlama yoluyla dışa aktarın.

İlgili: Link Kısaltma API'si | Webhook'lar

Başlamadan önce

Linkly, arayüzde API isteklerini sizin için oluşturur ve uygulamalarınıza kopyalayıp yapıştırabilmeniz için hazırlar.

Zamandan tasarruf edin ve bize zor işleri yaptırın. API'miz tamamen makine tarafından tüketilebilir.

Yetkilendirme

API Anahtarınıza ve Çalışma Alanı Kimliğinize ihtiyacınız olacak. Bu ayrıntıları Linkly'den alabilirsiniz.

Trafik raporları API'si

Linkly, trafik raporlarınızda sizin için otomatik olarak API istekleri oluşturur.

Linkly'nin trafik raporları sizin için otomatik olarak API istekleri oluşturur, ekranda gösterilen verilere dayalı olarak.

Bu bağlantılar API anahtarınızı içerir ve kendi uygulamalarınızda kolayca özelleştirilebilir ve kullanılabilir.

Çıktı biçimleri

Analytics API üç çıktı biçimini destekler:

Pivot modu (matris biçimi)

Varsayılan olarak, API zaman serisi verilerini her tarih için bir satırla döndürür. Pivot modu ile tüm bağlantılarınızın trafiğini tek bir istek olarak matris olarak alabilirsiniz.

Herhangi bir trafik raporundaki Verileri Dışa Aktar açılır menüsünü kullanarak bağlantıya göre verileri hızlıca dışa aktarın veya API isteğinize pivot=link_id ekleyin.

İsteğinize pivot=link_id ekleyin ve aşağıdaki verileri alın:

• Satırlar olarak tarihler (gün başına bir satır)
• Sütunlar olarak bağlantılar (bağlantı başına bir sütun)

CSV/TSV pivot çıktı örneği

JSON pivot çıktı örneği

{
  "links": [
    {"id": 123, "name": "Bağlantım", "full_url": "https://linkly.link/abc"},
    {"id": 456, "name": "Diğer Bağlantı", "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}}
  ]
}

Pivot modu şunlar için yararlıdır:

• Birden fazla bağlantı arasında trafiği karşılaştırma
• Analiz için elektronik tablolara aktarma
• Tüm bağlantı verilerini tek bir çağrıda içeren pano oluşturma

Ham tıklama verileri

Tam parametreler, zaman damgaları ve coğrafi konum bilgisi dahil olmak üzere kayıt ettiğimiz ham tıklama verileri mevcuttur.

Bu verilere erişmek için alttaki sekmelerden Dışa Aktar'ı tıklayın ve biçiminizi seçin. Bunlar uygulamanızda doğrudan kullanabileceğiniz tam biçimlendirilmiş API istekleridir.

Veri dışa aktarımı hakkında notlar

• Dışa aktarılan veri miktarını azaltmak için önce görünümdeki verileri filtrelemeyi düşünün. Bu işlev, şu anda ekranda bulunan raporu oluşturmak için kullanılan temel verileri dışa aktarır.
• Bu veriler 3 saate kadar önbelleğe alınır. Bu uç noktaya tekrarlanan istekler gerçek zamanlı veriler üretmez.

Gruplandırılmış sayımlar

/counters/{dimension} uç noktası, country, platform, destination, referer, isp veya link_id gibi tek bir boyuta göre gruplandırılmış tıklama toplamlarını döndürür. Sonuçlar tıklama sayısına göre sıralanır, en yüksek ilk.

Maksimum 10.000 değer döndürülür. Yüksek kardinalite boyutları — destination, referer, remote_ip ve isp — meşgul bir çalışma alanında bundan çok daha fazla farklı değere sahip olabilir. Durum böyleyse, tıklama sayısına göre ilk 10.000'i alırsınız ve geri kalanlar döndürülmez.

total alanı her zaman döndürülmeyen tüm gruplar da dahil olmak üzere her grup arasında toplam tıklamadır. Kısaltılmış bir sonuçta count değerleri total değerinden küçük olacak — bu da count / total olarak hesaplanan bir yüzdenin hala doğru olduğu anlamına gelir.

İlk 10.000 yerine tam değer kümesi gerekiyorsa, ham tıklama verilerini dışa aktarın ve kendiniz toplayın veya BigQuery entegrasyonunu kullanın.

Gerçek zamanlı tıklama bildirimleri

Gerçek zamanlı tıklama bildirimleri için bkz. Webhook'lar. Webhook'lar, tıklama gerçekleştiğinde hemen belirtilen URL'ye POST isteği gönderir ve tıklama hakkında ayrıntılı bilgi içerir.

Ayrıca API aracılığıyla webhook'ları yönetebilirsiniz - ayrıntılar için OpenAPI spec'e bakın.

Adil kullanım politikası

Hız sınırları

Analytics API, çalışma alanı başına saatte 50 istek ile hız sınırlandırılır.

Kullanım sınırları

Hız sınırlarına ek olarak, Analytics API'nin her faturalama döneminde sıfırlanan kullanım sınırları vardır:

Kullanım olarak sayılan nedir

• API İstekleri: Analytics API uç noktalarına (/clicks, /counters, /export) yapılan her çağrı bir istek olarak sayılır.
• Tarama Yapılan Veriler: İsteğinizi karşılamak için analitik veritabanımız tarafından işlenen veri miktarı. Daha geniş tarih aralıkları ve daha karmaşık sorgular daha fazla veri tarar.

Sınırları aştığınızda ne olur

Kullanım sınırlarınızı aştığınızda:

1. 1
   API istekleri 429 Too Many Requests hatası döndürür
2. 2
   Sınırlarınız bir sonraki faturalama döneminin başında otomatik olarak sıfırlanır
3. 3
   Bağlantılarınız çalışmaya devam eder ve tıklamaları normal şekilde izler

Kullanım azaltmak için ipuçları

Çoğu kullanıcı pivot modunu (pivot=link_id) kullanarak tüm verilerini tek bir API isteğinde alabilir ve bu, tüm bağlantıların trafiğini bir çağrıda matris olarak döndürür.

• Pivot modunu kullanın: Her bağlantıyı ayrı ayrı sorgulama yerine tüm bağlantılarının trafiğini tek bir istekte almak için pivot=link_id ekleyin
• Yanıtları önbelleğe alın: Aynı verileri tekrar tekrar almak yerine API yanıtlarını yerel olarak saklayın
• Daha küçük tarih aralıkları kullanın: Yalnızca ihtiyacınız olan tarihleri sorgulayın
• İstekleri toplu olarak yapın: link_ids parametresini kullanarak birden fazla bağlantı sorgusunu tek bir istekte birleştirin

Daha fazlasına ihtiyacınız var mı?

Daha yüksek sınırlara ihtiyacınız varsa, lütfen destek widget'ini kullanarak bizimle iletişime geçin.

BigQuery entegrasyonu

Yüksek hacimli analitik ihtiyaçları için Linkly, tıklama verilerinize doğrudan SQL erişimi sağlayan bir BigQuery entegrasyonu sunar.

• Canlı veri erişimi - BigQuery'de tıklama verilerinizi doğrudan gerçek zamanlı güncellemelerle sorgulayın
• Sınırsız sorgular - API hız sınırı yok; yalnızca BigQuery hesaplama için ödeme yaparsınız
• Özel raporlama - Looker, Data Studio veya Tableau ile panolar oluşturun
• Veri konsolidasyonu - Tıklama verilerini diğer iş metriklerinizle birleştirin

BigQuery entegrasyonu Enterprise planına dahildir. Ayrıntılar için bizimle iletişime geçin.

BigQuery Entegrasyonu hakkında daha fazla bilgi edinin →

İlgili

• Link Kısaltma API'si - Programlama yoluyla bağlantı oluşturun ve güncelleyin
• Webhook'lar - Gerçek zamanlı tıklama bildirimleri
• BigQuery Entegrasyonu - Tıklama verilerine doğrudan SQL erişimi
• Zapier Entegrasyonu - Kodsuz entegrasyonlar