פתרון בעיות בנכסי HTML5 בקמפיינים לקידום אפליקציות

כשמעלים נכסי HTML5 ל-Google Ads, לפעמים מוצגת הודעת שגיאה. ברוב המקרים, שינוי של הקובץ ושמירה שלו מחדש יפתרו את הבעיה. אחרי ששומרים את הקובץ מחדש, אפשר לנסות להעלות אותו שוב.

במצבים מסוימים, ניתן להשתמש בכלי כמו HTML5 validator ב-Google Ads, שמאפשר לכם לבדוק את הנכסים לפני שאתם מעלים אותם ל-Google Ads ולאתר אם יש בעיות פוטנציאליות.

במאמר הזה מפורטות בעיות ספציפיות שעשויות להופיע בזמן עבודה עם נכסי HTML5 בקמפיינים לקידום אפליקציות ומוסבר מה צריך לעשות כדי לטפל בהן. מידע נוסף על מודעות HTML5/מודעות התנסות באפליקציה לקמפיינים לקידום אפליקציות

בעיות בהעלאה

הקובץ גדול מדי

גודל קובץ של נכסי HTML5 במידות של מודעות מעברון (320x480 ו-480x320) יכול להיות עד 5.2MB. נכסים גדולים יותר יידחו באופן מיידי, לכן יש להקטין את גודל הקובץ של הנכס לפי הצורך.

הערה: לפעמים קובץ שקרוב למגבלת הגודל עלול לגרום לבעיות. הקטנת גודל הקובץ אמורה לעזור.

המידות אסורות

יש תמיכה רק ב-2 מידות של נכסים:

• 320x480 (לאורך)
• 480x320 (לרוחב)

כדי לתקן את הבעיה, יש לשנות את מידות הנכס למידות הנתמכות או להשתמש במטא תג "ad.orientation" ולהגדיר את ערך הכיוון הנכון שלפיו יש לעבד את הנכס.

הערה: אתם יכולים להחליט לא להשתמש במטא תג "ad.size" ובמקום זאת להשתמש במטא תג החדש "ad.orientation" כדי להגדיר את ערך הכיוון הרצוי של הנכס:

• “portrait” (לנכסים בפורמט אנכי)
• "landscape” (לנכסים בפורמט אופקי)
• “portrait,landscape” או “landscape,portrait” (לנכסים רספונסיביים באופן מלא לשני הכיוונים)

אם אתם עדיין משתמשים במטא תג "ad.size" ומספקים מידות שאינן נתמכות, הודעת השגיאה עדיין תוצג כשתעלו את הנכס.

אם תהיה הכרזה על שני המטא תגים ב-HTML, ייעשה שימוש בערך של "ad.orientation".

אם אתם לא משתמשים במטא תגים או אם הגדרתם את ערכי הכיוון באופן שגוי, הנכסים לא יידחו בזמן ההעלאה, אבל הם יוצגו רק בפריסה לאורך.

הקובץ נמצא בנתיב שכולל תו אחד או יותר שאנחנו לא תומכים בהם. יש להסיר את כל המופעים של התווים האלה משם הקובץ ומכל הספריות. לאחר מכן יש לנסות שוב.

שמות של תיקיות וקבצים בקובץ ה-ZIP יכולים לכלול רק תווים נתמכים כמו אותיות, מספרים, נקודות ( . ), מקפים (-) וקווים תחתונים (_). אם תשתמשו בשמות של התיקיות והקבצים בתווים אחרים שאינם נתמכים (כולל רווחים), יכולה להתרחש שגיאה.

כדי לפתור את הבעיה, יש לשנות את השמות של התיקיות והקבצים תוך שימוש בתווים נתמכים, ולהסיר את כל המופעים של תווים שאינם נתמכים משם הקובץ ומכל הספריות. לאחר מכן יש לנסות שוב.

הקבצים הרלוונטיים יפורטו בהודעת השגיאה היכן שמצוין הפרמטר של נתיב הקובץ, והתווים שאינם נתמכים יפורטו היכן שמצוין הפרמטר של התווים הלא חוקיים.

הערה: אם בקוד המקור יש הפניה לקבצים ששיניתם את שמם, תצטרכו לעדכן את השמות כדי שהם יעובדו באופן נכון.

