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:
- Çekirdek — CMP ID, CMP sürümü, izin zaman damgaları, politika sürümü ve en önemlisi amaç izinleri ve satıcı izinleri bit alanları.
- Açıklanan satıcılar — kullanıcıya hangi satıcıların gösterildiği.
- Yayıncı TC — size, yayıncıya özel izinler.
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:
.üzerinden bölün ve çekirdek segmenti Base64-URL ile çözün.- Sabit genişlikli başlık alanlarını okuyun (version, created, lastUpdated, cmpId, cmpVersion).
- Tam olarak hangilerinin verildiğini görmek için amaç ve satıcı bit alanlarını gezin.
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:
- Eksik dize — reklam isteği hiçbir
gdprApplies/TC string taşımaz, bu yüzden uyumlu SSP'ler kişiselleştirilmemiş duruma düşer. - Satıcının izni yok — talep ortağınızın satıcı ID biti 0'dır, dolayısıyla kişiselleştirme ile teklif veremezler.
- Süresi dolmuş veya eski dize — eski bir zaman damgası, alt akış platformlarının ona güvenmemesine neden olur.
- Yanlış CMP ID — kayıtlı olmayan veya test bir CMP ID'si tüm dizeyi geçersiz kılar.
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, TC dizelerini sertifikalı CMP kimliği 317 ile üretir ve __tcfapi üzerinden sunar; böylece canlı dizeyi çözebilirsiniz. Raporları kararları kaynağa ve bölgeye göre gösterir.
Temel Çıkarımlar
- TC string, her izin seçiminin bit paketlenmiş, denetlenebilir bir kaydıdır.
- Amaç ve satıcı bit alanları, ortakların kişiselleştirilmiş reklam sunup sunamayacağına karar verir.
- Çoğu gelir düşüşü eksik bir dizeye, izin verilmemiş bir satıcıya veya eski/geçersiz bir CMP ID'sine dayanır.
- Hata ayıklarken canlı dizeyi
__tcfapiile çözün ve ortak gereksinimlerine göre doğrulayın.