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

학습 내용

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

캠페인 발송 경고

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

오류 미리보기

메시지를 미리 볼 때 다음과 같은 오류 메시지가 표시될 수 있어요:

태그 또는 변수 없이 표시된 메시지
잘못된 템플릿 태그 또는 변수를 수정하여 실제 프로필 및 이벤트가 포함된 메시지를 미리보기할 수 있어요.

이 오류는 메시지 어딘가에 잘못된 구문이 있다는 뜻이에요. 오류의 원인을 찾으려면 메시지의 제목 및 본문 콘텐츠에서 변수, 태그 또는 조건문(즉, 템플릿에서 중괄호 {}로 둘러싸인 모든 항목)이 Klaviyo 고객센터 리소스에 설명된 형식을 따르는지 확인해 주세요. 아래는 오류를 찾는 데 도움이 되는 몇 가지 팁이에요:

• 메시지의 데스크톱 및 모바일 버전을 모두 확인해 주세요.
• 메시지에 고유 쿠폰이 포함되어 있다면 쿠폰 이름이 올바른지, 그리고 쿠폰이 쿠폰 탭에서 구성되어 있는지 확인해 주세요.

맞춤 HTML 템플릿 오류

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

카탈로그 오류

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

이 오류가 표시되면 탭에 포함된 항목 ID를 인식하지 못한다는 뜻이에요. 다음을 확인해 주세요:

• 항목 ID가 포함된 이벤트로 미리 보고 있어요(항목 ID가 이벤트 데이터를 동적으로 참조하는 경우).
• 이벤트 데이터의 항목 ID 참조가 올바르게 형식화되어 있어요.
• 이벤트 데이터의 항목 ID가 Klaviyo 카탈로그에 있는 항목 ID와 일치해요.

Shopify 템플릿 오류

• 본문 html Liquid 구문 오류: 알 수 없는 태그 'unsubscribe'
  본문 html Liquid 구문 오류: 알 수 없는 태그 'web_view'
  이러한 오류와 이와 유사한 다른 오류는 Shopify로 내보내기 전에 Klaviyo 전용 태그가 템플릿에 추가되었음을 의미해요. Shopify는 Klaviyo의 구독 취소, 환경설정 관리 또는 웹 보기 링크를 지원하지 않아요.
• 본문 HTML Liquid 구문 오류: 알 수 없는 태그 "Load"
  Shopify는 Klaviyo의 제품 블록 기능을 지원할 수 없어요. Shopify 알림 템플릿에 제품 블록을 추가한 다음 해당 템플릿을 Shopify로 가져오면 이 오류가 표시돼요. 제품 블록을 제거하고, 템플릿의 HTML을 내보낸 다음 Shopify로 가져오세요.
• Body html Liquid syntax error: Unknown tag 'elsif'
  Body html Liquid syntax error: 'if' tag was never closed
  Body html Liquid syntax error: 'X' Tag Was Never Closed
  Klaviyo의 Shopify 알림 템플릿 중 상당수에는 조건문이 포함되어 있어 고객의 주문 상태에 따라 메시지가 동적으로 변경돼요. 조건문의 일부가 삭제되면 위와 같은 오류가 표시돼요.
  
  이를 해결하려면 Klaviyo에서 템플릿을 열고 조건문의 남아 있는 요소를 제거하세요. 다음으로 시작하는 태그를 검색하세요:
  • { % for item in...
  • {% endfor %}
  • {% if...
  • {% elsif...
  • {% else %}
  • {% endif %}