حلّ المشاكل المتعلّقة بمواد عرض HTML5 في "حملات التطبيقات"

عند تحميل مواد عرض HTML5 في "إعلانات Google"، قد تتلقّى رسالة خطأ. في معظم الحالات، يمكن حلّ المشكلة عن طريق إدخال تغييرات على الملف وحفظه مرة أخرى. ويمكنك بعد ذلك محاولة تحميل الملف.

في بعض الحالات، يمكنك استخدام أداة مثل أداة التحقّق من توافق HTML5 في "إعلانات Google"، التي تسمح لك باختبار مواد العرض قبل تحميلها إلى "إعلانات Google" والبحث عن أي مشاكل محتملة.

ستساعدك هذه المقالة على معالجة مشاكل معيّنة قد تظهر لك أثناء التعامل مع مواد عرض HTML5 في "حملات التطبيقات". اطّلِع على مزيد من المعلومات عن إعلانات HTML5/إعلانات تشغيل إصدار بسيط من اللعبة في "حملات التطبيقات".

مشاكل التحميل

حجم الملف كبير جدًا

يمكن أن يصل حجم ملفات مواد عرض HTML5 في أبعاد الإعلانات البينية (320 × 480 و480 × 320) إلى 5.2 ميغابايت. سيتم رفض مواد العرض الأكبر حجمًا على الفور. لذا عليك تصغير حجم ملف مادة العرض حسب الحاجة.

ملاحظة: إذا كان حجم الملف قريبًا من الحد الأقصى المسموح به للحجم، يمكن أن يتسبب ذلك في بعض المشاكل. من المفيد أيضًا تصغير حجم الملف قليلاً.

غير مسموح بالأبعاد

هناك بُعدان متوافقَان فقط لمواد العرض:

• 320 × 480 (اتجاه عمودي)
• 480 × 320 (اتجاه أفقي)

لحلّ هذه المشكلة، عليك تغيير أبعاد مادة العرض إلى الأبعاد المتوافقة أو استخدام العلامة الوصفية "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. يُسمح فقط بالإشارات إلى الملفات الداخلية (مثل "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 مناسب، ثم محاولة إعادة التحميل.

ميزة HTML5 غير متوافقة في مادة عرض HTML5

يشير هذا الخطأ إلى أنّ رمز مصدر الملفات ضمن الحِزمة يحتوي على بعض الميزات التي لا تتوافق مع "إعلانات Google".

لحلّ هذه المشكلة، عليك إزالة الميزات غير المتوافقة من حِزمة إعلانات HTML5. من المفترض أن تحصل على مساعدة في هذا الشأن من أداة التحقّق من توافق HTML5 في "إعلانات Google".

ملاحظة: في قسم "فحص HTML5 المتقدّم" ضمن أداة التحقّق من توافق HTML5 في "إعلانات Google"، قد تظهر لك رسالة الخطأ التالية: UNSUPPORTED_HTML5_FEATURE: rdf:description.

إذا كانت المشكلة تتعلّق بعلامات SVG. غير المتوافقة، قد تكون هناك علامات في رمز تصميم إعلانك لم يتم تضمينها في إحدى الفئات المتوافقة، مثل عناصر الحاوية وعناصر التدرّج وعناصر الرسومات.

لحلّ هذه المشكلة، تحقَّق من جميع الملفات المخزَّنة في ملف ZIP. وابحث عن العلامات غير المتوافقة في رمز تصميم إعلانك، ثم احذفها. يمكنك الاطّلاع على قائمة بجميع علامات SVG. المتوافقة. اطّلِع على مزيد من المعلومات عن قائمة علامات SVG. المتوافقة وفئاتها.

على سبيل المثال، عندما يتم فتح نموذج لملف SVG. ضمن الحِزمة في محرِّر نصوص، يمكن أن تظهر العلامة "“rdf:Description". وعند إزالة هذه العلامة من جميع ملفات SVG.، يمكن أن يتم تحميل الحِزمة في هذه الحالة.

لم يتم نشر ملف ZIP من Google Web Designer

لا يمكنك تحميل ملفات المصدر المضغوطة يدويًا، التي لا تزال قابلة للتعديل في Google Web Designer، بعد فكّ ضغطها. ويجب أن يتم نشر مواد العرض التي تتبع Google Web Designer محليًا قبل أن تصبح مؤهَّلة للتحميل إلى "إعلانات Google".

لحلّ هذه المشكلة، في Google Web Designer:

1. انقر على نشر.
2. اختر النشر محليًا.
3. حمِّل ملف ZIP. الناتج إلى "إعلانات Google".

لم يتم إنشاء Google Web Designer لبيئة "إعلانات Google"

يجب أن تحتوي مواد العرض التي تتبع Google Web Designer على "gwd-googleads" أو "gwd-admob" كبيئة الإعلان في العلامة الوصفية "environment". لكن إذا كانت بيئة الإعلان هي "gwd-genericad" أو "gwd-dv360"، سيتم عندئذٍ رفض الإعلان. ولا ينطبق ذلك على مواد العرض التي لا تتبع Google Web Designer.

