캠페인 컴포저 및 Klaviyo MCP 서버에서 SQL 시작하기

학습 내용

캠페인 컴포저 또는 Klaviyo 모델 컨텍스트 프로토콜(MCP) 서버를 사용해, Klaviyo 데이터에 대한 애널리틱스 질문을 쉬운 언어로 묻는 방법을 알아보세요. Klaviyo 데이터 플랫폼 SQL은 프로필, 오디언스, 캠페인, 제품, 이벤트를 한데 모아 여러 데이터 세트가 관련된 질문에 답할 수 있게 해요. SQL을 작성할 필요가 없어요.

SQL은 현재 베타 버전이며 모든 고객이 이용할 수 있어요.

시작하기 전에 알아야 할 것

질문할 위치를 선택해 주세요:

• 캠페인 컴포저를 사용해 Klaviyo 내 채팅에서 작업하세요. 추가 SQL 설정이 필요하지 않아요.
• Klaviyo MCP 서버를 사용해 Claude나 ChatGPT 같은 연결된 AI 클라이언트에서 작업하세요. 이미 Klaviyo를 연결했다면 다른 도구를 설치할 필요는 없지만, 클라이언트의 도구 목록을 새로 고쳐야 할 수도 있어요.

두 옵션 모두 동일한 데이터를 사용하며 동일한 유형의 분석 질문을 지원해요. SQL은 분석을 위해 설계되었어요. 대량 데이터 내보내기를 하려면 맞춤 보고서 같은 다른 Klaviyo 도구를 사용해 주세요.

데이터는 일반적으로 계정의 활동보다 약 30분 정도 늦게 반영돼요. 아주 최근의 주문, 전송, 또는 멤버십 변경의 경우 Klaviyo에서 직접 확인해 주세요.

첫 번째 분석 질문을 해 보세요.

캠페인 컴포저 사용하기

1. Klaviyo에서 캠페인 컴포저를 여세요. 찾는 데 도움이 필요하면 캠페인 컴포저 시작하기를 참고해 주세요.
2. 애널리틱스 질문을 쉬운 언어로 물어보세요. 지표, 날짜 범위, 그리고 오디언스 또는 제품에 대한 세부 정보를 포함해 주세요. 예를 들어, “지난 90일 동안 판매된 수량 기준으로 상위 5개 제품은 무엇인가요?”
3. 답변을 검토한 다음, 같은 대화에서 후속 질문을 해서 더 자세히 살펴보세요.

캠페인 컴포저에서 SQL을 언제 사용할지 결정해요. 도구 이름을 지정하거나 설정을 변경할 필요가 없어요.

Klaviyo MCP 서버를 사용하세요

AI 클라이언트를 연결하려면 사용하려는 Klaviyo 계정에서 소유자, 관리자 또는 매니저 역할이 필요해요. 연결에서 API 키를 사용하는 경우, 해당 키는 질문에 관련된 데이터 세트에 액세스할 수 있어야 해요. 예를 들어, 주문과 세그먼트에 대한 질문을 하려면 이벤트와 세그먼트에 대한 액세스 권한이 필요해요.

1. 클라이언트 또는 설정에 맞는 가이드를 사용해 Klaviyo를 연결해 주세요:
   • 터미널 및 원격 서버 연결을 위한 Klaviyo MCP 서버 개발자 문서
   • Claude용 Klaviyo 앱 FAQ
   • ChatGPT용 Klaviyo 앱 사용 방법
   • 클라이언트 계정 전반에서 작업하기 위한 에이전시를 위한 Klaviyo MCP 서버 가이드
2. 연결된 클라이언트에서 상세한 분석 질문을 해 보세요. ask_analytics_question 도구 이름을 지정할 필요는 없어요. 클라이언트가 질문에 적절할 때 이를 선택해요.
3. 답변을 검토하고 후속 질문을 계속해 주세요. 도구를 사용할 수 없는 경우 아래 문제 해결 단계를 따라 클라이언트의 Klaviyo 도구 목록을 새로고침해 주세요.

OAuth를 통해 연결하는 경우, 요청된 권한을 검토하고 승인하려면 클라이언트의 가이드를 따라 주세요.

답변을 바탕으로 이어서 작성하고 계산을 확인해 보세요.

SQL은 질문에 여러 데이터 세트의 정보가 필요할 때 유용해요. 예를 들어, 주문 수 집계에 고객, 세그먼트 멤버십, 국가를 추가하면 더 상세한 대상 분석이 돼요.

질문으로 시작한 다음, 같은 대화에서 답변을 바탕으로 이어서 작성해 주세요:

