이메일에 사용자 지정 웹 피드를 추가하는 방법

학습 내용

이메일 내에서 사용자 지정 웹 피드를 추가하고 사용하는 방법을 알아보세요. 사용자 지정 웹 피드를 사용하면 클라비요 이메일 내에서 외부 URL의 데이터 피드를 동적으로 채울 수 있습니다. 이메일을 보내기 전에 클라비요는 URL에 HTTP 요청을 하고 데이터를 가져옵니다. 그러면 웹 피드의 콘텐츠를 이메일에서 사용할 수 있습니다.

웹 피드의 장점은 단일 템플릿을 사용하여 콘텐츠를 동적으로 가져올 수 있다는 것인데, 사용자는 피드를 최신 상태로 유지하기만 하면 클라비요가 모든 전송에 피드의 새로운 콘텐츠가 채워지도록 보장합니다.

이 문서에서는 캠페인 및 흐름에서 사용자 지정 웹 피드를 추가하고 사용하는 방법에 대해 설명합니다.

시작하기 전 안내 사항

클라비요에서 이메일에 동적 외부 콘텐츠를 추가하는 첫 번째 단계는 웹 피드 소스를 만드는 것입니다. 피드가 있어야 합니다: 

• JSON 또는 XML 형식의 액세스 가능한 URL에서 호스팅되어야 합니다.
• 3.3MB 이하
• 리디렉션 URL 사용 안 함 

클라비요는 지정된 URL에 HTTP 요청을 보내 피드 데이터를 가져옵니다. 흐름 이메일이 지속적으로 전송되는 방식으로 인해 클라비요는 주기적으로 피드 URL을 쿼리하여 다음 일정 중 하나에 따라 새로 고쳐진 콘텐츠를 가져와서 피드 콘텐츠를 최신 상태로 유지합니다: 

• 15분 새로 고침
  클라비요는 15분마다 피드 새로고침을 시도합니다. 이를 위해서는 피드가 5초 이내에 로드되고 성공적인 응답으로 돌아와야 합니다.

• 매일 밤 새로 고침
  피드가 돌아오는 데 5초 이상 걸리는 경우, 3시간 동안 시도한 후 밤마다 피드를 업데이트하기 시작합니다. 매일 밤 새로 고침을 계속하려면 피드가 30초 이내에 로드되어야 합니다. 

3일 연속으로 30초 이내에 피드를 로드하지 못하면 이메일에서 이 피드를 사용할 수 없게 됩니다. 이 피드에 의존하는 흐름 이메일은 전송이 중지되며, 피드가 제거되거나 피드와 관련된 미해결 문제가 해결될 때까지 캠페인 및 흐름 이메일이 전송되지 않습니다.

피드를 쿼리할 때 오류 응답을 받으면 피드 콘텐츠에 액세스할 수 없게 됩니다. 위와 동일한 패턴을 따라 최대 3일 동안 재시도합니다. 그 동안에는 이메일이 전송되지 않습니다.

웹 피드에 액세스하는 데 문제가 있는 경우 인앱 및 이메일 알림을 통해 이를 알려드립니다. 쉬운 문제 해결 단계는 피드 요구 사항을 다시 확인하고 위에 설명된 매개변수에 맞는지 확인하는 것입니다. 

업로드 시간을 단축하기 위해 크기를 줄이거나 오류 응답을 일으키는 문제를 해결하는 등 피드를 변경하고 클라비요가 새로 고침을 시도하도록 하려면 데이터 피드 탭에서 피드로 이동하여 데이터 피드 업데이트를 클릭합니다. 피드를 테스트하고 재검증합니다. 피드가 유효하고 적시에 응답이 돌아오면 콘텐츠를 최신 상태로 유지하기 위한 노력을 재개합니다. 변경하지 않았더라도 웹 피드에 액세스하는 데 문제가 있는 경우 시도해 볼 수 있는 좋은 문제 해결 단계입니다.

장고 필터

삽입하는 변수에 대해 장고 필터를 사용할 수 있도록 지원합니다. 다음은 일반적으로 사용되는 몇 가지 필터이며, 필터를 사용하여 변수 사용자 지정하기 가이드와 변수 필터 용어집에서 자세한 내용을 확인할 수 있습니다.

글 요약은 단어 수 X개로 제한

글 제목 아래에 블로그 글의 간략한 요약을 포함하려는 경우(피드에서 이 요약 텍스트를 제공하는 경우) 잘라내기 필터를 사용할 수 있습니다.

예를 들어 글의 요약을 250자로 제한하려면 다음과 같이 사용할 수 있습니다:

{{ item.summary|truncatechars:250 }}

사용자 지정 웹 피드 추가

피드 설정

1. 클라비요의 왼쪽 하단에서 회사 이름을 클릭합니다.
2. 설정을 클릭합니다.
3. 기타를 클릭합니다.
   
