Khắc phục các vấn đề với thành phần HTML5 cho chiến dịch Quảng cáo ứng dụng

Khi tải các thành phần HTML5 lên trong Google Ads, bạn có thể nhận được một thông báo lỗi. Trong hầu hết các trường hợp, bạn có thể khắc phục bằng cách chỉnh sửa tệp rồi lưu lại. Sau đó, bạn có thể thử tải tệp lên một lần nữa.

Trong một số trường hợp, bạn có thể sử dụng một công cụ như Trình xác thực HTML5 của Google Ads. Với công cụ này, bạn có thể thử nghiệm các thành phần trước khi tải lên Google Ads và kiểm tra những vấn đề tiềm ẩn.

Bài viết này sẽ giúp bạn giải quyết những vấn đề cụ thể có thể xảy ra khi làm việc với các thành phần HTML5 trong chiến dịch Quảng cáo ứng dụng. Tìm hiểu thêm về Quảng cáo HTML5/Quảng cáo có thể chơi cho chiến dịch Quảng cáo ứng dụng

Các vấn đề khi tải lên

Kích thước tệp quá lớn

Thành phần HTML5 trong kích thước quảng cáo xen kẽ (320 x 480 và 480 x 320) có thể có kích thước tệp tối đa là 5,2 MB. Những thành phần lớn hơn sẽ bị từ chối ngay lập tức nên hãy giảm kích thước tệp của thành phần nếu cần.

Lưu ý: Nếu tệp gần đạt đến giới hạn kích thước thì đôi khi nó cũng có thể gây ra sự cố. Việc giảm kích thước tệp một chút cũng sẽ giúp ích.

Kích thước không được cho phép

Chúng tôi chỉ hỗ trợ 2 kích thước cho thành phần:

• 320 x 480 (dọc)
• 480 x 320 (ngang)

Để khắc phục vấn đề này, hãy thay đổi kích thước của thành phần thành kích thước được hỗ trợ hoặc sử dụng thẻ meta "ad.orientation" và đặt đúng giá trị hướng mà thành phần sẽ hiển thị.

Lưu ý: Bạn có thể chọn không sử dụng thẻ meta "ad.size" mà sử dụng thẻ meta "ad.orientation" mới để đặt giá trị hướng mong muốn của thành phần:

• “portrait” (đối với thành phần dọc)
• "landscape" (đối với thành phần ngang)
• “portrait,landscape” hoặc “landscape,portrait” (đối với các thành phần thích ứng hoàn toàn hoạt động theo cả hai hướng)

Nếu bạn vẫn sử dụng thẻ meta “ad.size” và cung cấp kích thước không được hỗ trợ, thì thông báo lỗi sẽ vẫn hiển thị khi tải lên.

Nếu cả hai thẻ meta được khai báo trong HTML, thì giá trị “ad.orientation” sẽ được sử dụng.

Nếu bạn không sử dụng thẻ meta nào hoặc đặt giá trị hướng không chính xác, thì thành phần sẽ không bị từ chối khi tải lên, mà chỉ được hiển thị theo hướng dọc.

Tệp sau đây là một đường dẫn chứa một hoặc nhiều ký tự mà chúng tôi không hỗ trợ. Vui lòng xoá tất cả các ký tự này khỏi tên tệp và tất cả các thư mục, sau đó thử lại.

Tên thư mục và tệp trong tệp .ZIP chỉ được chứa ký tự được hỗ trợ như chữ cái, số, dấu chấm ( . ), dấu gạch nối (-) và dấu gạch dưới (_). Nếu bạn sử dụng các ký tự khác không được hỗ trợ trong tên thư mục hoặc tên tệp (bao gồm cả dấu cách), thì điều này có thể gây ra lỗi.

Để khắc phục vấn đề này, hãy đổi tên thư mục và tệp thành một tên chỉ chứa ký tự được hỗ trợ, đồng thời xoá tất cả các ký tự không được hỗ trợ khỏi tên tệp và tất cả các thư mục rồi thử lại.

Những tệp bị ảnh hưởng sẽ được liệt kê trong thông báo lỗi thay cho thông số đường dẫn tệp, còn những ký tự vi phạm sẽ được liệt kê thay cho thông số đường dẫn ký tự không hợp lệ.