1. “지난달 주문이 몇 건이었나요?”
2. “몇 명의 고객이 해당 주문을 했나요?”
3. “현재 고객이 속해 있는 세그먼트별로 주문을 세분화해 주세요.”
4. “결과를 세그먼트와 국가별로 나눠서, 각 그룹의 수익도 포함해 주세요.”
5. “첫 구매 고객의 첫 주문 전 10일 동안 제품 탐색이 얼마나 있었나요?”

중요한 숫자를 공유하거나 그 숫자를 바탕으로 의사결정을 내리기 전에, 답이 어떻게 계산됐는지 먼저 확인해 보세요. 예를 들면 다음과 같습니다.

• “어떤 데이터 세트를 사용하셨나요?”
• “어떤 날짜 범위와 필터를 적용했나요?”
• “이 계산에서 수익은 어떻게 정의했나요?”
• “그걸 어떻게 계산했는지 설명해 주세요.”

설명을 활용해 답변이 의도한 질문과 일치하는지 확인해 주세요. 일치하지 않으면 지표, 날짜 또는 필터를 명확히 한 뒤 다시 질문해 주세요.

질문할 수 있는 데이터

SQL은 연결에 설정된 권한에 따라 이러한 데이터 세트에 대한 질문에 답할 수 있어요.

이벤트 및 이벤트 내 세부 정보

사용 가능한 이벤트 데이터에는 다음이 포함돼요:

• 장바구니에 담기, 주문하기 또는 주문 취소하기, 환불, 제품 보기 등의 커머스 활동
• 수신, 열람, 클릭, 반송, 드롭, 구독 취소를 포함한 이메일 활동
• 수신, 클릭, 실패, 동의, 구독 취소를 포함한 SMS 및 WhatsApp 활동
• 수신, 열람, 반송을 포함한 푸시 활동
• 구독 및 억제 변경 사항(구독, 구독 취소, 억제 추가 또는 제거, 환경설정 업데이트 포함)
• 항목 추가, 제거, 주문 처리, 건너뛰기, 시작을 포함한 플로우 활동
• 프로필 병합
• 리뷰 및 평점 제출, 수정, 삭제, 리뷰 준비 상태
• 쿠폰 할당 및 사용
• 시작, 수신 또는 발신 메시지, 에스컬레이션, 해결, 티켓 생성 또는 종료를 포함한 지원 대화 활동
• 로그인, 즐겨찾기, 제품 또는 쿠폰 클릭, 콘텐츠 블록 조회와 같은 Klaviyo 고객 허브 활동
• API, Shopify, Lightspeed 등의 소스에서 들어오는 연동 이벤트(결제 활동, 양식 제출, 로열티 가입, 검색, 배송 포함)
• 전송, 수신자, 열람, 클릭, 반송, 구독 취소, 스팸 신고, 사람 참여 유도 수 및 비율을 포함한 마케팅 지표

일부 이벤트에는 중첩된 값이 포함돼요. 이벤트 안에 관련된 세부 정보가 묶여 있는 형태예요. 예를 들어, 주문에는 여러 상품 목록이 포함될 수 있고, 각 상품에는 SKU, 수량, 가격이 있어요. SQL은 이런 세부 정보를 읽을 수 있으므로, 특정 SKU가 포함된 주문이 몇 건이었는지 또는 주문당 평균 상품 수가 얼마였는지 물어볼 수 있어요.

데이터 세트 결합

SQL은 관련된 데이터 세트를 연결해 질문에 답할 수 있어요. 이를 조인(join)이라고 하지만, 조인을 명시적으로 요청할 필요는 없어요. 예를 들어, 다음과 같이 할 수 있어요:

• 캠페인 메시지를 캠페인 이름 및 참여 유도 데이터에 연결해 이름이 지정된 캠페인을 비교하세요.
• 현재 리스트 또는 세그먼트 멤버십을 프로필 및 주문과 연결해 오디언스의 구매 활동을 분석하세요.
• 국가, 동의 상태 또는 예측 고객 가치를 기준으로 오디언스를 세분화하세요.
• 제품을 카테고리에 연결하거나, 같은 이메일의 다른 버전을 상위 제품에 연결해 제품 또는 카테고리 성과를 분석하세요.
• 쿠폰 할당을 쿠폰 사용과 연결해 상환을 계산하고, 상환되지 않은 쿠폰을 식별하세요.

예시 질문

날짜, 제품, 세그먼트, 캠페인 세부 정보를 계정에 맞게 조정해 주세요.

제한 사항 이해하기

사용할 수 없는 데이터

SQL은 현재 다음을 지원하지 않아요:

• 과거 특정 시점의 목록 또는 세그먼트 멤버십
• 가입 양식 또는 성과
• 사용자 정의 개체
• 이메일 또는 SMS 템플릿

