Rozwiązywanie problemów z komponentami HTML5 w kampaniach promujących aplikacje

Gdy przesyłasz do Google Ads komponenty HTML5, możesz zobaczyć komunikat o błędzie. Aby rozwiązać problem, wystarczy zwykle zmodyfikować plik i ponownie go zapisać. Następnie możesz ponownie przesłać plik.

W niektórych przypadkach możesz skorzystać z takiego narzędzia jak Walidator HTML5 Google Ads, które pozwala przetestować komponenty przed ich przesłaniem do Google Ads w celu wykrycia w nich potencjalnych problemów.

Z tego artykułu dowiesz się, co możesz zrobić, gdy podczas korzystania z komponentów HTML5 w kampaniach promujących aplikacje wystąpią konkretne problemy. Więcej informacji o reklamach HTML5 i reklamach demonstracyjnych gier w kampaniach promujących aplikacje

Problemy z przesyłaniem

Plik jest za duży

Komponenty HTML5 w wymiarach reklam pełnoekranowych (320 x 480 i 480 x 320) mogą mieć rozmiar pliku do 5,2 MB. Większe komponenty będą natychmiast odrzucane, więc musisz wtedy odpowiednio zmniejszyć ich rozmiar pliku.

Uwaga: jeśli rozmiar pliku jest bliski limitu, może to czasem powodować problemy. Spróbuj go wtedy trochę zmniejszyć.

Wymiary są niedozwolone

Obsługiwane są tylko 2 wymiary komponentów:

• 320 x 480 (orientacja pionowa),
• 480 x 320 (orientacja pozioma).

Aby rozwiązać ten problem, zmień wymiary komponentu na obsługiwane lub użyj metatagu "ad.orientation" i ustaw prawidłową wartość orientacji, w jakiej komponent ma być renderowany.

Uwaga – możesz nie używać metatagu "ad.size", tylko zamiast niego stosować nowy metatag "ad.orientation" w celu określania odpowiedniej wartości orientacji komponentu:

• "portrait" (w przypadku komponentów w orientacji pionowej);
• "landscape" (w przypadku komponentów w orientacji pionowej);
• "portrait,landscape" lub "landscape,portrait" (w przypadku w pełni elastycznych komponentów, które równie dobrze sprawdzają się w obu orientacjach).

Jeśli nadal używasz metatagu "ad.size" i podasz wymiary inne niż obsługiwane, po przesłaniu komponentu znów wyświetli się komunikat o błędzie.

Jeśli w kodzie HTML zadeklarowane są oba metatagi, zostanie użyta wartość "ad.orientation".

Jeśli nie używasz żadnych metatagów lub nieprawidłowo ustawisz wartości orientacji, komponenty nie zostaną odrzucone po przesłaniu, ale będą renderowane tylko w orientacji pionowej.

W ścieżce pliku występuje co najmniej 1 nieobsługiwany znak. Usuń wszystkie wystąpienia tego znaku lub znaków z nazwy pliku i wszystkich katalogów, a następnie spróbuj ponownie.

Nazwy plików i folderów w archiwum ZIP mogą zawierać tylko obsługiwane znaki, czyli litery, cyfry, kropki (. ), łączniki (-) i znaki podkreślenia (_). Jeśli w nazwach plików lub folderów występują nieobsługiwane znaki (m.in. spacje), może to spowodować błąd.

Aby rozwiązać ten problem, zmień nazwy plików i folderów, tak aby zawierały tylko obsługiwane znaki, a potem spróbuj ponownie przesłać komponenty.

Pliki, których dotyczy problem, będą wymienione w komunikacie o błędzie w miejscu parametru ścieżki pliku, a znaki naruszające zasady – w miejscu parametru nieprawidłowych znaków.

Uwaga: jeśli kod źródłowy odwołuje się do plików o zmienionych nazwach, musisz go zaktualizować, aby pliki były prawidłowo renderowane.

