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

학습 내용

학습 내용

Magento 1과 통합하는 방법을 알아보세요. 클라비요는 마젠토 1 CE 및 마젠토 1 EE와 모두 통합됩니다. 현재 Magento 버전 1.5 이상을 지원합니다.

Magento 1과 클라비요를 통합하는 데는 크게 두 가지 단계가 있습니다:

1. 클라비요에서 마젠토 통합 활성화하기.
2. Magento에 클라비요 확장 설치하기.

이 가이드에서는 Magento 1 스토어에 대한 단계와 관련 작업을 모두 다룹니다.

Magento API 자격 증명 설정

Magento API 자격 증명 설정

Magento 1.x와 Klaviyo를 통합하려면 전체 리소스 액세스 권한이 있는 새 역할을 생성하고 이 역할에 새 사용자를 할당해야 합니다. 이 사용자의 사용자 아이디와 비밀번호가 API 자격 증명으로 사용됩니다.

Magento 관리자 패널에서 시스템 탭을 클릭하고 웹 서비스 > SOAP/XML-RPC-Roles를 선택합니다.

새 역할 추가를 선택합니다.그런 다음 역할 리소스 탭을 클릭하고 리소스 액세스를 모두로 설정합니다.

역할 정보 탭을 선택하고 역할 이름을 "클라비요," 로 지정한 다음 역할 저장을 클릭합니다.

시스템 탭을 클릭하고 웹 서비스 > SOAP/XML-RPC-Users를 선택합니다.

새 사용자 추가를 선택합니다.

사용자 역할 탭을 클릭하고 역할을 클라비요로 설정합니다.

사용자 정보 탭을 클릭합니다. 사용자 이름을 "klaviyo" 로 설정하고 강력한 API 키를 입력합니다. 영숫자 값을 입력할 수 있습니다. 사용자 이름과 API 키를 저장하면 클라비요에서 Magento 1 통합을 활성화할 때 사용할 수 있습니다. 나머지 정보를 입력하고 사용자 저장을 클릭합니다.

API 성능

API 성능

통합 성능을 향상시키려면 두 가지 Magento 웹 서비스 구성 설정에 캐싱을 사용하도록 설정하는 것이 좋습니다.

Magento 관리자 패널에서 시스템 > 캐시 관리를 클릭합니다.

두 웹 서비스 구성 설정에서 캐싱을 사용 설정합니다.

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

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

생성한 Magento API 키를 사용하여 클라비요에서 Magento 1 통합을 활성화합니다.

Klaviyo 계정에 로그인하고 왼쪽 아래 모서리에 있는 계정 이름을 클릭합니다. 그런 다음 연동 > 연동 추가를 선택하고 Magento 을 검색합니다. Magento 카드를 클릭한 다음 설치를 클릭합니다.

다음 정보를 입력합니다:

• 사이트URL
  사이트 URL은 Magento 인스턴스의 주소입니다.
• API 사용자아이디
  API 권한이 있는 새 사용자에 대해 생성한 사용자 아이디입니다.
• 비밀번호 / API 키
  새 사용자를 위해 생성한 API 키입니다.

이제 Magento에 연결을 클릭합니다. 다음과 같은 고급 옵션이 표시되며 필요에 따라 해당 옵션을 활성화해야 합니다:

• 스토어
  모든 Magento 1 스토어는 기본적으로 클라비요에 동기화됩니다. 이 설정을 사용하면 통합할 스토어를 선택적으로 지정할 수 있습니다. 자세한 내용은 여러 Magento 스토어 지원으로 이동하세요. 
• 특별 가격 설정
  이 기능을 사용하려는 경우 특별 가격 설정을 활성화하는 것이 좋습니다. 나중에 이 기능을 활성화하는 것은 더 어렵습니다. 이 설정에 대한 자세한 내용은 아래특별가 섹션에서확인할 수 있습니다 .
• 쿠폰 설정
  Magento 1에서 쿠폰을 활성화하는 방법에 대한 이 가이드를 검토한 다음 이 필드를 채우세요.

완료되면 설정 완료를 클릭합니다.

마젠토 1이 이제 클라비요에 연결되었습니다. 다음으로 Magento 계정에 클라비요 확장/플러그인을 추가합니다.

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

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

