도움말
로그인

Checkout Blocks 콘텐츠 문제 해결

Checkout Blocks의 콘텐츠는 다양한 이유로 예상대로 표시되지 않을 수 있으며, 그 결과 요소가 사라지거나 제대로 작동하지 않을 수 있습니다. 일반적인 문제로는 표시 규칙 미충족, 권한 구성 오류, 블록 자체의 설정과 체크아웃 및 계정 편집기에 블록이 추가된 방식 간의 불일치 등이 있습니다.

이 가이드는 일반적인 Checkout Blocks 문제를 직접 해결하는 데 도움이 됩니다. 이 가이드의 단계를 검토한 후에도 문제가 계속 발생하는 경우에는 Shopify 지원팀에 문의하여 도움을 요청하십시오.

이 페이지의 내용

블록 문제 해결

블록은 사용자 지정 필드, 동적 콘텐츠, 배너 등 체크아웃에 콘텐츠를 표시하는 맞춤 설정 요소입니다. 블록이 예상대로 작동하지 않는 경우 다음 섹션을 참조하여 문제를 확인하고 해결하세요.

체크아웃에 블록이 표시되지 않음

블록이 편집기에 추가되지 않은 경우

Checkout Blocks 앱에서 블록을 생성해도 체크아웃에 자동으로 추가되지는 않습니다. 체크아웃 및 계정 편집기를 사용하여 체크아웃 구성에 블록을 추가해야 합니다.