Typ pliku jest nieobsługiwany. Usuń lub zastąp ten plik i spróbuj ponownie.

Obecnie w pakietach reklam HTML5 są obsługiwane tylko te typy plików:

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

Jeśli prześlesz inne nieobsługiwane typy plików, np. MPEG lub FLA, może to spowodować błąd. Aby rozwiązać problem, usuń lub zastąp plik, a potem ponów przesyłanie.

Twoja reklama HTML5 odwołuje się do komponentu, którego nie ma w pliku ZIP. Dozwolone są tylko odwołania do plików wewnętrznych (np. „path/to/asset/in-zip.png”). Sprawdź, czy w pliku ZIP znajdują się wszystkie komponenty i czy wszystkie odwołania odnoszą się do plików wewnętrznych. Gdy wprowadzisz zmiany, spróbuj ponownie.

Gdy przesyłasz pakiet reklam HTML5, niedozwolone są odwołania do plików zewnętrznych z wyjątkiem tych:

• createjs,
• cssplugin,
• easeljs,
• easepack,
• Google Fonts,
• biblioteka CreateJS na serwerach Google,
• biblioteka Greensock na serwerach Google (pliki powinny działać niezależnie od wersji),
• biblioteka jQuery na serwerach Google,
• TimelineLite,
• timelinemax,
• tweenjs,
• TweenLite,
• tweenmax.

Aby rozwiązać ten problem, usuń z pakietu reklam HTML5 wszystkie niedozwolone odwołania do plików zewnętrznych. Po wprowadzeniu zmian ponownie spróbuj przesłać plik.

Twoja reklama HTML5 odwołuje się do komponentu, którego nie możemy znaleźć w pliku ZIP. Sprawdź, czy wszystkie komponenty znajdują się w pliku ZIP i spróbuj ponownie.

Pakiet musi zawierać wszystkie komponenty lokalne, do których odwołuje się każdy z plików. Jeśli użyjesz odwołania do ścieżki do obrazu, który nie występuje w pakiecie, plik zostanie odrzucony.

Aby rozwiązać ten problem, usuń odwołania do plików, których brak w pakiecie, lub dodaj do niego wszystkie pliki, do których występują odwołania, a potem ponownie prześlij pakiet.

W reklamie HTML5 brakuje głównego pliku HTML. Główne pliki HTML zawierają tag rozmiaru reklamy, np. „<meta name="ad.size" content="width=320,height=480">”. Dodaj do reklamy plik HTML z tagiem rozmiaru reklamy i spróbuj ponownie.

Komponent, w którym występuje ten błąd, nie zawiera w ani jednym pliku HTML w pakiecie żadnego z wymaganych parametrów metadanych, np. tagu rozmiaru reklamy: <meta name="ad.size" content="width=320 ,height=480">. Nie dotyczy to komponentów Google Web Designera.

Aby rozwiązać ten problem, upewnij się, że komponent HTML5 zawiera główny plik HTML z tagiem rozmiaru reklamy umieszczonym w sekcji <head> kodu źródłowego. Do kodu źródłowego komponentu musisz też dodać wszystkie wymagane tagi:

• deklarację <!DOCTYPE html>;
• tag <html>;
• tag <body>;
• metatag orientacji formatu reklamy w tagu <head>, np. <meta name="ad.orientation" content="portrait">.

Nieprawidłowe tagi, np. <path><path />, nie będą akceptowane.

Do spełnienia tych wymagań konieczne może być wyodrębnienie wbudowanych tagów SVG do osobnych plików.

Uwaga: chociaż trzeba podać rozmiar komponentu, musi on też być elastyczny, ponieważ będzie wyświetlany w boksach pełnoekranowych z banerem o różnej wielkości. Aby wyświetlać reklamy pełnoekranowe w orientacji poziomej, użyj parametrów "width=480,height=320".