Lưu ý: Nếu các tệp đã đổi tên được tham chiếu trong mã nguồn, thì bạn cũng cần phải cập nhật chúng để tệp có thể hiển thị chính xác.

Tệp sau đây là loại không được hỗ trợ. Bạn nên xoá hoặc thay thế tệp này rồi thử lại.

Hiện tại, đây là những loại tệp duy nhất được hỗ trợ trong gói quảng cáo HTML5:

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

Nếu bạn tải lên các loại tệp khác không được hỗ trợ như .MPEG hoặc .FLA, việc này có thể gây ra lỗi. Để khắc phục vấn đề này, bạn cần xoá hoặc thay thế tệp rồi tải lên lại.

Quảng cáo HTML5 của bạn đang cố gắng tham chiếu đến một thành phần bên ngoài tệp .ZIP. Chúng tôi chỉ cho phép tham chiếu đến tệp nội bộ (ví dụ: "path/to/asset/in-zip.png"). Hãy đảm bảo bạn đã thêm tất cả các thành phần vào tệp .ZIP và tất cả các tham chiếu đến tệp đều thuộc nội bộ. Sau khi bạn thực hiện các thay đổi này, hãy thử lại.

Khi tải gói quảng cáo HTML5 lên, bạn không được sử dụng nội dung tham chiếu đến tệp bên ngoài, trừ những trường hợp sau:

• createjs
• cssplugin
• easeljs
• easepack
• Google Fonts
• CreateJS được lưu trữ trên Google
• Greensock được lưu trữ trên Google (tệp cần hoạt động bất kể phiên bản)
• jQuery được lưu trữ trên Google
• timelinelite
• timelinemax
• tweenjs
• tweenlite
• tweenmax

Để khắc phục vấn đề này, hãy đảm bảo rằng bạn xoá tất cả các tham chiếu đến tệp bên ngoài không được phép khỏi gói quảng cáo HTML5. Sau khi bạn thực hiện các thay đổi, hãy thử tải lên lại.

Quảng cáo HTML5 của bạn đang cố gắng tham chiếu một thành phần mà chúng tôi không tìm thấy trong tệp .ZIP của bạn. Hãy đảm bảo bạn đã thêm tất cả các thành phần vào tệp .ZIP rồi thử lại.

Tất cả thành phần cục bộ được tham chiếu trong tất cả tệp đều phải có trong gói. Nếu bạn tham chiếu một đường dẫn đến một hình ảnh không tồn tại trong gói, thì tệp đó sẽ bị từ chối.

Để khắc phục vấn đề này, hãy nhớ xoá các tham chiếu đến những tệp không tồn tại trong gói hoặc thêm các tệp tham chiếu vào gói rồi tải lên lại.

Quảng cáo HTML5 của bạn bị thiếu tệp HTML chính. Tệp .HTML chính gồm một thẻ Kích thước quảng cáo, chẳng hạn như <meta name="ad.size" content="width=320,height=480">. Hãy đảm bảo quảng cáo HTML5 của bạn có một tệp .HTML chứa một thẻ Kích thước quảng cáo, rồi thử lại.

Thành phần hiển thị lỗi này không chứa một trong các thông số siêu dữ liệu bắt buộc trong bất kỳ tệp .HTML nào trong gói, chẳng hạn như thẻ Kích thước quảng cáo: <meta name="ad.size" content="width=320,height=480">. Việc này không áp dụng với các thành phần của Google Web Designer.

Để khắc phục vấn đề này, hãy đảm bảo rằng thành phần HTML5 có tệp .HTML chính có một thẻ Kích thước quảng cáo chứa trong mục <head> trong mã nguồn. Bạn cũng cần thêm tất cả các thẻ bắt buộc vào mã nguồn của thành phần:

• Khai báo <!DOCTYPE html>
• Thẻ <html>
• Thẻ <body>
• Thẻ meta về hướng của định dạng quảng cáo trong thẻ <head>. Ví dụ: <meta name="ad.orientation" content="portrait">

Các thẻ không hợp lệ như <path><path /> sẽ không được chấp nhận.

Để đáp ứng những yêu cầu này, bạn có thể cần phải trích xuất thẻ .SVG cùng dòng vào các tệp riêng biệt.