הקובץ הוא מסוג לא נתמך. צריך להסיר את הקובץ הזה או להחליף אותו ואז לנסות שוב.

נכון לעכשיו, אלה סוגי הקבצים הנתמכים בחבילות מודעות HTML5:

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

אם תעלו קבצים מסוגים אחרים שאינם נתמכים כמו ‎.MPEG או ‎.FLA, יכולה להתרחש שגיאה. כדי לפתור את הבעיה, עליכם להסיר או להחליף את סוג הקובץ ולאחר מכן להעלות אותו שוב.

מודעת ה-HTML5 מנסה להפנות לנכס חיצוני שאינו כלול בקובץ ה-ZIP. אנחנו מתירים הפניות רק לקבצים שכלולים בקובץ ה-ZIP (למשל, "‎path/to/asset/in-zip.png"). צריך להקפיד לכלול את כל הנכסים בקובץ ה-ZIP ולוודא שכל ההפניות לקבצים הן פנימיות. לאחר שיבוצעו השינויים הדרושים, ניתן לנסות שוב.

כשמעלים חבילת מודעות HTML5, אסור להשתמש בהפניות לקבצים חיצוניים, למעט במקרים הבאים:

• createjs
• cssplugin
• easeljs
• easepack
• Google Fonts
• CreateJS שמתארח ב-Google
• Greensock שמתארח ב-Google (קבצים מכל הגרסאות אמורים לעבוד)
• jQuery שמתארח ב-Google
• timelinelite
• timelinemax
• tweenjs
• tweenlite
• tweenmax

כדי לפתור את הבעיה, עליכם להסיר את כל ההפניות החיצוניות שאינן נתמכות מחבילת מודעות HTML5. לאחר ביצוע השינויים, יש לנסות להעלות מחדש.

מודעת ה-HTML5 שלך מנסה להפנות לנכס שלא ניתן היה למצוא בקובץ ה-ZIP. עליך לבדוק שכללת את כל הנכסים בקובץ ה-ZIP ואז לנסות שוב.

כל הנכסים המקומיים שמתבצעת אליהם הפניה בקבצים צריכים להיכלל בחבילה. אם אתם מפנים לנתיב של תמונה שלא נמצאת בחבילה, הקובץ יידחה.

כדי לפתור את הבעיה, יש להסיר את ההפניות לקבצים שלא קיימים בחבילה או להוסיף את הקבצים לחבילה ולאחר מכן להעלות מחדש.

במודעת ה-HTML5 חסר קובץ ‎HTML ראשי. קובצי HTML ראשיים כוללים תג 'גודל מודעה', כמו ‎<meta name="ad.size" content="width=320,height=480">‎. עליך לוודא שיש קובץ HTML עם תג גודל מודעה במודעת ה-HTML5. לאחר מכן יש לנסות שוב.

הנכס שמציג את השגיאה הזו לא מכיל אחד מהפרמטרים הנדרשים של המטא-נתונים באף אחד מקובצי ה-HTML בחבילה, כמו תג גודל המודעה: ‎<meta name="ad.size" content="width=320 ,height=480">‎. הבעיה לא רלוונטית לנכסי Google Web Designer.

כדי לתקן את הבעיה, יש לוודא שבנכס ה-HTML5 יש קובץ HTML ראשי עם תג גודל מודעה שכלול בקטע <head> בקוד המקור. בנוסף, צריך להוסיף את כל התגים הנדרשים לקוד המקור של הנכס:

• הצהרת <‎!DOCTYPE html>
• תג <html>
• תג <body>
• מטא תג לציון הכיוון של פורמט המודעה בתוך התג <head>. לדוגמה: <meta name="ad.orientation" content="portrait">

לא יתקבלו תגים לא חוקיים כמו ‎<path><path />‎.

כדי לעמוד בדרישות האלה, ייתכן שיהיה עליכם לחלץ תגי ‎.SVG מוטבעים אל קבצים נפרדים.