Pakiet kreacji multimedialnych zawiera zbyt wiele plików. Liczba plików w pliku ZIP nie może przekraczać 512.

W przypadku rozmiarów reklam pełnoekranowych komponenty mogą zawierać w pakiecie kreacji multimedialnych maksymalnie 512 plików. Komponenty, które zawierają liczbę plików większą od dozwolonej, zostaną odrzucone.

Aby rozwiązać ten problem, upewnij się, że liczba plików w archiwum ZIP nie przekracza 512.

Uwaga: foldery w pakiecie kreacji multimedialnych nie zwiększają ogólnej liczby plików w pakiecie.

Nie można przetworzyć pliku ZIP, bo ten plik lub jeden z plików znajdujących się w nim jest uszkodzony. Sprawdź pliki, skompresuj je ponownie i spróbuj jeszcze raz.

Aby rozwiązać ten problem, sprawdź pliki w pakiecie, skompresuj je ponownie, aby mieć pewność, że wynikowy plik jest prawidłowym archiwum ZIP, a potem jeszcze raz spróbuj go przesłać.

Nieobsługiwana funkcja HTML5 w komponencie HTML5

Ten błąd wskazuje, że kod źródłowy w plikach należących do pakietu zawiera funkcje, których Google Ads nie obsługuje.

Aby rozwiązać ten problem, usuń z pakietu reklam HTML5 nieobsługiwane funkcje. Pomoże Ci w tym Walidator HTML5 Google Ads.

Uwaga: w sekcji „Zaawansowany test HTML5" Walidatora HTML 5 Google Ads może się pojawić taki komunikat o błędzie: UNSUPPORTED_HTML5_FEATURE: rdf:description

Jeśli problem dotyczy nieobsługiwanych tagów SVG, być może w kodzie kreacji występują tagi, które nie należą do żadnej z obsługiwanych kategorii, czyli do elementów kontenera, gradientu lub grafiki.

Aby rozwiązać ten problem, sprawdź wszystkie pliki w archiwum ZIP, odszukaj w kodzie kreacji nieobsługiwane tagi, a potem je usuń. Możesz wyświetlić listę wszystkich obsługiwanych tagów SVG. Więcej informacji o liście obsługiwanych tagów SVG i ich kategoriach

Jeśli np. otworzysz w edytorze tekstu przykładowy plik SVG z pakietu, możesz zobaczyć tag „rdf:Description”. Po usunięciu tego tagu ze wszystkich plików SVG możesz ponowne przesłać pakiet.

Plik ZIP z usługi Google Web Designer nie jest opublikowany

Jeśli rozpakujesz ręcznie skompresowane pliki źródłowe, które nadal można edytować w aplikacji Google Web Designer, nie możesz ich przesłać. Aby przesłać do Google Ads komponenty Google Web Designera, musisz je najpierw opublikować lokalnie.

Aby rozwiązać ten problem, w aplikacji Google Web Designer:

1. Kliknij Opublikuj.
2. Wybierz Opublikuj lokalnie.
3. Prześlij powstały plik ZIP do Google Ads.

Plik Google Web Designera nie jest przeznaczony do środowiska „Google Ads”

Komponenty Google Web Designera muszą mieć w metatagu „environment” podaną wartość „gwd-googleads” lub „gwd-admob” wskazującą środowisko reklamowe. Jeśli jednak środowisko reklamowe zostało określone za pomocą wartości „gwd-genericad” lub „gwd-dv360”, reklama zostanie odrzucona. Nie dotyczy to komponentów spoza Google Web Designera.

Aby rozwiązać ten problem, otwórz w aplikacji Google Web Designer plik źródłowy (nieopublikowany komponent) i zmień środowisko na „Google Ads”. Więcej informacji o wybieraniu środowiska reklamowego

Pakiet kreacji multimedialnych wymaga dynamicznego typu produktu z prawidłową branżą

