解决应用广告系列的 HTML5 素材资源问题

当您在 Google Ads 中上传 HTML5 素材资源时，可能会收到错误消息。在大多数情况下，只要修改文件并重新保存即可解决问题。然后，您就可以再次尝试上传文件。

在某些情况下，您可以使用 Google Ads 的 HTML5 验证工具等工具来解决问题。借助该验证工具，可以在将素材资源上传到 Google Ads 之前先对它们进行测试，看看是否存在潜在问题。

本文将帮助您应对在应用广告系列中使用 HTML5 素材资源时可能遇到的具体问题。详细了解应用广告系列的 HTML5/试玩广告

上传方面的问题

文件过大

对于插页式广告尺寸（320x480 和 480x320），HTML5 素材资源的文件不得超过 5.2 MB。超出此大小的素材资源将立即被拒绝，因此请根据需要缩减素材资源的文件大小。

注意：如果文件接近此大小上限，有时也可能会造成问题。这种情况下，稍微缩减文件大小也应该有助于解决问题。

不支持这些尺寸

仅支持以下 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 文件外部的素材资源。仅允许引用内部文件（例如“path/to/asset/in-zip.png”）。请确保您已在 .ZIP 文件中添加了所有素材资源，并且引用的所有文件均是内部素材资源。完成更改之后，请重试。

上传 HTML5 广告的文件包时，不允许引用外部文件，但以下情况除外：

若要解决此问题，请确保 HTML5 广告的文件包中不再引用所有不允许引用的外部文件。完成更改之后，请尝试重新上传。

您的 HTML5 广告尝试引用 .ZIP 文件中找不到的素材资源。请确保您已在 .ZIP 文件中添加了所有素材资源，然后重试。

所有文件中引用的所有本地素材资源都需要存在于文件包中。如果您引用的图片路径在文件包中不存在，此文件将被拒绝。
若要解决此问题，请务必移除对文件包中不存在的文件的引用，或将引用的文件添加到文件包中，然后重新上传。

您的 HTML5 广告缺少 .HTML 主文件。.HTML 主文件包含一个广告尺寸标记，例如 <meta name="ad.size" content="width=320,height=480">。请确保您的 HTML5 广告中包含带有广告尺寸标记的 .HTML 文件，然后重试。

显示此错误的素材资源在文件包内的任何 .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 Ads 不支持的一些功能。
若要解决此问题，请从 HTML5 广告的文件包中移除不受支持的功能。Google Ads 的 HTML5 验证工具应该可以为您提供这方面的帮助。
注意：在 Google Ads 的 HTML5 验证工具的“Advanced HTML5 check”（高级 HTML5 检查）部分，您可能会看到以下错误消息：UNSUPPORTED_HTML5_FEATURE: rdf:description

如果问题与不受支持的 .SVG 标记有关，说明您的广告素材代码中可能存在未包含在任一受支持类别（例如容器元素、渐变元素和图形元素）中的标记。

若要解决此问题，请检查存储在 .ZIP 文件中的所有文件，然后在广告素材代码中搜索不受支持的标记，并将其删除。您可以查看所有受支持的 .SVG 标记列表。详细了解受支持的 .SVG 标记列表及其类别

例如，在文本编辑器中打开文件包中的示例 .SVG 文件时，可能会显示“rdf:Description”标记。从所有 .SVG 文件中移除此标记后，就可以上传文件包了。

来自 Google Web Designer 的 ZIP 文件未发布

您无法上传手动压缩的源文件，这些文件在解压缩后仍可在 Google Web Designer 中编辑。Google Web Designer 素材资源必须先在本地发布，然后才能上传到 Google Ads。
若要解决此问题，请在 Google Web Designer 中执行以下操作：
  1. 点击发布。
  2. 选择本地发布。
  3. 将生成的 .ZIP 文件上传到 Google Ads。

Google Web Designer 不支持“Google Ads”环境

对于 Google Web Designer 素材资源，必须在“environment”元标记中将“gwd-googleads”或“gwd-admob”指定为广告环境。但是，如果广告环境是“gwd-genericad”或“gwd-dv360”，广告将被拒登。这并不适用于非 Google Web Designer 素材资源。
若要解决此问题，请在 Google Web Designer 中打开源文件（而非已发布的素材资源），并将环境更改为“Google Ads”。了解如何选择广告环境

媒体包需要使用行业信息正确的动态产品类型

您的素材资源可能会在源代码中包含以下行，而不包含产品行业标记：<meta name="productType" content="dynamic">。此标记是为基于 Feed 的 HTML5 素材资源的动态再营销而定义的。
若要解决此问题，请从源代码中手动移除 <meta name="productType" content="dynamic"> 行，因为应用广告系列目前不支持基于 Feed 的自定义 HTML5 素材资源。