لحلّ هذه المشكلة، افتح ملف المصدر (وليس مادة العرض المنشورة) في Google Web Designer وغيِّر البيئة إلى "إعلانات Google". تعرَّف على كيفية اختيار بيئة الإعلان.

تتطلّب حِزمة الوسائط نوع المنتج الديناميكي مع المجال الصحيح

قد تحتوي مواد العرض على السطر التالي في رمز المصدر بدون تضمين علامة مجال المنتج: <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.

ملاحظة: يمكن أن تكون هناك قيم مختلفة في العنصر النائب {content_type} مثل RETAIL وCUSTOM وغيرهما.

لا يتم السماح بإعلانات HTML5 التي تستخدِم ملفات ZIP المُنشأة في DoubleClick Studio

بوجهٍ عام، فإنّ مواد العرض المُنشأة في أداة محترَف (المعروفة سابقًا باسم DoubleClick Studio) غير متوافقة مع "إعلانات Google". ويحدِّد النظام هذا من خلال البحث عن توفّر إشارة مكتبة JS المتعلقة بأداة "محترَف" والتي تحمل اسم "أداة التفعيل". وبالنسبة إلى مواد العرض المخصّصة التي لا تتبع 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" أو "أداة التحقّق من توافق HTML5" في "إعلانات Google".
2. انقر على "فحص" من قائمة السياقات.
3. انقر على علامة التبويب الشبكة.

لحلّ هذه المشكلة، راجِع مواد العرض، وابحث عن العناصر والعلامات غير المتوافقة باستخدام أداة التحقّق من توافق HTML5 في "إعلانات Google"، ثم أدخِل التعديلات اللازمة. وبعد ذلك، حاوِل تحميل مواد العرض مرة أخرى. يمكنك أيضًا الاطّلاع على مزيد من المعلومات عن المتطلبات الفنية "لإعلان HTML5 غير المقبول".

لا يتم تحميل معاينة الإعلان

من غير المتوقّع أن يتم تحميل معاينة الإعلان إذا كانت مادة العرض المحمَّلة تستخدِم موردًا يخالف "سياسة أمان المحتوى".

لحلّ هذه المشكلة، يمكنك التحقّق مما يُرسله المتصفّح بشأن مادة العرض (ما إذا كان المتصفّح يرفض بعض الموارد عن قصد في إعلان HTML5) من خلال علامة التبويب "وحدة التحكّم" في "أدوات مطوّري برامج Chrome". وللوصول إلى هذه الميزة:

1. انقر بزر الماوس الأيمن على معاينة مادة العرض في "إعلانات Google" أو "أداة التحقّق من توافق HTML5" في "إعلانات Google".
2. انقر على "فحص" من قائمة السياقات.
3. انقر على علامة التبويب وحدة التحكم.

يتم عرض معاينة الإعلان بشكلٍ غير سليم

قد تحدث أخطاء في عرض معاينات الإعلانات بسبب مواد عرض معيّنة تستخدِم مكتبة PixiJS (أو مكتبات خارجية أخرى)، ما قد يؤدي إلى عدم عملها بشكلٍ سليم في وضع الحماية.

لحلّ هذه المشكلة، تأكّد من إنشاء مواد عرض HTML5 لتعمل في إطار iframe مشمول بوضع الحماية مع استخدام علامة "allow-scripts" فقط.

ملاحظة: نظرًا لأنّ إعلانات HTML5 تكون مشمولة بوضع الحماية بدون استخدام allow-same-origin، فإنّه يجب تحميل الصور مع crossorigin="anonymous" حتى يتم استخدامها في لوحة.

مادة العرض غير قابلة للنقر في المعاينة

من المتوقّع أن تحظر خدمة "معاينة الإعلان" إمكانية النقر للتنقّل، ما يعني أنّك من المفترض أن تتمكّن من التفاعل مع مادة العرض، ولكن ليس النقر للخروج من مادة العرض والانتقال إلى عنوان URL النهائي.

لحلّ هذه المشكلة، يمكنك اختبار إمكانية النقر عندما تحمِّل مادة العرض إلى أداة التحقّق من توافق HTML5 في "إعلانات Google".

مادة عرض HTML5 لا تظهر

إذا كانت مادة عرض HTML5 لا تظهر على الإطلاق (لم تسجِّل أي مرّات ظهور)، يمكنك الرجوع إلى هذه المقالة في مركز المساعدة للتعرّف على كيفية إصلاح "حملات التطبيقات" على "إعلانات Google" التي لا تعرِض إعلانات أو التي تسجِّل عددًا منخفضًا من الزيارات.

ارتفاع نسبة النقر إلى الظهور مع انخفاض معدّل الإحالات الناجحة

إنّ أحد الحلول الممكنة التي قد تؤدي إلى معالجة المشكلة هي ضرورة تضمين نص ExitAPI البرمجي كعلامة <script> ذات قيمة ثابتة في <head> وعدم إضافته من خلال مقتطف JavaScript آخر. وبخلاف ذلك، ستكون تصميمات الإعلانات التي يتم عرضها مباشرةً قابلة للنقر بالكامل على المنطقة الكاملة من الإعلان، ما قد يتسبب في عدد كبير من النقرات غير المقصودة ويؤدي بدوره إلى ضعف الأداء.