修正上傳 HTML5 廣告時出現的錯誤訊息

先前自動轉換為 HTML5 格式的 Flash 廣告以及其他所有 Flash 廣告,不久之後都將停止放送。我們曾在 2016 年宣佈,Google Ads 多媒體廣告聯播網廣告只會以 HTML5 格式放送,而本次異動就是我們後續所做的調整。

請更新您的 Flash 廣告,確保廣告可繼續放送。

在 Google Ads 中上傳廣告素材時,您可能會收到錯誤訊息。不過在多數情況下,您只要修改並重新儲存檔案就能修正問題,之後只要重新上傳檔案就行了。

請使用 Google Ads HTML5 驗證工具檢查廣告。

本文將解說上傳廣告素材時可能發生哪些錯誤訊息,並協助您採取因應措施。若要瞭解詳細規定,請參閱「圖像廣告」政策頁面的內容。

HTML5 廣告

不支援使用 Swiffy 工具建立的 HTML5 廣告,請改為上傳原始 Flash 檔案。

如需將 Flash 廣告轉換為 HTML5 格式,請直接把 Flash 檔案上傳至 Google Ads;要是您使用 Swiffy 轉換工具,系統會拒絕您的廣告。另外,您也可以使用 Google Web Designer 等工具重新製作廣告。進一步瞭解如何將 Flash 廣告轉換為 HTML5 廣告。

此廣告包含不支援的檔案類型。為解決這個問題,請移除所有不受支援的檔案類型。

如想確認 .ZIP 壓縮檔是否包含不受支援的檔案類型,請按照下列步驟操作:

  1. 對 .ZIP 檔案按兩下滑鼠,將檔案開啟。
  2. 查看畫面上出現的資料夾,確定每一個檔案都是受支援的類型 (可支援類型包括 .CSS、.JS、.HTML、.GIF、.PNG、.JPEG 和 .SVG)。如果發現任何不支援的檔案類型,請移除該檔案。
  3. 選取資料夾中所有的檔案,然後依序點選 [檔案] > [壓縮項目],即可儲存修改過的檔案。
  4. 如果無法順利壓縮資料夾,問題可能出在您壓縮了整個資料夾;壓縮時請務必選取資料夾中的各個項目,不要直接選取整個資料夾。
