Shopware 시작하기

예상 5 읽은 시간(분)

업데이트 2025년 7월 29일 오후 7:04 EST

학습 내용

사이트 활동, 주문, 카탈로그 및 구독자 데이터를 클라비요로 가져오기 위해 Shopware 6과 통합하는 방법을 알아보세요.

시작하기 전 안내 사항

다음 사항을 주의해 주시기 바랍니다:

통합 전에 통합하려는 Klaviyo 계정에 로그인되어 있는지 확인하세요.
Shopware 6 연동은 Klaviyo 앱 마켓플레이스에 등록되어 있지 않습니다. 아래 단계는 통합 방법을 설명합니다.
Shopware 6 연동은 Klaviyo 을 통해 제3자 서비스를 통해 지원됩니다. 지원이 필요하신 경우, 아래 섹션에서 연락 방법에 대해확인해 주세요.

확장 프로그램 다운로드 및 설치

컴포저를 통해 설치하거나 Github에서 확장 프로그램을 다운로드한 다음 Shopware에 업로드하는 두 가지 방법 중 하나를 통해 설치할 수 있습니다.

컴포저를 통해 설치

컴포저를 통해 설치하는 경우 클라비요 확장 버전을 지정해야 하며, 모든 확장 프로그램이 모든 Shopware 버전에서 작동하는 것은 아닙니다.

6.4.4.0에서 6.4.20.2 사이의 Shopware 버전을 사용 중입니까? 다음 확장 버전으로 명령을 실행합니다:

composer require Klaviyo/shopware-Klaviyo:1.17.0

6.5.0.0에서 6.5.8.10 사이의 Shopware 버전을 사용 중입니까? 다음 확장 버전으로 명령을 실행합니다.

composer require Klaviyo/shopware-Klaviyo:2.19.0

Shopware 버전 6.6.0.0부터 6.7.0.0 사이를 사용하고 계신가요? 다음 확장 버전으로 명령을 실행합니다.

composer require Klaviyo/shopware-Klaviyo:3.4.2

Shopware 버전 6.7.0.0 이상을 사용하고 계신가요? 다음 확장 버전으로 명령을 실행합니다.

컴포스터는 Klaviyo/Shopware-Klaviyo: 4.0.0이 필요합니다.

업로드를 통한 설치

이 링크에서 Klaviyo 의 무료 확장 프로그램을 찾아 다운로드 버튼을 클릭합니다:
- Shopware 버전 6.4.4.0부터 6.4.20.2 사이를 사용 중이신가요? Klaviyo 확장 프로그램 버전 1.17.0을 다운로드하세요.
- Shopware 버전 6.5.0.0부터 6.5.8.10 사이를 사용하고 계신가요? Klaviyo 확장 프로그램 버전 2.19.0을 다운로드하세요.
- Shopware 버전 6.6.0.0부터 6.7.0.0 사이를 사용하고 계신가요? Klaviyo 확장 프로그램 버전 3.4.2를 다운로드하세요.
- Shopware 버전 6.7.0.0 이상을 사용 중이신가요? Klaviyo 확장 프로그램 버전 4.0.0을 다운로드하세요.
통합하려는 스토어의 Shopware 관리자에 로그인합니다.
확장 프로그램 > 내 확장 프로그램을 클릭합니다.
확장 프로그램 업로드를 클릭합니다.
파일에서 클라비요 확장자를 선택합니다.
확장 프로그램이 확장 프로그램 목록에 나타나면 설치를 클릭합니다.
클라비요 확장 프로그램을 켜고 끕니다.

Shopware에서 확장 프로그램 구성

Shopware 스토어 관리자에서 설정으로 이동하여 확장 탭을 클릭합니다.
클라비요를 선택합니다. 클라비요 확장 프로그램 설정 페이지로 이동합니다.
판매 채널 아래의 드롭다운에서 클라비요와 통합하려는 판매 채널을 선택합니다. Shopware 스토어당 하나의 판매 채널만 클라비요와 통합할 수 있습니다. 또한 각 판매 채널에 대한 설정을 개별적으로 구성해야 합니다.
상호 작용 설정에서 이 통합에 사용할 쿠키 동의 도구를 선택합니다. Klaviyo 쿠키를 수락하지 않는 방문자는 Klaviyo 에서 추적되지 않으며 Klaviyo 양식을 볼 수 없습니다. 쿠키 동의 도구 옵션은 다음과 같습니다:
- 아무것도 없음
  이 옵션을 선택하면 Klaviyo 스토어 쿠키에 무료로 액세스할 수 있습니다.
- Shopware 기본값
  이 옵션을 선택하면 Shopware가 켜져 있는 경우 기본 방법을 통해 쿠키 관리가 구현됩니다. 이 기능을 켜려면 설정 > 쇼핑 > 기본 정보에서 보안 및 개인정보 보호 섹션을 찾은 다음 기본 쿠키 알림 사용을 켜세요.
- 쿠키봇
  이 옵션을 선택하면 쿠키 관리가 쿠키봇에 의해 구현됩니다. 쿠키봇을 선택하려면 Shopware 스토어에 쿠키봇이 이미 설치되어 있어야 합니다.
- 동의 관리자
- 이 옵션을 선택하면 동의 관리자를 통해 동의 관리가 구현됩니다. 동의 관리자를 선택하려면 Shopware 스토어에 동의 관리자가 이미 설치되어 있어야 합니다.
- 사용자 중심 CMP
  이 옵션을 선택하면 Usercentrics CMP를 통해 동의 관리가 구현됩니다. Usercentrics CMP를 선택하려면 Shopware 스토어에 이미 설치되어 있어야 합니다.