Komponenty mogą zawierać w kodzie źródłowym ten wiersz bez tagu branży produktu: <meta name="productType" content="dynamic">. Ten tag jest przeznaczony do remarketingu dynamicznego w przypadku komponentów HTML5 opartych na pliku danych.

Aby rozwiązać ten problem, ręcznie usuń z kodu źródłowego wiersz <meta name="productType" content="dynamic">, ponieważ kampanie promujące aplikacje nie obsługują obecnie niestandardowych komponentów HTML5 opartych na plikach danych.

Pakiet kreacji multimedialnych jest niezgodny z obecnym typem produktu

Twój komponent może się odwoływać do tagu <meta name="productType" content="dynamic">, ale kampanie promujące aplikacje w ogóle nie obsługują dynamicznych komponentów HTML5.

Aby rozwiązać ten problem, usuń z kodu źródłowego pliku index.html fragment <meta name="productType" content="dynamic"><meta name="vertical" content="{rodzaj_treści}">.

Uwaga: w miejscu obiektu zastępczego {rodzaj_treści} mogą występować różne wartości, np. RETAIL lub CUSTOM.

Reklamy HTML5 korzystające z plików ZIP utworzonych w DoubleClick Studio nie są obsługiwane

Komponenty utworzone w Studio (dawniej „DoubleClick Studio”) są niezgodne z Google Ads. System wykrywa to, sprawdzając, czy występuje odwołanie do biblioteki JavaScriptu o nazwie „Enabler” używanej przez Studio. W przypadku niestandardowych komponentów spoza Google Web Designera biblioteka Enabler.js nie jest obsługiwana i nie można z niej korzystać.

Uwaga: pliki Google Web Designera domyślnie zawierają bibliotekę Enabler.js i jest ona w nich w pełni obsługiwana, ale nie w niestandardowych pakietach HTML5.

Aby rozwiązać ten problem, usuń z niestandardowego komponentu HTML5 odwołania do biblioteki Enabler.js.

Nieprawidłowo skonfigurowane zachowanie wyjścia z reklamy

Kreacje Google Web Designera nie obsługują skryptu ExitAPI. Aby rozwiązać ten problem, usuń wszelkie odwołania do skryptu ExitAPI i zamiast tego użyj komponentu Obszar kliknięcia, aby przypisać niestandardowy obszar klikalny.

Problemy występujące po przesłaniu pliku

Twoje komponenty HTML5 zostały odrzucone z powodu błędu „Nieprawidłowe połączenie między serwerami zewnętrznymi” lub „Niedopuszczalna reklama HTML5” albo obu naraz.

Z powodu błędu „Nieprawidłowe połączenie między serwerami zewnętrznymi” lub „Niedopuszczalna reklama HTML5” odrzucane są zwykle komponenty HTML5 z jednym z tych elementów:

• tag <video> bez atrybutu src;
• niewykryte odwołania do elementów zewnętrznych;
• Czcionki spoza Google, które znajdują się bezpośrednio w pliku i nie są wywoływane z domeny fonts.googleapis.com spowodują odrzucenie komponentów – nie dotyczy to tylko czcionek w tych formatach:
  • DFONT,
  • EOT,
  • OTF,
  • TTE,
  • TTF,
  • WOFF,
  • WOFF2.
    • Uwaga: listę wszystkich obsługiwanych czcionek możesz sprawdzić w Google Fonts.
• komponenty umieszczone w ramkach podrzędnych;
  • Poszukaj w kodzie źródłowym tagów takich jak <frameset>, <frame> lub <iframe>. Ramki umożliwiają umieszczanie w pliku HTML treści zewnętrznych, a nawet całych witryn, ale nie są one obsługiwane w komponentach HTML5.
• kreacje Google Web Designera i AMP HTML.
  • Poszukaj w kodzie źródłowym tagów, które zaczynają się od przedrostka „amp”, np. <amp-img> lub <amp-ad-exit>. Możesz też odszukać odwołania do skryptów hostowanych na stronie cdn.ampproject.org.