연동 이벤트에는 양식 제출이 포함될 수 있지만, 그렇다고 해서 SQL이 가입 양식이나 그 성과에 대한 분석을 지원한다는 의미는 아니에요. 질문이 사용할 수 없는 데이터에 의존하는 경우, 답변이 불완전할 수 있거나 클라이언트가 답변하지 못할 수 있어요.

데이터 최신성 및 Klaviyo 보고서와의 차이점

데이터는 일반적으로 계정보다 약 30분 정도 늦게 표시돼요. 최근 활동이 바로 표시되지 않을 수 있어요.

수치는 일반적으로 Klaviyo와 일치해야 하지만, 정의의 차이, 쿼리 최적화, 또는 데이터 최신성 차이로 인해 약간의 차이가 발생할 수 있어요. SQL은 Klaviyo 데이터에 액세스하는 다른 방식과는 다른 데이터 소스를 사용해요. Klaviyo는 이 데이터가 지난 3년 동안 99% 일관되게 유지되었는지 확인했어요.

보고서의 숫자가 다를 때는 계산 방식, 날짜 범위, 필터를 확인해 보세요. 이 설명을 통해 동일한 지표와 기간을 비교하고 있는지 파악할 수 있어요.

생성된 쿼리 및 시간 초과

SQL은 질문을 바탕으로 쿼리를 생성해요. 현재는 자체 SQL 쿼리를 제출하고, 보장되며 반복 가능한 결과를 받을 수 있는 엔드포인트가 없어요. 표현이 조금만 달라도 다른 쿼리가 생성될 수 있고, 결과도 약간 달라질 수 있어요. 중요한 숫자는 계산을 확인해 주세요.

MCP 클라이언트는 캠페인 컴포저보다 더 빨리 응답을 기다리는 것을 중단할 수 있어요. 예를 들어 Claude에는 60초 타임아웃 창이 있어요. 질문이 타임아웃되면 날짜 범위를 좁히고, 세부 분류 수를 줄이거나, 분석을 더 작은 질문으로 분할해 보세요.

문제 해결

분석 도구를 사용할 수 없어요

AI 클라이언트에서 ask_analytics_question이 보이지 않으면, 계정에서 SQL이 활성화되어 있는지 확인하고 클라이언트의 Klaviyo 도구 목록을 새로고침해 주세요.

Claude에서:

1. 맞춤 설정 > 커넥터 > Klaviyo(으)로 이동해 주세요.
2. 오른쪽 상단에서 점 3개 메뉴를 여세요.
3. 도구 목록 새로고침을 클릭한 다음 질문을 다시 시도해 보세요.

SQL에서 계정에 있는 것으로 알고 있는 데이터를 반환하지 못해요

데이터 세트가 지원되는지 확인하고, 일반적으로 30분 지연이 발생할 수 있다는 점을 고려해 주세요. 연결에서 API 키를 사용한다면, 프로필, 세그먼트, 리스트, 캠페인, 카탈로그 또는 이벤트 등 관련된 모든 데이터 세트에 액세스할 수 있는지 확인해 주세요. Klaviyo에서 누락된 권한을 업데이트하고, 클라이언트의 Klaviyo 도구 목록을 새로고침한 다음, 질문을 다시 시도해 보세요.

OAuth 연결의 경우 클라이언트의 연결 가이드를 사용해 권한을 검토해 주세요.

질문 시간이 초과됩니다

더 짧은 날짜 범위를 선택하거나 세부 분류를 줄이거나, 질문을 더 작은 질문으로 분할해 보세요. 더 좁힌 질문으로 다시 시도한 다음, 후속 질문으로 결과를 확장해 보세요.

번호가 Klaviyo와 일치하지 않아요

데이터 세트, 날짜 범위, 필터를 포함해 SQL이 해당 숫자를 어떻게 계산했는지 확인해 보세요. 지표 정의와 데이터 최신성이 그 차이를 설명하는지 확인해 보세요. 차이가 크다면 Klaviyo 지원팀에 문의 하고 질문, 반환된 숫자, 기대했던 숫자를 공유해 주세요.

캠페인 컴포저가 질문을 거절합니다

특정 지표, 날짜 범위, 오디언스를 포함해 질문을 다시 작성해 주세요. 지원되는 데이터 세트 중 하나를 사용하고 있는지 확인한 다음 다시 시도해 주세요.

추가 자료

• 캠페인 컴포저 시작하기
• Klaviyo MCP 서버 개발자 문서
• Claude용 Klaviyo 앱 FAQ
• ChatGPT용 Klaviyo 앱 사용 방법
• 에이전시를 위한 Klaviyo MCP 서버 가이드
• Klaviyo에서 맞춤 보고서 시작하기