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

예상 7분 읽기

업데이트 2026년 2월 25일 AM 12:00 EST

학습 내용

Klaviyo를 Magento 2 CE 또는 EE 스토어와 연동하는 방법을 알아보세요. Magento에서 Klaviyo 확장 프로그램을 설치하고, 확장 프로그램을 구성하고, OAuth를 설정한 다음, Klaviyo에서 연동을 활성화해야 합니다. 이 가이드에서는 모든 필수 연동 단계와 과거 데이터 동기화 성공을 확인하는 방법에 대해 설명합니다.

시작하기 전에 알아야 할 것

2.4.0 미만의 Magento 2 버전은 지원되지 않는다는 점에 유의하세요.

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

인증 및 구성 문제를 최소화하려면 방화벽 제공업체의 허용 목록에 Klaviyo IP를 추가하는 것이 좋습니다. 자세한 내용은 Klaviyo 연동 트래픽 IP 주소 허용 방법을 참조하세요.

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

Magento 2에 Klaviyo 확장 프로그램을 설치합니다.

Magento 2 서버에 로그인하고 명령줄 도구에서 Magento 앱의 루트 디렉터리로 이동합니다. 이 가이드에서는 Terminal용 출력 예를 보여주지만, 이러한 단계는 원하는 명령줄 도구에 맞게 수정할 수 있습니다.
Packagist에서 Klaviyo 확장의 최신 버전에 액세스하려면 다음 명령을 실행해 주세요. Packagist는 PHP 코드 라이브러리용 리포지토리로, 확장의 최신 버전을 쉽게 설치할 수 있도록 해줍니다.
composer require klaviyo/magento2-extension
방금 다운로드한 Klaviyo 확장 프로그램을 사용 설정하려면 다음 명령을 실행해 주세요:
php bin/magento module:enable Klaviyo_Reclaim --clear-static-content

샘플 출력에 표시된 대로 이제 추가 모듈을 모두 활성화해야 해요. 다음 명령을 실행해 활성화하세요:
php bin/magento setup:upgrade
출력에서 Module 'Klaviyo_Reclaim'을(를) 스캔해 Klaviyo 모듈이 활성화되어 실행 중인지 확인해 주세요.
Magento 2 스토어에서 CSS와 JS가 계속 제대로 작동하도록 하려면 정적 콘텐츠 배포 명령을 실행해야 해요.
php bin/magento setup:static-content:deploy -f

이제 브라우저에서 Magento 관리자 대시보드로 돌아갈 수 있습니다.

캠페인 컴포저를 통한 설치가 완료되었습니다! 다음 섹션으로 이동하여 구성 지침을 확인하세요.

Klaviyo 확장 프로그램을 구성합니다.

비디오 사용법

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

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

OAuth 설정

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

Magento의 OAuth 설정 탭 으로 이동합니다.
나중에 이 이름으로 찾아야 하므로 연동에 기억에 남는 이름을 지정하세요.
구성 저장 을 클릭하여 계속 진행합니다.

왼쪽 탐색 창 에서 시스템을 찾아 시스템 트레이에서 연동 을 선택합니다.
연동 이름을 찾아 활성화를 클릭합니다. 연동을 활성화하면 액세스 승인을 요청하는 창이 열립니다.

허용을 클릭하면 Klaviyo로 리디렉션되어 연동 설정을 완료할 수 있습니다.

메시지가 표시되면 Klaviyo에 로그인하거나 계정 이름이 올바른지 확인한 후 연동을 클릭합니다. 이렇게 하면 설정에 사용한 API 키와 연결된 Klaviyo 계정에 Magento 2 연동이 추가됩니다. 여러 Klaviyo 계정에 로그인했는데 올바른 계정이 표시되지 않는 경우 다른 세션에서 로그아웃하세요.

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

대신 다음 오류가 발생하면 첫 단계에서 사용된 API 키가 현재 로그인한 계정과 일치하는지 확인하세요.

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

뉴스레터 목록을 설정합니다.

다음으로, 뉴스레터 구독자를 동기화할 Klaviyo 목록을 선택합니다. 선택한 목록에 Klaviyo 옵트인 설정 또는 Magento 2 옵트인 설정을 사용할 수도 있습니다.

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

결제 시 동의를 활성화합니다.

다음으로 이메일 및 SMS 결제 시 동의를 활성화하도록 선택할 수 있습니다.

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

구성 페이지의 Klaviyo 아래에서 결제 시 동의 로 이동합니다.

이메일 동의 및 모바일(SMS/WhatsApp) 동의 수집 섹션이 표시됩니다. 이 두 가지는 별도로 처리되므로 이메일만 수집하거나 SMS/WhatsApp만 수집하거나 두 가지 모두 수집할 수 있습니다. SMS/WhatsApp 및 이메일 구독자를 모두 수집하는 경우 SMS/WhatsApp에 이메일과 다른 목록을 선택하세요. 이렇게 하면 동의가 항상 올바른 채널에 올바르게 기인하는지 확인할 수 있습니다.
- 고객이 주문을 완료하고 이중 옵트인으로 인해 해당되는 경우 구독을 확인할 때까지 동의(이메일 및 SMS/WhatsApp 모두)가 동기화되지 않습니다.
- Magento 2 스토어에 이미 로그인한 사용자의 경우 이메일 동의 확인란은 기본적으로 결제 시 표시되지 않습니다.
이메일에서 결제 시 연락처를 이메일 마케팅에 구독하려면 예를 선택합니다.
구독자를 동기화할 이메일 목록(예: 뉴스레터)을 선택합니다.
사용하려는 이메일 옵트인 확인란 텍스트를 입력합니다.

모바일에서 문자 메시지 수집 및 WhatsApp 구독자 에 대해 예를 선택합니다.
SMS/WhatsApp 연락처를 동기화할 목록을 선택하세요. 이 설정에 대한 추가 세부정보는 결제 시 SMS 및/또는 WhatsApp 동의 수집 가이드를 확인해 보세요.

채널, 구독자 리스트 및 동의 문자에 대한 옵션이 있는 문자 메시지 및 WhatsApp에 대한 동의를 수집하기 위한 모바일 설정 페이지입니다.

정렬 순서를 사용하면 이메일 및 SMS 동의 상자의 배치를 변경할 수 있습니다. 기본적으로 이러한 상자는 각각 첫 번째 이메일 입력란과 배송 전화번호 필드 아래에 표시됩니다. 따라서 결제 페이지를 다시 정렬하지 않은 경우에는 정렬 순서를 변경할 필요가 없습니다. 레이아웃을 변경한 경우 그에 따라 정렬 순서를 조정합니다.
완료되면 오른쪽 상단의 구성 저장 (Save Config)을 클릭합니다.

웹후크를 활성화합니다.

다음으로 Magento 2 계정에서 Klaviyo 웹후크를 활성화합니다. 결제 시 동의가 올바르게 작동하려면 웹후크를 활성화해야 한다는 점에 유의하세요.

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

다중 스토어 연동을 사용하는 경우 이 필드의 웹후크 비밀번호를 기본 구성에 입력해야 하며, 각 스토어 구성에 대해 동일한 비밀번호가 유효성 검사로 사용됩니다. 웹후크 비밀번호는 기본 구성에만 추가되어야 하며 스토어당 추가되어서는 안 됩니다.

활성화하려는 웹후크 옆에서 드롭다운에서 예를 선택해 주세요. Klaviyo에서 지원하는 웹후크에 대해 자세히 알아보려면 Magento 2용 웹후크 가이드를 확인해 보세요.
구성 저장 을 클릭합니다.

Klaviyo에서 Magento 2 연동을 활성화합니다.

비디오 사용법

Klaviyo를 연 다음 왼쪽 탐색 메뉴에서 연동을 선택합니다. 리스트에서 Magento 2를 찾아 선택합니다.
다음 페이지에서 새 Magento 2 고객을 Klaviyo 목록에 추가하는 옵션을 선택할 수 있어요. 체크박스를 클릭해 새 Magento 2 고객을 Klaviyo 목록에 추가를 선택하고 드롭다운에서 목록을 선택해 주세요. 이 설정을 체크하면 선택한 목록에만 고객이 추가되며, 마케팅 메시지를 구독하다 상태로 만들지는 않아요.

이 설정은 새 고객만 동기화해요. 기존 고객은 Magento 목록에서 Klaviyo로 수동으로 마이그레이션해야 해요.

데이터 동기화, 스토어 보기 및 고급 기능 옵션이 포함된 Magento 2 및 Klaviyo 연동 설정 페이지입니다.

다음으로 Magento 2에서 Klaviyo에 동기화할 스토어 보기를 선택합니다. 모든 스토어 조회수는 기본적으로 Klaviyo에 동기화됩니다. 이 설정을 통해 어떤 스토어와 연동할지 선택할 수 있습니다. Magento 2에서 다중 출처 재고(MSI)를 사용하는 경우 특정 Magento 2 스토어 보기 를 확인하고 동기화할 스토어를 선택하여 Klaviyo에 재고가 제대로 표시되는지 확인합니다.
고급에서 필요에 따라 다음 설정을 활성화합니다.
- 특별 가격 설정
  이 설정은 특정 날짜 범위에서 선택적으로 적용될 수 있는 품목의 특별 판매 가격을 나타냅니다. 나중에 활성화하기가 더 어렵기 때문에 이 기능을 사용하려는 경우 활성화하는 것이 좋습니다. 해당되는 경우 제품 가격에 특가 사용을 활성화하면 해당 시 제품 블록에 특가가 표시됩니다. 동적 제품 피드를 사용하는 경우 전송 시점에 특별 가격이 채워집니다. 카탈로그에서 품목을 수동으로 선택하면 제품을 선택하면 특별 가격이 채워집니다. 제품마다 동기화할 4개의 메타데이터 필드가 있습니다.
  - 가격
    (필수, 플로트) 품목의 표준 가격입니다.
  - special_price
    (선택 사항, 플로트) 해당 품목의 특별 판매 가격입니다. 이 가격이 적용되면 가격 할인 옆에 이 special_price가 표시됩니다.
  - special_from_date
    (선택 사항, 날짜) 이렇게 하면 special_price가 적용되는 시작 날짜가 지정됩니다.
  - special_to_date
    (선택 사항, 날짜) 이렇게 하면 적용 중인 special_price의 종료 날짜가 지정됩니다.
- 사용자 정의 미디어 루트 URL
  이 설정을 통해 사이트 이미지의 기본 경로를 변경할 수 있습니다. 웹사이트와 다른 URL에서 제품 이미지를 호스팅하는 경우 이 설정을 활성화합니다.
- 정기 주문 동기화를 최근 주문으로 제한합니다.
  정기 주문 동기화는 이전 정기 동기화 이후 업데이트된 주문을 식별하여 다음 동기화에 포함합니다. 이 설정을 사용하면 주문이 생성된 시점을 기준으로 정기 주문 동기화에 적합한 주문을 제한할 수 있습니다. 활성화하면 상대 날짜 범위를 선택할 수 있으며 해당 기간 내에 생성된 업데이트된 주문만 다음 정기 주문 동기화에 포함됩니다. 이렇게 하면 해당 주문에 의미가 없는 업데이트가 발생할 때 정기 동기화 중에 이전 주문이 다시 인출되는 것을 방지할 수 있습니다.
저장을 클릭합니다.

이제 Magento 2 연동을 성공적으로 활성화했습니다! 몇 분 안에 데이터가 Klaviyo에 동기화되기 시작합니다.

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

Magento 2 연동과 동기화된 데이터입니다.

Klaviyo의 Magento 2 연동은 Magento 플랫폼에서 주요 고객 정보를 가져옵니다.

다음은 Magento에서 동기화한 데이터의 일부입니다.

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

자세히 알아보려면 Magento 2 데이터 참조 자료로 이동해 주세요.

Magento 주문 값을 단일 통화로 변환합니다.

Klaviyo는 Magento의 모든 외화에 대해 Klaviyo의 1개 기본 통화로의 전환을 지원해요. 이 기능을 사용 설정하려면 지원 팀에 문의하세요. 여러 스토어에서 서로 다른 통화로 거래가 발생하는 경우 특히 유용해요.

이 기능을 활성화하면 다음과 같이 됩니다.

전환은 Magento가 주문 데이터를 Klaviyo에 동기화할 때 발생합니다.
Klaviyo는 order_currency _code가 set global_currency_code와 동일한지 확인합니다. 그렇지 않은 경우 Klaviyo는 주문 총액을 주문 통화에서 지정된 글로벌 통화로 변환하여 재무 분석이 정확한지 확인합니다. 주문 라인 항목은 주문 통화 코드로 유지되며 변환되지 않는다는 점에 유의하세요.

확장 프로그램을 업그레이드하세요.

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