Uygulama kampanyalarında HTML5 öğeleriyle ilgili sorunları düzeltme

HTML5 öğelerini Google Ads'e yüklerken hata mesajları alabilirsiniz. Çoğu durumda, dosyayı değiştirerek veya yeniden kaydederek sorunu düzeltebilirsiniz. Ardından, dosyanızı yeniden yüklemeyi deneyebilirsiniz.

Bazı durumlarda ise öğelerinizi Google Ads'e yüklemeden önce test etmenize ve olası sorunları kontrol etmenize olanak tanıyan Google Ads HTML5 Doğrulama Aracı gibi bir araç kullanabilirsiniz.

Bu makale, uygulama kampanyalarınızda HTML5 öğeleriyle çalışırken karşılaşabileceğiniz belirli sorunları gidermenize yardımcı olacaktır. Uygulama kampanyaları için HTML5/oynanabilir reklamlar hakkında daha fazla bilgi edinin.

Yükleme sorunları

Dosya boyutu çok büyük

Geçiş reklamı boyutlarındaki (320x480 ve 480x320) HTML5 öğelerinin dosya boyutu en fazla 5,2 MB olabilir. Daha büyük öğeler hemen reddedilir. Bu nedenle öğenizin dosya boyutunu gereken şekilde küçültün.

Not: Boyutları sınıra yakın olan dosyalar bazen sorunlara neden olabilmektedir. Dosya boyutunu biraz küçültmek de işe yarayabilir.

Boyutlara izin verilmiyor

Yalnızca iki öğe boyutu desteklenmektedir:

• 320x480 (dikey)
• 480x320 (yatay)

Sorunu düzeltmek için öğenizin boyutlarını desteklenen değerlere getirin veya "ad.orientation" meta etiketini kullanarak öğenizin oluşturulması gereken yön değerini doğru şekilde ayarlayın.

Not: Öğenizin yön değerini ayarlamak için "ad.size" meta etiketi yerine yeni "ad.orientation" meta etiketini kullanmayı tercih edebilirsiniz.

• "portrait" (dikey öğeler için)
• "landscape" (yatay öğeler için)
• "portrait,landscape" veya "landscape,portrait" (her iki yönde de çalışan tamamen uyumlu öğeler için)

“ad.size” meta etiketini kullanmaya devam edip desteklenen değerler haricinde boyutlar kullanırsanız yükleme sırasında hata mesajı gösterilmeye devam eder.

Her iki meta etiket de HTML'de tanımlanıyorsa "ad.orientation" değeri kullanılır.

Herhangi bir meta etiket kullanmıyorsanız veya yön değerlerini yanlış ayarladıysanız öğeleriniz yükleme sırasında reddedilmez ancak yalnızca dikey yönde oluşturulur.

Bu dosya, desteklemediğimiz bir veya daha çok karakter içeren bir yolda. Lütfen dosya adından ve tüm dizinlerden bu karakterlerin tüm örneklerini kaldırıp tekrar deneyin.

.ZIP dosyasındaki klasör ve dosya adları yalnızca harf, sayı, nokta (.), kısa çizgi (-) ve alt çizgi (_) gibi desteklenen karakterlerden oluşabilir. Klasör veya dosya adlarınızda desteklenmeyen başka karakterler kullanırsanız (boşluklar dahil) hata oluşabilir.

Sorunu düzeltmek için klasör ve dosyalarınızı desteklenen karakterler kullanarak yeniden adlandırın ve desteklenmeyen karakterleri dosya adından ve tüm dizinlerden kaldırıp tekrar deneyin.

Etkilenen dosyalar, hata mesajındaki "file path" parametresinde listelenir. Politikayı ihlal eden karakterler ise "invalid chars" parametresinde gösterilir.

Not: Yeniden adlandırılan dosyalara kaynak kodda referans veriliyorsa dosyanın doğru şekilde oluşturulması için söz konusu dosyaların adlarını da kaynak kodda güncellemeniz gerekir.

Dosya desteklenmeyen bir türde. Bu dosyayı kaldırıp veya değiştirip yeniden denemeniz gerekiyor.

