IAB AB TCF 2.3 sürümünü uygulamayla ilgili sorunları giderme

Sağlayıcı olarak Google, IAB AB TCF 2.3 sürümünü kullanan TC dizelerini artık kabul etmektedir.

• 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
• Politika merkezi
• Hata raporu
• Sorun giderme

---

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

Hata 1.1. Bu yönergeler hata 3.1, 4.1, 5.1, 5.2 ve 6.1'e de uygulanabilir.

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.

IAB spesifikasyonu

IAB spesifikasyonları uyarınca CMP'ler izin dizelerini 13 ay boyunca önbelleğe alabilir.

Not: Bazı CMP'ler daha önce ilk izin tarihini koruyup tarihi uzatmıştır. Bu uygun değildir. İzin tarihi, belirli bir izin dizesi için her seferinde yeni tarih olmalıdır.

Önerilen: CMP'nizin AddEventHandler çağrılarını 500 ms içinde döndürmesini sağlayın.
^{(Hata 2.1a, 2.1b, 2.0a, 2.0b ve 2.0c)}

İlgili hatalar

Hata 2.1a. Bu yönergeler hata 2.1b, 2.0a, 2.0b ve 2.0c'ye de uygulanabilir.

Güncellenen yönergeler

Artık bir zaman aşımı koşulu olmasa da CMP'lerin, çağrıları hemen AddEventListener getTCData'ya 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)

Not: CMP durumunun 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.

İpucu: Bu rapor, yalnızca son 7 gün içinde hata tespit edilirse kullanılabilir.

"AB kullanıcı izni" sayfasına ve TCF hata raporuna erişmek için: 

• 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 2.2 ve 2.3 sürümü entegrasyonlarını düzeltmelerine yardımcı olmak amacıyla sık karşılaşılan 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 PurposeOneTreatment değerlendirmesini kontrol etmeyeceğiz.
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.

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 kaba kod, yükleniyor veya hata olması nedeniyle TC dizesi almıyor.	Reklam isteği göndermek için işlevi manuel olarak çağırıyorsanız yanıtın getTCData TCData.eventStatus = 'tcloaded' VEYA 'cmpuishown' + 'useractioncomplete' olduğundan emin olun. Bunlar, CMP'nin kullanıcıya izinle ilgili bir seçenek sağlamaya hazır olduğunu gösterir. Reklam isteği göndermek amacıyla işlevi manuel olarak çağırmıyorsanız CMP ile birlikte çalışarak getTCData desteğinin uygulandığından ve kullanıcı izninin API ile kullanılmaya hazır olduğunu göstermek için TCData.eventStatus = 'tcloaded' VEYA 'cmpuishown' + 'useractioncomplete' değerinin döndürüldüğünden emin olun.
2.1b	Her iki koşul da karşılanır: CMP'ler &gdpr=1 olarak ayarlandı. &gdpr_consent= istekte mevcut, ancak TC dizesi boş.	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: “2”	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.
3.2	Artık kullanılmıyor.	Yok. Önceki anlamı: TC dizesi 13 aydan uzun bir süre önce oluşturuldu.

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
3.3	Artık kullanılmıyor.	Yok. Önceki anlamı: TC dizesi en son 13 aydan uzun bir süre önce güncellendi.
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.

Sınırlı reklam sunumu

Sınırlı reklamlar yayınlanı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.2 veya 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.1	gdprApptes tanımlanmamış veya geçersiz ya da çözülemez bir değere ayarlanmış, ancak geçerli bir TC dizesi mevcut.	Yok
7.2	TC dizesi, Google'ın sahip olduğu mevcut reklam sunma teknolojisinden daha yeni bir GVL sürümü ile oluşturulmuş.	Yok
7.3	Bazı amaçlar, özellikler ve/veya sağlayıcılar izin verilen aralığın dışında (bilinmiyor).	Yok
7.4	TC dizesi en yeni GVL'den daha eski bir tcf_policy_version değerine sahip.	CMP, eski TC dizesini silmeli ve en yeni GVL'yi kullanarak izni yeniden almalıdır.
7.5	Bir isteğin &gdpr=1 değeri var, ancak istek URL'sinde &gdpr_consent parametresi mevcut değil.	Yok
7.6	Geçersiz yayıncı ülke kodu, ancak 1. Amaç için izin mevcut.	CMP, TC dizesi uygulama hatalarını düzeltmelidir.
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. Uygulamanızda Google kullanıcı rızası yönetim çözümlerini ve UMP SDK'sını kullanıyorsanız UMP SDK'sının doğru şekilde uygulandığını ve her uygulama başlangıcında requestConsentInfoUpdate çağrısının yapıldığını onaylayın.
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.