Magento 2.x(CE 및 EE) 시작하기

예상 11분 읽기

업데이트 2026년 2월 25일 오후 10:41 EST

클라비요를 Magento 2 CE 또는 EE 스토어와 통합하는 방법을 알아보세요. Magento에 클라비요 확장 프로그램을 설치하고, 확장 프로그램을 구성하고, OAuth를 설정한 다음 클라비요에서 통합을 활성화해야 합니다. 이 가이드에서는 모든 필수 통합 단계와 기록 데이터 동기화가 성공적으로 완료되었는지 확인하는 방법에 대해 설명합니다.

시작하기 전 안내 사항

2.4.0 이하의 Magento 2 버전은 지원되지 않습니다.

클라비요가 통합에 필요한 API 호출을 수행할 수 있도록 하려면 Magento 2 서버에 공개적으로 액세스할 수 있는 호스트 이름이 있어야 합니다. 로컬에서 호스팅되는 Magento 2 서버는 클라비요와 완전히 통합할 수 없습니다.

Klaviyo의 Magento 2 확장 프로그램을 컴포저를 통해 설치해야 합니다. Composer를 통해 설치하려면 Magento 2가 호스팅되는 서버에 대한 SSH 액세스 권한이 있는 IT 관리자가 필요합니다.

Magento 2에 클라비요 확장 프로그램 설치

Magento 2 서버에 로그인하고 명령줄 도구에서 Magento 앱의 루트 디렉터리로 이동합니다. 이 가이드에서는 터미널의 출력 예시를 보여드리지만, 원하는 명령줄 도구에 맞게 이 단계를 수정할 수 있습니다.
다음 명령을 실행하여 Packagist에서 클라비요 확장 프로그램의 최신 버전에 액세스하세요. Packagist는 최신 버전의 확장 프로그램을 쉽게 설치할 수 있는 PHP 코드 라이브러리 저장소입니다.
작곡가 필요 클라비요/마젠토2-익스텐션
다음 명령을 실행하여 방금 다운로드한 클라비요 확장 프로그램을 활성화하세요:
php bin/magento module:enable Klaviyo_Reclaim --clear-static-content
샘플 출력에 표시된 것처럼 이제 추가 모듈을 활성화해야 합니다. 다음 명령을 실행하여 활성화합니다:
php bin/magento setup:upgrade
출력에서 'Klaviyo_Reclaim' 모듈을 스캔하여 클라비요 모듈이 활성화되어 실행 중인지 확인합니다.
Magento 2 스토어의 CSS 및 JS가 계속 제대로 작동하도록 하려면 정적 콘텐츠 배포 명령을 실행해야 합니다.
php bin/magento setup:static-content:deploy -f
이제 브라우저에서 Magento 관리자 대시보드로 돌아갈 수 있습니다.

컴포저를 통한 설치가 완료되었습니다! 구성 지침은 다음 섹션으로 진행하세요.

클라비요 확장 프로그램 구성

사용법 비디오

클라비요 계정에서 API 키 탭으로 이동합니다.
새 탭에서 Magento 스토어 관리자로 이동합니다.
설정에서 스토어 > 구성을 클릭합니다.
클라비요 드롭다운에서 일반을 클릭합니다.
클라비요 확장 프로그램 사용을 예로 설정합니다.
API 키 탭에서 6자리 클라비요 공개 API 키를 복사하여 Magento의 해당 상자에 붙여넣습니다.
Klaviyo API 키 탭에서 새 개인 키를 생성한 다음 Magento의 해당 상자에 붙여넣습니다. 비공개 API 키로 인증하면 Magento에서 클라비요로 뉴스레터 구독을 동기화할 수 있습니다.

다음 섹션에서는 통합의 다른 측면을 활성화하는 OAuth를 설정합니다.

OAuth 설정

다음으로 OAuth 인증을 활성화하여 Klaviyo 계정을 Magento 2 확장자에 안전하게 연결합니다.