הערה: למרות שיש לציין את הגודל, הנכס חייב להיות גם רספונסיבי, מפני שהוא יוצג במשבצות מעברון עם מודעת באנר שהגודל שלה עשוי להשתנות. כדי להציג מודעות מעברון לרוחב, יש להשתמש בפורמט "width=480,height=320".

חבילת המדיה כוללת יותר מדי קבצים. יש לוודא שמספר הקבצים בקובץ ה-ZIP הוא עד 512.

עבור גדלים של מודעות מעברון, הנכסים שלכם יכולים לכלול עד 512 קבצים בתוך חבילת המדיה. נכסים שמספר הקבצים שלהם גדול מהמספר המותר יידחו.

כדי לפתור את הבעיה, צריך לוודא שמספר הקבצים בקובץ ה-ZIP הוא עד 512.

הערה: התיקיות בתוך חבילת המדיה לא מגדילות את המספר הכולל של הקבצים בתוך החבילה.

לא ניתן לעבד את קובץ ה-ZIP כי הקובץ עצמו, או אחד מהקבצים שנכללים בו, פגום. יש לבדוק את הקבצים, לדחוס אותם פעם נוספת ולנסות שוב.

כדי לפתור את הבעיה, צריך לבדוק את הקבצים בחבילה, לדחוס אותה פעם נוספת כדי לוודא שהקובץ שנוצר הוא קובץ ארכיון ZIP ולאחר מכן לנסות להעלות אותו מחדש.

תכונת HTML לא נתמכת בנכס HTML5

משמעות השגיאה הזו היא שבקוד המקור של הקבצים בחבילה יש תכונות שלא נתמכות על ידי Google Ads.

כדי לפתור את הבעיה, יש להסיר את התכונות שאינן נתמכות מחבילת מודעות ה-HTML5. אתם יכולים להיעזר בכלי HTML5 Validator של Google Ads.

הערה: בקטע 'בדיקת HTML5 מתקדמת' בכלי HTML5 Validator של Google Ads, עשויה להופיע הודעת השגיאה הבאה: UNSUPPORTED_HTML5_FEATURE: rdf:description

אם הבעיה היא בתגי ‎.SVG שאינם נתמכים, יכול להיות שיש בקוד הקריאייטיב תגים שאינם נכללים באחת מהקטגוריות הנתמכות, כמו אלמנטים של מאגר, אלמנטים של גרדיאנט ואלמנטים של גרפיקה.

כדי לפתור את הבעיה, עליכם לבדוק את כל הקבצים בקובץ ה-ZIP ולחפש תגים שאינם נתמכים בקוד הקריאייטיב. לאחר מכן יש למחוק אותם. אפשר להציג את הרשימה של כל תגי ה-‎.SVG הנתמכים. מידע נוסף על רשימת תגי ‎.SVG הנתמכים והקטגוריות שלהם

למשל, כשקובץ ‎.SVG לדוגמה בתוך החבילה נפתח בכלי לעריכת טקסט, התג "rdf:Description" עשוי להופיע. לאחר ההסרה של התג הזה מכל קובצי ה-‎.SVG, אפשר יהיה להעלות את החבילה.

קובץ ZIP מ-Google Web Designer לא פורסם

אי אפשר להעלות באופן ידני קובצי מקור דחוסים שעדיין ניתן לערוך אותם ב-Google Web Designer לאחר ביטול הדחיסה שלהם. כדי שניתן יהיה להעלות אותם ל-Google Ads, תחילה צריך לפרסם את הנכסים של Google Web Designer באופן מקומי.

כדי לפתור את הבעיה ב-Google Web Designer:

1. לוחצים על פרסום.
2. בוחרים באפשרות Publish Locally ('פרסום באופן מקומי').
3. מעלים את קובץ ה-ZIP. ל-Google Ads.

Google Web Designer לא נוצר לסביבת 'Google Ads'

עבור נכסי Google Web Designer יש לציין את הערך "gwd-googleads" או "gwd-admob" בתור סביבת המודעה במטא תג “environment”. עם זאת, אם סביבת המודעה היא "gwd-genericad" או "gwd-dv360", המודעה תידחה. הבעיה לא רלוונטית לנכסים שאינם של Google Web Designer.