您的廣告太大,請上傳小於 150KB 的廣告。
請注意,ZIP 壓縮檔內所有檔案的大小都不應超過 150KB。若要查看檔案大小,請先選取檔案,然後視所用的電腦而定,依序點選 [檔案] > [查看資訊] 或 [檔案] > [內容],畫面上就會出現彈出式方塊,其中顯示檔案大小 (以 KB 為單位)。
在您上傳的廣告中,有一些檔案路徑或檔案名稱含有不支援的字元 (支援的字元為:字母、數字、英文句號 (.)、連字號 (-) 和底線 (_)。

如想確認 .ZIP 壓縮檔中是否有檔案名稱包含不支援的字元,請按照下列步驟操作:

  1. 對 .ZIP 檔案按兩下滑鼠,將檔案開啟。
  2. 查看畫面上出現的資料夾,確定每個檔名都只使用以下支援字元:字母、數字、英文句號 (.)、連字號 (-) 和底線 (_)。如果檔名包含不支援的字元,請重新命名檔案。若 .ZIP 檔案內含子資料夾,請務必一併開啟並檢查其中的檔案。
  3. 選取資料夾中所有的檔案,然後依序點選 [檔案] > [壓縮項目],即可儲存修改過的檔案。
  4. 如果無法順利壓縮資料夾,問題可能出在您壓縮了整個資料夾;壓縮時請務必選取資料夾中的各個項目,不要直接選取整個資料夾。
您上傳的廣告包含違反 Google Ads 政策的 HTML5 程式碼。

為解決這個問題,您必須在廣告素材程式碼中找出上述不受支援的代碼。請務必檢查 .ZIP 壓縮檔中存放的所有檔案,並將有問題的檔案刪除。

不受支援的 .SVG 代碼經常導致這個問題。如有這個情況,請在廣告素材程式碼中找出不屬於受支援類別 (容器元素、漸層元素和圖形元素) 的代碼。進一步瞭解各種可支援代碼所對應的類別。

您的 HTML5 廣告缺少主要 .HTML 檔案。請確定您的 HTML5 廣告包含附帶廣告大小代碼的 HTML 檔案,然後再試一次。廣告大小代碼看起來應該像這樣:<meta name=”ad.size” content=”width=300,height=250”>

主要 .HTML 檔案應包含廣告大小代碼,例如 <meta name=”ad.size” content=”width=300,height=250”>

  1. 開啟您的 .HTML 檔案,然後找出廣告大小中繼代碼。找到後,請確認這個代碼包含在 <head> 代碼中,且 <head> 陳述式以 </head> 結尾。
  2. 手動替換英文半形引號,因為複製/貼上的引號不符合 Google Ads 規定,很可能導致錯誤。
  3. 您透過 DoubleClick Studio 或 Swiffy 工具上傳檔案時,也可能出現這個錯誤訊息,這是因為 Google Ads 不接受這類檔案,所以無法上傳。DoubleClick 的檔案應照常透過 3PAS 投放,而 Swiffy Flash 檔案則應以 Flash (而非轉換後的 HTML5) 的形式上傳。
在 .ZIP 壓縮檔中找不到您 HTML5 廣告嘗試參照的素材資源。

請確認 .ZIP 壓縮檔中所有檔案的檔名,都與參照檔案中所列的名稱完全相同。

舉例來說,假設您的 .ZIP 檔案包含「path/to/example/asset」這個檔案,但您在 HTML 檔案中參照的卻是「path/to/example/asset2」,這時 Google Ads 就無法找到正確檔案。

為解決這個問題,請比對上述檔名和 HTML5 程式碼中的所有檔案;如果發現不一致,請更正參照檔案的名稱。

在 .ZIP 檔案中找不到您 HTML5 廣告嘗試參照的素材資源。請確定您的 .ZIP 檔案只參照了內部素材資源。

您只能參照已上傳的 .ZIP 檔案中所包含的檔案,但上述素材資源不包含在這個 .ZIP 檔案中。您必須在 HTML 檔案中移除所有對 .ZIP 檔案外素材資源的參照,才能進行後續步驟。

錯誤訊息中列出的素材資源不包含在您的 .ZIP 檔案中,您也必須一併移除所有對該檔案的參照。唯一允許的外部參照如下:

  • Google Fonts
  • Google 代管的 jQuery
無法處理此 .ZIP 檔案,因為檔案本身或內含檔案毀損。

為修復 .ZIP 檔案內含的毀損檔案,請按照下列步驟操作:

  1. 對 .ZIP 檔案按兩下滑鼠,將檔案開啟。
  2. 到畫面上出現的資料夾中開啟每一個檔案,然後再次儲存。
  3. 選取資料夾中所有的檔案,然後依序點選 [檔案] > [壓縮項目],即可儲存修改過的檔案。
  4. 如果無法順利壓縮資料夾,問題可能出在您壓縮了整個資料夾;壓縮時請務必選取資料夾中的各個項目,不要直接選取整個資料夾。
您的 HTML5 廣告在「可點擊」屬性方面有所變更,系統不支援這項功能。
我們不支援以下功能:在以 Google Web Designer 建立的 HTML5 廣告中使用輕按區域,以及在以其他工具建立的廣告中使用 JavaScript Exitapi.exit()。
如果您的 HTML5 廣告是以 Google Web Designer 建立,請刪除輕按區域元件。
上述變更並不會影響使用 Google Web Designer (GWD) 製作的動態再行銷廣告,因此您不必為這些廣告移除輕觸區域並重新上傳。
如果您是透過其他工具建立 HTML5 廣告,請將 index.html 檔案中 <head> 部分的 ExitApi 指令碼移除。
  • <script src="https://tpc.googlesyndication.com/pagead/gadgets/html5/api/exitapi.js"></script>

移除這個指令碼代碼後,整個廣告都會變成可點擊。您可以保留該按鈕,但點擊廣告任何部分都會將使用者導向到達網頁。

從您的 index.html 檔案中移除會呼叫 ExitAPI.exit 的 onclick 事件。

  • 例如:<button onclick="ExitApi.exit()">

AMP HTML 廣告

HTML 文件遭到標準 AMP 驗證工具拒絕。
快訊訊息 您的 HTML 檔案並非有效的 AMP HTML 廣告文件,請您先以 AMP 驗證工具檢查。
解決方法 請使用可公開取得的 AMP 驗證工具,確保 AMP HTML 廣告通過驗證。
最佳做法 在上傳 HTML 文件之前使用 AMP 驗證工具。
驗證廣告組合時發生嚴重的內部錯誤。
快訊訊息 發生內部錯誤。如果錯誤持續發生,請與支援小組聯絡以測試廣告組合。我們會儘快調查這個問題。
解決方法 不適用
Google Ads 不支援自訂 AMP 元素。

例如:系統不支援 <amp-audio> 這類 AMP 自訂元素。

快訊訊息 不支援 <$name> 這個 AMP 自訂元素。
解決方法 移除不支援的 AMP 元素,以及這些元素從 HTML 匯入的 JavaScript。
例如:
來自 <body> 區段的 <amp-audio width=”400” height=”300” src=”audios/myaudio.mp3”></amp-audio>,以及
來自 <head> 區段的 <script async custom-element=”amp-audio” src=”https://cdn.ampproject.org/v0/amp-audio-0.1.js”></script>
最佳做法 只使用支援的 AMP 元素。
Google Ads 不支援自訂的 AMP 元素。

例如:匯入的內容包含 <amp-audio> 這個系統不支援的 AMP 自訂元素。

快訊訊息 匯入的內容包含 <$name> 這個系統不支援的 AMP 自訂元素。
解決方法 移除不支援的 AMP 元素,以及這些元素從 HTML 匯入的 JavaScript。
例如:
來自 <body> 區段的 <amp-audio width=”400” height=”300” src=”audios/myaudio.mp3”></amp-audio>,以及
來自 <head> 區段的 <script async custom-element=”amp-audio” src=”https://cdn.ampproject.org/v0/amp-audio-0.1.js”></script>
最佳做法 只使用支援的 AMP 元素。
媒體組合包含的媒體素材資源中有一個預留的素材資源路徑。

例如:禁止的素材資源路徑:_a4a/invalid

快訊訊息 禁止的素材資源路徑:$assetPath
解決方法 重新命名路徑。
最佳做法 避免讓素材資源路徑使用「_a4a」這類預留的目錄名稱。
在 amp 自訂樣式區塊中發現剖析錯誤。

例如:CSS 剖析錯誤:「... .foo:nth-child(1n) { color: red } …」。

快訊訊息 CSS 剖析錯誤示例:「... .foo:nth-child(1n) { color: red } …」。
解決方法 修正附加 CSS 程式碼片段中的錯誤。多數時候這些錯誤都和 CSS 虛擬選擇器有關,目前的 Google Ads 服務並不支援這類選擇器,請將其從 amp 自訂樣式區塊移除。
屬性中包含無效的值。

例如:「amp-ing」代碼中的「srcset」屬性包含無效的值「a b c」。

快訊訊息 $tagName」代碼中的「$attrName」屬性包含「$value」這個無效值。
解決方法 這通常是指屬性值格式錯誤。例如「on」屬性可能含有格式錯誤的事件活動。請參閱目前的「AMP HTML 規格」,並查看正確的值格式。
屬性中包含禁用值。

例如:「div」代碼中的「class」屬性包含「amp-carousel-slide」這個禁用值。

快訊訊息 $tagName」代碼中的「$attrName」屬性包含「$value」這個禁用值。
解決方法 檢查屬性,確保當中沒有任何預留值。元素類別不應包含「amp-carousel-button」這類預留的類別名稱。同樣的,「AMP」也不能做為事件動作的目標。
最佳做法 製作廣告前,您可以先參閱 Google Ads AMP HTML 廣告規格中的禁用值清單。
缺少設定項目。

例如:「amp-ad-exit」代碼設定中的「exit1」缺少「finalURL」。

快訊訊息 $tagName」代碼設定中的「$item」缺少「$value」。
解決方法 <amp-ad-exit><amp-animation> 這類 AMP 元素需要 JSON 設定。請參考對應的 AMP 元素規格,使用有效的設定格式。
設定項目包含無效值。

例如:「amp-ad-exist」代碼設定中的「selector」含有無效值。

快訊訊息 $tagName」代碼設定中的「$item」含有無效的「$value」。
解決方法 <amp-ad-exit><amp-animation> 這類 AMP 元素需要 JSON 設定。請參考對應的 AMP 元素規格,使用有效的設定格式。
Google Ads 不支援設定項目。

例如:「amp-ad-exit」設定不支援「Filters」代碼。

快訊訊息 $tagName」代碼設定不支援「$item」。
解決方法 Google Ads 不支援設定項目,請將其從設定中移除。
AMP 文件中有些只能出現一次的元素/值多次出現。

例如:「amp-ad-exit」多次出現。

快訊訊息 找到多個「$item」。
解決方法 將多餘的元素從文件中移除,只保留一個例項即可。
不支援 AMP HTML 廣告組合中的自訂離開事件。

例如:您的 AMP HTML 廣告修改了可點擊屬性「tap:exit-api.exit(target=’product1’)」,系統目前不支援此功能。

快訊訊息 您的 AMP HTML 廣告修改了可點擊屬性「$exit」,系統目前不支援此功能。
解決方法 移除 <amp-ad-exit> 設定以及來自 HTML 的 JavaScript 匯入項目。移除會叫用 exit-api.exit 的事件動作 (例如 <button on=”tap:exit-api.exit(target=’product1’)”>)
廣告包含多個 HTML 檔案。
快訊訊息 廣告包含多個進入點,請確定您的 HTML5 廣告只包含一個附有廣告大小代碼的 .HTML 檔案,然後再試一次。
解決方法 請確定 .zip 檔案中只有一個 HTML 檔案會顯示廣告內容,並移除多餘的 HTML 檔案。
CSS 規則包含禁用的屬性值。

例如:「.amp-carousel-button」選擇器不允許使用「width:100%」這個 CSS 屬性值。

快訊訊息 $cssSelector」選擇器不允許使用「$cssPropertyName:$cssPropertyValue」這個 CSS 屬性值。
解決方法 將訊息中指出的 CSS 屬性值從 amp 自訂樣式區塊移除。

Google Web Designer HTML5

注意:如要在 Google Web Designer 中製作 AMP HTML 橫幅廣告,第一步請依照「新增檔案」對話方塊中的指示操作,按一下 [AMP HTML 橫幅] 即可開始製作廣告。Google Web Designer 對於 AMP HTML 廣告設有一些特定功能限制。如需詳細資訊,請參閱「AMP HTML 廣告」這篇文章。
您必須上傳已發佈的檔案。檔案必須先在 Google Web Designer 中發佈,才能上傳到 Google Ads。
上傳廣告時,您必須上傳已發佈的檔案,而不是您建立的原始檔案。請先到 Google Web Designer 中開啟您建立的原始檔案,然後依序點選 [發佈] > [在本機端發佈] 來上傳廣告。瞭解詳情
這則廣告是在「一般」而非「Google Ads」環境中製作而成。若要繼續,請在 Google Web Designer 中將檔案轉為「Google Ads」環境。
您製作廣告時選取了錯誤的環境,因此廣告是在「一般」而非「Google Ads」環境中製作而成。請先將檔案轉為「Google Ads」環境,以進行後續步驟。進一步瞭解環境轉換。
您上傳的廣告包含違反 Google Ads 政策的 HTML5 程式碼。請先移除所有對上述代碼的參照,再上傳廣告。

您的廣告違反其中一項 Google Ads 政策,詳情請見原始錯誤訊息中所列的問題。

上傳廣告前,您必須先移除所有不受支援的功能;只要開啟 .ZIP 壓縮檔中的 index.html 檔案,然後到「gwd-admetadata」部分找出不受支援的功能就行了。

  • 展開式廣告:找出「creativeProperties」。minWidth 必須等於 maxWidth,minHeight 則應該等於 maxHeight。
  • 計數器或計時器:找出「counters」或「timers」。這些陣列必須是空白的。
  • 多個離開事件
  • 影片
  • 地圖
  • 到這裡查看受支援功能的完整清單。
在 .ZIP 檔案中找不到您 HTML5 廣告嘗試參照的素材資源。請確定您的 .ZIP 檔案只參照了內部素材資源。

在 Google Web Designer 中,您必須加入圖片來代表圖片按鈕的各種視覺狀態。

請參考下列範例 index.html 檔案的程式碼片段,其中的粗體文字就是缺少的向上圖片 (up-image)、覆蓋圖片 (over-image) 和向下圖片 (down-image)。

<gwd-imagebutton id="gwd-imagebutton_1" up-image="" over-image="" down-image="" scaling="cover" class="gwd-imagebutton-tcf2"></gwd-imagebutton>

進一步瞭解圖片按鈕元件。

為解決這個問題,請將 placeholder.png 替換成您要使用的圖片,並確定該圖片包含在 .ZIP 檔案中。

注意:錯誤訊息通常會說明您缺少哪些圖片。不過,訊息有時候會指出您缺少了 "",這可能是因為您並未指明圖片位置。為解決這個問題,請開啟您的 .ZIP 壓縮檔並找出 index.html 檔案,然後在當中搜尋「' =""」來揪出錯誤。

 

若要進一步瞭解本文所談到的問題,請參閱這個 SME 建議培訓
 

 

這篇文章實用嗎?
我們應如何改進呢?