Şu an için HTML5 reklam paketlerinde yalnızca aşağıdaki dosya türleri desteklenmektedir:

• .CSS
• .GIF
• .HTML
• .JPEG
• .JS
• .PNG
• .SVG

.MPEG veya .FLA gibi desteklenmeyen dosya türlerini yüklerseniz hata oluşabilir. Sorunu düzeltmek için dosyayı kaldırıp yerine başka bir dosya yüklemeniz veya gerekli değişiklikleri yaptıktan sonra dosyayı yeniden yüklemeniz gerekir.

HTML5 reklamınız, .ZIP dosyanızın dışındaki bir öğeyi kullanmaya çalışıyor. Yalnızca dahili dosya referanslarına izin verilir (örneğin, "zip/içindeki/öğenin/yolu.png"). Tüm öğelerinizi .ZIP dosyasına eklediğinizden ve tüm dosya referanslarının dahili olduğundan emin olun. Gerekli değişiklikleri yaptıktan sonra tekrar deneyin.

HTML5 reklam paketinizi yüklediğinizde, aşağıdakiler dışında harici dosya referanslarına izin verilmez:

• createjs
• cssplugin
• easeljs
• easepack
• Google Fonts
• Google tarafından barındırılan CreateJS
• Google tarafından barındırılan Greensock (dosyalar sürümden bağımsız olarak çalışmalıdır)
• Google tarafından barındırılan jQuery
• timelinelite
• timelinemax
• tweenjs
• tweenlite
• tweenmax

Bu sorunu düzeltmek için izin verilmeyen tüm harici dosya referanslarını HTML5 reklam paketinizden kaldırdığınızdan emin olun. Gerekli değişiklikleri yaptıktan sonra dosyayı yeniden yüklemeyi deneyin.

HTML5 reklamınız .ZIP dosyanızda bulamadığımız bir öğeye referansta bulunmaya çalışıyor. Tüm öğelerinizi .ZIP dosyasına eklediğinizden emin olun ve tekrar deneyin.

Tüm dosyalarda referans verilen yerel öğelerin tamamı pakette bulunmalıdır. Pakette bulunmayan bir resmin yoluna referans veriyorsanız dosya reddedilecektir.

Sorunu düzeltmek için pakette bulunmayan dosyaların referanslarını kaldırdığınızdan veya referans verilen dosyaları pakete eklediğinizden emin olun, ardından dosyayı yeniden yükleyin.

HTML5 reklamınızın birincil .HTML dosyası eksik. Birincil .HTML dosyalarında <meta name="ad.size" content="width=320,height=480"> gibi bir reklam boyutu etiketi bulunur. HTML5 reklamınızda reklam boyutu etiketi içeren bir .HTML dosyası bulunduğundan emin olun ve tekrar deneyin.

Bu hataya neden olan öğeye ait paketteki .HTML dosyalarının hiçbirinde, reklam boyutu etiketi gibi gerekli meta veri parametreleri bulunmamaktadır: <meta name="ad.size" content="width=320 ,height=480"> Bu, Google Web Designer öğeleri için geçerli değildir.

Sorunun düzeltilmesi için HTML5 öğenize ait bir birincil .HTML dosyası olmalı ve bu dosyanın kaynak kodundaki <head> bölümünde bir reklam boyutu etiketi bulunmalıdır. Gerekli tüm etiketleri öğenizin kaynak koduna da eklemeniz gerekir:

• <!DOCTYPE html> bildirimi
• <html> etiketi
• <body> etiketi
• <head> etiketinde yer alan reklam biçimi yönü meta etiketi. Örneğin: <meta name="ad.orientation" content="portrait">

<path><path /> gibi geçersiz etiketler kabul edilmez.

Bu gereksinimleri karşılamak için satır içi .SVG etiketlerini ayrı dosyalara çıkarmanız gerekebilir.

Not: Boyutun belirtilmesi zorunlu olsa da öğenizin, farklı boyutta bannerlara sahip geçiş reklamı alanlarında yayınlanması söz konusu olabilir. Bu yüzden öğenizin uyumlu olması da gerekir. Öğeyi yatay geçiş reklamlarında yayınlamak için "width=480,height=320" değerini kullanın.