클라비요 확장 프로그램은 Magento 스토어에 사이트 내 활성 및 조회된 제품 추적 기능을 추가합니다. 결제 시작 이벤트 동기화를 시작하려면 Magento용 클라비요 확장 프로그램도 설치해야 합니다. 결제 시작 이벤트를 동기화하여 중단된 카트 플로우를 트리거할 수 있도록 하는 것이 중요합니다.

Klaviyo의 최신 확장 Magento 버전은Magento 1 v1.9.0, 2024년 10월 업데이트: 1 v1.9.0 확장 다운로드입니다.

확장 프로그램을 컴퓨터에 다운로드한 후 시스템 > Magento Connect > Magento Connect Manager로 이동합니다.

직접 패키지 파일 업로드에서 파일 선택을 클릭하고 위에서 다운로드한 확장자를 선택합니다. 업로드를 클릭합니다. 확장 프로그램이 업로드되고 설치됩니다.

확장 프로그램을 설치한 후 확장 프로그램의 페이지로 이동하여 설정을 구성합니다.
시스템 > 구성을 클릭한 다음 고객 섹션에서 클라비요를 클릭합니다. 클라비요를 클릭한 후 404 메시지가 표시되면 Magento에서 로그아웃했다가 다시 로그인하세요.

사용을 예로 설정하고 다른 필드를 채웁니다. 소비자 키, 소비자 비밀, 인증 토큰, 인증 비밀은 마젠토에서 쿠폰을 설정하지 않는 한 모두 비워 둘 수 있습니다.

Magento 가입 양식을 클라비요 목록에 동기화하기

Magento 가입 양식을 클라비요 목록에 동기화하기

선택적으로 Magento 가입 양식을 동기화하여 사용자가 클라비요 목록에 추가되도록 할 수 있습니다.

먼저 클라비요에서 Magento 가입 양식과 동기화할 목록을 생성합니다.

이전 섹션의 안내에 따라 일반 설정 탭을 아직 사용하지 않은 경우 시스템 > 구성으로 이동한 다음 고객 섹션 아래에서 클라비요를 클릭합니다.

일반 구독 목록 드롭다운에서 동기화하려는 클라비요 목록을 선택합니다.

기본적으로 이 목록에 클라비요 옵트인 설정 사용은 예, 이 목록에 클라비요 설정 사용으로 설정되어 있습니다. 이 설정을 활성화하는 것이 좋습니다. 이 설정이 활성화된 경우:

• 이중 옵트인 목록의 경우: 사용자가 지정된 목록에 추가되기 전에 확인 이메일을 받게 됩니다. 이메일을 통해 확인하면 목록에 추가되고 목록 구독 메트릭이 생성됩니다. 확인을 받지 못하면 목록에 추가되지 않습니다.
• 단일 옵트인 목록의 경우: 고객이 목록에 추가되고 목록에 대한 구독 메트릭이 생성됩니다.

클라비요에서 옵트인 이메일을 보내지 않음을 사용 설정한 경우 프로필이 리스트에 추가될 때 리스트에 구독함 메트릭이 생성되지 않습니다. 이 설정은 권장하지 않지만 레거시 설정을 보존하기 위해 사용할 수 있습니다.

Magento 크론 작업 설정

Magento 크론 작업 설정

클라비요 확장 프로그램은 크론 작업을 사용하여 최신 상태를 유지하고 정기적인 유지 관리 작업을 실행합니다.

Magento 관리자 패널에서 시스템 > 구성으로 이동합니다.

고급 섹션까지 아래로 스크롤하여 시스템을 선택합니다.

그런 다음 Cron(예약된 작업 )을 선택합니다.5분마다 실행되도록 Cron을 설정한 다음 구성 저장을 클릭합니다.

Magento 크론 작업 설정에 대한 자세한 내용은 Magento 문서에서 크론 작업 설정에 대한 자세한 정보를 참조하세요.

UNIX 기반 운영 체제에서 크론 설정하기

UNIX 기반 운영 체제에서 크론 설정하기

서버에 대한 셸 액세스 권한이 있는 경우 crontab 서비스 명령을 사용할 수 있습니다. Magento 크론은 5분마다 실행되어야 하므로 시간 구성은 다음과 같습니다:

