Memperbaiki masalah aset HTML5 untuk kampanye Aplikasi

Saat mengupload aset HTML5 di Google Ads, Anda mungkin menerima pesan error. Umumnya, masalah bisa diperbaiki dengan mengubah dan menyimpan ulang file Anda. Selanjutnya, Anda dapat mencoba mengupload lagi file tersebut.

Dalam beberapa situasi, Anda dapat menggunakan alat seperti validator HTML5 Google Ads, yang memungkinkan Anda menguji aset sebelum menguploadnya ke Google Ads dan memeriksanya untuk mengetahui masalah yang mungkin timbul.

Artikel ini akan membantu Anda menangani masalah tertentu yang mungkin muncul saat menggunakan aset HTML5 di kampanye Aplikasi. Pelajari lebih lanjut artikel Tentang Iklan HTML5/Iklan yang dapat dimainkan untuk kampanye Aplikasi

Masalah upload

Ukuran file terlalu besar

Aset HTML5 dalam dimensi interstisial (320x480 dan 480x320) dapat berukuran hingga 5,2 MB. Aset yang lebih besar dari ukuran ini akan langsung ditolak, jadi perkecil ukuran file aset sesuai ketentuan.

Catatan: Jika file hampir mencapai batas ukuran, terkadang masalah dapat muncul. Memperkecil sedikit ukuran file juga dapat membantu menghindari masalah.

Dimensi tidak diizinkan

Hanya ada 2 dimensi aset yang didukung:
  • 320x480 (potret)
  • 480x320 (lanskap)

Untuk memperbaiki masalah ini, ubah dimensi aset ke dimensi yang didukung atau gunakan tag meta “ad.orientation” dan tetapkan nilai orientasi yang benar untuk hasil render aset Anda.

Catatan: Alih-alih menggunakan tag meta “ad.size”, Anda dapat menggunakan tag meta “ad.orientation” yang baru dalam menetapkan nilai orientasi yang diinginkan untuk aset Anda:
  • “portrait” (untuk aset vertikal)
  • "landscape” (untuk aset horizontal)
  • “portrait,landscape” atau “landscape,portrait” (untuk aset yang sepenuhnya responsif yang bisa digunakan dalam kedua orientasi tersebut)

Jika Anda tetap menggunakan tag meta “ad.size” dan memasukkan dimensi selain dimensi yang didukung, pesan error akan tetap muncul setelah aset diupload.

Jika kedua tag meta dideklarasikan dalam HTML, nilai “ad.orientation” akan digunakan.

Jika Anda tidak menggunakan tag meta mana pun atau tidak menyetel nilai orientasi yang benar, aset tidak akan ditolak setelah diupload, tetapi hanya akan dirender dalam orientasi potret.

File berikut berada di jalur yang menyertakan satu atau beberapa karakter yang tidak kami dukung. Hapus semua instance karakter ini dari nama file dan semua direktori, lalu coba lagi.

Nama folder dan file dalam file .ZIP hanya boleh berisi karakter yang didukung seperti huruf, angka, titik (. ), tanda hubung (-), dan garis bawah (_). Jika Anda menggunakan karakter lain yang tidak didukung dalam nama folder atau file (termasuk spasi), tindakan ini dapat memicu error.
Untuk memperbaiki masalah ini, ganti nama folder dan file Anda dengan karakter yang didukung dan hapus semua instance karakter yang tidak didukung dari nama file dan semua direktori, lalu coba lagi.
File yang terpengaruh akan dicantumkan dalam pesan error di tempat parameter jalur file, sedangkan karakter yang melanggar akan dicantumkan di tempat parameter jalur karakter yang tidak valid.
Catatan: Jika file yang diganti namanya direferensikan di kode sumber, Anda juga harus memperbaruinya agar file dapat dirender dengan benar.

File berikut adalah jenis file yang tidak didukung. Anda harus menghapus atau mengganti file ini, lalu coba lagi.

Saat ini, jenis file berikut adalah yang didukung dalam paket iklan HTML5:
  • .CSS
  • .GIF
  • .HTML
  • .JPEG
  • .JS
  • .PNG
  • .SVG

Jika Anda mengupload jenis file lain yang tidak didukung seperti .MPEG atau .FLA, file tersebut dapat memicu error. Untuk memperbaiki masalah ini, Anda harus menghapus atau mengganti jenis file, lalu menguploadnya lagi.

Iklan HTML5 Anda mencoba mereferensikan aset yang tidak ada di dalam file .ZIP Anda. Hanya referensi file internal yang diizinkan (misalnya, "path/to/asset/in-zip.png"). Pastikan Anda telah menyertakan semua aset di dalam file .ZIP dan semua referensi file bersifat internal. Setelah melakukan perubahan, coba upload ulang.