Medya paketi çok fazla dosya içeriyor. ZIP dosyanızda bulunan dosya sayısının en fazla 512 olduğundan emin olun.

Geçiş reklamı boyutları söz konusuysa öğelerinizin medya paketlerinde en fazla 512 dosya bulunabilir. İzin verilenden fazla dosyaya sahip öğeler reddedilir.

Sorunu çözmek için .ZIP dosyanızdaki dosya sayısının en fazla 512 olduğundan emin olun.

Not: Medya paketindeki klasörler, paket içindeki toplam dosya sayısını artırmaz.

Dosyanın kendisi veya içerdiği dosyalardan biri bozuk olduğundan, .ZIP dosyası işlenemiyor. Dosyalarınızı kontrol edin, tekrar sıkıştırın ve yeniden deneyin.

Sorunu düzeltmek için paketteki dosyalarınızı kontrol edin. Dosyayı tekrar sıkıştırarak dosyanın düzgün bir ZIP arşivi olduğundan emin olun ve sonra yeniden yüklemeyi deneyin.

HTML5 öğesinde desteklenmeyen HTML5 özelliği

Bu hata, paketteki dosyaların kaynak kodunda Google Ads'in desteklemediği bazı özellikler bulunduğunu gösterir.

Bu sorunu düzeltmek için desteklenmeyen özellikleri HTML5 reklam paketinizden kaldırın. Google Ads HTML5 Doğrulama Aracı bu konuda size yardımcı olabilir.

Not: Google Ads HTML 5 Doğrulama Aracı'nın "Gelişmiş HTML5 kontrolü" bölümünde şu hata mesajını görebilirsiniz: UNSUPPORTED_HTML5_FEATURE: rdf:description

Sorun, desteklenmeyen .SVG etiketlerinden kaynaklanıyorsa reklam öğesi kodunuzda, desteklenen kategorilerde (ör. kapsayıcı öğeleri, gradyan öğeleri ve grafik öğeleri) olmayan etiketler olabilir.

Bu sorunu düzeltmek için .ZIP dosyanızda kayıtlı olan tüm dosyaları kontrol edin, reklam öğesi kodunuzda desteklenmeyen etiketleri arayıp bulun ve bu etiketleri silin. Desteklenen tüm .SVG etiketlerinin listesini görüntüleyebilirsiniz. Desteklenen .SVG etiketlerinin listesi ve kategorileri hakkında daha fazla bilgi edinin.

Örneğin, paket içindeki bir .SVG dosyası bir metin düzenleyicide açıldığında, "rdf:Description" etiketi görünebilir. Bu etiket tüm .SVG dosyalarından kaldırıldığında paket yüklenebilir.

Google Web Designer'dan alınan ZIP dosyası yayınlanmıyor

Arşivden çıkarmanızın ardından Google Web Designer'da hâlâ düzenlenebilir durumda olan, manuel olarak sıkıştırılmış kaynak dosyalarını yükleyemezsiniz. Google Web Designer öğelerinin Google Ads'e yüklenebilir hale gelmesi için yerel olarak yayınlanmaları gerekir.

Sorunu düzeltmek için Google Web Designer'da:

1. Yayınla'yı tıklayın.
2. Yerel olarak yayınla'yı seçin.
3. Oluşturulan .ZIP dosyasını Google Ads'e yükleyin.

Google Web Designer, "Google Ads" ortamı için oluşturulmadı

Google Web Designer öğelerinin, "ortam" meta etiketinde reklam ortamı olarak "gwd-googleads" veya "gwd-admob" belirtilmelidir. Ancak reklam ortamı "gwd-genericad" veya "gwd-dv360" ise reklam reddedilir. Bu, Google Web Designer dışındaki öğeler için geçerli değildir.

Sorunu düzeltmek için Google Web Designer'da kaynak dosyayı (yayınlanan öğeyi değil) açın ve ortamı "Google Ads" olarak değiştirin. Reklam ortamının nasıl seçileceğini öğrenin.