*/5 * * * *

크론탭의 전체 줄은 이 중 하나처럼 보일 것입니다(첫 번째 버전을 권장합니다):

*/5 * * * * /bin/sh MAGENTO_PATH/cron.sh
*/5 * * * * /bin/bash MAGENTO_PATH/cron.sh
*/5 * * * * /usr/bin/php MAGENTO_PATH/cron.php
*/5 * * * * /usr/local/bin/php -f MAGENTO_PATH/cron.php

여기서 MAGENTO_PATH는 서버에 Magento를 설치한 위치입니다.

cPanel(또는 가상 호스팅 제공업체)을 사용하여 크론 설정하기

cPanel(또는 가상 호스팅 제공업체)을 사용하여 크론 설정하기

셸 액세스 권한이 없는 경우 가상 호스팅 제공업체의 설명서를 참조하세요. 아래에서 cPannel 사용을 예로 들어 설명합니다.

호스팅 계정의 cPanel에 로그인합니다. 고급 섹션을 찾아 "크론 채용" 아이콘을 클릭합니다.

현재 크론 작업 목록이 새 작업을 추가할 수 있는 양식과 함께 표시됩니다. "새 Cron 작업 추가" 양식에 다음 설정을 입력합니다. MAGENTO_PATH를 Magento 설치 경로로 바꾸어야 합니다. 경로가 무엇인지 또는 경로를 찾는 방법을 잘 모르는 경우 FTP 프로그램을 사용하여 서버의 파일을 탐색하고 cron.sh 파일이 들어 있는 디렉터리를 찾을 수 있습니다.

새 크론 작업을 추가하면 15분 이내에 클라비요에서 결제 데이터를 확인할 수 있습니다.

기록 데이터 동기화 모니터링

기록 데이터 동기화 모니터링

Magento 1과 처음 통합할 때, 클라비요는 지난 90일 동안의 Magento 1 데이터를 동기화하여 가장 최근의 고객 참여를 바로 시작할 수 있도록 지원합니다. 가장 최근 90일간의 데이터를 동기화하면 클라비요가 전체 과거 데이터 동기화를 시작합니다. 스토어에 있는 주문, 고객 및 제품 수에 따라 모든 데이터를 동기화하는 데 몇 분에서 며칠까지 걸릴 수 있습니다.

이 기록 동기화가 완료되면 30분마다 새로운 데이터가 클라비요에 동기화됩니다. 초기 동기화 진행 상황을 확인하려면 사이드바에서 애널리틱스 탭을 클릭합니다.

주문 완료 메트릭을 찾아 그래프의 날짜 범위를 변경하여 완전히 동기화된 날짜를 확인합니다. 동기화가 완료되면 통합 탭( )의 Magento 1 통합이 완료됨으로 표시됩니다. Magento 1의 모든 데이터가 동기화되었는지 직접 확인하려는 경우 며칠 또는 일주일 동안의 총 주문을 교차 확인할 수 있습니다. 유효성 검사를 시작하기 전에 계정의 표준 시간대가 Magento 1의 설정과 일치하는지 확인하세요.

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

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

클라비요의 Magento 통합을 통해 Magento 플랫폼에서 특정 고객 정보를 가져와 클라비요에서 데이터 기반 타겟팅 이메일을 보낼 수 있습니다. 통합을 구성하고 나면 고객 구매 및 웹사이트 활동을 기반으로 이메일을 개인화하고 타겟팅할 수 있습니다. 다음은 Magento에서 동기화하는 데이터 중 일부입니다:

• 이름, 성, 위치를 포함한 고객 정보.
• 클라비요는 앞으로 Magento 뉴스레터 목록을 구독하는 모든 고객을 동기화합니다. Magento 뉴스레터 목록에 포함된 모든 고객이 마케팅 이메일 수신에 동의했는지 확인하는 것이 중요합니다.
• 주문 처리, 환불 및 취소된 주문 데이터.
• 사람들이 언제 웹사이트를 방문하고 어떤 항목과 카테고리를 보는지 파악합니다.
  • 이러한 지표는 계정에 사이트 활성 및 조회된 제품으로 표시됩니다.
  • 이러한 메트릭은 이미 확장 프로그램에서 처리하므로 Magento 통합을 통해 클라비요 추적 스니펫을 사이트에 추가할 필요가 없습니다 .