Saat Anda mengupload paket iklan HTML5, referensi file eksternal tidak diizinkan kecuali untuk referensi file berikut:

Untuk memperbaiki masalah ini, pastikan Anda menghapus semua referensi file eksternal yang tidak diizinkan dari paket iklan HTML5. Setelah Anda melakukan perubahan, coba upload ulang.

Iklan HTML5 Anda mencoba mereferensikan aset yang tidak dapat ditemukan dalam file .ZIP. Pastikan Anda menyertakan semua aset dalam file .ZIP, lalu coba lagi.

Semua aset lokal yang direferensikan dalam semua file harus ada di paket. Jika Anda mereferensikan jalur ke gambar yang tidak ada dalam paket, file tersebut akan ditolak.
Untuk memperbaiki masalah ini, pastikan Anda menghapus referensi ke file yang tidak ada dalam paket, atau tambahkan file yang direferensikan ke dalam paket, lalu upload ulang.

File .HTML utama pada Iklan HTML5 Anda tidak ada. File .HTML utama berisi tag Ukuran Iklan seperti <meta name="ad.size" content="width=320,height=480">. Pastikan ada file .HTML dengan tag Ukuran Iklan di Iklan HTML5 Anda, lalu coba lagi.

Aset yang menampilkan error ini tidak memuat salah satu parameter metadata yang diperlukan dalam file .HTML di paket, seperti tag Ukuran Iklan: <meta name="ad.size" content="width=320,height=480">. Ketentuan ini tidak berlaku untuk aset Google Web Designer.
Untuk memperbaiki masalah ini, pastikan aset HTML5 Anda berisi file .HTML utama dengan tag Ukuran Iklan di dalam bagian <head> pada kode sumber. Anda juga harus menambahkan semua tag yang diperlukan ke dalam kode sumber aset Anda:
  • Deklarasi <!DOCTYPE html>
  • Tag <html>
  • Tag <body>
  • Tag meta orientasi format iklan di dalam tag <head>. Misalnya, <meta name="ad.orientation" content="portrait">

Tag yang tidak valid seperti <path><path /> tidak akan diterima.

Untuk memenuhi persyaratan ini, Anda mungkin perlu mengekstrak tag .SVG inline ke dalam file terpisah.

Catatan: Meskipun ukuran harus ditentukan, aset Anda juga harus bersifat responsif, karena aset akan ditayangkan di slot interstisial dengan banner yang ukurannya dapat bervariasi. Untuk menayangkan aset di slot interstisial dengan orientasi lanskap, gunakan ukuran "width=480,height=320".

Paket media berisi terlalu banyak file. Pastikan jumlah file dalam file .ZIP Anda kurang dari atau sama dengan 512 file.

Untuk ukuran interstisial, aset Anda dalam paket media boleh berisi hingga 512 file. Jika jumlah file dalam aset melebihi batas yang diizinkan, aset akan ditolak.
Untuk memperbaiki masalah ini, pastikan jumlah file dalam file .ZIP Anda kurang dari atau sama dengan 512 file.
Catatan: Folder dalam paket media tidak menambah keseluruhan jumlah file dalam paket.

File .ZIP tidak dapat diproses karena file tersebut atau salah satu file di dalamnya rusak. Periksa file Anda, kompres ulang, lalu coba lagi.

Untuk memperbaiki masalah ini, periksa file Anda dalam paket, kemudian kompres ulang untuk memastikan bahwa file yang dihasilkan adalah file ZIP yang tepat, lalu coba upload ulang.

Fitur HTML5 yang tidak didukung dalam aset HTML5

Error ini menunjukkan bahwa kode sumber file dalam paket memiliki beberapa fitur yang tidak didukung Google Ads.
Untuk memperbaiki masalah ini, hapus fitur yang tidak didukung dari paket iklan HTML5 Anda. Validator HTML5 Google Ads dapat membantu Anda mengatasi masalah tersebut.
Catatan: Di bagian “Pemeriksaan HTML5 lanjutan” pada validator HTML5 Google Ads, Anda mungkin menemukan pesan error berikut: UNSUPPORTED_HTML5_OPTION: rdf:description

Jika masalah terkait dengan tag .SVG yang tidak didukung, mungkin ada tag dalam kode materi iklan Anda yang tidak termasuk dalam salah satu kategori yang didukung seperti elemen penampung, elemen gradien, dan elemen grafis.