Medya paketi, doğru temaya sahip dinamik ürün türü gerektiriyor

Öğelerinizin kaynak kodunda, ürün dikey etiketi olmamasına rağmen şu satır bulunuyor olabilir: <meta name="productType" content="dynamic">. Bu etiket, feed tabanlı HTML5 öğeleri için dinamik yeniden pazarlama için tanımlanmıştır.

Uygulama kampanyalarında şu anda feed tabanlı özel HTML5 öğeleri desteklenmediğinden, sorunu gidermek için kaynak koddan <meta name="productType" content="dynamic"> satırını manuel olarak kaldırın.

Medya paketi, mevcut ürün türüyle uyumlu değil

Öğeniz <meta name="productType" content="dynamic"> etiketine referans veriyor olabilir ancak uygulama kampanyalarında dinamik HTML5 öğeleri genellikle desteklenmemektedir.

Sorunu gidermek için <meta name="productType" content="dynamic"><meta name="vertical" content="{content_type}"> öğesini index.html dosyasının kaynak kodundan kaldırın.

Not: {content_type} yer tutucusunda RETAIL, CUSTOM gibi farklı değerler olabilir.

DoubleClick Studio tarafından oluşturulan ZIP dosyalarını kullanan HTML5 reklamları desteklenmiyor

Genel olarak, Studio'da (eski adıyla "DoubleClick Studio") oluşturulan öğeler Google Ads ile uyumlu değildir. Sistem, "Enabler" adı verilen Studio'ya özel bir JS kitaplığı referansının olup olmadığını kontrol eder. Google Web Designer dışında oluşturulan özel öğeler için Enabler.js kitaplığı desteklenmez ve kullanılamaz.

Not: Google Web Designer dosyaları, Enabler.js kitaplığını varsayılan olarak içerir ve kitaplık bu dosyalarda tam olarak desteklenir ancak özel HTML5 paketlerinde desteklenmez.

Sorunu çözmek için özel HTML5 öğenizdeki Enabler.js kitaplığına yönelik referansları kaldırın.

Reklam çıkış davranışı düzgün yapılandırılmamış

ExitAPI, Google Web Designer reklam öğelerinde desteklenmez. Sorunu gidermek üzere ExitAPI'ye yönelik tüm referansları kaldırın ve bunun yerine özel tıklanabilir alanı atamak için Dokunma Alanı bileşenini kullanın.

Yükleme sonrası sorunlar

HTML5 öğeleriniz "Geçersiz dördüncü taraf çağrısı", "Kabul edilemez HTML5 reklam" veya her ikisi nedeniyle onaylanmıyor.

Aşağıdaki bileşenlerden birine sahip HTML5 öğelerinin "Geçersiz dördüncü taraf çağrısı" veya "Kabul edilemez HTML5 reklam" nedeniyle onaylanmaması beklenen bir durumdur:

• src özelliği olmayan <video> etiketi
• Algılanmayan harici referanslar
• Doğrudan dosyaya yerleştirilmiş olan ve fonts.googleapis.com alanında referans verilmeyen Google dışı yazı tipleri onaylanmaz (aşağıda listelenen yazı tipleri hariç):
  • .dfont
  • .eot
  • .otf
  • .tte
  • .ttf
  • .woff
  • .woff2
    • Not: Google Fonts'ta desteklenen tüm yazı tiplerinin listesini kontrol edebilirsiniz.
• Alt çerçevelere yerleştirilmiş öğeler
  • Kaynak kodunda <frameset>, <frame> veya <iframe> gibi etiketler olup olmadığına bakın. Çerçeveler, harici içerikleri ve hatta tüm web sitelerini bir HTML dosyasına yerleştirmenize olanak tanır ancak HTML5 öğelerinde desteklenmez.
• Google Web Designer ve AMPHTML reklam öğeleri
  • Kaynak kodunda <amp-img> veya <amp-ad-exit> gibi "amp" ön ekleriyle başlayan etiketleri bulun. cdn.ampproject.org üzerinde barındırılan komut dosyalarına yönelik referanslar bulabilirsiniz.