Lưu ý: Mặc dù phải chỉ định kích thước, nhưng thành phần của bạn cũng phải có tính thích ứng vì thành phần sẽ được phân phát trên các vị trí xen kẽ với một biểu ngữ có thể khác nhau về kích thước. Để phân phát quảng cáo xen kẽ theo hướng ngang, hãy sử dụng "width=480,height=320".

Gói phương tiện chứa quá nhiều tệp. Hãy đảm bảo số lượng tệp trong tệp .ZIP tối đa là 512 tệp.

Đối với kích thước quảng cáo xen kẽ, thành phần của bạn có thể chứa tối đa 512 tệp trong gói phương tiện. Những thành phần vượt quá số lượng tệp cho phép sẽ bị từ chối.

Để khắc phục vấn đề này, hãy đảm bảo số lượng tệp trong tệp .ZIP tối đa là 512 tệp.

Lưu ý: Các thư mục trong gói phương tiện không làm tăng tổng số tệp trong gói.

Hệ thống không thể xử lý tệp .ZIP này vì tệp .ZIP bị hỏng hoặc có chứa tệp bị hỏng. Hãy kiểm tra các tệp của bạn, nén lại rồi thử lại.

Để khắc phục vấn đề này, hãy kiểm tra tệp trong gói, nén lại để đảm bảo rằng tệp cuối cùng là tệp lưu trữ ZIP thích hợp, rồi thử tải lên lại.

Tính năng HTML5 trong thành phần HTML5 không được hỗ trợ

Lỗi này cho thấy mã nguồn của các tệp trong gói có một số tính năng mà Google Ads chưa hỗ trợ.

Để khắc phục vấn đề này, hãy xoá những tính năng không được hỗ trợ khỏi gói quảng cáo HTML5. Trình xác thực HTML5 của Google Ads có thể giúp bạn làm việc đó.

Lưu ý: Trong mục “Kiểm tra HTML5 nâng cao” của trình xác thực HTML5 của Google Ads, bạn có thể thấy thông báo lỗi sau: UNSUPPORTED_HTML5_FEATURE: rdf:description

Nếu vấn đề là do thẻ .SVG không được hỗ trợ, thì có thể có các thẻ trong mã mẫu quảng cáo không được đưa vào một trong các danh mục được hỗ trợ, chẳng hạn như phần tử vùng chứa, phần tử chuyển màu và phần tử đồ hoạ.

Để khắc phục vấn đề này, hãy kiểm tra tất cả tệp được lưu trữ trong tệp .ZIP và tìm những thẻ không được hỗ trợ trong mã mẫu quảng cáo, sau đó xoá các thẻ đó. Bạn có thể xem danh sách tất cả các thẻ .SVG được hỗ trợ. Tìm hiểu thêm về danh sách các thẻ .SVG được hỗ trợ và danh mục của chúng

Ví dụ: khi mở tệp .SVG mẫu trong gói bằng một trình chỉnh sửa văn bản, thẻ "rdf:Description" có thể xuất hiện. Khi thẻ đó bị xoá khỏi tất cả các tệp .SVG, bạn có thể tải gói lên.

Tệp ZIP của Google Web Designer chưa được xuất bản

Bạn không thể tải thủ công những tệp nguồn được nén mà vẫn có thể chỉnh sửa bằng Google Web Designer sau khi giải nén. Bạn cần xuất bản thành phần trên Google Web Designer trong cục bộ trước khi chúng đủ điều kiện để tải lên Google Ads.

Để khắc phục vấn đề này, trong Google Web Designer:

1. Nhấp vào Xuất bản.
2. Chọn Xuất bản nội bộ.
3. Tải tệp .ZIP đã tạo lên Google Ads.

Chưa tạo Google Web Designer cho môi trường "Google Ads"

Thành phần Google Web Designer phải chỉ định “gwd-googleads” hoặc “gwd-admob” làm môi trường quảng cáo trong thẻ meta “environment”. Tuy nhiên, nếu môi trường quảng cáo là “gwd-genericad” hoặc “gwd-dv360”, thì quảng cáo sẽ bị từ chối. Điều tắc này không áp dụng cho những thành phần không phải là Google Web Designer.

Để khắc phục vấn đề này, hãy mở tệp nguồn (không phải thành phần đã xuất bản) trong Google Web Designer và thay đổi môi trường thành "Google Ads". Tìm hiểu cách chọn môi trường quảng cáo

