Klaviyo Bağlantı Takibi: Tıklamalar Özel Metrik Olarak

Elido üzerinden Klaviyo bağlantı takibi sunucu tarafındadır ve tek yönlü çalışır: kısa bağlantılarınızdan birine yapılan her tıklama, Klaviyo'nun Events API'sine Elido Link Click adlı özel bir metrik üzerinde olay olarak gönderilir. Olay; bağlantının slug'ını ve kimliğini, ülkeyi ve cihazı, ziyaretçinin yönlendirildiği hedefi ve tıklama zamanını taşır. Metrik ilk kullanımda oluşturulur ve onu diğer metrikler gibi grafiğe dökebilir, filtreleyebilir ve üzerinde rapor kurabilirsiniz.

Yapmadığı şey, tıklamayı bir abonenin profiline koymaktır. Her olay bağlantıya anonim bir kimlikle bağlanır; yani 4.000 kişinin tıkladığı bir bağlantı Klaviyo'da, zaman çizelgesinde 4.000 olay bulunan tek bir anonim profil olarak görünür. Entegrasyonun neye yaradığını bu tek gerçek belirler. Burada yükü, kurulumu, akışların ve segmentlerin bununla neler yapabildiğini ve Klaviyo'nun yerel tıklama takibiyle nasıl karşılaştığını anlatacağım.

Bağlantılarınız henüz tutarlı biçimde etiketlenmediyse önce onu düzeltin. UTM'leri uçtan uca izleme temel yazısı bu kuralı anlatır; Klaviyo yalnızca bağlantının taşıdığını görür.

Elido Her Tıklamada Klaviyo'ya Ne Gönderir?

Bir tıklama, bir POST. Yönlendirici, özel anahtarınızı Authorization: Klaviyo-API-Key başlığında ve revision: 2023-02-22 başlığıyla birlikte https://a.klaviyo.com/api/events/ adresine çağırır. Bu, Klaviyo'nun Create Event başvurusunda belgelenen uç noktadır.

Örnek değerlerle gövdenin tamamı şöyle:

{
  "data": {
    "type": "event",
    "attributes": {
      "time": "2026-09-21T09:14:22Z",
      "properties": {
        "workspace_id": 12,
        "link_id": 4711,
        "slug": "autumn-drop",
        "country": "DE",
        "device": "mobile",
        "destination": "https://shop.example/autumn?utm_source=instagram",
        "ip": "203.0.113.24"
      },
      "metric": {
        "data": {
          "type": "metric",
          "attributes": { "name": "Elido Link Click" }
        }
      },
      "profile": {
        "data": {
          "type": "profile",
          "attributes": { "anonymous_id": "elido-link-4711" }
        }
      }
    }
  }
}

Hepsi bu kadar. E-posta yok, telefon numarası yok, ayrı özellik olarak UTM alanları yok, referrer ve tarayıcı da yok.

Filtrelemeye başladığınızda birkaç ayrıntı önem kazanır. destination, her akıllı bağlantı yönlendirme kuralından sonra bu ziyaretçinin gerçekten aldığı URL'dir; yani iPhone'ları App Store'a, diğerlerini mağazanıza gönderen bir bağlantı iki farklı hedef değeri üretir. device, mobile, tablet ya da desktop değerlerinden biridir. UTM etiketleri yalnızca destination dizesinin içinde bulunur; bu yüzden doğrudan utm_campaign üzerinden filtrelemek mümkün değildir, onun yerine slug üzerinden filtreleyin; zaten çoğunlukla daha temiz anahtar odur.

User agent'larında kendilerini belli eden tarayıcı botları yönlendirmede elenir ve hiç iletilmez. Elido'nun kendi sezgisel yöntemlerinin şüpheli diye işaretlediği tıklamalar yine gönderilir ve olayda bunu belirten bir özellik yoktur.

Bağlantı Başına Bir Anonim Profil ve Nedeni

Her Klaviyo olayı bir profil belirtmek zorundadır; profil bir e-posta, telefon numarası, harici kimlik, Klaviyo kimliği ya da anonymous_id ile tanımlanır. Elido her zaman sonuncusunu gönderir ve bunu elido-link- artı bağlantı kimliği olarak oluşturur.

Yani autumn-drop bağlantısına yapılan her tıklama aynı profile gider. İlk tıklama onu oluşturur, sonrakilerin hepsi zaman çizelgesine eklenir.

Bunun üç sonucu var ve üçüncüsü beni şaşırttı.

Birincisi, sayımlar çalışır ama kişiler bilinmez. Toplam tıklamalar, bağlantı, ülke ve cihaz başına tıklamalar çalışır. "Benzersiz" olan her şey insanları değil, bağlantıları sayar.

İkincisi, anonim profilin e-postası ya da telefonu yoktur. Bir segmentte yer alabilir ama mesaj alamaz.

