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

학습 내용

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

시작하기 전 안내 사항

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

클라비요 확장 버전 찾기

표의 모든 버전 범위에는 모든 버전이 포함되어 있습니다. 모든 확장 프로그램은 컴포저를 통해 설치할 수 있습니다. 

설치 프로세스는 사용 중인 Magento 2 버전에 따라 다릅니다. 

Magento 2 버전 2.4.0 이상을 사용하는 경우 아래의 작성기로 설치에 설명된 지침을 따르세요.

2.4.0 이하의 Magento 2 버전을 사용하는 경우: 이전 버전의 확장 프로그램과 새로운 API 간의 호환성을 제공하기 위한 패치를 릴리스했습니다. 위의 표에 Github 링크가 제공되며, Packagist/Composer를 통해서도 설치할 수 있습니다. 현재 확장 프로그램을 설치하는 데 사용하는 방법을 통해 설치해야 합니다(컴포저인 경우 아래의 컴포저로 설치하기 섹션을 따르세요). Magento 2 버전 2.2.0을 사용하는 경우에는 설치 후 수동으로 OAuth를 사용하도록 설정해야 합니다.

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

사용법 비디오

컴포저로 설치

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

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

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

사용법 비디오

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

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

OAuth 설정

다음으로 OAuth 인증을 사용하도록 설정하여 클라비요 계정을 Magento 2 확장 프로그램에 안전하게 연결합니다. 기존 연동 서비스를 사용 중이며 OAuth를 추가해야 하는 사용자를 위한 별도의 가이드가 마련되어 있습니다. Magento 2 버전 2.2.0을 사용하는 경우 통합을 위해 OAuth를 수동으로 활성화하는 방법에 대한 가이드를 참조하세요. 

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

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

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

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

뉴스레터 목록 설정

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

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

결제 시 동의 사용 설정

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

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

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

웹훅 사용

1. 관리자 대시보드에서 스토어 > 구성으로 이동합니다.
2. 클라비요를 클릭하고 웹훅 탭을 선택합니다 . 
3. 웹훅 비밀을 생성하고 해당 웹훅 비밀 필드에 입력합니다. 웹훅 비밀은 클라비요가 유효성 검사에 사용할 키입니다. 이 비밀은 무엇이든 선택할 수 있지만 안전한 문자와 숫자로 구성된 문자열을 생성하는 것이 좋습니다. Magento는 보안을 위해 별표로 웹후크 비밀을 숨기므로 올바르게 입력하도록 주의하세요.
   
   멀티스토어 통합을 사용하는 경우 이 필드의 웹훅 비밀번호는 기본 구성에 입력해야 하며, 각 스토어 구성에 대해 동일한 비밀번호가 유효성 검사로 사용됩니다. 웹훅 비밀번호는 기본 구성에만 추가해야 하며 스토어별로 추가해서는 안 됩니다.
4. 활성화하려는 웹후크 옆의 드롭다운에서 예를선택합니다. 클라비요에서 지원하는 웹후크에 대해 자세히 알아보려면 Magento 2용 웹후크 가이드를확인하세요.
5. 구성 저장을 클릭합니다.

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

사용법 비디오

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

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

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

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

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

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

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

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

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

클라비요는 Magento의 모든 외화를 클라비요의 기본 통화로 변환하는 기능을 지원합니다. 이 기능을 사용하려면 지원팀에 문의하세요. 서로 다른 통화로 거래하는 스토어가 여러 개 있는 경우 특히 유용합니다.

이 기능이 활성화된 경우:

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

확장 프로그램 업그레이드

아래 표를 참조하세요. Magento 2 버전에 지정된 버전보다 낮은 확장 버전을 사용 중이신가요? 그렇다면 즉시 확장 프로그램을 업그레이드하는 것이 좋습니다. 특정 이전 버전의 확장 프로그램은 Klaviyo의 v1 및 v2 API를 사용하며, 이는 폐기되어 더 이상 예상대로 작동하지 않습니다. 표에 링크된 Magento 2의 이전 버전에서 고객사를 지원하기 위해 특정 패치 버전을 제공합니다.

먼저 아래 표를 사용하여 업그레이드해야 할 확장 프로그램 버전을 결정하세요. 

표의 모든 버전 범위에는 모든 버전이 포함되어 있습니다. 모든 확장 프로그램은 컴포저를 통해 설치할 수 있습니다. 

업그레이드할 버전을 결정했으니 이제 업그레이드할 차례입니다. 업그레이드 프로세스는 사용 중인 Magento 2 버전에 따라 다릅니다. 

Magento 2 버전 2.4.0 이상을 사용하는 경우 위의 컴포저로 설치에 설명된 지침에 따라 명령을 실행하여 최신 버전을 설치합니다. 이렇게 하면 현재 버전을 덮어쓰고 업데이트가 완료되며, 클라비요에서 확장 프로그램을 다시 구성하거나 통합을 다시 활성화할 필요가 없습니다.

2.4.0 이하의 Magento 2 버전을 사용하는 경우: 이전 버전의 확장 프로그램과 새로운 API 간의 호환성을 제공하기 위한 패치를 릴리스했습니다. 깃허브 링크는 위 표에서 확인할 수 있으며, Packagist/Composer를 통해서도 설치할 수 있습니다. 현재 확장 프로그램을 설치하는 데 사용하는 방법을 통해 설치해야 합니다(컴포저인 경우 위의 컴포저로 설치하기 섹션을 따르세요).

추가 리소스

• 마젠토 2 데이터 참조
• Magento 2에서 결제 시 SMS 동의를 수집하는 방법
• 클라비요 커뮤니티: 마젠토 2 "무엇이든 물어보세요" 질문과 답변 비디오