Adobe Experience Platform Tags için açık kaynaklı TikTok Pixel ve Events API eklentisi yayınlandı

Bir geliştirici, TikTok'un tarayıcı pixelini TikTok Events API ile Adobe Experience Platform Tags içinde birleştiren bir tag yönetim eklentisini açık kaynak yaptı. dev.to'daki duyurusunda Bhargav Bhatt, projenin artık topluluk katkılarına ve sponsorluğa açık olduğunu söylüyor ve bunu, tarayıcı gizlilik kısıtlamaları, reklam engelleyiciler ve akıllı izleme önleme (ITP) nedeniyle güvenilmez hale gelen dönüşüm takibine bir yanıt olarak konumlandırıyor.

Eklenti nasıl çalışıyor

Gönderiye göre eklenti aynı anda iki gönderim yolu çalıştırıyor. Bir Adobe Tags kuralı AddToCart gibi bir eventi tetiklediğinde, tarayıcı TikTok'un standart ttq.track çağrısını yürütürken eklenti aynı anda TikTok'un Events API'si — şirketin dönüşüm verisi için Business API uç noktası — için eşleşen bir payload hazırlıyor. Adobe Tags'te yapılandırılan data element'ler event parametrelerini sağlıyor ve ayrı bir modül pixel snippet'ini sayfaya enjekte ediyor.

Tasarım, birleşik takibin temel sorununu hedefliyor: yinelenen dönüşümler. Her event için eklenti bir RFC 4122 sürüm 4 UUID üretiyor ve aynı tanımlayıcıyı hem tarayıcı isteğine hem de Events API isteğine ekliyor. Bhatt, bu paylaşılan event ID'nin, tek bir dönüşüm iki kanaldan da ulaştığında TikTok'un onu iki kez saymasını engellediğini yazıyor.

Gizlilik yönetimi

Kullanıcı tanımlayıcıları — e-posta adresi, telefon numarası ve harici ID — herhangi bir şey iletilmeden önce tarayıcıda, harici bir kütüphane yerine yerel Web Crypto API (crypto.subtle) kullanılarak SHA-256 ile hash'leniyor. Yalnızca hash'lenmiş değerler Events API payload'ıyla iletiliyor; yazarın gizlilik öncelikli bir yaklaşım olarak sunduğu bu yöntem, hassas verinin normalize edilmesini sağlıyor.

SPA desteği, zaman aşımları ve hata ayıklama

Eklenti, History API üzerinde gözlemcilerle (pushState, replaceState ve popstate) geliyor; böylece modern JavaScript framework'leriyle kurulmuş tek sayfalık uygulamalardaki rota değişiklikleri ek yapılandırma olmadan yakalanıyor. Yürütme engellemesiz: script yüklemesi beş saniye sonra, API istekleri on saniye sonra zaman aşımına uğruyor; böylece bir ağ hatası Tags kural zincirinin geri kalanını kilitleyemiyor. Bir debug modu ekran üzerinde bir rozet ve ayrıntılı console günlüklemesi ekliyor.

Finansman hedefleri ve yol haritası

Proje, GitHub Sponsors, Open Collective ve Patreon üzerinden destek arıyor. Gönderiye göre finansman dört yol haritası maddesini destekleyecek: eklentinin Adobe Exchange marketplace'te doğrulama için sunulması, Adobe'un Edge Network üzerinde Event Forwarding ile çalışan yerel bir sunucu tarafı sürümün geliştirilmesi, mevcut Jest test paketinin otomatik tarayıcı entegrasyon testleriyle genişletilmesi ve takip mühendisleri için kurulum kılavuzları ile video anlatımlarının hazırlanması.

Bhatt ayrıca kullanıcıları eklentiyi Adobe'un reactor-sandbox ortamında test etmeye, herkese açık GitHub deposuna yıldız vermeye ve issue ya da dokümantasyon iyileştirmeleri göndermeye davet ediyor.

Neden önemli

Tarayıcılar cookie'leri kısıtladıkça ve eklentiler takip script'lerini engelledikçe istemci tarafı ölçüm sürekli sinyal kaybediyor; reklam platformları da bu yüzden artık sunucu tarafı event yönlendirmesini alternatif çözüm olarak öne çıkarıyor. Zor olan kısım API çağrısının kendisi değil, çevresindeki her şey: tekilleştirme için paylaşılan tanımlayıcılar, uyumluluk için hash'lenmiş kullanıcı verisi ve tek sayfalık gezinmeyi anlayan tetikleyiciler. Bu eklenti bu parçaları tek bir özel eşleşme — TikTok ve Adobe Experience Platform Tags — için paketliyor.

Adobe yığınını kullanan ekipler için açık kaynak, PII yönetiminin bir gizlilik incelemesinden önce satır satır denetlenebileceği anlamına da geliyor; kapalı satıcı eklentileri bunu nadiren sağlıyor. Ödünleşim ise olgunluk: eklenti henüz Adobe Exchange doğrulamasından geçmedi ve Edge yerel sunucu tarafı sürümü yalnızca sponsorluğa bağlı bir yol haritası hedefi olarak mevcut. Bu kilometre taşları gerçekleşirse, tek başına çalışan bir geliştiricinin entegrasyonu, TikTok dönüşümlerinin sayılmaya devam etmesini isteyen pazarlama ekipleri için desteklenen bir seçeneğe dönüşebilir.