Magento에서 OAuth 설정 탭으로 이동합니다.
나중에 이 이름으로통합을 찾아야 하므로 기억하기 쉬운 이름을 지정하세요.
계속하려면 구성 저장을 클릭합니다.
왼쪽탐색 창에서 시스템을 찾은 다음 시스템트레이에서 연동을 선택합니다.
연동 이름을 찾아 활성화를클릭합니다. 연동을 활성화하면 액세스 승인을 요청하는 창이 열립니다.
허용을클릭하면 Klaviyo 로 리디렉션되어 연동 설정이 완료됩니다.
메시지가 표시되면 Klaviyo 에 로그인하거나 계정 이름이 올바른지 확인한 후 통합을 클릭합니다 . 그러면 설정에 사용한 API 키와 연결된 Klaviyo 계정에 Magento 2 연동이 추가됩니다. 여러 Klaviyo 계정에 로그인했는데 올바른 계정이 표시되지 않는 경우 다른 세션에서 로그아웃합니다.

창이 자동으로 닫히면 연결에 성공한 것입니다. 새 브라우저 탭이나 창에서 Klaviyo 계정을 열고 연동 탭을 선택한 다음 목록에서 Magento 2를 찾아서성공 여부를 확인할 수도 있습니다.

대신 다음 오류가 표시되는 경우 첫 번째 단계에서 사용한 API 키가 현재 로그인한 계정과 일치하는지 확인하세요.

Magento와 클라비요 간의 연결을 설정할 때 오류 목록이 대신 표시되면 각 오류를 클릭하여 원인에 대해 자세히 알아볼 수 있습니다.

뉴스레터 목록 설정

다음으로 뉴스레터 구독자를 동기화할 클라비요 목록을 선택합니다. 선택한 목록에 대해 클라비요 옵트인 설정 또는 마젠토 2 옵트인 설정을 사용할 수도 있습니다.

Magento에서 뉴스레터를 클릭합니다.
드롭다운에서 Magento 가입 양식을 동기화할 클라비요 목록을 선택합니다.
구성 저장을 클릭합니다.

뉴스레터 M2.png

결제 시 동의 사용 설정

다음으로 결제 시 이메일 및 SMS에 대한 동의를 사용하도록 선택할 수 있습니다.

결제 시 동의를 활성화하는 경우 결제 시 동의가 제대로 작동하려면 웹훅(아래)도 활성화해야 한다는 점에 유의하세요.

구성 페이지의 클라비요 아래에서 결제 시 동의로 이동합니다.
이메일 동의 및 SMS 동의를 수집하는 섹션이 표시됩니다. 이 두 가지는 별도로 처리되므로 이메일만 수집하거나 SMS만 수집하거나 둘 다 수집할 수 있습니다. SMS와 이메일 구독자를 모두 수집하는 경우 이메일과 다른 SMS 목록을 선택하세요. 이렇게 하면 동의가 항상 올바른 채널에 올바르게 귀속됩니다.
- 고객이 주문을 완료하고 이중 옵트인으로 인해 구독을 확인할 때까지 동의는 (이메일과 SMS 모두에 대해) 동기화되지 않습니다(해당되는 경우).
- Magento 2 스토어에 이미 로그인한 사용자의 경우 결제 시 기본적으로 이메일 동의 확인란이 표시되지 않습니다.
이메일 아래에서 결제 시 이메일 마케팅에 연락처를 구독하려면 예를 선택합니다 .
뉴스레터와 같이 구독자를 동기화할 이메일 목록을 선택합니다.
사용하려는 이메일 옵트인 확인란의 텍스트를 입력합니다.
SMS 아래에서 결제시 SMS 마케팅에 연락처를 구독하려면예를 선택합니다 .
SMS 연락처를 동기화할 목록을 선택합니다. 이러한 설정에 대한 자세한 내용은 결제 시 SMS 동의 수집가이드를 참조하세요.
정렬 순서를 사용하면 이메일 및 SMS 동의 상자의 배치를 변경할 수 있습니다. 기본적으로 이 상자는 첫 번째 이메일 입력란과 배송 전화번호 필드 아래에 각각 표시됩니다. 따라서 결제 페이지를 재정렬하지 않은 경우에는 정렬 순서를 변경할 필요가 없습니다. 레이아웃을 변경한 경우 그에 따라 정렬 순서를 조정합니다.
완료했으면 오른쪽 상단의 구성 저장을 클릭합니다.