Dodatkowo na karcie „Sieć” w Narzędziach deweloperskich w Chrome możesz sprawdzić, czy komponent wywołuje określone połączenia między serwerami zewnętrznymi. Aby uzyskać dostęp do tych narzędzi:

1. Kliknij prawym przyciskiem myszy podgląd komponentu w Google Ads lub w Walidatorze HTML5 Google Ads.
2. W menu kontekstowym kliknij „Zbadaj”.
3. Kliknij kartę Sieć.

Aby rozwiązać ten problem, sprawdź swoje komponenty, za pomocą Walidatora HTML5 Google Ads odszukaj nieobsługiwane tagi i elementy, a potem wprowadź niezbędne zmiany. Następnie jeszcze raz spróbuj przesłać plik. Możesz się też dowiedzieć więcej o wymaganiach technicznych związanych z błędem „Niedopuszczalna reklama HTML5”.

Podgląd reklamy się nie wczytuje

Podgląd reklamy może się nie wczytać, jeśli przesłany komponent korzysta z zasobu, który jest niezgodny ze standardem Content Security Policy.

Aby rozwiązać ten problem, na karcie „Konsola” w Narzędziach deweloperskich w Chrome możesz sprawdzić, jakie informacje przekazuje przeglądarka o Twoim komponencie (np. czy przeglądarka celowo odrzuca niektóre zasoby zawarte w reklamie HTML5). Aby uzyskać dostęp do tych narzędzi:

1. Kliknij prawym przyciskiem myszy podgląd komponentu w Google Ads lub w Walidatorze HTML5 Google Ads.
2. W menu kontekstowym kliknij „Zbadaj”.
3. Kliknij kartę Konsola.

Nieprawidłowe renderowanie podglądu reklamy

Nieprawidłowe renderowanie podglądu reklamy może być spowodowane przez niektóre komponenty używające biblioteki PixiJS (lub innych bibliotek zewnętrznych), które mogą działać nieprawidłowo w trybie piaskownicy.

Aby rozwiązać ten problem, upewnij się, że Twoje komponenty HTML5 są dostosowane do współpracy z elementem iframe działającym w trybie piaskownicy, który ma ustawioną tylko flagę „allow-scripts”.

Uwaga: reklamy HTML5 działają w trybie piaskownicy bez atrybutu „allow-same-origin”, dlatego, aby można było używać obrazów w obszarze roboczym, należy je wczytywać z użyciem ustawienia crossorigin="anonymous".

Nie można kliknąć komponentu w podglądzie

Usługa podglądu reklam powinna blokować przechodzenie na strony docelowe elementów klikalnych. Oznacza to, że możesz wchodzić w interakcje z komponentem, ale nie możesz po kliknięciu go przejść pod jego końcowy adres URL.

Aby rozwiązać ten problem, klikalność komponentu możesz sprawdzić po przesłaniu go do Walidatora HTML5 Google Ads.

Komponent HTML5 się nie wyświetla

Jeśli komponent HTML5 w ogóle się nie wyświetla (0 wyświetleń), dowiedz się w Centrum pomocy, jak rozwiązać problem z kampaniami Google Ads promującymi aplikacje, które są nieaktywne lub generują mało ruchu.

Wysoki współczynnik klikalności (CTR) i niski współczynnik konwersji (CVR)

Jednym z możliwych rozwiązań tego problemu jest ręczne umieszczenie skryptu ExitAPI w tagu <script> w sekcji <head> zamiast dodawania go za pomocą innego kodu JavaScriptu. Jeśli tego nie zrobisz, kreacje wyświetlające się na żywo będzie można klikać na całym obszarze reklamy, co może doprowadzić do dużej liczby niezamierzonych kliknięć i obniżyć skuteczność kampanii.