此媒体包与当前产品类型不兼容

您的素材资源可能引用了 <meta name="productType" content="dynamic"> 标记，但应用广告系列通常不支持动态 HTML5 素材资源。
若要解决此问题，请从 index.html 文件的源代码中移除 <meta name="productType" content="dynamic"><meta name="vertical" content="{content_type}">。
注意：{content_type} 占位符中的值可能有所不同，例如 RETAIL、CUSTOM 等。

使用 DoubleClick Studio 中创建的 ZIP 文件的 HTML5 广告不受支持

一般来说，在 Studio（之前称为“DoubleClick Studio”）中创建的素材资源与 Google Ads 不兼容。系统通过检查是否存在名为“Enabler”的 Studio 专用 JS 库引用来确定这一点。对于自定义的非 Google Web Designer 素材资源，Enabler.js 库不受支持，也无法使用。
注意：默认情况下，Google Web Designer 文件包含 Enabler.js 库，并且完全支持该库，但在自定义的 HTML5 文件包中就并非如此。

若要解决此问题，请从自定义 HTML5 素材资源中移除对 Enabler.js 库的引用。

广告退出行为的配置不恰当

Google Web Designer 广告素材不支持 ExitAPI。若要解决此问题，请移除对 ExitAPI 的所有引用，并改用“点按区域”组件来分配自定义可点击区域。

上传之后的问题

您的 HTML5 素材资源因“第四方调用无效”和/或“不可接受的 HTML5 广告”而被拒登。

包含以下某个元素的 HTML5 素材资源可能会因“第四方调用无效”或“不可接受的 HTML5 广告”而被拒登：
  • 不含 src 属性的 <video> 标记
  • 未检测到外部引用
  • 直接嵌入到文件中但未从 fonts.googleapis.com 网域引用的非 Google 字体会导致拒登，下列格式的字体除外：
    • .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 或 Google Ads HTML5 验证工具中右键点击素材资源预览。
  2. 从上下文菜单中选择“检查”。
  3. 点击网络标签页。

若要解决此问题，请检查您的素材资源，通过 Google Ads HTML5 验证工具查找不受支持的元素和标记，并进行必要的修改。然后，尝试重新上传。您还可以详细了解“不可接受的 HTML5 广告”的技术要求。

广告预览无法加载

如果您上传的素材资源使用违反内容安全政策的资源，广告预览可能不会加载。
若要解决此问题，您可以通过 Chrome 开发者工具中的“控制台”标签页检查浏览器将传达素材资源的哪些信息（浏览器是否有意拒绝 HTML5 广告中的某些资源）。若要使用此功能，请执行以下操作：
  1. 在 Google Ads 或 Google Ads HTML5 验证工具中右键点击素材资源预览。
  2. 从上下文菜单中选择“检查”。
  3. 点击控制台标签页。

广告预览无法正确呈现

广告预览无法正确呈现可能是由使用 PixiJS 库（或其他外部库）的某些素材资源导致的，这些素材资源可能无法在沙盒中正常运行。
若要解决此问题，请确保您的 HTML5 素材资源可以在仅带有“allow-scripts”标志的沙盒化 iframe 中使用。
注意：由于 HTML5 广告是在没有 allow-same-origin 的情况下进行沙盒化，因此图片必须通过 crossorigin="anonymous" 加载才能在画布中使用。

素材资源在预览中不可点击

广告预览服务可能会阻止导航元素的可点击性，也就是说，您应该能够与素材资源互动，但不能通过点击素材资源进入最终到达网址。
若要解决此问题，您可以在将素材资源上传到 Google Ads HTML5 验证工具后测试可点击性。

HTML5 素材资源未投放

如果您的 HTML5 素材资源完全没有投放（展示次数为零），您可以参阅这篇帮助中心文章，了解如何解决 Google Ads 应用广告系列未能投放或流量较低的问题。

点击率 (CTR) 较高，但转化率 (CVR) 较低

若要解决此问题，一种可行的方法是必须将 ExitAPI 脚本作为字面量 <script> 标记添加到 <head> 中，而不能通过其他 JavaScript 添加。否则，正在投放的广告素材将在整个广告区域中完全可点击，这可能会导致大量意外点击，并导致效果不佳。

该内容对您有帮助吗？

您有什么改进建议？

需要更多帮助？

请尝试以下步骤：

向帮助社区发帖 向社区成员寻求答案
与我们联系 向我们提供更多信息，以便我们帮您解决问题
true
Achieve your advertising goals today!

Attend our Performance Max Masterclass, a livestream workshop session bringing together industry and Google ads PMax experts.

Register now

搜索
清除搜索内容
关闭搜索框
主菜单
450984774297856151
true
搜索支持中心
true
true
true
true
true
73067
false
false
false