4. 웹 피드를 클릭합니다.
5. 웹 피드 추가를 클릭합니다.
   
6. 웹 피드 필드를 다음과 같이 입력합니다:
   • 피드 이름
     나중에 템플릿에서 이 식별자를 사용하여 피드 콘텐츠에 액세스할 수 있습니다. 피드에 설명이 포함된 짧은 이름을 지정합니다. 피드 이름은 대/소문자를 모두 사용하거나(예: "MyDataFeed") 공백을 밑줄로 대체하여 대문자로만 작성하는 것이 좋습니다(예: "MY_DATA_FEED"). 피드 이름에는 공백을 사용할 수 없습니다. 
   • 피드 URL
     클라비요가 피드 콘텐츠를 가져오는 데 사용하는 엔드포인트(즉, 이전에 구성한 JSON 또는 XML 피드의 URL)입니다. 피드에 개인 정보가 포함된 경우, 피드의 보안을 위해 HTTPS URL을 사용하고 논스 쿼리 매개변수를 포함할 것을 강력히 권장합니다.
   • 요청 방법
     피드를 요청하는 데 사용할 HTTP 방법을 지정합니다. 어떤 것을 선택해야 할지 잘 모르겠다면 GET을 선택하세요. 
   • 콘텐츠 유형
     피드의 형식(JSON 또는 XML)입니다. 가능하면 JSON을 사용하는 것이 좋습니다. XML 피드의 경우 피드가 JSON으로 변환됩니다.
7. 모든 필드를 입력한 후 웹 피드 추가를 클릭합니다. 피드 URL을 쿼리하여 피드가 제대로 작동하는지 확인합니다. 오류가 발생하면 오류 메시지가 표시되며 문제가 해결될 때까지 이 새 피드를 저장할 수 없습니다.
   • 이 기능을 사용해보고 싶지만 고유한 웹 피드 URL이 없으신가요? 저희 것을 사용하세요. 클라비요 헬프 센터의 다음 URL을 피드 URL 상자에 복사하여 자신의 클라비요 계정에서 사용해 보세요:

     https://help.klaviyo.com/api/v2/help_center/en-us/articles.json

8. Klaviyo 피드의 유효성을 검사하고 잠재적인 오류를 표시합니다. 인증이 완료되면 Klaviyo 에 피드가 표시되며 이메일에서 사용할 준비가 된 것입니다.
   

피드 미리보기

웹 피드를 이메일에 추가하기 전에 미리 보는 것이 유용합니다. 피드를 미리 보려면 다음과 같이 하세요:

1. 웹 피드 페이지에서 내 피드를 찾습니다. 
2. 점 3개를 클릭한 다음 편집을 선택합니다. 
   
3. 피드 세부 정보 페이지에서 미리 보기를 클릭합니다. 

피드를 미리 볼 때 피드 콘텐츠가 표시되거나 피드를 로드할 수 없는 경우 오류 메시지가 표시됩니다. 

피드가 JSON 배열인 경우 각 행을 자동으로 파싱하여 개별적으로 표시합니다. 다른 것, 대부분 JSON 사전인 경우 전체 사전을 표시합니다.

피드를 활발하게 개발 중인 경우 새로 고침 버튼을 사용하여 최신 버전의 피드를 가져올 수 있습니다. 피드 미리보기 페이지에는 전체 피드가 표시됩니다. 피드가 큰 경우 콘텐츠를 표시하는 데 몇 초가 걸릴 수 있습니다. 피드를 쿼리하는 데 30초 이상 걸리면 이 피드에 의존하는 모든 이메일의 성능에 영향을 미친다는 점을 유의하세요.

이제 웹 피드를 추가하고 콘텐츠를 미리 보았으니 이메일에서 사용할 수 있습니다.

이메일에서 웹 피드 사용

캠페인의 경우 클라비요는 각 피드를 전송할 때마다 한 번씩 가져와서 반환된 콘텐츠를 저장합니다. 수천 명의 수신자에게 전송하는 경우에도 클라비요는 서버에 수천 건의 요청을 하지 않습니다.

템플릿에 피드 콘텐츠 채우기

이전 섹션의 예제 웹 피드에는 각 항목에 이름, URL, 문서 ID 등이 포함된 문서 배열이 있습니다. 이메일에 피드가 추가되면 피드 변수를 통해 피드를 사용할 수 있습니다:

{{ feeds }}

예를 들어, 위의 JSON 피드의 경우 이제 템플릿에 이 구문을 포함하여 문서 피드의 콘텐츠를 참조하거나 출력할 수 있습니다:

{{ feeds.Klaviyo_Help_Center }}

배열의 모든 항목을 반복하여 특정 변수를 표시하는 예제를 실행해 보겠습니다. 여기서는 클라비요 블로그 피드를 예로 들어 이미지에 대해 반복해 보겠습니다.

