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 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
- 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.