כדי לתקן את הבעיה, יש לפתוח את קובץ המקור (ולא את הנכס שפורסם) ב-Google Web Designer ולשנות את הסביבה ל-'Google Ads'. כך בוחרים את סביבת המודעה

סוג מוצר דינמי עם הקטגוריה הנכונה נדרש על-ידי חבילת המדיה

הנכסים שלכם יכולים לכלול את השורה הבאה בקוד המקור בלי להכיל את התג של קטגוריית המוצר: ‎<meta name="productType" content="Dynamic">‎. התג הזה מוגדר לרימרקטינג דינמי בנכסי HTML5 שמבוססים על פידים.

כדי לפתור את הבעיה, יש להסיר באופן ידני את השורה ‎<meta name="productType" content="Dynamic">‎ מקוד המקור, כי קמפיינים לקידום אפליקציות לא תומכים כרגע בנכסי HTML5 מותאמים אישית שמבוססים על פידים.

חבילת המדיה לא תואמת לסוג המוצר הנוכחי

ייתכן שהנכס שלכם מפנה לתג ‎<meta name="productType" content="Dynamic">‎, אבל נכסי HTML5 דינמיים אינם נתמכים בקמפיינים לקידום אפליקציות.

כדי לפתור את הבעיה, יש להסיר את ‎<meta name="productType" content="Dynamic"><meta name="vertical" content="{content_type}">‎ מקוד המקור של הקובץ index.html.

הערה: ייתכן שב-placeholder‏ {content_type} יהיו ערכים שונים, כמו RETAIL‏, CUSTOM ועוד.

אין תמיכה במודעות HTML5 עם קובצי ZIP שנוצרו באמצעות DoubleClick Studio

באופן כללי, נכסים שנוצרים ב-Studio (לשעבר DoubleClick Studio) לא תואמים ל-Google Ads. המערכת קובעת זאת על ידי בדיקה אם יש הפניה לספריית JS ספציפית ל-Studio שנקראת 'Enabler'. עבור נכסים מותאמים אישית שאינם של Google Web Designer, הספרייה Enabler.js לא נתמכת ולא ניתן להשתמש בה.

הערה: קובצי Google Web Designer מכילים את ספריית Enabler.js כברירת מחדל, והיא נתמכת בהם באופן מלא, אבל לא בחבילות HTML5 בהתאמה אישית.

כדי לפתור את הבעיה, אתם צריכים להסיר את ההפניות לספרייה Enabler.js מנכס HTML5 שלכם בהתאמה אישית.

התנהגות היציאה של המודעה מוגדרת בצורה שגויה

לא ניתן להשתמש ב-ExitAPI בנכסי קריאייטיב של Google Web Designer. כדי לפתור את הבעיה, צריך להסיר את כל ההפניות אל ExitAPI ולהשתמש ברכיב אזור ההקשה על מנת להקצות במקום זאת את האזור הקליקבילי בהתאמה אישית.

בעיות לאחר ההעלאה

נכסי ה-HTML5 נדחו בגלל 'קריאה לא חוקית מצד רביעי', 'מודעת HTML5 לא קבילה' או בגלל שתי הסיבות.

נכסי HTML5 עם אחד מהאלמנטים הבאים צפויים להידחות עקב 'קריאה לא חוקית מצד רביעי' או 'מודעת HTML5 לא קבילה':

• תג <video> ללא מאפיין src
• הפניות חיצוניות שלא זוהו
• גופנים שאינם של Google שמוטמעים ישירות בקובץ ואין אליהם הפניה מהדומיין fonts.googleapis.com יגרמו לדחיה, למעט הגופנים בפורמטים הבאים:
  • ‎.dfont
  • ‎.eot
  • ‎.otf
  • ‎.tte
  • ‎.ttf
  • ‎.woff
  • ‎.woff2
    • הערה: אפשר לבדוק את רשימת הגופנים הנתמכים ב-Google Fonts.
• נכסים שמוטמעים במסגרות צאצא
  • יש לחפש תגים כמו <frameset>‏, <frame> או <iframe> בקוד המקור. המסגרות מאפשרות להטמיע תוכן חיצוני ואפילו אתרים שלמים בקובץ HTML, אבל הן לא נתמכות בנכסי HTML5.