Üçüncüsü, aynı saniyedeki tıklamalar tek olaya iner. Yönlendirici unique_id göndermez ve Klaviyo'nun başvurusuna göre bu olmadığında aynı profil ve metrik için olay zamanını saniye düzeyinde tekilleştirir. Profil bağlantı başına olduğundan, aynı saniye içinde aynı bağlantıya tıklayan iki kişi tek olay olur. Damla damla gelen bir bülten bağlantısında bunu asla fark etmezsiniz. Tıklamaların zirvede saniyede birkaç kez geldiği büyük bir Instagram hikayesindeki bağlantıda ise Klaviyo sayısı, Elido tıklama analitiğindeki sayının altında kalır. Artısı şu: yönlendiricinin tek yeniden denemesi çift sayım yapamaz, çünkü yeniden denenen olayın zamanı aynıdır.

Neden ziyaretçi başına bir kimlik değil? Yönlendirme ziyaretçinin kim olduğunu bilmez ve ziyaretçinin kendi seçmediği bir alan adında çerez bırakmasını istemem. Aynı ödünleşimi Mixpanel bağlantı takibinde yaptık; orada distinct_id de aynı nedenle bağlantı başınadır.

Elido'da Klaviyo Bağlantı Takibini Kurma

Kurulum tek bir alandan ibaret.

1. Klaviyo'da Settings, ardından API keys bölümüne gidin ve bir özel API anahtarı oluşturun. Create Event başvurusu gereken kapsam olarak events:write değerini listeler. Elido'nun uygulama içi kurulum notları profiles:write değerinden de söz ediyor; ben yalnızca olaylarla başlar, Klaviyo 403 dönerse ikincisini eklerdim.
2. Elido çalışma alanınızda Entegrasyonlar'ı açın, Klaviyo kartını seçin ve Connect Klaviyo'ya tıklayın.
3. Anahtarı Private API Key alanına yapıştırıp kaydedin. Elido anahtarı bekleme halinde şifreler ve sonrasında yalnızca maskelenmiş olarak gösterir.
4. Yaklaşık beş dakika bekleyin. Entegrasyon ayarları iletim tarafında önbelleğe alınır; bu yüzden kaydettikten hemen sonraki ilk tıklamalar gönderilmeyebilir.
5. Kendi bağlantılarınızdan birine telefondan tıklayın, sonra Klaviyo'da Analytics > Metrics'i açıp Elido Link Click metriğini arayın.

Test connection düğmesi Klaviyo'ya bir test olayı (elido_test: true ile işaretli) gönderir ve Klaviyo'nun yanıtını gösterir; böylece iptal edilmiş ya da salt okunur bir anahtar tam orada başarısız olur. Bu, anahtarın çalıştığını kanıtlar, metriğin beklediğiniz profile düştüğünü değil. Gerçek bir tıklamadan sonra metriğin Klaviyo'da görünmesi asıl kanıttır.

Bağlantı başına bir anahtar yok. Çalışma alanındaki her tıklama iletilir; pazarlama için hiç düşünmediğiniz bağlantılar dahil. Çok sayıda müşteriyle çalışan ajanslar, bir şey bağlamadan önce her müşteriye kendi çalışma alanını vermelidir.

Klaviyo Yerel Tıklama Takibi ile Elido Metriği

Klaviyo kendi e-postalarındaki ve metinlerindeki tıklamaları zaten izler ve abone düzeyindeki işlerde bu yerel takip kazanır. Her bağlantıyı kendi izleme alan adı üzerinden yeniden yazar, alıcının profiline Clicked Email ya da Clicked SMS kaydeder ve olası tarayıcıları, raporlamadan dışlayabileceğiniz bir Bot Click özelliğiyle işaretler.

Elido'nun metriğinin yerini hak ettiği yer, geri kalan her yerdir: Instagram biyografinizdeki bağlantı, ambalajdaki bir QR kod, bir iş ortağının kendi bülteninden gönderdiği bağlantı, bir podcast bölüm notundaki bağlantı. Bu tıklamaların hiçbiri Klaviyo'nun izleyicisinden geçmez. Yönlendirici açıkken e-posta metriklerinizle aynı hesapta görünürler; böylece tek bir Klaviyo panosu "sonbahar bağlantısına her yerden tıklayanlar" ile "sonbahar e-postasına tıklayanlar"ı yan yana koyabilir.

Dikkat edilecek bir etkileşim var. Canlı e-postalarda Klaviyo her bağlantıya bir _kx parametresi ekler; böylece onsite betiği tıklayanı web sitenizde tanımlayabilir. E-postanızdaki bağlantı bir Elido kısa bağlantısıysa _kx kısa URL'ye düşer ve Elido'nun yönlendirmesi gelen sorgu parametrelerini hedefe taşımaz. Onsite tanımlama kaybolur. Benim kuralım: Klaviyo e-postalarının içinde doğrudan kendi sitenize bağlantı verin ve Klaviyo'nun izlemesine izin verin; kısa bağlantıları Klaviyo'nun erişemediği kanallar için kullanın.