Ayrıca, öğenizin belirli dördüncü taraf çağrıları yapıp yapmadığını Chrome Geliştirici Araçları'ndaki "Ağ" sekmesinden kontrol edebilirsiniz. İlgili sekmeye erişmek için:

1. Google Ads veya Google Ads HTML5 Doğrulama Aracı'nda öğe önizlemesini sağ tıklayın.
2. İçerik menüsünden "İncele"yi seçin.
3. Ağ sekmesini tıklayın.

Sorunu düzeltmek için öğelerinizi inceleyin, Google Ads HTML5 Doğrulama Aracı'nı kullanarak desteklenmeyen öğeler ve etiketler olup olmadığına bakın ve gerekli düzenlemeleri yapın. Ardından, öğenizi yeniden yüklemeyi deneyin. Ayrıca, "Kabul edilemez HTML5 reklam" ile ilişkili teknik koşullar hakkında daha fazla bilgi edinebilirsiniz.

Reklam önizlemesi yüklenmiyor

Yüklediğiniz öğe, İçerik Güvenliği Politikası'nı ihlal eden bir kaynak kullanıyorsa reklam önizlemesinin yüklenmemesi beklenen bir durumdur.

Sorunu düzeltmek için Chrome Geliştirici Araçları'ndaki "Konsol" sekmesinden tarayıcının öğenizle ilgili olarak verdiği bilgileri kontrol edebilirsiniz (tarayıcının HTML5 reklamındaki bazı kaynakları kasten reddedip reddetmediğini öğrenebilirsiniz). İlgili sekmeye erişmek için:

1. Google Ads veya Google Ads HTML5 Doğrulama Aracı'nda öğe önizlemesini sağ tıklayın.
2. İçerik menüsünden "İncele"yi seçin.
3. Konsol sekmesini tıklayın.

Reklam önizleme hatalı şekilde oluşturuluyor

Reklam önizlemesinin hatalı şekilde oluşturulmasına, PixiJS kitaplığının (veya başka harici kitaplıkların) kullanıldığı bazı öğeler neden olabilir. Bu öğeler, korumalı alanda düzgün şekilde çalışmayabilir.

Sorunu düzeltmek için HTML5 öğelerinizin yalnızca "allow-scripts" işaretiyle, korumalı alana alınmış bir iframe'de çalışacak şekilde oluşturulduğundan emin olun.

Not: HTML5 reklamlar "allow-same-origin" olmadan korumalı alana alındığından, zeminde kullanılacak resimlerin crossorigin="anonymous" ile yüklenmesi gerekir.

Öğe önizlemede tıklanabilir değil

Reklam önizleme hizmetinin, gezinme amaçlı tıklanabilirliği engellemesi beklenir. Bu, öğeyle etkileşimde bulunabileceğiniz ancak nihai URL'yi tıklayarak öğeden çıkamayacağınız anlamına gelir.

Sorunu düzeltmek için, öğenizi Google Ads HTML5 Doğrulama Aracı'na yüklediğinizde tıklanabilirliği test edebilirsiniz.

HTML5 öğesi yayınlanmıyor

HTML5 öğeniz hiç yayınlanmıyorsa (sıfır gösterim) yayınlanmayan veya düşük trafiğe sahip Google Ads uygulama kampanyalarını nasıl düzelteceğinizi öğrenmek için bu Yardım Merkezi makalesini inceleyebilirsiniz.

Tıklama oranı (TO) yüksek olmasına rağmen dönüşüm oranı (DO) düşük

Sorunu düzeltebilecek olası bir çözüm, <head> bölümündeki <script> etiketine ExitAPI komut dosyasının değişmez değer olarak eklenmesi ve bu komut dosyasının başka bir JavaScript kodu üzerinden eklenmemesidir. Aksi takdirde, canlı yayınlanan reklam öğeleri reklamın tüm alanında tamamen tıklanabilir olacaktır. Bu durum, çok sayıda istemeden tıklama durumuna neden olabilir ve düşük performansa yol açabilir.