- TCF 2.1 sürümü: IAB TCF politikası uyarınca 28 Şubat 2026'dan önce oluşturulan TCF 2.1 ve 2.2 sürümü dizelerini kabul etmeye devam edeceğiz.
- Google kullanıcı rızası yönetim çözümleri: Ad Manager, AdSense ve AdMob'un Gizlilik ve Mesajlaşma sekmesinde bulunan Google kullanıcı rızası yönetim çözümleri, IAB'nin CMP'lerle ilgili güncellenen şartları doğrultusunda, AB tüzükleriyle ilgili mesajlar için TCF 2.3 sürümünü desteklemektedir.
IAB Avrupa Şeffaflık ve Kullanıcı Rızası Çerçevesi 2.2 ve 2.3 sürümünün yayınlanmasıyla ilgili hataları ve yanlış yapılandırmaları yönetmeleri için yayıncılara tespit ettiğimiz hataların raporunu sunuyoruz.
Bu makalede, TCF 2.2 ve 2.3 sürümü uygulama hatalarının nasıl düzeltileceği hakkında daha fazla bilgi bulabilirsiniz. Örneğin:
Güncellenen yönergeler
Sık karşılaşılan hataları giderme yöntemleri
Aşağıdaki işlemleri gerçekleştirerek Ad Manager, AdSense ve AdMob'da en sık karşılaşılan hatalardan bazılarını giderebilirsiniz:
Para kazandırmayan TC dizeleriyle kullanıcılardan yeniden izin istemeyi deneyin(Hata 1.1, 3.1, 4.1, 5.1, 5.2 ve 6.1)
İlgili hatalar
Güncellenen yönergeler
Kullanıcılardan yeniden izin istemeyi deneyin.
Gerekçe
Daha önce bant dışı, global kapsamlı dizeler, geçersiz CMP kimlikleri (testlerden), geçersiz GVL kimlikleri (testlerden) kullanan veya uygulamalarının herhangi bir noktasında uygun izne sahip satıcı olarak Google'ı kullanmayan yayıncılar, yeniden izin isteme seçeneğinden yararlanacaktır.
Hata 1.1, 1.2, 1.3: Bu hataların, trafiğin önemli bir kısmını teşkil edip etmediğini kontrol etmek önemlidir. Böyle bir durum söz konusuysa CMP tarafında sorun olabileceği ihtimalini dikkate alın. Ayrıca, ilgili izinlere VE meşru menfaate sahip bir sağlayıcı (sağlayıcı kimliği: 755) olmasının yanı sıra Google'a gerekli amaçlar doğrultusunda izin verildiğinden emin olun.
addEventListener çağrılarını 500 ms içinde döndürmesini sağlayın(Hata 2.1a ve 2.1b)
İlgili hatalar
Hata 2.1a. Bu yönergeler hata 2.1b için de geçerli olabilir.
Güncellenen yönergeler
Artık bir zaman aşımı koşulu olmasa da CMP'lerin, çağrıları hemen addEventListener'a döndürdüklerinden emin olmak için uygulamalarını yakından incelemelerini öneririz.
CMP yanıt vermezse istekten para kazanılamayabilir.
Gerekçe
Google, bir CMP'nin addEventListener işlevine hemen yanıt vermesi gerektiğini belirten IAB spesifikasyonuna uyar. CMP hemen yanıt vermezse istekten para kazanılamayabilir.
Ayrıca CMP yanıtları, reklam isteğinin ne kadar kısa sürede oluşturulabileceğini etkileyen etkinlik zincirinin bir parçasıdır. Sayfa yükleme ile reklam istekleri arasında geçen sürenin kısaltılması yayıncı için kaybedilen gösterimlerin azalmasını sağlar.
IAB spesifikasyonu
Geçerli IAB spesifikasyonu: IAB addEventListener spesifikasyonu (GitHub'da)
loading, CMP'nin TC verilerinin ise eksik olması halinde bile geçerli TC verileriyle gerçekleştirilen kayıttan hemen sonra addEventListener geri çağırması yapılmalıdır. Bu işlem, çağrı komut dosyasının kayıtlı listenerId değerine erişmesini sağlar. Ayrıca her TC dizesi değişikliğinde removeEventListener kullanılarak dize kaldırılmadığı sürece geri çağırma yapılmalıdır.Politika merkezi
Politika merkezi, Google kullanıcı rızası yönetim şartlarına uymayan bir uygulama veya site olduğunda yayıncıları bilgilendirir.
Hata raporu
TC dizesinde, sitelerinden ya da uygulamalarından bir veya daha fazlasıyla ilişkili bir sorun algıladığımızda yayıncıları ürün kullanıcı arayüzünde bilgilendiririz. Yayıncılar, hesaplarındaki "AB kullanıcı izni" sayfasında, son 7 gün içinde tespit edilen hataların ayrıntılı bir raporunu indirmek için TCF hata raporunu indir seçeneğini tıklayabilir.
- Ad Manager: Yönetici'yi, ardından AB kullanıcı izni'ni tıklayın.
- AdMob: Engelleme kontrolleri'ni, ardından AB tüzüklerini yönetin'i tıklayın.
- AdSense: Marka güvenliği'ni tıklayın. İçerik, Engelleme kontrolleri'ni, ardından AB tüzüklerini yönetin'i tıklayın.
Rapor, algılanan hataların her biri hakkında aşağıdaki bilgileri içerir:
- Alan adı/MobileAppID: Yanlış yapılandırılmış site veya mobil uygulama.
- Reklam birimi yolu: Hatayla ilişkili reklam birimi.
- Hata kodu: Hataya atanan kod.
- Hata sayısı: Algılanan hatayı içeren ve önceki hafta boyunca gözlemlenen sorguların sayısı.
- Son algılanan tarih: Hatanın algılandığı son tarih.
Yayıncılar, aşağıdaki sorun giderme tablolarında yapılması önerilen işlemleri bulmak ve hataları çözmek için raporda listelenen hata kodlarını kullanabilir.
Sorun giderme
Yayıncıların yanlış yapılandırılmış IAB TCF entegrasyonlarını düzeltmelerine yardımcı olmak amacıyla en yaygın TC dizesi hata türleri ve ilgili sorun giderme önerileri için aşağıdaki tabloları oluşturduk.
Reklam isteği düzeyinde ortaya çıkan sorunları ve ilgili sistem davranışını anlamak için bu tabloları kullanın.
Sınırlı izin senaryoları
İlgili istekte birden çok hata olması durumunda bile her üç senaryo da yapılandırma hatalarına kıyasla önceliklidir.
| Senaryo | Açıklama | Yapılması önerilen işlem |
|---|---|---|
| 1.1 | Google'ın, tedarikçi firma olarak rıza veya meşru menfaat kapsamında gösterilmesi yasaktır. | Kullanıcının tedarikçi firma olarak Google'ı kasten reddettiğini, CMP uygulaması hatalarının meydana gelip gelmediğini veya yayıncı kısıtlamaları olup olmadığını onaylayın. |
| 1.2 | AEA ülkeleri, Birleşik Krallık ve İsviçre'de 1. Amaç için izin verilmemiş. |
Kullanıcının kasten mi 1. Amaç'a izin vermediğini yoksa bunun CMP uygulama hatalarından mı kaynaklandığını kontrol edin. İsviçre'deki yayıncılar, kullanıcılardan izin istemedikleri takdirde
PublisherCC ve PurposeOneTreatment alanlarını doğru şekilde ayarladıklarından emin olmalıdır. Aralık 2021'den itibaren, Almanya Telekomünikasyon ve Telemedya Veri Koruma Yasası uyarınca artık Almanya'dan gelen reklam isteklerinde |
| 1.3 | 1. Amaç için izni vardır ancak genel reklamlar için yasal gerekçeye sahip değildir. |
Kullanıcının meşru menfaatleri başka amaçlar doğrultusunda kasten reddedip reddetmediğini veya bunun CMP uygulama hatalarından mı kaynaklandığını kontrol edin. |
| 1.4 | Tüm TCF 2.3 sürümü dizelerinde zorunlu olan "Açıklanan sağlayıcılar" bölümü eksik, hatalı biçimlendirilmiş veya Google'ı içermiyor. |
Google, açıklanan sağlayıcılar segmentinde açıklanmadığı, açıklanan sağlayıcılar segmenti 2.3 sürümü dizesinde eksik olduğu veya açıklanan sağlayıcılar segmentini işleyemediğimiz için bu isteği işleme alamadı. CMP kurulumunuzun TCF v2.3 sürümü spesifikasyonunu desteklediğini ve CMP'nizi, sağlayıcı yapılandırmasına Google Reklamcılığı Ürünleri'ni (Ürün Kimliği 755) dahil edecek şekilde yapılandırdığınızı onaylayın. TCF 2.3 sürümü, 1 Mart 2026'da veya sonrasında oluşturulan tüm TC dizeleri için zorunludur. |
Yanlış yapılandırma
Google, bu sorunlar meydana geldiğinde sınırlı reklamlar yayınlamaya çalışır.
| Hata | Açıklama | Yapılması önerilen işlem |
|---|---|---|
| 2.1a | Etiket veya SDK, CMP durumunun stub, loading veya error olması nedeniyle TC dizesi almıyor. |
Reklam isteği göndermek için işlevi manuel olarak çağırıyorsanız Reklam isteği göndermek amacıyla işlevi manuel olarak çağırmıyorsanız CMP ile birlikte çalışarak addEventListener desteğinin uygulandığından ve kullanıcı izninin API ile kullanılmaya hazır olduğunu göstermek için |
| 2.1b |
Her iki koşul da karşılanır:
|
CMP'nizden, API'lerinin IAB TCF teknik özelliklerine göre doğru şekilde uygulandığını kontrol etmesini isteyin. |
| 2.2a |
TC dizesi, base64 olarak kodlanmadığı için ayrıştırılamıyor. Örnek: |
CMP'ler (veya yayıncılar), base64 şifrelenmiş verilerini yalnızca gdpr_consent= parametrelerinde göndermelidir. |
| 2.2b |
TC dizesi, kod çözme hatası nedeniyle ayrıştırılamıyor. Örnek: Yanlış bit sayısı içermekte |
CMP, TC dizesi uygulama hatalarını düzeltmelidir. |
| 2.2c |
Bir veri hatası nedeniyle TC dizesi ayrıştırılamıyor. Örnek: Yanlış zaman damgası, sağlayıcı kimliği çok büyük |
CMP, TC dizesi uygulama hatalarını düzeltmelidir. |
TC dizesiyle ilgili sorunlar
TC dizesindeki, reklam isteğiyle ilişkili sorunlar. Google, bu sorunlar meydana geldiğinde sınırlı reklamlar yayınlamaya çalışır.
| Hata | Açıklama | Yapılması önerilen işlem |
|---|---|---|
| 3.1 | Geçersiz CMP kimliği. |
IAB tarafından doğrulanmış bir CMP'nin kullanıldığından ve kimliğinin TC dizelerinde doğru şekilde ayarlandığından emin olun. TC dizesi oluşturulduğunda bir CMP geçerliyse ancak daha sonra IAB tarafından silindiyse geçerli bir CMP kullanarak izni yeniden almanız gerekir. |
Yeniden izin alınmalıdır
Kullanıcıdan izin alınmalıdır. Google'ın henüz listelenmediği bir GVL sürümünü kullanıyorsanız kullanıcının iznini yeniden almanız gerekir. Aksi takdirde Google, sınırlı reklamlar yayınlamaya çalışır.
| Hata | Açıklama | Yapılması önerilen işlem |
|---|---|---|
| 4.1 | TC dizesi, Google'ın henüz listelenmediği bir GVL sürümü kullanılarak oluşturulmuştur. | GVL'nin güncel bir sürümünü kullanarak yeniden izin alın. |
Global kapsam ve bant dışı kapsam
Aşağıdakiler, global kapsam ve bant dışı kapsamla ilgili sorunlardır (Ad Manager, AdMob, AdSense). Google, bu sorunlar meydana geldiğinde sınırlı reklamlar yayınlamaya çalışır.
| Hata | Açıklama | Önerilen işlem |
|---|---|---|
| 5.1 | TC dizesi, bant dışı izinlere izin veriyor. | CMP'nizden bant dışı sinyalleri TC dizelerinden kaldırmasını isteyin. |
| 5.2 | Global kapsamlı TC dizesi. | CMP'den TC dizelerinizi hizmete özel olacak şekilde güncellemesini isteyin. |
Eski TCF sürümünün kullanılması
Google, bu sorunlar meydana geldiğinde sınırlı reklamlar yayınlamaya çalışır.
| Hata | Açıklama | Önerilen işlem |
|---|---|---|
| 6.1 | TC dizesi sürümü 1 veya 1.1 (1.0 sürümü dizesi) şeklinde. |
CMP, TCF 2.3 sürümü dizeleri göndermelidir. |
Google'ın ele alacağı sorunlar
Bu sorunlar ortaya çıktığında Google gereken yerlerde sorunun etkisini azaltır ve normal TCF işlemiyle devam eder.
| Hata | Açıklama | Önerilen işlem |
|---|---|---|
| 7.7 | Geçersiz dil kodu. | CMP, TC dizesi uygulama hatalarını düzeltmelidir. |
| 7.8 | TC dizesi sürümü alanı 1 veya 2 şeklinde değil. |
Geçersiz bir TC dizesi algılanırsa CMP yeni izin isteyerek TC dizesi uygulama hatalarını gidermelidir. Google'ın kullanıcı rızası yönetim çözümlerini kullanıyorsanız bu tür hataları gidermek için uygulamalarla ilgili sorun giderme adımlarını inceleyin. Google kullanıcı rızası yönetim çözümlerini kullanan AdSense yayıncılarının bu hata türü için herhangi bir işlem yapmasına gerek yoktur. |
| 7.9 | Eİ dizesi sürümü 1 veya 2 değil. |
CMP, Eİ dizesi sürümünü 1 veya 2 olarak ayarlamalıdır. |
Eİ dizesi sorunları
Bu sorunlar söz konusu olduğunda Google, Ek İzin (Eİ) dizesini geçersiz olarak değerlendirir ve TC dizesi dışında başka satıcılar dikkate alınmaz.
| Hata | Açıklama | Önerilen işlem |
|---|---|---|
| 8.1 | Eİ dizesi, sürüm ayırıcısını (~) kullanmıyor. |
CMP, sürüm numarasını izin verilen satıcılar listesinden ayırmak için Eİ dizesinin ikinci karakteri olarak "~" kullanmalıdır. |
| 8.2 | Eİ dizesi, beklenen biçimlendirmeye uymayan bir sağlayıcı listesi içerir (int64'lerin listesi "." ile ayrılmış). | CMP, Eİ dizesi uygulama hatalarını düzeltmelidir. |
CMP sertifikasyonu
Bu sorunlar oluştuğunda Google kişiselleştirilmemiş reklamlar yayınlamaya çalışacaktır.
| Hata | Açıklama | Önerilen işlem |
|---|---|---|
| 9.1 | İstekteki TCF CMP'si Google tarafından onaylanmamıştır. | CMP, Google'dan sertifika almalıdır. |
Reklam isteklerinde TCF sinyali yok
Google, bu sorunlar meydana geldiğinde sınırlı reklamlar yayınlamaya çalışır.
| Hata | Açıklama | Önerilen işlem |
|---|---|---|
| 10.1 | İstek AEA, Birleşik Krallık veya İsviçre'den geliyor ya da gdpr=1 parametresi aracılığıyla GDPR yaptırımı için manuel olarak etiketlenmiş ancak istekte TCF sinyalleri eksik. |
Yayıncı, Google sertifikalı bir TCF CMP'si ile entegre olmalı ve/veya gdpr=1 parametresinin yalnızca GDPR yaptırımı kapsamındaki kullanıcılar için ayarlandığından emin olmalıdır. |