쿠키 관리 도구를 사용하지 않고(이미 클라비요의 스크립트가 로드되는 것을 차단하고 있음) 페이지 로드 시간을 단축하려면 페이지와 첫 번째 상호 작용 후 클라비요 초기화 설정을 켜세요. 이렇게 하면 다음과 같은 동작이 활성화됩니다:
- 클라이언트가 페이지와 상호 작용을 시작하면 클라비요 스크립트가 초기화됩니다.
- 이후 페이지 전환 시 스크립트가 즉시 초기화됩니다.
계속하려면 클라비요에서 공개 및 비공개 API 키를 받으세요. 이렇게 하려면 새 탭을 열고 Shopware와 통합하려는 클라비요 계정에 로그인합니다.
1. 왼쪽 하단에서 계정 이름을 클릭하고 설정을 선택합니다.
2. API 키를 선택합니다.
3. 비공개 API 키 생성을 클릭합니다. 키에 이름을 지정한 다음 전체 액세스 키를 선택하고 만들기를 클릭합니다. 다음 페이지에서 키 복사를 클릭합니다.
4. 비공개 API 키를 Shopware 내의 해당 설정에 붙여넣습니다.
5. 클라비요로 돌아가서 완료를 클릭합니다. 그런 다음 페이지에서 공개 API 키를 복사합니다.
6. Shopware의 해당 상자에 공개 API 키를 붙여넣습니다.
다음으로, 추가할 Shopware 양식을 통해 구독하는 프로필에 대한 드롭다운에서 클라비요 목록을 선택합니다.
이월 재고 이형 상품 필드 매핑에 사용할 식별자를 선택합니다. 카탈로그에서 사용하는 식별자와 일치하는 식별자를 사용해야 합니다.
Shopware에서 클라비요로 동기화하려는 모든 메트릭을 토글합니다.
재입고 추적을 선택하면 재입고 팝업 열기 버튼, 팝업 닫기 버튼 및 구독 버튼의 텍스트 색상과 배경을 사용자 지정할 수 있습니다. 사각형을 클릭한 다음 선택기를 사용하여 색상을 선택하거나 브랜드 색상에 대한 16진수 색상 코드가 있는 경우 해당 상자에 붙여넣습니다.
스니펫 이름 아래에는 HTML에서 다양한 재고 있음 구성 요소를 참조하는 방법에 대한 참조가 있습니다. 사이트 코드 내에서 사용자 정의하도록 선택할 수 있습니다.
사용자 지정 필드 매핑: 여기에는 Shopware에서 설정한 사용자 지정 필드(기술 이름이 회색으로 표시됨)가 표시됩니다. 고객 개체에 할당된 모든 필드를 클라비요에 동기화할 수 있습니다. 이러한 사용자 지정 필드를 클라비요 프로필에 동기화하려면 개별 필드를 활성으로 전환합니다. 그런 다음 필드 이름 아래에 클라비요에서 필드에 사용할 해당 이름을 입력합니다.
완료했으면 저장을 클릭합니다.
과거 이벤트 동기화를 실행하려면 페이지 상단에서 과거 이벤트 동기화를 클릭합니다.
기존 구독자의 동기화를 실행하려면 페이지 상단에서 구독자 동기화를 클릭합니다.

처음에 이러한 동기화를 수동으로 실행한 후에는 앞으로 자동으로 실행됩니다. 구독자 및 거래 이벤트 동기화는 5분마다 실행됩니다. 현장 이벤트(사이트 내 활성, 제품 조회, 결제 시작)는 실시간으로 동기화됩니다.

카탈로그 피드 동기화

클라비요와의 통합을 완료하려면 제품 카탈로그의 피드를 생성한 다음 이를 클라비요와 동기화해야 합니다. 피드를 생성하려면

Shopware 스토어 관리자에 로그인합니다.
새 채널을 추가하려면 판매 채널 옆의 +를 클릭합니다.
제품 비교 옆의 판매 채널 추가를 클릭합니다.
템플릿에서 클라비요 XML을 선택합니다.
클라비요 내보내기 등의 채널 이름을 지정합니다.
세금 징수에서 라인별(가로) 계산을 선택합니다.
스토어 판매 채널 아래에 있습니다:
- 이 카탈로그의 스토어 판매 채널을 선택합니다.
- 스토어 프론트 도메인을 선택합니다.
- 통화를 선택합니다.
- 언어를 선택합니다.
- 고객 그룹을 선택합니다.
제품 내보내기 아래에서
- 파일 이름을 지정합니다(예: klaviyo.xml).
- 인코딩 UTF-8을 선택합니다.
- 파일 형식 XML을 선택합니다.
이형 상품을 개별 제품으로 내보내기는 꺼진 상태로 둡니다.
간격을 선택합니다: 1일.
스케줄러를 통한 생성은 꺼진 상태로 둡니다.
동적 제품 그룹을 선택합니다.
상태 아래에서 활성으로 전환합니다.
오른쪽 상단의 저장을 클릭합니다.
아래로 스크롤하여 클라비요 동기화에 사용할 내보내기 URL을 복사합니다.
이제 피드가 생성되었으므로 클라비요에 동기화해야 합니다. 지침에 따라 사용자 지정 카탈로그 피드를 클라비요에 동기화합니다.