Untuk memperbaiki masalah ini, periksa semua file yang disimpan dalam file .ZIP Anda, kemudian cari tag yang tidak didukung di kode materi iklan Anda, lalu hapus tag tersebut. Anda dapat melihat daftar semua tag .SVG yang didukung. Pelajari daftar tag .SVG yang didukung dan kategorinya lebih lanjut

Misalnya, saat sampel file .SVG dalam paket dibuka di editor teks, tag “rdf:Description” dapat muncul. Jika tag tersebut dihapus dari semua file .SVG, paket dapat diupload.

File ZIP dari Google Web Designer tidak dipublikasikan

Anda tidak dapat mengupload file sumber yang dikompresi secara manual dan masih dapat diedit di Google Web Designer setelah diekstrak. Aset Google Web Designer harus dipublikasikan secara lokal sebelum dapat diupload ke Google Ads.
Untuk memperbaiki masalah ini, di Google Web Designer:
  1. Klik Publikasikan.
  2. Pilih Publikasikan secara lokal.
  3. Upload file .ZIP yang dihasilkan ke Google Ads.

Google Web Designer tidak dibuat untuk lingkungan "Google Ads"

Aset Google Web Designer harus menetapkan “gwd-googleads” atau “gwd-admob” sebagai lingkungan iklan dalam tag meta “lingkungan”. Namun, jika lingkungan iklan yang ditetapkan adalah “gwd-genericad” atau “gwd-dv360”, iklan tersebut akan ditolak. Ketentuan ini tidak berlaku untuk aset non-Google Web Designer.
Untuk memperbaiki masalah ini, buka file sumber (bukan aset yang dipublikasikan) di Google Web Designer dan ubah lingkungan menjadi “Google Ads”. Pelajari cara memilih lingkungan iklan

Paket media memerlukan jenis produk dinamis dengan vertical yang tepat

Aset Anda dapat berisi baris berikut dalam kode sumber tanpa memuat tag vertical produk: <meta name="productType" content="dynamic">. Tag ini ditujukan bagi pemasaran ulang dinamis untuk aset HTML5 berbasis feed.
Untuk memperbaiki masalah ini, hapus baris <meta name="productType" content="dynamic"> secara manual dari kode sumber karena kampanye Aplikasi saat ini tidak mendukung aset HTML5 kustom berbasis feed.

Paket media tidak kompatibel dengan jenis produk saat ini

Aset Anda mungkin mereferensikan tag <meta name="productType" content="dynamic">, tetapi aset HTML5 dinamis umumnya tidak didukung di kampanye Aplikasi.
Untuk memperbaiki masalah ini, hapus <meta name="productType" content="dynamic"><meta name="vertical" content="{content_type}"> dari kode sumber file index.html.
Catatan: Placeholder {content_type} dapat berisi nilai yang berbeda, seperti RETAIL, CUSTOM, dan lain-lain.

Iklan HTML5 yang menggunakan file ZIP buatan DoubleClick Studio tidak didukung

Umumnya, aset yang dibuat di Studio (sebelumnya disebut “DoubleClick Studio”) tidak kompatibel dengan Google Ads. Sistem mencari tahu ketidaksesuaiannya dengan memeriksa apakah ada referensi library JS khusus Studio yang disebut "Enabler" dalam aset. Untuk aset kustom non-Google Web Designer, library Enabler.js tidak didukung dan tidak dapat digunakan.
Catatan: Secara default, file Google Web Designer berisi library Enabler.js dan didukung penuh dalam file tersebut, tetapi tidak dalam paket HTML5 kustom.

Untuk memperbaiki masalah ini, hapus referensi ke library Enabler.js dari aset HTML5 kustom Anda.

Perilaku fungsi keluar iklan tidak dikonfigurasi dengan benar

ExitAPI tidak didukung di materi iklan Google Web Designer. Untuk memperbaiki masalah ini, hapus semua referensi ke ExitAPI dan gunakan komponen Area Ketuk untuk menetapkan area kustom yang dapat diklik.

Masalah setelah upload

Aset HTML5 Anda tidak disetujui karena “Panggilan pihak keempat tidak valid”, “Iklan HTML5 yang tidak dapat diterima”, atau keduanya.

Aset HTML5 yang memiliki salah satu elemen berikut diperkirakan tidak akan disetujui karena “Panggilan pihak keempat tidak valid” atau “Iklan HTML5 yang tidak dapat diterima”:
  • Tag <video> tanpa atribut src
  • Referensi eksternal yang tidak terdeteksi
  • Font non-Google yang disematkan langsung dalam file dan tidak direferensikan dari domain font.googleapis.com akan ditolak, kecuali untuk font dalam format yang tercantum di bawah:
    • .dfont
    • .eot
    • .otf
    • .tte
    • .ttf
    • .woff
    • .woff2
      • Catatan: Anda dapat melihat daftar semua font yang didukung di Google Fonts.
  • Aset disematkan dalam frame turunan
    • Cari tag seperti <frameset>, <frame>, atau <iframe> dalam kode sumber. Dengan frame, Anda dapat menyematkan konten eksternal dan bahkan seluruh situs dalam file HTML. Namun, tindakan ini tidak didukung di aset HTML5.
  • Materi iklan AMPHTML dan Google Web Designer
    • Cari tag yang diawali dengan imbuhan "amp", seperti <amp-img> atau <amp-ad-exit> di kode sumber. Anda juga dapat menemukan referensi ke skrip yang dihosting di cdn.ampproject.org.

Selain itu, Anda dapat memeriksa apakah aset Anda melakukan panggilan pihak keempat tertentu dengan membuka tab "Jaringan" di Chrome Developer Tools. Untuk mengaksesnya:

  1. Klik kanan pada pratinjau aset di Google Ads atau validator HTML5 Google Ads.
  2. Pilih “Periksa” dari menu kontekstual.
  3. Klik tab Jaringan.

Untuk memperbaiki masalah ini, tinjau aset Anda, cari elemen dan tag yang tidak didukung menggunakan validator HTML5 Google Ads, lalu edit sesuai kebutuhan. Setelah itu, coba upload lagi. Anda juga dapat mempelajari persyaratan teknis untuk “Iklan HTML5 yang tidak dapat diterima” lebih lanjut.

Pratinjau iklan tidak dapat dimuat

Pratinjau iklan kemungkinan tidak dapat dimuat jika aset yang diupload menggunakan resource yang melanggar Kebijakan Keamanan Konten.
Untuk memperbaiki masalah ini, Anda dapat memeriksa informasi yang dimiliki browser tentang aset Anda (apakah browser sengaja menolak beberapa resource dalam iklan HTML5) melalui tab "Console" di Chrome Developer Tools. Untuk mengaksesnya:
  1. Klik kanan pada pratinjau aset di Google Ads atau validator HTML5 Google Ads.
  2. Pilih “Periksa” dari menu kontekstual.
  3. Klik tab Konsol.

Pratinjau iklan tidak dirender dengan benar

Kesalahan proses rendering pratinjau iklan dapat disebabkan oleh aset tertentu yang menggunakan library PixiJS (atau library eksternal lainnya), yang mungkin tidak berfungsi dengan benar di sandbox.
Untuk memperbaiki masalah ini, pastikan aset HTML5 Anda dapat berfungsi di iframe yang di-sandbox hanya dengan memasukkan tanda "allow-script".
Catatan: Karena iklan HTML5 di-sandbox tanpa tanda allow-same-origin, gambar harus dimuat dengan crossorigin="anonymous" agar dapat digunakan di kanvas.

Aset dalam pratinjau tidak dapat diklik

Dalam Pratinjau iklan, kemampuan aset diklik akan dibatasi sehingga Anda dapat berinteraksi dengan aset, tetapi tidak dapat mengklik aset yang mengarahkan ke URL final.
Untuk memperbaiki masalah ini, Anda dapat menguji kemampuan aset diklik saat menguploadnya ke validator HTML5 Google Ads.

Aset HTML5 tidak tayang

Jika aset HTML5 Anda tidak tayang sama sekali (tidak memiliki tayangan), Anda dapat membaca artikel Pusat Bantuan ini untuk mempelajari cara memperbaiki kampanye Aplikasi Google Ads yang tidak berjalan atau mendapatkan traffic rendah.

Rasio klik-tayang (CTR) tinggi dengan Rasio Konversi (CVR) rendah

Salah satu solusi yang dapat memperbaiki masalah tersebut adalah dengan menyertakan skrip ExitAPI sebagai tag <script> literal di <head> dan tidak ditambahkan melalui JavaScript lain. Jika tidak, materi iklan yang sedang ditayangkan akan dapat diklik sepenuhnya di seluruh area iklan, sehingga bisa menyebabkan banyak klik yang tidak disengaja dan menghasilkan performa yang buruk.

Apakah ini membantu?

Bagaimana cara meningkatkannya?
Telusuri
Hapus penelusuran
Tutup penelusuran
Aplikasi Google
Menu utama
10209749401153949573
true
Pusat Bantuan Penelusuran
true
true
true
true
true
73067
false
false
false