1. 새 텍스트 블록을 이메일에 드래그하여 웹 피드를 채울 위치에 배치합니다.
2. 반복 블록/콘텐츠 반복 기능 켜기: 텍스트 블록의 표시 옵션 탭을 클릭한 다음 반복 규칙 만들기를 클릭합니다.
3. 반복 대상 필드에 feeds.YOUR_FEED_NAME을 입력한 다음 반복하려는 배열이 포함된 변수 이름을 입력합니다.
   • 이 예제에서는 "articles" 값도 반복하고 있으므로 feeds.Klaviyo_Help_Center.articles에 대해 반복합니다.
4. 데이터는 일련의 변수 안에 중첩될 수 있습니다. 예를 들어 피드는 다음과 같이 구성될 수 있습니다: 

   rss: {
            ..... 
            채널: { 
                    ..... 
                        item: { 
                                .....}}}

   이 경우 feeds.YOUR_FEED_NAME.rss.channel.item을 반복 대상으로 사용합니다.

5. 이 블록이 특정 개수의 항목에 대해서만 반복되도록 하려면 "슬라이스" 필터를 사용하세요. 이 필터를 사용하려면 끝에 필터를 추가하여 반복 대상 값을 조정합니다:  feeds.Klaviyo_Help_Center.articles|slice:':3'
   이 예에서 |slice:':3 '은 처음 세 개의 항목만 표시되도록 합니다. 
6. 항목별칭 필드에 다음을 입력합니다.
7. 반복 블록/콘텐츠 반복 기능을 구성한 후에는 "항목" 별칭을 사용하여 변수를 삽입할 수 있습니다.
8. 변수를 식별하고 추가하려면 웹 피드의 미리 보기를 열고 데이터 구조 방식을 참조하세요. 반복 대상 필드에 사용된 배열 내에 중첩된 모든 데이터를 변수로 사용할 수 있습니다.
   이 예에서는 문서 배열에 표시된 모든 데이터를 이메일에서 사용할 수 있습니다:
   
9. 1단계 데이터의 경우, 데이터에 표시된 변수 이름 앞에 항목을 추가하기만 하면 됩니다. 예를 들어 {{ item.title }}을 사용하여 문서 제목을 표시하거나 {{ item.url }}을 사용하여 문서 URL을 표시합니다. 
10. 첫 번째 수준 변수 내에 중첩된 데이터에 액세스하려면 점 표기법(예: {{ item.images.thumbnail_url }})을 사용합니다. 점 표기법과 템플릿 변수에 대해 자세히 알아보려면 템플릿 태그 및 변수 구문 가이드를 참조하세요. 
11. 템플릿을 미리 보면 반복 블록/콘텐츠 반복 기능을 사용하면 이 간단한 텍스트 블록이 피드의 모든 항목에 대해 자동으로 반복되는 것을 확인할 수 있습니다. 텍스트 블록에서 지정한 변수만 각 항목에 표시됩니다.
12. 이미지를 삽입하는 경우 텍스트 블록의 소스 코드 필드를 편집하고 <img src> 태그에 이미지를 포함해야 한다는 점에 유의하세요.
    

이제 이메일에 사용자 지정 웹 피드를 추가하여 외부 URL에서 데이터 피드를 동적으로 채울 수 있습니다. 

피드 테스트 또는 유효성 검사

웹 피드에 액세스하는 데 문제가 있다는 이메일 또는 앱 내 알림을 받은 경우:

1. 내 피드로 이동하여 피드 업데이트 버튼을 클릭합니다.
2. 유효성 검사가 완료되면 두 가지 유형의 오류 메시지가 표시될 수 있습니다:
   • 잘못된 응답
     피드 콘텐츠를 쿼리할 때 오류 응답이 수신되면 오류의 상태 코드를 알려드립니다. 이메일 내에서 피드를 성공적으로 사용하려면 이 오류 응답의 원인이 되는 문제를 해결해야 합니다.
   • 성능 문제
     피드에서 30초 이내에 응답을 받지 못하면 전송이 지연될 수 있습니다. 이전에는 피드를 저장할 수 있었을지라도 전송 지연의 위험을 줄이려면 피드의 성능 문제를 해결한 후 다시 유효성을 검사하여 성공적으로 저장해야 합니다.

두 경우 모두 전송 중에 문제가 있는 피드를 사용하면 전송이 지연되거나 이메일이 완전히 취소될 수 있습니다. 흐름의 경우 이메일이 전송되지 않을 수도 있습니다.

전송 중단을 방지하기 위해 미해결 문제를 해결하는 동안 모든 이메일에서 문제가 있는 피드를 삭제하는 것이 좋습니다.

추가 리소스

• 이메일에서 Instagram 웹 피드 문제 해결하기
• 제품 피드 및 추천 사용 방법