웹훅 사용

다음으로 Magento 2 계정에서 클라비요 웹훅을 활성화합니다. 결제 시 동의가 제대로 작동하려면 웹훅을 사용하도록 설정해야 합니다.

관리자 대시보드에서 스토어 > 구성으로 이동합니다.
클라비요를 클릭하고 웹훅 탭을 선택합니다 .
웹후크 비밀번호를 생성하고 해당 웹후크 비밀번호 필드에입력합니다. 웹후크 비밀번호는 Klaviyo 에서 유효성 검사에 사용할 키입니다. 이 비밀은 무엇이든 선택할 수 있지만 안전한 문자와 숫자로 구성된 문자열을 생성하는 것이 좋습니다. Magento는 보안을 위해 별표로 웹후크 비밀을 숨기므로 올바르게 입력하도록 주의하세요.

멀티스토어 연동을 사용하는 경우 이 필드의 웹후크 비밀번호는 기본 구성에 입력해야 하며, 각 스토어 구성에 대해 동일한 비밀번호가 유효성 검사로 사용됩니다. 웹후크 비밀번호는 기본 구성에만 추가해야 하며 스토어별로 추가해서는 안 됩니다.
활성화하려는 웹후크 옆의 드롭다운에서 예를선택합니다. 클라비요에서 지원하는 웹후크에 대해 자세히 알아보려면 Magento 2용 웹후크 가이드를확인하세요.
구성 저장을 클릭합니다.

클라비요에서 Magento 2 통합 활성화하기

사용법 비디오

Klaviyo를 연 다음 왼쪽 탐색 메뉴에서 연동을 선택합니다. 리스트에서 Magento 2를 찾아 선택합니다.
다음 페이지에는 Klaviyo 목록에 새로운 Magento 2 고객을 추가할 수 있는 옵션이 있습니다. Klaviyo 목록에 새 Magento 2 고객 추가확인란을 클릭하고 드롭다운에서 목록을 선택합니다. 이 설정을 선택하면 선택한 목록에만 고객을 추가할 뿐 마케팅 메시지를 구독하지는 않습니다.

이 설정은 신규 고객만 동기화하며, 기존 고객은 Magento 목록에서 으로 수동으로 마이그레이션해야 Klaviyo 합니다.
다음으로 Magento 2에서 Klaviyo 에 동기화할 스토어 보기를 선택합니다. 모든 스토어 보기는 기본적으로 Klaviyo 에 동기화됩니다. 이 설정을 사용하면 통합할 스토어를 선택적으로 지정할 수 있습니다. Magento 2에서 다중 소스 인벤토리(MSI)를 사용하는 경우 특정 Magento 2 스토어 보기를 확인하고 동기화하려는 스토어를 선택하여 Klaviyo 에서 인벤토리가 제대로 표시되는지 확인하십시오.
고급에서 필요에 따라 다음 설정을 활성화합니다 :
- 특별 가격 설정
  이 설정은 특정 날짜 범위에서 선택적으로 적용될 수 있는 품목의 특별 판매 가격을 나타냅니다. 이 기능은 나중에 활성화하기가 더 어렵기 때문에 사용할 계획이라면 지금 활성화하는 것이 좋습니다. 해당되는 경우 제품 가격에 특별 가격 사용을 사용하도록 설정하면 제품 블록에 해당되는 경우 특별 가격이 표시됩니다. 동적 제품 피드를 사용하는 경우 전송 시간에 특별 가격이 채워집니다. 카탈로그에서 수동으로 품목을 선택하는 경우, 제품을 선택하면 특별 가격이 표시됩니다. 각 제품마다 동기화할 메타데이터 필드가 4개씩 있습니다:
  - 가격
    (필수, 부동) 아이템의 표준 가격입니다.
  - special_price
    (선택 사항, 부동) 아이템의 특별 판매 가격입니다. 이 가격이 적용되면 가격 옆에 취소선 옆에 특별_가격이 표시됩니다.
  - special_from_date
    (선택 사항, 날짜) 특별 가격이 적용될 시작 날짜를 지정합니다.
  - special_to_date
    (선택 사항, 날짜) 특별 가격 적용 종료 날짜를 지정합니다.