자세히 알아보려면 Magento 1 데이터 검토 및 이해로 이동하세요.

제한된 권한으로 API 키 만들기

제한된 권한으로 API 키 만들기

이 문서는 클라비요 통합의 기반이 되는 Magento SOAP API에 대해 설명합니다. API/* 경로 내의 모든 엔드포인트에 대한 액세스 권한을 부여하는 것이 좋습니다. 다양한 1.x 버전에서 권한이 변경되었기 때문에 SOAP 사용자 및 역할을 설정할 때 표시되는 권한과 직접적으로 동일하지는 않지만, 다음은 Magento 1.x에 대해 수행하는 API 호출입니다:

• 카탈로그 카테고리 트리
• 카탈로그인벤토리 재고 항목 목록
• 카탈로그 제품 속성 정보
• 카탈로그 제품 속성 미디어 목록
• 카탈로그 제품 정보
• 카탈로그 제품 목록
• 카탈로그 제품 태그 목록
• 고객고객정보
• 고객고객 목록
• 고객 그룹 목록
• 판매 주문 정보
• 판매 주문 목록
• 쇼핑 카트 정보
• storeList

특정 포트를 허용 목록에 추가해야 하는 경우(예: 방화벽이 있는 경우) Magento 연동은 현재 HTTP/80을 사용하지만 443에서 사용할 수 있는 경우 이를 변경할 수 있습니다.

특별 가격

특별 가격

연동 설정을 구성할 때 특정 날짜 범위에서 선택적으로 적용될 수 있는 아이템의 특별 판매 가격을 의미하는 "특별 가격(" )을 가져올 수 있는 옵션이 제공됩니다. 각 제품마다 동기화할 메타데이터 필드가 4개씩 있습니다:

• 가격 (필수 부동 소수점): 아이템의 표준 가격
• special_price (선택 사항): 아이템의 특별 판매 가격입니다. 이 가격이 적용되면 가격 옆에 취소선 옆에 특별_가격이표시됩니다.
• special_from_date (선택적 날짜): 특별 가격이 적용될 시작 날짜를 지정합니다.
• special_to_date (선택적 날짜): 특별 가격 적용 종료 날짜를 지정합니다.

Magento 1 통합 설정 페이지에는  해당되는 경우 제품 가격에 특별가 사용( ) 확인란이 있습니다. 이 설정을 활성화하면 해당되는 경우 제품 블록에 특별 가격이 표시됩니다. 동적 제품 피드를 사용하는 경우 전송 시점에 특별 가격이 채워집니다. 카탈로그에서 수동으로 품목을 선택하는 경우, 제품을 선택하면 특별 가격이 표시됩니다.

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

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

클라비요는 마젠토의 모든 외화를 클라비요에서 하나의 기본 통화로 변환할 수 있도록 지원합니다. 이 기능을 사용하도록 설정하면 Magento가 주문 데이터를 클라비요에 동기화할 때 전환이 이루어집니다. 서로 다른 통화로 거래하는 스토어가 여러 개 있는 경우 특히 유용합니다.

클라비요는 주문_통화_코드가 설정된 글로벌_통화_코드와 동일한지 확인합니다. 그렇지 않은 경우 클라비요는 주문 총액을 주문 통화에서 연동 설정에 지정된 글로벌 통화로 변환합니다. 이렇게 하면 재무 분석이 정확해집니다.

확장 프로그램 업그레이드

확장 프로그램 업그레이드

1.8.3 이하의 Magento 확장 버전을 사용 중이신가요? 즉시 1.8.3 버전으로 업그레이드하는 것이 좋습니다. 이전 버전의 확장 프로그램은 Klaviyo의 v1 및 v2 API를 사용하며, 이는 폐기되어 더 이상 예상대로 작동하지 않습니다. 

확장 프로그램을 업그레이드하려면 기존 확장 프로그램을 제거한 다음 이 가이드에 포함된 단계에 따라 다시 설치하세요. 여기에서 1.8.3 버전을 다운로드할 수 있습니다: Magento 1 v1.8.3 확장 다운로드.