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

학습 내용

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

캠페인 발송 경고

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

오류 미리보기

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

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

이 메시지는 Klaviyo에서 템플릿 태그 또는 변수를 렌더링할 수 없었다는 의미예요. 오류의 원인을 찾으려면 메시지의 제목과 본문 콘텐츠에서 변수, 태그 또는 조건문(즉, 템플릿에서 {{ }} or {% %}로 둘러싸인 모든 항목) 중 메시지 개인화 참조에 설명된 형식을 따르지 않는 항목이 있는지 확인해 보세요. 아래는 오류를 찾는 데 도움이 되는 몇 가지 팁이에요:

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

문제를 수정한 후, 템플릿에서 사용하는 데이터가 포함된 프로필 또는 이벤트로 메시지를 다시 미리보기해 주세요. 테스트 이메일을 보내기 전에 변수가 채워지는지 확인해 주세요.

맞춤 HTML 템플릿 오류

• 다음 이미지를 찾을 수 없어요: ... 업로드한 zip 파일에 포함되어 있는지 확인해 주세요.
  모든 이미지 소스 경로의 철자가 올바른지, 그리고 업로드한 이미지의 파일 이름과 일치하는지 확인해 주세요. 오류 메시지에 이미지 경로가 제공되지 않으면 HTML 파일에서 비어 있는 background 속성(예: background="")이 있는지 확인해 주세요. 비어 있는 background 속성을 제거한 다음, 수정된 HTML 파일을 다시 업로드해 주세요.
• {% unsubscribe %} 태그가 필요합니다.
  이 오류를 해결하려면 메시지 바닥글에 Klaviyo 구독 취소 태그를 추가해 주세요.
• 나머지를 파싱할 수 없어요: 'XYZ'에서 'Z'.
  이 오류는 Klaviyo가 템플릿 표현식의 일부를 읽을 수 없었다는 뜻이에요. 오류에 인용된 표현식에서 따옴표가 잘못 배치되었거나 반복되었는지, 속성 이름에 공백이 있는지, 또는 필터 구문이 올바르지 않은지 확인해 주세요. 문제는 {{ }} 변수나 {% %} 태그 안에 있을 수 있어요. 지원되는 구문과 예시는 메시지 개인화 참조를 참고해 주세요.

카탈로그 오류

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

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

• 항목 ID가 포함된 이벤트로 미리 보고 있어요(항목 ID가 이벤트 데이터를 동적으로 참조하는 경우).
• 항목 ID가 이벤트 데이터 또는 프로필 속성에서 가져온 경우, 참조가 올바르게 형식이 지정돼 있어요.
• 태그, 이벤트 데이터 또는 프로필 속성에 있는 품목 ID가 Klaviyo 카탈로그의 품목과 일치해요.

Shopify 템플릿 오류

• Body html Liquid syntax error: Unknown tag '구독 취소'
  Body html Liquid syntax error: Unknown tag 'web_view'
  이러한 오류와 이와 유사한 다른 오류는 Shopify로 내보내기 전에 Klaviyo 전용 태그가 템플릿에 추가되었다는 의미예요. Shopify는 Klaviyo의 구독 취소, 환경설정 관리 또는 웹 보기 링크를 지원하지 않아요. 다시 내보내기 전에 Shopify 알림 템플릿에서 이러한 Klaviyo 전용 링크를 제거해 주세요.
• Body Html Liquid 구문 오류: 알 수 없는 태그 "Load"
  이 오류는 내보낸 HTML에 Shopify에서 지원하지 않는 Klaviyo 전용 태그가 포함되어 있음을 의미해요. Shopify 알림 템플릿에 Klaviyo 제품 블록이 포함되어 있다면 이를 제거한 다음, 템플릿의 HTML을 내보내 Shopify로 가져오세요.
• Body html Liquid syntax error: Unknown 태그 'elsif'
  Body html Liquid syntax error: 'if' 태그 was never closed
  Body html Liquid syntax error: 'X' 태그 Was Never Closed
  Klaviyo의 Shopify 알림 템플릿 중 많은 템플릿에는 조건문이 포함되어 있어 고객의 주문 상태에 따라 메시지가 동적으로 바뀌고, 반복문은 주문 내 항목에 대해 콘텐츠를 반복해요. 문 또는 반복문의 일부가 삭제되면 위와 같은 오류가 표시될 수 있어요.
  
  이 문제를 해결하려면 Klaviyo에서 템플릿을 열고 누락된 태그를 복원해 주세요. 각 {% if ... %}에는 일치하는 {% endif %}가 필요하고, 각 {% for ... %}에는 일치하는 {% endfor %}가 필요해요. {% elsif ... %} 및 {% else %}는 해당하는 문 안에 유지해 주세요. 문 또는 루프를 의도적으로 제거하는 경우, 일치하지 않는 태그나 항목 변수가 남지 않도록 해당 내용까지 포함해 전체 블록을 삭제해 주세요. 다음 여는 태그, 분기 태그, 닫는 태그를 찾아보세요:
  • {% for item in...
  • {% endfor %}
  • {% if...
  • {% elsif...
  • {% else %}
  • {% endif %}

변경한 후 업데이트된 템플릿을 내보내고 Shopify로 가져오세요. 저장하기 전에 Shopify에서 알림을 미리 보고 테스트해 보세요. Shopify 알림 변수는 Shopify에서 채워지며, Klaviyo 미리보기에서는 스타일만 확인할 수 있어요.