- 사용자 정의 미디어 루트 URL
  이 설정을 사용하면 사이트 이미지의 기본 경로를 변경할 수 있습니다. 웹사이트와 다른 URL에서 제품 이미지를 호스팅하는 경우 이 설정을 사용하도록 설정합니다.
저장을 클릭합니다.

이제 Magento 2 통합을 성공적으로 활성화했습니다! 데이터는 몇 분 안에 클라비요에 동기화되기 시작합니다.

초기 기록 데이터 동기화가 완료되면 Magento 2 통합은 30분마다 동기화됩니다.

Magento 2 통합과 동기화된 데이터

클라비요의 Magento 2 통합은 Magento 플랫폼에서 주요 고객 정보를 가져옵니다.

다음은 Magento에서 동기화하는 데이터 중 일부입니다:

이름, 성, 위치를 포함한 고객 정보.
구매한 품목, 품목 이미지, 품목 카테고리, 적용된 할인을 포함한 판매 및 주문 데이터입니다.
주문 처리, 환불 및 취소된 주문 데이터.
사람들이 웹사이트를 방문하는 시기와 그들이 보는 항목; 웹 추적은 확장 프로그램에서 처리합니다.

자세한 내용은 Magento 2 데이터 참조를 참조하세요.

Magento 주문 값을 단일 통화로 변환

Klaviyo Magento 의 모든 외화를 Klaviyo 에서 하나의 기본 통화로 전환할 수 있도록 지원합니다. 이 기능을 활성화하려면 고객 연락처 지원을 요청하세요. 서로 다른 통화로 거래하는 스토어가 여러 개 있는 경우 특히 유용합니다.

이 기능이 활성화된 경우:

마젠토가 주문 데이터를 클라비요에 동기화하면 전환이 이루어집니다.
클라비요는 주문_통화_코드가 설정된 글로벌_통화_코드와동일한지 확인합니다. 그렇지 않은 경우 클라비요는 재무 분석이 정확한지 확인하기 위해 주문 총액을 주문 통화에서 지정한 글로벌 통화로 변환합니다. 주문 품목은 주문 통화 코드에 그대로 유지되며 변환되지 않습니다.

확장 프로그램 업그레이드

Magento 2 확장 프로그램을 업그레이드하고 싶으신가요?Klaviyo 위의설치섹션에 설명된 지침에 따라 명령을 실행하여 최신 버전을 설치하세요. 이렇게 하면 현재 버전을 덮어쓰고 업데이트가 완료되므로 확장 프로그램을 다시 구성하거나 에서 연동을 다시 활성화할 필요가 Klaviyo 없습니다.

카탈로그 재동기화

언제든지 Magento 2 카탈로그의 전체 기록 재동기화를 요청할 수 있습니다. 카탈로그를 다시 동기화하면 Klaviyo 인벤토리 업데이트 및 이메일의 다른 버전 관련 기능을 활용하는 데 도움이 됩니다.

카탈로그를 다시 동기화하려면: