이메일 템플릿 오류 메시지 문제 해결

예상 3 읽은 시간(분)
|
업데이트 2024년 8월 22일 오전 10:38 EST
학습 내용

학습 내용

이메일 템플릿에서 오류나 경고가 발생하면 메시지를 보내기 전에 이를 해결해야 할 수 있습니다. 이 리소스에서 발생한 오류 메시지 또는 경고를 검색하여 문제 해결을 위한 팁을 찾아보세요. 

캠페인 전송 경고

캠페인 전송 경고

  • 이메일에서 기본 텍스트가 수정되지 않았거나 비어 있는 #블록이 발견되었습니다. 계속하기 전에 이메일을 검토해 주세요.
    이 경고가 표시되면 빈 블록이나 플레이스홀더 콘텐츠(예: "이것은 텍스트 블록입니다. 편집하려면 여기를 클릭하세요.") 를 템플릿에 추가합니다. 데스크톱 및 모바일 버전의 템플릿을 확인하세요. 빈 블록이나 플레이스홀더 콘텐츠를 찾을 수 없는 경우 자신에게 미리보기 메시지를 보내고 데스크톱과 모바일에서 모두 검토하세요. 미리보기가 괜찮아 보인다면 이 경고를 무시하고 메시지를 보내도 안전합니다.
  • 이메일 콘텐츠 문제일 수 있습니다. 이메일에 링크가 없는 것 같습니다. 이메일에 링크를 추가하는 것을 잊으셨나요?
    일반 텍스트 또는 사용자 지정 HTML 이메일에 링크가 포함되어 있지 않은 경우 이 경고가 표시됩니다. 메시지를 검토하여 클릭 유도 문안 링크를 포함한 모든 콘텐츠가 추가되었는지 확인합니다. 이메일에 수신 거부 링크를 제외한 어떤 링크도 포함하지 않으려면 이 경고를 무시하면 됩니다. 
  • 구독 취소 링크. 이메일에서 수신 거부 링크를 찾을 수 없습니다. 수신 거부 링크를 추가하지 않은 경우 클라비요에서 이메일 전송 시 자동으로 수신 거부 링크를 추가합니다.
    이 경고는 메시지에 수신 거부 태그(예: {% unsubscribe %} 또는 {% unsubscribe_link %})를 추가하지 않은 경우에 표시됩니다. 클라비요의 기본 바닥글이 메시지에 추가되지 않도록 수신 거부 링크를 추가하세요
미리보기 오류

미리보기 오류

메시지를 미리 볼 때 이 오류 메시지가 표시될 수 있습니다: 

태그나 변수 없이 표시되는 메시지
잘못된 템플릿 태그 또는 변수를 수정하여 실제 프로필 및 이벤트가 포함된 메시지를 미리 볼 수 있습니다.

이 오류는 메시지의 어딘가에 잘못된 구문이 있음을 의미합니다. 오류의 원인을 찾으려면 메시지 제목과 본문 콘텐츠에서 클라비요의 도움말 센터 리소스에 설명된 형식을 따르지 않는 변수, 태그 또는 조건문(즉, 중괄호 {}로 묶인 템플릿의 모든 항목)이 있는지 확인하세요. 다음은 오류를 찾기 위한 몇 가지 팁입니다: 

  • 메시지의 데스크톱 버전과 모바일 버전을 모두 확인하세요. 
  • 메시지에 동적 쿠폰이 포함된 경우 쿠폰 이름이 올바른지, 쿠폰 탭에서 쿠폰이 구성되었는지 확인하세요. 
사용자 지정 HTML 템플릿 오류

사용자 지정 HTML 템플릿 오류

  • 다음 이미지를 찾을 수 없습니다: ... 업로드한 zip 파일에 해당 이미지가 포함되어 있는지 확인하세요.
    모든 이미지 소스 경로의 철자가 올바른지, 업로드한 이미지의 파일 이름과 일치하는지 확인합니다. 오류 메시지에 이미지 경로가 제공되지 않으면 HTML 파일에 빈 배경 속성(예: background="")이 있는지 검토합니다.
  • 0}{% unsubscribe %} 태그가 필요합니다.
    이 오류를 해결하려면 메시지 바닥글에 클라비요 구독 취소 태그를 추가하세요. 
  • 나머지를 구문 분석할 수 없습니다: 'XYZ'에서 'Z'를 구문 분석할 수 없습니다.
    이 오류는 태그 중 하나({% %}으로 둘러싸인 모든 태그)가 클라비요에서 인식되지 않는다는 의미입니다. 허용되는 태그를 확인하려면 메시지 개인화 참조 가이드를 참조하세요.
카탈로그 오류

카탈로그 오류

템플릿에서 카탈로그 조회 태그를 사용하는 경우 코드가 있는 항목을 찾을 수 없음오류가 발생할 수 있습니다: __. 삭제되었을 수 있습니다.

이 오류가 표시되면 탭에 포함된 항목 ID를 인식하지 못한다는 의미입니다. 이를 확인합니다: 

  • 항목 ID가 포함된 이벤트로 미리 보기 중입니다(항목 ID가 이벤트 데이터를 동적으로 참조하는 경우). 
  • 이벤트 데이터의 항목 ID에 대한 참조 형식이 올바르게 지정되었습니다.
  • 이벤트 데이터의 아이템 ID가 클라비요 카탈로그에 있는 것과 일치합니다. 
Shopify 템플릿 오류

Shopify 템플릿 오류

  • 본문 html Liquid 구문 오류가 발생했습니다: 알 수 없는 태그 '구독 취소'
    본문 html Liquid 구문 오류입니다: 알 수 없는 태그 'web_view'
    이러한 오류 및 이와 유사한 기타 오류는 템플릿을 Shopify로 내보내기 전에 클라비요 관련 태그가 템플릿에 추가되었음을 의미합니다. Shopify는 클라비요의 구독 취소, 기본 설정 관리 또는 웹 보기 링크를 지원하지 않습니다.
  • 본문 Html 액체 구문 오류 : 알 수 없는 태그 "로드"
    클라비요의 제품 차단 기능은 Shopify에서 지원할 수 없습니다. Shopify 알림 템플릿에 제품 블록을 추가한 다음 해당 템플릿을 Shopify로 가져오면 이 오류가 표시됩니다. 제품 블록을 제거하고 템플릿의 HTML을 내보낸 다음 Shopify로 가져옵니다. 
  • 본문 html 액체 구문 오류: 알 수 없는 태그 'elsif'
    본문 html Liquid 구문 오류: 'if' 태그가 닫히지 않았습니다.
    본문 html Liquid 구문 오류: 'X' 태그가 닫히지 않았습니다.
    클라비요의 많은 Shopify 알림 템플릿에는 고객의 주문 상태에 따라 메시지를 동적으로 만드는 조건문이 포함되어 있습니다. 조건문의 일부가 삭제되면 위와 같은 오류가 표시됩니다.
    이 문제를 해결하려면 클라비요에서 템플릿을 열고 조건문의 나머지 요소를 제거하세요. 로 시작하는 태그를 검색합니다: 
    • { 항목의 %는...
    • {% endfor %}
    • {% if...
    • {% elsif...
    • {% else %}
    • {% endif %}
추가 리소스

추가 리소스

이 도움말 문서가 유용했나요?
이 형식은 도움말 문서 피드백 용도로만 사용하세요. 지원 팀에 문의하는 방법.

Klaviyo에서 자세히 살펴보기

커뮤니티
동료, 파트너, Klaviyo 전문가와 연결되어 영감을 받고 인사이트를 공유하며, 모든 궁금한 사항에 대해 답을 얻으세요.
라이브 교육
Klaviyo 전문가와 함께하는 라이브 세션에 참여하여 모범 사례, 주요 기능 설정 방법 등에 대해 알아보세요.
지원

계정을 통해 지원에 액세스하세요.

이메일 지원 (무료 체험 및 유료 계정) 연중무휴 24시간 사용 가능

채팅/가상 비서
사용 가능 여부는 위치 및 요금제 유형에 따라 다름