• קריאייטיבים של Google Web Designer ו-AMPHTML
  • יש לחפש תגים שמתחילים בקידומת 'amp', למשל <amp-img> או <amp-ad-exit> בקוד המקור. ייתכן שתמצאו גם הפניות לסקריפטים שמתארחים באתר cdn.ampproject.org.

בנוסף, אפשר לבדוק אם הנכס מבצע קריאות מסוימות מצד רביעי באמצעות הכרטיסייה 'רשת' בכלים למפתחים ב-Chrome. לשם כך:

1. לוחצים לחיצה ימנית על התצוגה המקדימה של הנכס ב-Google Ads או בכלי HTML5 Validator של Google Ads.
2. בוחרים באפשרות 'בדיקה' מתפריט ההקשר.
3. לוחצים על הכרטיסייה רשתות.

כדי לתקן את הבעיה, יש לבדוק את הנכסים ולחפש אלמנטים ותגים שאינם נתמכים באמצעות הכלי HTML5 validator של Google Ads ולבצע את השינויים הנדרשים. לאחר מכן, נסו להעלות שוב. אפשר גם לקרוא מידע נוסף על הדרישות הטכניות בנוגע ל'מודעת HTML5 לא קבילה'.

התצוגה המקדימה של המודעה לא נטענת

לא ניתן לטעון תצוגה מקדימה של מודעה אם הנכס שהעליתם משתמש במשאב שמפר את Content Security Policy.

כדי לפתור את הבעיה, תוכלו לבדוק איזה מידע הדפדפן מעביר לגבי הנכס שלכם (האם הדפדפן דוחה בכוונה חלק מהמשאבים במודעת ה-HTML5) בכרטיסייה 'מסוף' בכלים למפתחים ב-Chrome. לשם כך:

1. לוחצים לחיצה ימנית על התצוגה המקדימה של הנכס ב-Google Ads או בכלי HTML5 Validator של Google Ads.
2. בוחרים באפשרות 'בדיקה' מתפריט ההקשר.
3. לוחצים על הכרטיסייה מסוף.

עיבוד התצוגה המקדימה של המודעה שגוי

עיבודים שגויים של תצוגה מקדימה של מודעות עשויים להיגרם מנכסים מסוימים שמשתמשים בספריית PixiJS (או בספריות חיצוניות אחרות), שייתכן שהן לא פועלות כראוי ב-Sandbox.

כדי לתקן את הבעיה, יש לוודא שנכסי ה-HTML5 מותאמים לעבודה ב-iframe שמריצים בארגז החול (sandboxing) רק עם הסימון 'allow-scripts'.

הערה: מאחר שמריצים מודעות HTML5 בארגז חול בלי האפשרות allow-same-origin, יש לטעון תמונות עם crossorigin="anonymous"‎ כדי להשתמש בהן באזור העריכה.

הנכס לא קליקבילי בתצוגה המקדימה

צפוי ששירות התצוגה המקדימה של המודעות יחסום קליקביליות לניווט. המשמעות היא שתוכלו לבצע פעולות בנכס, אבל לא ללחוץ על הנכס ולעבור לכתובת ה-URL הסופית.

כדי לפתור את הבעיה, תוכלו לבדוק את הקליקביליות כשאתם מעלים את הנכס לHTML5 Validator של Google Ads.

נכס HTML5 לא מוצג

אם נכס HTML5 שלכם לא מוצג בכלל (אפס חשיפות), כדאי לעיין במאמר הזה במרכז העזרה כדי לבדוק איך לפתור בעיות בקמפיינים לקידום אפליקציות ב-Google Ads שלא פועלים או שנפח התנועה שלהם נמוך.

שיעור קליקים (CTR) גבוה עם שיעור המרה (CVR) נמוך

אחד הפתרונות האפשריים לבעיה הוא שיש לכלול את הסקריפט ExitAPI כתג <script> ליטרלי ב-<head> ולא להוסיף אותו דרך JavaScript אחר. אחרת, הקריאייטיבים שיוצגו בזמן אמת יהיו קליקביליים בכל שטח המודעה, מה שעלול להוביל למספר גדול של קליקים לא מכוונים ולהוביל לביצועים נמוכים.