- TCF 2.1 sürümü: TCF 2.1 sürümü dizelerini kabul etmeye devam edeceğiz ancak sektörün TCF 2.2 sürümüne geçiş sürecinde CMP'leri, uygulama aşamalarına ilişkin IAB rehberini takip etmeye teşvik ediyoruz.
- 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.2 sürümünü desteklemektedir.
IAB Europe Şeffaflık ve Kullanıcı Rızası Çerçevesi 2.2 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 sürümü uygulama hatalarının nasıl düzeltileceği hakkında daha fazla bilgi bulabilirsiniz. Örneğin:
Güncellenen yönergeler
Güncellemeler
- İzinlerin 13 ayda bir yeniden alınmasıyla ilgili TCF koşulu hakkında hatırlatma:
IAB TCF politikası gereğince izin tercihlerini kullanıcılara en az 13 ayda bir hatırlatmanız (390 gün) gerekir. İzin kararı 13 aydan eskiyse TC dizesi artık Google tarafından geçerli olarak kabul edilmez ve Google bu kullanıcıya reklam yayınlamaz. 13 aylık sınıra ulaşmadan önce izin seçeneklerini kullanıcılara hatırlatmak için CMP'nizle çalışmanızı öneririz.
- 3.2 hata türü kaldırıldı. Son 13 ay içinde güncellenen TC dizeleri geçerli kalır.
Sık karşılaşılan hatalar için düzeltmeler
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.
IAB spesifikasyonu
IAB spesifikasyonları uyarınca CMP'ler izin dizelerini 13 ay boyunca önbelleğe alabilir.
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 istek için para kazanma özelliği devre dışı bırakılabilir.
Gerekçe
Google, bir CMP'nin AddEventListener
işlevine hemen yanıt vermesi gerektiğini belirten IAB spesifikasyonuna uyar. CMP hemen yanıt vermezse istek için para kazanma özelliği devre dışı bırakılabilir.
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 ve AdSense: Engelleme kontrolleri'ni, ardından AB kullanıcı izni'ni 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 sürümü 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 ve Birleşik Krallık için 1. Amaç izni verilmez. |
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 Temel Reklamlar için yasal dayanaklardan yoksundur. |
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
Yanlış yapılandırma hataları varsa reklam istekleri yerine getirilmez.
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 Reklam isteği göndermek amacıyla işlevi manuel olarak çağırmıyorsanız CMP ile birlikte çalışarak |
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. Reklam istekleri iptal edilir ve yerine getirilmez.
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. 13 aydan uzun bir süre önce veya Google'ın henüz listelenmediği bir GVL sürümünü kullanarak izin aldıysanız kullanıcının iznini yeniden almanız gerekir. Aksi takdirde reklam istekleri iptal edilir ve yerine getirilmez.
Hata | Açıklama | Önerilen işlem |
---|---|---|
3.3 | TC dizesi son kez 13 aydan uzun bir süre önce güncellendi. |
CMP, eski TC dizesini silmeli ve izni yeniden almalıdır. Kullanıcı izni CMP tarafından geçersiz kılınıp yeniden alınmadan önce reklam isteklerinin süresi dolmuş bir TC dizesiyle gönderilmesi halinde bu hata birkaç kere görülebilir. 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. |
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). TC dizesinde "bant dışı" veya "global kapsam" ifadesi belirtilmişse reklam yayınlanmaz.
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 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 |
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ı düzeltmelidir. 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 ortaya çıktığında 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
Bu sorunlar ortaya çıktığında Google sınırlı reklamlar yayınlamaya çalışacaktır.
Hata | Açıklama | Önerilen işlem |
---|---|---|
10.1 |
İstek AEA, Birleşik Krallık veya İsviçre'den geliyor ancak TCF sinyalleri yok. |
Yayıncı, Google sertifikalı bir TCF CMP'si ile entegre olmalıdır. |