Tıklamaları Gerçek Abone Profillerine Taşıma

Bazen tıklamayı bir kişiye bağlamak istersiniz. Bugün işleyen iki yol var ve ikisi de yönlendirici değil.

Kolay olanı, kimliği Klaviyo'nun onsite takibine bırakmaktır. Paylaşılan kısa bağlantıyı UTM etiketli bir hedefe gönderin ve Klaviyo'nun JavaScript'inin o sayfada çalıştığından emin olun. Önceki bir e-posta tıklamasından zaten çerezlenmiş ya da bir form üzerinden kaydolmuş ziyaretçilerin onsite etkinliği profillerine bağlanır. Kısa bağlantı tıklaması anonim kalır; ondan sonraki ziyaret kalmaz. İkisini sonra kampanya düzeyinde karşılaştırırsınız; bu, kişi başına olandan daha kabadır ama her tarafın ne bildiği konusunda dürüsttür.

Ağır olanı, alıcı başına bağlantılardır. B2B dizisi ya da VIP davetleri gibi küçük ve yüksek değerli bir liste için /v1/workspaces/{workspace_id}/links adresindeki API ile kişi başına bir kısa bağlantı oluşturun ve bağlantı kimliğinden e-postaya kendi tablonuzu tutun. Bağlantı olaylarına webhook'larla abone olun, tıklama geldiğinde e-postayı bulun ve profil tanımlayıcısı olarak o e-postayla Klaviyo'ya kendi olayınızı gönderin. Yaklaşık kırk satır kod tutar ve bir Elido tıklamasını adı bilinen bir aboneye koyan tek yol budur. 200.000 kişilik bir bülten için yapmam.

Klaviyo içinde karma kanallı tıklama sayılarını özlediyseniz bir plan seçip çalışma alanı bağlayın, sonra bir sonraki sosyal kampanyanızı markalı bağlantılar üzerinden geçirin.

Yönlendiricinin Bugünkü Sınırları

Bir rapor ona bağlanmadan önce bilinmesi gereken beş şey.

Teslimat en iyi çabayla yapılır. Başarısız bir POST bir saniye sonra bir kez yeniden denenir, sonra bırakılır ve sonrası için hiçbir şey kuyruğa alınmaz.

Events API hesap başına hız sınırlıdır: patlamalarda saniyede 350, sürekli olarak dakikada 3.500 istek. Bu bütçe, hesabınıza olay yazan diğer tüm uygulamalarla paylaşılır. Bir dakika boyunca saniyede yaklaşık 58 tıklamanın üzerine çıkan bir kampanya sıçraması 429 görür ve tek yeniden denemeden sonra o tıklamalar Klaviyo'dan düşer.

Revizyon başlığı eski. Klaviyo her API revizyonuna emekliliğinden önce iki yıl verir ve emekli bir revizyona yapılan istekler mevcut en eski sonraki revizyonla karşılanır. 2023-02-22 revizyonu bu çizgiyi geçti; bu yüzden bugün yönlendirici ileri düşme sayesinde çalışıyor. Çalışıyor. Yine de başlığın yükseltilmesini isterdim.

Ziyaretçi IP'si olay özelliği olarak gönderilir. Diğer özellikler gibi saklanmasını bekleyin; bu yüzden işleme kayıtlarınızda kişisel veri olarak ele alın. Pazarlama ekipleri için AB veri barındırma rehberi bunu nasıl tartacağınızı anlatır.

Yalnızca tıklamalar. Dönüşümler yükün parçası değildir; bu yüzden geliri müşteri kimliğinin bulunduğu yerde izleyin; çoğu mağaza için orası Klaviyo'nun kendi e-ticaret entegrasyonudur.

Blogda İlgili Yazılar

• UTM'leri uçtan uca izleme - kampanya düzeyindeki birleştirmenin dayandığı etiketleme kuralı.
• Mixpanel bağlantı takibi - aynı yönlendirici deseni, aynı bağlantı başına kimlik.
• Bağlantı olayları için webhook'lar - alıcı başına tıklama olayları için yapı taşı.
• Mailchimp, Brevo ve Klaviyo için e-posta tıklama atfı - e-posta platformlarına geniş bakış.
• Kısa bağlantı tıklamaları ile GA4 oturumları - tıklama sayıları ile analitik oturumları neden hiç tutmaz.
• Datadog URL izleme - aynı tıklama yönlendiricisi, bir Datadog panosunu besliyor.