Gói phương tiện yêu cầu loại sản phẩm động có ngành dọc phù hợp

Thành phần của bạn có thể chứa dòng sau trong mã nguồn mà không chứa thẻ ngành dọc sản phẩm: <meta name="productType" content="dynamic">. Thẻ này được xác định cho tính năng tái tiếp thị linh động cho những thành phần HTML5 dựa trên nguồn cấp dữ liệu.

Để khắc phục vấn đề này, hãy xoá dòng <meta name="productType" content="dynamic"> theo cách thủ công khỏi mã nguồn vì chiến dịch Quảng cáo ứng dụng hiện chưa hỗ trợ các thành phần HTML5 tuỳ chỉnh dựa trên nguồn cấp dữ liệu.

Gói phương tiện không tương thích với loại sản phẩm hiện tại

Thành phần của bạn có thể đang tham chiếu thẻ <meta name="productType" content="dynamic">, nhưng các thành phần HTML5 động thường không được hỗ trợ trong chiến dịch Quảng cáo ứng dụng.

Để khắc phục vấn đề này, hãy xoá <meta name="productType" content="dynamic"><meta name="vertical" content="{content_type}"> khỏi mã nguồn của tệp index.html.

Lưu ý: Có thể có các giá trị khác nhau trong phần giữ chỗ {content_type}, chẳng hạn như RETAIL, CUSTOM, v.v.

Quảng cáo HTML5 sử dụng tệp ZIP tạo bằng DoubleClick Studio không được hỗ trợ

Nhìn chung, những thành phần được tạo trong Studio (trước đây gọi là "DoubleClick Studio") không tương thích với Google Ads. Hệ thống xác định điều này bằng cách kiểm tra xem có tham chiếu thư viện JS dành riêng cho Studio tên là “Trình cấp phép” hay không. Đối với các thành phần tuỳ chỉnh không phải Google Web Designer, thư viện Enabler.js không được hỗ trợ nên không thể sử dụng.

Lưu ý: Các tệp Google Web Designer chứa thư viện Enabler.js theo mặc định và thư viện này được hỗ trợ đầy đủ trong các tệp đó chứ không được hỗ trợ trong gói HTML5 tuỳ chỉnh.

Để khắc phục vấn đề này, hãy xoá những tham chiếu đến thư viện Enabler.js khỏi thành phần HTML5 tuỳ chỉnh.

Hành vi thoát của quảng cáo được định cấu hình không đúng cách

ExitAPI không được hỗ trợ trong mẫu quảng cáo Google Web Designer. Để khắc phục vấn đề này, hãy xoá mọi tham chiếu đến ExitAPI và sử dụng thành phần Khu vực nhấn để chỉ định khu vực có thể nhấp tuỳ chỉnh.

Vấn đề sau khi tải lên

Thành phần HTML5 bị từ chối vì "Lệnh gọi của bên thứ 4 không hợp lệ", "Quảng cáo HTML5 không được chấp nhận" hoặc cả hai.

Những thành phần HTML5 có một trong các phần tử sau đây dự kiến sẽ bị từ chối do "Lệnh gọi của bên thứ 4 không hợp lệ" hoặc "Quảng cáo HTML5 không được chấp nhận":

• Thẻ <video> không có thuộc tính src
• Tham chiếu bên ngoài không phát hiện được
• Những phông chữ không phải của Google được nhúng trực tiếp trong tệp và không được tham chiếu từ miền fonts.googleapis.com sẽ khiến thành phần bị từ chối, ngoại trừ những phông chữ có định dạng được liệt kê bên dưới:
  • .dfont
  • .eot
  • .otf
  • .tte
  • .ttf
  • .woff
  • .woff2
    • Lưu ý: Bạn có thể kiểm tra danh sách tất cả phông chữ được hỗ trợ trong Google Fonts.
• Thành phần được nhúng trong khung con
  • Tìm các thẻ như <framework>, <frame> hoặc <iframe> trong mã nguồn. Khung cho phép bạn nhúng nội dung bên ngoài và thậm chí toàn bộ trang web trong một tệp HTML nhưng không được hỗ trợ trong các thành phần HTML5.