단계:

  1. Shopify 관리자에서 설정 > 체크아웃으로 이동하십시오.
  • 구성 섹션에서 수정하려는 구성 옆의 사용자 지정을 클릭합니다.
  • 블록을 표시하려는 체크아웃 페이지로 이동합니다.
  • ⊕ 블록 추가를 클릭하고 적절한 블록 유형을 선택합니다.
  • Checkout Blocks에서 생성한 블록의 ID와 블록 ID가 일치하도록 설정합니다.
  • 저장을 클릭합니다.
    • 블록이 활성으로 설정되지 않은 경우

    블록이 체크아웃에 표시되려면 활성 상태여야 합니다. 초안 상태인 블록은 고객에게 표시되지 않습니다.

    단계:

    1. Shopify 관리자에서 앱 > Checkout Blocks로 이동하십시오.
  • 블록을 클릭합니다.
  • 활성화하려는 블록을 클릭합니다.
  • 상태 섹션에서 활성을 선택합니다.
  • 저장을 클릭합니다.
    • 블록이 마켓 또는 페이지에 게시되지 않은 경우

    블록이 마켓별 게시 설정으로 구성된 경우 선택한 마켓에만 표시됩니다. 블록이 특정 체크아웃 페이지에만 게시된 경우에는 다른 페이지에 표시되지 않습니다.

    단계:

    1. Shopify 관리자에서 앱 > Checkout Blocks로 이동하십시오.
  • 블록을 클릭합니다.
  • 검토하려는 블록을 클릭합니다.
  • 게시 섹션에서 블록이 모든 해당 마켓에 게시되었는지 확인합니다.
  • 체크아웃 페이지 섹션에서 블록이 모든 해당 체크아웃 페이지에 표시되도록 설정되어 있는지 확인합니다.
  • 저장을 클릭합니다.
    • 표시 규칙이 충족되지 않는 경우

    표시 규칙은 블록이 체크아웃에 표시되기 위해 충족해야 하는 조건을 정의합니다. 고객의 체크아웃 세션 중에 이러한 조건이 충족되지 않으면 블록이 표시되지 않습니다.

    단계:

    1. Shopify 관리자에서 앱 > Checkout Blocks로 이동하십시오.
  • 블록을 클릭합니다.
  • 표시되지 않는 블록을 클릭합니다.
  • 블록에 구성된 표시 규칙을 검토합니다.
  • 테스트 체크아웃이 카트 합계 기준, 제품 유형, 고객 로그인 상태 등 모든 필수 조건을 충족하는지 확인합니다.
  • 표시 조건: 모든 규칙 통과로 설정한 경우에는 모든 규칙이 충족되는지 확인합니다. 표시 조건: 일부 규칙 통과로 설정한 경우에는 하나 이상의 규칙이 충족되는지 확인합니다.
    • 블록 ID가 일치하지 않는 경우

    체크아웃 및 계정 편집기의 각 블록 유형에는 블록 ID 설정이 있습니다. 편집기의 블록 ID는 Checkout Blocks 앱에서 생성한 블록의 ID와 일치해야 합니다. ID가 일치하지 않으면 블록이 표시되지 않습니다.

    예를 들어, Checkout Blocks 앱에 있는 블록의 ID가 4인 경우 체크아웃 및 계정 편집기에 있는 블록의 블록 ID도 4로 설정해야 합니다.

    단계:

    1. Shopify 관리자에서 앱 > Checkout Blocks로 이동하십시오.
  • 블록을 클릭합니다.
  • 표시되지 않는 블록을 클릭하고 블록 ID를 확인합니다.
  • 설정 > 체크아웃으로 이동하십시오.
  • 구성 섹션에서 확인하려는 구성 옆의 사용자 지정을 클릭합니다.
  • 콘텐츠를 표시해야 하는 편집기의 블록을 클릭합니다.
  • 블록 설정에서 블록 ID가 3단계의 ID와 일치하는지 확인합니다.
  • ID가 일치하지 않으면 블록 ID를 업데이트하여 일치시킵니다.
  • 저장을 클릭합니다.
    • 미리 보기 블록 ID 필드에 값이 포함된 경우

    체크아웃 및 계정 편집기의 미리 보기 블록 ID(테스트용) 필드는 테스트용으로만 사용됩니다. 체크아웃을 저장한 후 이 필드에 값이 포함되어 있으면 블록의 표시 규칙을 재정의하여 예기치 않은 동작이 발생할 수 있습니다.

    단계:

    1. Shopify 관리자에서 설정 > 체크아웃으로 이동하십시오.
  • 구성 섹션에서 확인하려는 구성 옆의 사용자 지정을 클릭합니다.
  • 올바르게 표시되지 않는 블록을 클릭합니다.
  • 미리 보기 블록 ID(테스트용) 필드에서 모든 값을 삭제하여 필드를 비워 둡니다.
  • 저장을 클릭합니다.
    • 우선순위가 더 높은 블록이 대신 표시되는 경우

    표시 규칙이 겹치는 동일한 유형의 블록이 여러 개 있는 경우 가장 우선순위가 높은 블록만 표시됩니다. 블록 우선순위에 대해 자세히 알아보세요.

    단계:

    1. Shopify 관리자에서 앱 > Checkout Blocks로 이동하십시오.
  • 블록을 클릭합니다.
  • ⇅ 우선순위 편집을 클릭하십시오.
  • 표시되지 않는 블록 유형을 선택하십시오.
  • 우선순위 순서를 검토하십시오. 숫자가 낮을수록 우선순위가 높습니다.
  • 우선순위 숫자를 조정하여 먼저 표시될 블록을 변경하십시오.
  • 저장을 클릭합니다.
    • 활성 블록 제한 도달 문제 해결

    Checkout Blocks는 블록 유형당 최대 30개의 활성 블록을 지원합니다. 단일 유형의 활성 블록이 30개를 초과하는 경우(예: 35개의 활성 사용자 지정 필드 블록), 체크아웃 시 처음 30개의 블록만 표시될 수 있습니다.

    단계:

    1. Shopify 관리자에서 앱 > Checkout Blocks로 이동하십시오.
  • 블록을 클릭합니다.
  • 문제를 해결하려는 블록 유형으로 필터링하십시오.
  • 활성 블록 수를 세어 보십시오.
  • 활성 블록이 30개를 초과하는 경우 더 이상 필요하지 않은 블록을 비활성화하거나 삭제하십시오.

    • 체크아웃에 블록이 여러 번 표시됨

    공유 섹션에 추가된 블록 문제 해결

    체크아웃 및 계정 편집기에서 블록을 추가하는 위치에 따라 체크아웃의 모든 단계에 걸쳐 블록이 표시될 수 있습니다. 주문 요약 섹션과 계속 또는 반품 버튼에 연결된 영역은 모든 체크아웃 페이지에서 일관되게 표시됩니다.

    블록을 특정 단계에만 표시하려면 해당 단계의 기본 콘텐츠 영역에 블록을 추가하십시오.

    단계:

    1. Shopify 관리자에서 설정 > 체크아웃으로 이동하십시오.
  • 구성 섹션에서 수정하려는 구성 옆의 사용자 지정을 클릭하십시오.
  • 여러 번 표시되는 블록을 클릭하십시오.
  • 블록이 어느 섹션에 있는지 확인하십시오. 주문 요약 섹션에 있거나 계속 또는 반품 버튼에 연결되어 있는 경우 모든 체크아웃 페이지에 블록이 표시됩니다.
  • 블록을 특정 페이지에만 표시하려면 현재 섹션에서 블록을 제거하고 원하는 체크아웃 페이지의 기본 콘텐츠 영역에 추가하십시오.
  • 저장을 클릭합니다.
    • 추가된 여러 블록 인스턴스 문제 해결

    품목 편집 블록과 같은 일부 블록 유형은 일반적으로 체크아웃에 한 번만 추가하면 됩니다. 이 블록은 표시 규칙을 사용하여 다양한 시나리오에 따라 서로 다른 콘텐츠를 표시합니다. 블록 콘텐츠가 중복되는 경우 실수로 필요한 것보다 더 여러 번 블록을 추가했을 수 있습니다.

    단계:

    1. Shopify 관리자에서 설정 > 체크아웃으로 이동하십시오.
  • 구성 섹션에서 확인하려는 구성 옆의 사용자 지정을 클릭합니다.
  • 체크아웃의 각 페이지를 탐색하고 추가된 블록을 검토하십시오.
  • 동일한 유형과 Block ID를 가진 중복 블록을 찾은 경우, 블록을 클릭하고 블록 제거를 선택하여 여분의 블록을 제거하십시오.
  • 저장을 클릭합니다.

    • 블록 생성 또는 저장 시 오류 문제 해결

    블록을 생성하거나 저장하는 동안 오류가 발생하는 경우 다음 섹션을 검토하십시오.

    “양식 제출에 몇 가지 문제가 있었습니다” 오류 문제 해결

    이 오류는 일반적으로 직원 계정에 Checkout Blocks에서 블록을 생성하는 데 필요한 권한이 없음을 나타냅니다.

    필요한 권한:

    • 스토어 권한 > 콘텐츠: 직원에게는 메타 객체 정의에 대한 보기 및 생성 및 편집 권한과 항목에 대한 보기 및 생성 및 편집 권한이 있어야 합니다.
    • 스토어 권한 > 스토어 설정: 직원에게는 설정 관리 권한이 있어야 합니다.
    • 앱 권한: 직원에게는 Checkout Blocks에 대한 권한이 최소한 있어야 합니다.

    단계:

    1. Shopify 관리자에서 설정 > 사용자 및 권한으로 이동하십시오.
    2. 오류가 발생하는 직원 계정을 클릭하십시오.
    3. 스토어 권한에서 콘텐츠 섹션을 확대하십시오.
    4. 메타 객체 정의에 보기 및 생성 및 편집 권한이 선택되어 있는지 확인하십시오.
    5. 항목에 보기 및 생성 및 편집 권한이 선택되어 있는지 확인하십시오.
    6. 스토어 설정에서 설정 관리가 선택되어 있는지 확인하십시오.
    7. 앱 권한에서 Checkout Blocks가 선택되어 있는지 확인하십시오.
    8. 저장을 클릭합니다.

    직원 권한을 수정할 권한이 없는 경우 스토어 소유자나 사용자 관리 권한이 있는 직원에게 문의하십시오.

    사용자 지정 할인 문제 해결

    Checkout Blocks에서 생성된 사용자 지정 할인은 여러 요인으로 인해 예상대로 적용되지 않을 수 있습니다.

    활성 자동 할인 한도 도달 문제 해결

    Shopify에서는 설치된 모든 앱의 앱 기반 할인을 포함하여 한 번에 최대 25개의 활성 자동 할인을 허용합니다. 이 제한은 Checkout Blocks뿐만 아니라 전체 스토어에 적용됩니다.

    26번째 자동 할인을 활성화하려고 하면 체크아웃에 적용되지 않습니다.

    단계:

    1. Shopify 관리자에서 할인으로 이동하십시오.
    2. 필터링하여 자동 할인만 표시하십시오.
    3. 현재 활성화된 자동 할인이 몇 개인지 세어 보십시오.
    4. 활성 자동 할인이 25개 이상인 경우, 새 할인을 활성화하기 전에 더 이상 필요하지 않은 할인을 비활성화하거나 삭제하십시오.

    할인 조합 시 제한 사항에 대해 자세히 알아보세요.

    활성화되지 않은 할인 문제 해결

    사용자 지정 할인이 체크아웃 내에서 적용되려면 활성으로 설정되어야 합니다. 또한 구성된 시작일 및 종료일을 기준으로 할인이 만료되지 않아야 합니다.

    단계:

    1. Shopify 관리자에서 앱 > Checkout Blocks로 이동하십시오.
  • 할인을 클릭하십시오.
  • 적용되지 않는 할인을 클릭하십시오.
  • 상태 섹션에서 할인이 활성으로 설정되어 있는지 확인하십시오.
  • 활성 날짜 섹션에서 현재 날짜가 구성된 시작일과 종료일 사이에 속하는지 확인하십시오.
  • 저장을 클릭합니다.
    • 충족되지 않은 할인 규칙 문제 해결

    Checkout Blocks의 사용자 지정 할인은 할인이 적용되는 시점을 결정하는 상세한 조건부 규칙을 가질 수 있습니다. 고객의 체크아웃 세션 중에 이러한 조건이 충족되지 않으면 할인이 적용되지 않습니다.

    단계:

    1. Shopify 관리자에서 앱 > Checkout Blocks로 이동하십시오.
  • 할인을 클릭하십시오.
  • 적용되지 않는 할인을 클릭하십시오.
  • 할인에 대해 구성된 규칙 및 조건을 검토하십시오.
  • 테스트 체크아웃이 최소 주문 금액, 특정 제품 또는 컬렉션, 고객 자격 요건과 같은 모든 필수 조건을 충족하는지 확인하십시오.
  • 필요에 따라 할인 규칙을 조정하십시오.
  • 저장을 클릭합니다.

    • 배송 및 결제 방법 맞춤 설정 문제 해결

    배송 또는 결제 방법이 예상대로 숨겨지거나 이름이 변경되거나 재정렬되지 않는 경우 다음 섹션을 검토하십시오.

    활성화되지 않은 맞춤 설정 문제 해결

    배송 또는 결제 방법 맞춤 설정이 체크아웃에 적용되려면 활성으로 설정되어야 합니다.

    단계:

    1. Shopify 관리자에서 앱 > Checkout Blocks로 이동하십시오.
  • Functions를 클릭하십시오.
  • 작동하지 않는 맞춤 설정을 클릭하십시오.
  • 상태 섹션에서 맞춤 설정이 활성으로 설정되어 있는지 확인하십시오.
  • 저장을 클릭합니다.
    • 활성 Functions 한도 도달 문제 해결

    Shopify Functions에는 유형별로 활성화할 수 있는 함수 수에 제한이 있습니다. 각 스토어에서 최대 25개의 결제 맞춤 설정 함수를 활성화할 수 있습니다. 이 한도를 초과하면 맞춤 설정을 활성화하지 못했습니다. 다시 시도하거나 지원팀에 문의하십시오. 오류가 표시될 수 있습니다.

    이러한 제한은 체크아웃에서 높은 실적을 유지하는 데 도움이 됩니다. 한도 미만으로 유지하려면 맞춤 설정을 병합하거나 제거해야 합니다.

    단계:

    1. Shopify 관리자에서 앱 > Checkout Blocks로 이동하십시오.
  • Functions를 클릭하십시오.
  • 배송 문제를 해결하는 경우 활성 배송 방법 맞춤 설정 수를 계산하고, 결제 문제를 해결하는 경우 활성 결제 방법 맞춤 설정 수를 계산하십시오.
  • 해당 유형의 한도에 도달한 경우 더 이상 필요하지 않은 맞춤 설정을 비활성화하거나 삭제하십시오.
  • 새 맞춤 설정을 다시 활성화해 보십시오.
    • 충족되지 않은 맞춤 설정 규칙 문제 해결

    배송 및 결제 방법 맞춤 설정은 맞춤 설정이 적용되는 시점을 결정하는 규칙에 따라 달라집니다. 고객의 체크아웃 세션 중에 이러한 조건이 충족되지 않으면 맞춤 설정이 적용되지 않습니다.

    단계:

    1. Shopify 관리자에서 앱 > Checkout Blocks로 이동하십시오.
  • Functions를 클릭하십시오.
  • 작동하지 않는 맞춤 설정을 클릭하십시오.
  • 맞춤 설정에 구성된 규칙을 검토하십시오.
  • 테스트 체크아웃이 모든 필수 조건을 충족하는지 확인하십시오.
  • 필요에 따라 규칙을 조정하십시오.
  • 저장을 클릭합니다.

    • 테스트 체크아웃으로 변경 사항 확인

    라이브 환경에서 Checkout Blocks 맞춤 설정을 사용하기 전에 테스트 체크아웃을 사용하여 예상대로 작동하는지 확인해야 합니다.

    단계:

    1. 온라인 스토어에서 테스트하려는 블록, 할인 또는 맞춤 설정의 조건과 일치하는 제품을 카트에 추가하십시오.
    2. 체크아웃으로 진행하되 구매는 완료하지 마십시오.
    3. 체크아웃의 각 단계를 검토하고 다음 사항을 확인하십시오.
      • 블록이 올바른 위치에 올바른 콘텐츠로 표시됩니다.
      • 자격 요건이 충족되면 사용자 지정 할인이 적용됩니다.
      • 배송 및 결제 방법 맞춤 설정이 예상대로 작동합니다.
    4. 카트 합계에 따른 표시 규칙을 테스트하는 경우, 다양한 카트 금액을 시도하여 올바른 임계값에서 블록이 표시되고 사라지는지 확인하십시오.
    5. 고객 기반 표시 규칙을 테스트하는 경우 로그인 및 게스트 체크아웃 시나리오를 모두 테스트하십시오.

    자주 묻는 질문

    동시에 활성화할 수 있는 블록은 몇 개인가요?

    블록 유형당 최대 30개의 활성 블록을 사용할 수 있습니다. 예를 들어 활성 사용자 지정 필드 30개, 활성 동적 콘텐츠 블록 30개, 활성 품목 편집 블록 30개를 동시에 사용할 수 있습니다. 한 유형의 블록을 30개 이상 생성할 수 있지만 체크아웃에는 처음 30개의 활성 블록만 표시될 수 있습니다.

    Checkout Blocks를 사용하려면 특정 직원 권한이 필요한 이유는 무엇인가요?

    Checkout Blocks는 블록 구성을 저장하기 위해 메타 객체 정의를 생성합니다. 앱에 블록을 저장하려면 직원/담당자가 메타 객체 정의 및 항목을 생성하고 편집할 권한이 있어야 합니다. 또한 스토어 설정의 설정 관리 및 Checkout Blocks에 대한 명시적인 앱 권한도 필요합니다.

    Shopify Plus 플랜을 사용하지 않는 경우에도 Checkout Blocks를 사용할 수 있나요?

    Basic 요금제 이상의 판매자는 감사 페이지 및 주문 상태 페이지에서만 동적 콘텐츠 및 정적 콘텐츠 블록을 사용할 수 있습니다. 사용자 지정 필드, 사용자 지정 할인, 배송/결제 방법 맞춤 설정을 비롯한 다른 모든 Checkout Blocks 기능은 Shopify Plus 플랜이 필요합니다.

    어떤 블록 ID를 사용해야 하는지 어떻게 알 수 있나요?

    Checkout Blocks 앱에서 블록을 생성하면 블록 ID(기본값: 0)가 할당됩니다. 편집기에서 해당 블록 유형을 체크아웃에 추가할 때, 편집기가 표시할 특정 블록을 인식할 수 있도록 동일한 블록 ID를 설정해야 합니다. 동일한 유형의 여러 블록을 다른 위치에 표시하려면 각 블록에 고유한 블록 ID를 할당하고 편집기에서 해당 ID를 일치시키십시오. 블록 ID에 대해 자세히 알아보세요.

    Checkout Blocks 할인을 다른 할인과 결합할 수 있나요?

    Checkout Blocks에서 생성된 사용자 지정 할인은 Shopify Functions로 구동되는 자동 할인입니다. 다른 자동 할인과 동일한 할인 조합 규칙을 따릅니다. Checkout Blocks 및 다른 앱에서 생성된 할인을 포함하여 스토어 전체에서 최대 25개의 활성 자동 할인을 사용할 수 있습니다.

    Checkout Blocks에 대해 Shopify 지원팀에 문의하기 전

    위의 문제 해결 단계를 시도한 후에도 Checkout Blocks 문제가 지속되면 Shopify 지원팀에 문의하여 도움을 요청할 수 있습니다. Shopify 지원팀에 문의하기 전에 다음과 같은 Checkout Blocks 관련 정보를 수집하면 문제를 더 빨리 해결하는 데 도움이 됩니다.

    • 블록 세부 정보: 작동하지 않는 블록의 이름, 유형(예: 사용자 지정 필드, 동적 콘텐츠 또는 품목 편집) 및 블록 ID
    • 구성 스크린샷: 표시 규칙, 게시 설정 및 상태를 포함하여 Checkout Blocks 앱에 있는 블록 설정의 스크린샷
    • 편집기 스크린샷: 블록 ID 및 미리 보기 블록 ID 필드를 포함하여 체크아웃 및 계정 편집기에서 블록이 구성된 방식에 대한 스크린샷
    • 오류 메시지: 블록 생성, 저장 또는 미리 보기 시 표시되는 오류 메시지의 스크린샷 또는 정확한 텍스트
    • 테스트 체크아웃 URL: 표시 규칙을 트리거하는 데 사용된 카트 콘텐츠와 함께 문제를 재현할 수 있는 테스트 체크아웃 또는 중단된 체크아웃 링크
    • 예상 동작과 실제 동작 비교: 예상했던 동작과 체크아웃에서 실제로 발생하는 동작에 대한 명확한 설명
    • 완료한 문제 해결 단계: 이 가이드에서 이미 검토한 섹션 및 시도한 방법
    • 직원 권한: 계정에 콘텐츠(메타 객체 정의 및 항목), 스토어 설정(설정 관리), 앱 권한(Checkout Blocks)에 대한 필수 권한이 있는지 확인합니다.

    이러한 Checkout Blocks 관련 정보를 미리 준비해 두시면 Shopify 지원팀이 문제를 더 효율적으로 진단하고 해결하는 데 도움이 됩니다.