Bir TCF İzin Dizesi Nasıl Okunur: Geliştiriciler için Saha Rehberi

TC String Gerçekte Nedir

IAB Transparency & Consent Framework, her reklam isteğiyle birlikte seyahat eden ve satıcılara bir kullanıcının tam olarak neyi kabul edip neyi etmediğini söyleyen tek bir kompakt jeton — TC string — üretir. Base64-URL kodlanmıştır ve bit düzeyinde paketlenmiştir, bu yüzden anlamsız gibi görünür (CPxy...AAA) ancak kesin, denetlenebilir bir kayıt kodlar.

Segmentler

Tam bir TC string, noktayla ayrılmış birkaç segmenttir. İlki çekirdek dizedir; diğerleri isteğe bağlıdır:

Bit alanları işin kalbidir: N biti 1 olarak ayarlandığında N amacı veya N satıcısı için izin anlamına gelir. Amaç 1 “bir cihazda bilgi depolama/erişim,” amaç 3 ve 4 kişiselleştirilmiş reklamları kapsar ve böyle devam eder.

Pratikte Birini Çözmek

Bitleri nadiren elle çözersiniz. IAB tarafından sağlanan kütüphaneleri veya genel bir çözücüyü kullanın:

JavaScript'te __tcfapi('getTCData', 2, cb) çağrısı zaten ayrıştırılmış nesneyi döndürür — tcData.purpose.consents ve tcData.vendor.consents, id → boolean eşlemeleridir. Çalışma zamanında temel gerçeğiniz budur.

Geliri Öldüren Hatalar

Kişiselleştirilmiş talep sessizce kaybolduğunda, sebebi genellikle TC string'dir:

Bir Hata Ayıklama İş Akışı

Kullanıcının iznini yeniden üretin, canlı TC string'i __tcfapi veya reklam isteğinden alın, bir doğrulayıcıdan geçirin ve çözülmüş amaçları/satıcıları ortaklarınızın gerektirdikleriyle karşılaştırın. On vakanın dokuzunda boşluk tek bir satıcı biti veya eksik bir amaç 1'dir.

FlexyConsent Nereye Uyar

FlexyConsent kayıtlı bir CMP ID ile spesifikasyona uygun TC string'ler üretir, onları taze tutar, hata ayıklama için çözülmüş durumu açığa çıkarır ve trafiğiniz genelinde hangi amaçların ve satıcıların gerçekten verildiğini raporlar — böylece iznin (ve gelirin) nerede sızdığını tahmin etmek yerine görebilirsiniz.

Temel Çıkarımlar

← Blog Tümünü Oku →