說明
登入

疑難排解 Checkout Blocks 內容

由於多種原因，您的 Checkout Blocks 內容可能無法如預期顯示，導致部分元素消失或無法正常運作。常見原因包括未符合顯示規則、權限設定錯誤，或是區塊本身的設定與其在結帳與帳號編輯器中的新增方式不一致。

本指南協助您自行疑難排解並解決常見的 Checkout Blocks 問題。若您依本指南步驟操作後仍有問題，請 contact Shopify Support 以取得協助。

本頁內容

疑難排解區塊

區塊是用來在結帳流程中顯示內容的自訂元素，例如自訂欄位、動態內容與橫幅。若某個區塊未如預期運作，請依下列各節找出並解決問題。

區塊未在結帳中顯示

疑難排解：未將區塊新增至編輯器

在 Checkout Blocks app 中建立方塊並不會自動將其加入您的結帳流程。您需要使用 checkout and accounts editor，將該方塊加入您的結帳設定。

步驟：

  1. 從您的 Shopify 管理介面，前往 設定 > Checkout。
  • 在組態區段中，按一下要修改的組態旁的自訂。
  • 切換到您要顯示該區塊的結帳頁面。
  • 按一下⊕ 新增區塊，並選取適當的區塊類型。
  • 將區塊 ID設為與您在 Checkout Blocks 中建立之區塊的 ID 相同。
  • 按一下儲存。
    • 疑難排解：區塊未設為啟用

    區塊必須設為啟用，才能在結帳流程中顯示。草稿區塊不會對顧客顯示。

    步驟：

    1. 從您的 Shopify 管理介面，前往 App > Checkout Blocks。
  • 按一下區塊。
  • 按一下您要啟用的區塊。
  • 在狀態區段中，選取啟用。
  • 按一下儲存。
    • 疑難排解：區塊未發佈至市場或頁面

    如果您的區塊設定為發佈至特定市場，則只會在您選取的市場中顯示。若該區塊僅發佈至特定結帳頁面，則不會在其他頁面顯示。

    步驟：

    1. 從您的 Shopify 管理介面，前往 App > Checkout Blocks。
  • 按一下區塊。
  • 按一下您要檢視的區塊。
  • 在發佈區段中，確認該區塊已發佈至所有適用的市場。
  • 在結帳頁面區段中，確認該區塊已設為在所有適用的結帳頁面顯示。
  • 按一下儲存。
    • 疑難排解：未符合顯示規則

    Display rules 會定義方塊在結帳時顯示所需符合的條件。若顧客的結帳工作階段未符合這些條件，該方塊就不會顯示。

    步驟：

    1. 從您的 Shopify 管理介面，前往 App > Checkout Blocks。
  • 按一下區塊。
  • 按一下未顯示的區塊。
  • 檢視該區塊設定的顯示規則。
  • 確認您的測試結帳是否符合所有必要條件，例如購物車金額門檻、產品類型或顧客登入狀態。
  • 如果您設定僅在以下情況顯示：所有規則皆通過，請確認每個規則都已符合。若設定為僅在以下情況顯示：任一規則通過，請確認至少符合其中一項規則。
    • 疑難排解：區塊 ID 不相符

    結帳與帳號編輯器中的每種區塊類型都有一個區塊 ID設定。編輯器中的區塊 ID 必須與您在 Checkout Blocks app 中建立的區塊 ID 相同。若 ID 不相符，將不會顯示該區塊。

    例如，若您的區塊在 Checkout Blocks app 中的區塊 ID 為 4，則結帳與帳號編輯器中的區塊也必須將其區塊 ID 設為 4。

    步驟：

    1. 從您的 Shopify 管理介面，前往 App > Checkout Blocks。
  • 按一下區塊。
  • 按一下未顯示的區塊，並記下其區塊 ID。
  • 前往 設定 > Checkout。
  • 在組態區段中，按一下要檢查的組態旁的自訂。
  • 在編輯器中按一下應顯示您內容的區塊。
  • 在區塊設定中，確認區塊 ID與步驟 3 的 ID 相符。
  • 若 ID 不相符，請更新區塊 ID 使其相符。
  • 按一下儲存。
    • 疑難排解：預覽區塊 ID 欄位有值

    結帳與帳號編輯器中的預覽區塊 ID（僅供測試）欄位僅供測試用途。若在儲存結帳後此欄位仍有值，可能會覆寫區塊的顯示規則，導致行為異常。

    步驟：

    1. 從您的 Shopify 管理介面，前往 設定 > Checkout。
  • 在組態區段中，按一下要檢查的組態旁的自訂。
  • 按一下未正確顯示的區塊。
  • 在預覽區塊 ID（僅供測試）欄位中，清除任何值，讓欄位保持空白。
  • 按一下儲存。
    • 疑難排解：改由優先順序較高的區塊顯示

    如果您有多個相同類型的方塊，其顯示規則互相重疊，就只會顯示優先順序最高的方塊。瞭解詳情：block priority。

    步驟：

    1. 從您的 Shopify 管理介面，前往 App > Checkout Blocks。
  • 按一下區塊。
  • 點選⇅ 編輯優先順序。
  • 選取未顯示的區塊類型。
  • 檢視優先順序。數字越小，優先順序越高。
  • 調整優先順序數字，以變更先顯示的區塊。
  • 按一下儲存。
    • 疑難排解已達作用中區塊上限

    Checkout Blocks 每種區塊類型最多支援 30 個作用中區塊。若某一類型的作用中區塊超過 30 個，例如有 35 個作用中的自訂欄位區塊，則結帳頁面僅會顯示前 30 個區塊。

    步驟：

    1. 從您的 Shopify 管理介面，前往 App > Checkout Blocks。
  • 按一下區塊。
  • 依您正在疑難排解的區塊類型來篩選。
  • 計算作用中區塊的數量。
  • 如果作用中區塊超過 30 個，請停用或刪除不再需要的區塊。

    • 區塊在結帳頁面重複顯示

    疑難排解新增到共用區段的區塊

    區塊在結帳與帳號編輯器內的新增位置不同，可能會在結帳流程的每個步驟顯示。訂單摘要區段與附加在繼續或返回按鈕旁的區域，在所有結帳頁面皆相同。

    若只想在特定步驟顯示區塊，請將該區塊新增到該步驟的主內容區域。

    步驟：

    1. 從您的 Shopify 管理介面，前往 設定 > Checkout。
  • 在組態區段中，點選您要變更的組態旁的自訂。
  • 點選重複顯示的區塊。
  • 留意該區塊所在的區段。若位於訂單摘要，或附加在繼續或返回按鈕旁，則此區塊會在每個結帳頁面顯示。
  • 若只要在特定頁面顯示，請從目前區段移除該區塊，並將其新增到目標結帳頁面的主內容區域。
  • 按一下儲存。
    • 疑難排解重複新增的區塊

    部分區塊類型（例如品項編輯區塊）通常只需要在結帳中新增一次。此類區塊會依據顯示規則，於不同情境顯示不同內容。若區塊內容出現重複，您可能是不小心將該區塊新增多次。

    步驟：

    1. 從您的 Shopify 管理介面，前往 設定 > Checkout。
  • 在組態區段中，按一下要檢查的組態旁的自訂。
  • 逐頁瀏覽您的結帳流程，檢視已新增的區塊。
  • 如果發現具有相同類型與區塊 ID 的重複區塊，請點選該區塊，然後選取移除區塊以刪除多餘的區塊。
  • 按一下儲存。

    • 建立或儲存區塊時發生錯誤的疑難排解

    若您在嘗試建立或儲存區塊時收到錯誤，請參閱下列章節。

    疑難排解「您的表單送出時發生一些問題」錯誤

    此錯誤通常表示您的員工帳號缺少在 Checkout Blocks 中建立區塊所需的權限。

    必要權限：

    • 商店權限 > 內容：員工必須擁有對 metaobject 定義的檢視與建立與編輯權限，以及對項目的檢視與建立與編輯權限。
    • 商店權限 > 商店設定：員工必須具備管理設定權限。
    • app 權限：員工至少必須擁有 Checkout Blocks 的權限。

    步驟：

    1. 從您的 Shopify 管理介面，前往 Users and permissions。
    2. 點選發生錯誤的員工帳號。
    3. 在商店權限下，展開內容區段。
    4. 確認metaobject 定義已選取檢視與建立與編輯權限。
    5. 確認項目已選取檢視與建立與編輯權限。
    6. 在商店設定下，確認已選取管理設定。
    7. 在app 權限下，確認已選取Checkout Blocks。
    8. 按一下儲存。

    如果您沒有權限修改員工權限，請聯絡商店擁有人或擁有使用者管理權限的員工。

    自訂折扣的疑難排解

    在 Checkout Blocks 中建立的自訂折扣可能因多種因素而無法如預期套用。

    疑難排解已達作用中自動折扣上限

    Shopify 最多同時允許 25 個作用中的自動折扣，包含所有已安裝 app 所提供的折扣。此限制適用於整個商店，而非僅限 Checkout Blocks。

    若您嘗試啟用第 26 個自動折扣，結帳頁面將不會套用該折扣。

    步驟：

    1. 從您的 Shopify 管理介面，前往 Discounts。
    2. 篩選僅顯示自動折扣。
    3. 計算目前作用中的自動折扣數量。
    4. 如果已經有 25 個以上的作用中自動折扣，請先停用或刪除不需要的折扣，再啟用新的折扣。

    瞭解詳情：limitations when combining discounts。

    疑難排解折扣未啟用

    自訂折扣必須設為啟用，才會在結帳頁面套用。此外，折扣的開始與結束日期也不得已過期。

    步驟：

    1. 從您的 Shopify 管理介面，前往 App > Checkout Blocks。
  • 點選折扣。
  • 點選未套用的折扣。
  • 在狀態區段中，確認折扣已設為啟用。
  • 在啟用日期區段中，確認目前日期在已設定的開始與結束日期之內。
  • 按一下儲存。
    • 疑難排解未符合折扣規則

    Checkout Blocks 中的自訂折扣可以設定詳細的條件規則，用以決定何時套用折扣。若顧客在結帳工作階段未符合這些條件，則不會套用折扣。

    步驟：

    1. 從您的 Shopify 管理介面，前往 App > Checkout Blocks。
  • 點選折扣。
  • 點選未套用的折扣。
  • 檢視該折扣所設定的規則與條件。
  • 確認您的測試結帳是否符合所有必要條件，例如最低訂單價值、特定商品或商品系列，或顧客資格條件。
  • 視需要調整折扣規則。
  • 按一下儲存。

    • 疑難排解配送與付款方式自訂

    若配送或付款方式未如預期被隱藏、重新命名或重新排序，請檢閱以下各節。

    排解自訂未啟用問題

    配送或付款方式自訂必須設為啟用，才能在結帳頁面中生效。

    步驟：

    1. 從您的 Shopify 管理介面，前往 App > Checkout Blocks。
  • 按一下 Functions。
  • 按一下無法正常運作的自訂項目。
  • 在 狀態 區段中，確認該自訂項目設為 啟用。
  • 按一下儲存。
    • 達到啟用功能上限的疑難排解

    Shopify Functions 針對每種類型的可用功能數量設有上限。每個商店最多可啟用 25 個付款自訂功能。若超過此上限，您可能會看到以下錯誤：Failed to enable customization. Please try again or contact support.

    這些上限有助於確保結帳維持高成效。您需要合併或移除自訂項目，以維持在上限之內。

    步驟：

    1. 從您的 Shopify 管理介面，前往 App > Checkout Blocks。
  • 按一下 Functions。
  • 請計算您有多少個啟用中的配送方式自訂 (若您正在排解配送問題)，或有多少個啟用中的付款方式自訂 (若您正在排解付款問題)。
  • 若已達該類型的上限，停用或刪除不再需要的自訂項目。
  • 再嘗試啟用新的自訂項目。
    • 未符合自訂規則的疑難排解

    配送與付款方式自訂會依據規則來決定何時套用。若顧客的結帳工作階段未符合這些條件，自訂就不會生效。

    步驟：

    1. 從您的 Shopify 管理介面，前往 App > Checkout Blocks。
  • 按一下 Functions。
  • 按一下無法正常運作的自訂項目。
  • 檢閱該自訂項目的規則設定。
  • 確認您的測試結帳是否符合所有必要條件。
  • 視需要調整規則。
  • 按一下儲存。

    • 使用測試結帳驗證變更

    在正式環境使用 Checkout Blocks 的自訂之前，您應先使用測試結帳確認其運作如預期。

    步驟：

    1. 在您的網路商店中，將符合您要測試之區塊、折扣或自訂條件的商品加入購物車。
    2. 進行結帳，但不要完成購買。
    3. 檢閱結帳的各步驟並確認以下事項：
      • 區塊在正確位置顯示正確內容。
      • 符合資格條件時，會套用自訂折扣。
      • 配送與付款方式自訂如預期運作。
    4. 若您測試的是依購物車總額設定的顯示規則，請嘗試不同的購物車金額，以確認區塊會在正確門檻出現與消失。
    5. 若您測試的是以顧客為基礎的顯示規則，請同時測試已登入與訪客結帳情境。

    常見問題

    同時可以啟用多少個區塊？

    每種區塊類型最多可啟用 30 個區塊。例如，您可同時啟用 30 個自訂欄位、30 個動態內容區塊，以及 30 個商品項目編輯區塊。您可以建立超過 30 個同類型的區塊，但在結帳頁面中僅會顯示前 30 個啟用中的區塊。

    使用 Checkout Blocks 為何需要特定的員工權限？

    Checkout Blocks 會建立 metaobject definitions 以儲存方塊設定。員工必須具備建立與編輯 metaobject 定義及項目的權限，才能在 app 中儲存方塊。此外，員工還需要在 商店設定 中具備 管理設定，以及 Checkout Blocks 的明確 App 權限。

    未使用 Shopify Plus 方案也能使用 Checkout Blocks 嗎？

    採用 Basic 方案或以上的商家，只能在其感謝頁面與訂單狀態頁面使用 dynamic content 與 static content 方塊。其餘 Checkout Blocks 功能 (包含自訂欄位、自訂折扣，以及配送/付款方式自訂) 則須使用 Shopify Plus 方案。

    我該如何知道要使用哪個區塊 ID？

    在 Checkout Blocks app 中建立方塊時，系統會指派一個方塊 ID (預設值為 0)。當您在編輯器中將該方塊類型加入結帳流程時，需要設定相同的方塊 ID，讓編輯器知道要顯示哪一個特定方塊。若您想在不同位置顯示同一類型的不同方塊，請為每個方塊指定唯一的方塊 ID，並在編輯器中對應這些 ID。瞭解詳情：Block IDs。

    Checkout Blocks 的折扣可以與其他折扣併用嗎？

    在 Checkout Blocks 中建立的自訂折扣屬於由 Shopify Functions 驅動的自動折扣，其遵循與其他自動折扣相同的 discount combination rules。全店最多可有 25 個啟用中的自動折扣，包含由 Checkout Blocks 與其他 app 建立的折扣。

    在就 Checkout Blocks 聯絡 Shopify 支援服務之前

    如果您已嘗試上述疑難排解步驟，但 Checkout Blocks 的問題仍然存在，則可 contact Shopify Support 以取得協助。聯絡 Shopify 支援服務 之前，請先蒐集以下與 Checkout Blocks 相關的資訊，以加速問題處理：

    • 區塊詳情：無法運作的區塊名稱、類型 (例如自訂欄位、動態內容或商品項目編輯)，以及該區塊的區塊 ID
    • 設定螢幕截圖：Checkout Blocks app 中該區塊設定的截圖，包括任何顯示規則、發布設定與狀態
    • 編輯器螢幕截圖：該區塊在結帳與帳戶編輯器中的設定截圖，包括區塊 ID 與預覽區塊 ID 欄位
    • 錯誤訊息：建立、儲存或預覽區塊時收到的任何錯誤訊息之截圖，或其完整文字內容
    • 測試結帳 URL：可重現問題的測試結帳或未完成結帳作業連結，以及用來觸發顯示規則的購物車內容
    • 預期行為與實際行為：清楚描述您在結帳中預期會發生的情況，以及實際發生的情況
    • 已完成的排解步驟：您已檢閱本指南哪些章節，以及已嘗試的做法
    • 員工權限：確認您的帳戶具備下列所需權限：內容 (metaobject 定義與項目)、商店設定 (管理設定)、以及應用程式權限 (Checkout Blocks)

    先準備好這些與 Checkout Blocks 相關的資訊，有助於 Shopify 支援服務更有效率地診斷並解決您的問題。