• Mẫu quảng cáo Google Web Designer và AMPHTML
  • Tìm các thẻ bắt đầu bằng tiền tố “amp”, chẳng hạn như <amp-img> hoặc <amp-ad-exit> trong mã nguồn. Bạn cũng có thể tìm thấy tham chiếu đến các tập lệnh được lưu trữ trên cdn.ampproject.org.

Ngoài ra, bạn có thể kiểm tra xem thành phần có đang thực hiện những lệnh gọi của bên thứ 4 nhất định hay không thông qua thẻ “Mạng” trong Công cụ cho nhà phát triển Chrome. Cách truy cập:

1. Nhấp chuột phải vào bản xem trước thành phần trong trình xác thực HTML5 của Google Ads hoặc Google Ads.
2. Chọn "Kiểm tra" trong trình đơn theo bối cảnh.
3. Nhấp vào thẻ Mạng.

Để khắc phục vấn đề, hãy xem xét các thành phần của bạn, tìm các phần tử và thẻ không được hỗ trợ bằng Trình xác thực HTML5 của Google Ads, rồi chỉnh sửa những thông tin cần thiết. Sau đó, hãy thử tải thành phần lên lại. Bạn cũng có thể tìm hiểu thêm về các yêu cầu kỹ thuật đối với "Quảng cáo HTML5 không được chấp nhận".

Bản xem trước quảng cáo không tải

Bản xem trước quảng cáo dự kiến sẽ không tải nếu thành phần bạn tải lên sử dụng một tài nguyên vi phạm Chính sách bảo mật nội dung.

Để khắc phục vấn đề này, bạn có thể kiểm tra xem trình duyệt đang thông báo điều gì về thành phần của bạn (liệu trình duyệt có cố ý từ chối một số tài nguyên trong quảng cáo HTML5 hay không) thông qua thẻ "Bảng điều khiển" trong Công cụ cho nhà phát triển Chrome. Cách truy cập:

1. Nhấp chuột phải vào bản xem trước thành phần trong trình xác thực HTML5 của Google Ads hoặc Google Ads.
2. Chọn "Kiểm tra" trong trình đơn theo bối cảnh.
3. Nhấp vào thẻ Bảng điều khiển.

Bản xem trước quảng cáo hiển thị không chính xác

Vấn đề bản xem trước quảng cáo hiển thị không chính xác có thể gây ra bởi một số thành phần sử dụng thư viện PixiJSy (hoặc thư viện bên ngoài khác) và thư viện có thể hoạt động không đúng cách trong hộp cát.

Để khắc phục vấn đề này, hãy đảm bảo xây dựng thành phần HTML5 sao cho hoạt động trong iframe hộp cát chỉ với cờ "allow-scripts".

Lưu ý: Vì quảng cáo HTML5 được đưa vào hộp cát mà không có allow-same-origin, nên phải tải hình ảnh với crossorigin="anonymous" để sử dụng trong một canvas.

Không thể nhấp vào thành phần trong bản xem trước

Dịch vụ Xem trước quảng cáo dự kiến sẽ chặn khả năng nhấp để điều hướng, tức là bạn có thể tương tác với thành phần, nhưng không được nhấp ra khỏi thành phần này trong URL cuối cùng.

Để khắc phục vấn đề này, bạn có thể kiểm tra khả năng nhấp khi tải thành phần lên trình xác thực HTML5 của Google Ads.

Thành phần HTML5 không phân phát

Nếu thành phần HTML5 hoàn toàn không phân phát (không có lượt hiển thị), bạn có thể tham khảo bài viết này trong Trung tâm trợ giúp để tìm hiểu cách khắc phục lỗi chiến dịch Quảng cáo ứng dụng trên Google Ads không chạy hoặc có lưu lượng truy cập thấp.

Tỷ lệ nhấp (CTR) cao với Tỷ lệ chuyển đổi (CVR) thấp

Một giải pháp có thể khắc phục được vấn đề này là thêm tập lệnh ExitAPI dưới dạng thẻ <script> trong <head> và không thêm qua JavaScript khác. Nếu không, mẫu quảng cáo phân phát trực tiếp sẽ hoàn toàn có thể nhấp được trên toàn bộ khu vực của quảng cáo. Điều này có thể dẫn đến một số lượng lớn các lượt nhấp ngoài ý muốn và dẫn đến hiệu suất kém.