Magento 1.x용 쿠폰 설정 방법
Klaviyo의 Magento 1 연동은 더 이상 신규 설치를 받지 않으며, 2027년 말에 완전 지원 종료에 도달할 예정이에요. Klaviyo 지원팀은 더 이상 Magento 1 관련 요청을 지원할 수 없어요.
학습 내용
Magento는 고객 주문에 할인을 적용하는 데 사용할 수 있는 장바구니 가격 규칙을 지원해요. 기존 가격 규칙에 대해 쿠폰 코드를 만들 수 있으므로, 쇼핑객이 결제 과정에서 특정 코드를 쉽게 사용해 할인을 적용할 수 있어요.
Klaviyo의 Magento용 쿠폰 기능을 사용하면 Magento 1.0 스토어에서 다음을 수행할 수 있어요:
- Magento의 기존 가격 규칙과 연결된 새 쿠폰을 Klaviyo에서 생성하세요.
- 플로우 이메일에 고유 쿠폰을 포함하면 각 수신자가 고유한 코드를 받게 돼요.
이 가이드는 Klaviyo에서 Magento 쿠폰을 설정하는 방법을 설명해 드릴게요.
캠페인 이메일을 발송할 때는 현재 고유 쿠폰 코드을 사용할 수 없어요. 캠페인에서 고유 쿠폰 코드를 전송하려면 초당 수천 개의 코드를 생성해야 합니다. Klaviyo는 이 정도의 규모와 속도에서 특정 Magento 서버의 속도 제한 설정이 고유 쿠폰 생성에 영향을 주지 않는다고 보장할 수 없어요. 따라서 고유 쿠폰은 플로우 이메일을 발송할 때만 사용할 수 있어요.
요구 사항
사전 준비 사항으로, Klaviyo에서 Magento 연동을 활성화하고 Magento에 Klaviyo 확장 프로그램을 설치했는지 확인해 주세요.
REST API를 활성화
먼저 새 REST 역할을 만들고 전체 액세스 권한을 부여해 REST API를 활성화한 다음, 해당 역할을 관리자 사용자 중 한 명에게 할당해 주세요.
- System > Web Services > REST - Roles를 클릭해 주세요.
- 새 관리자 역할을 만드세요. 역할 이름 필드에 예를 들어 “관리자”와 같은 이름을 입력하세요.
- 왼쪽에서 Role API Resources 탭을 클릭하세요. Resource Access를 All로 설정한 다음 Save Role을 클릭하세요.
- 다음으로 System > Web Services > REST - Attributes로 이동하세요.
- 사용자 유형 목록에서 관리자를 선택하세요.
- 리소스 액세스를 전체로 설정하고 저장을 클릭하세요.
- 다음으로 System > Permissions > Users로 이동하세요.
- 목록에서 관리자 사용자를 선택한 다음 사용자 편집을 클릭해 주세요.
- 왼쪽 사이드바에서 REST 역할 탭을 클릭하세요.
- 라디오 버튼을 클릭해 사용자에게 새 REST 관리자 역할을 할당하세요.
- 사용자 저장을 클릭해 주세요.
이제 Magento 스토어에 대해 REST API를 활성화했어요.
REST API가 올바르게 구성되어 있는지 확실하지 않다면 Magento 1x용 쿠폰 문제 해결 리소스에 설명된 단계를 검토해 주세요.
Magento에서 REST 자격 증명 생성
Klaviyo의 Magento 쿠폰 기능을 활성화하려면, 먼저 방금 만든 REST 관리자 계정을 사용해 Magento 스토어에서 REST API 자격 증명을 생성한 다음 이를 Klaviyo 계정에 붙여넣으세요.
- 위의 REST API 활성화 섹션에서 생성한 REST 관리자 사용자로 로그인하세요.
- System > Configuration 을 클릭한 다음 Customers 섹션에서 Klaviyo 를 클릭하세요.
- OAuth 토큰 생성을 클릭하세요.
Consumer Key, Consumer Secret, Authorization Token 및 Authorization Secret이 채워져요. 다음 단계에서 이 값을 Klaviyo 계정에 복사/붙여넣기할 거예요.
Klaviyo에서 Magento 쿠폰 설정하기
- Klaviyo 계정에서 Magento 연동으로 이동하세요.
- 고급 옵션 화살표를 클릭하여 쿠폰 설정을 펼치세요.
- 위에서 만든 REST 자격 증명을 붙여넣으세요.
Magento 서버는 OAuth 인증을 위한 HMAC-SHA1 서명을 지원해야 해요.
- Magento 설정 업데이트를 클릭합니다.
Klaviyo에서 REST 자격 증명을 검증하면 계정의 쿠폰 탭에서 쿠폰을 만들기 시작할 수 있어요.
Klaviyo에서 Magento 쿠폰 생성
REST 자격 증명을 제공한 후 Klaviyo 계정에서 쿠폰 탭으로 처음 이동하면 “아직 쿠폰을 추가하지 않았습니다.”라는 메시지가 표시돼요.
새 쿠폰을 만들기 전에, 먼저 쿠폰에 필요한 모든 세부 사양을 포함하는 Magento의 가격 규칙(Price Rule)을 정의해야 해요. Price Rules는 Klaviyo 내에서 만들 수 없어요. Klaviyo에서 생성한 새 쿠폰은 Magento에 미리 존재하는 Price Rule을 참조해야 해요.
Magento에서 Price Rule을 만들 때, 새 Price Rule을 특정 쿠폰에 연결하는 옵션은 Specific Coupon으로 설정된 상태로 두고 Use Auto Generation 체크박스를 선택해야 해요.
- 쿠폰 추가를 클릭하여 새 쿠폰을 생성합니다.
- 다음 정보를 입력하세요. 쿠폰 이름 및 Magento 규칙 ID.
- 쿠폰 이름: 지정하는 이름은 문자, 숫자, 밑줄로만 구성할 수 있으며 최대 32자까지 입력할 수 있습니다.
- Magento 규칙 ID: 먼저 Magento에서 규칙을 생성한 다음, 해당 규칙의 ID를 여기에 붙여 넣어 이 쿠폰과 연결하세요.
생성된 모든 쿠폰은 다음 개요 정보와 함께 표시돼요:
- 쿠폰 이름: 쿠폰의 이름
- 활성 기간: 다음 옵션이 있습니다.
- 활성, 만료 없음
- 날짜 A - 만료 없음
- 날짜 A - 날짜 B
- 활성, 만료일 B
- 생성 날짜: 쿠폰이 생성된 날짜
- 마지막 업데이트 날짜: 쿠폰이 마지막으로 업데이트된 날짜
쿠폰은 오른쪽의 드롭다운을 통해 이 탭에서 수정하고 삭제할 수 있어요.
플로우 이메일에서 Magento 쿠폰 사용
쿠폰을 만들면 다음 플레이스홀더 변수를 사용해 플로우 이메일에 삽입할 수 있어요. 이메일당 쿠폰 코드는 1개만 추가할 수 있어요. 같은 쿠폰 코드를 여러 위치에 표시할 수는 있지만, 여러 코드는 사용할 수 없어요.
{% coupon_code 'CouponName' %} CouponName 을 쿠폰의 이름으로 바꿉니다. 예를 들어, 다음과 같습니다.
SMS 플로우 메시지에서 고유 쿠폰 사용하기
플로우의 SMS/MMS 메시지 에서도 고유 쿠폰을 사용할 수 있습니다. 이메일과 마찬가지로 코드를 생성합니다. 그런 다음 아래 템플릿 태그를 사용하여 SMS 또는 MMS 메시지에 쿠폰 코드를 추가하세요:
{% coupon_code 'CouponName' %}.
스니펫에서 CouponName을 원하는 쿠폰 이름으로 변경한 다음 메시지(플로우 또는 캠페인)에 추가하세요.
이메일과 달리 SMS 메시지당 쿠폰 코드 1개만 사용할 수 있습니다. 이메일에서는 숨겨진 블록을 사용하여 상대방의 거주 지역이나 수행한 작업에 따라 다른 쿠폰을 보낼 수 있습니다. SMS 메시지에 여러 개의 쿠폰을 추가하려고 하면 오류 메시지가 표시됩니다.
오류 문제 해결
오류 메시지: “지정된 REST 자격 증명으로 REST API에 연결할 수 없습니다. Magento 관리자에서 이러한 자격 증명이 유효한지 확인해 주세요."
Klaviyo에서 이 오류 메시지가 표시된다면, 가능한 근본 원인이 2가지 있어요.
- Magento 서버가 OAuth 인증을 위한 HMAC-SHA1 서명을 지원하도록 설정되어 있지 않아요.
- REST API에 대한 전체 역할 액세스를 활성화하지 않았을 수 있습니다.
이 문제를 해결하려면 Magento 서버에서 OAuth 인증을 위한 HMAC-SHA1 서명을 활성화하세요. 그런 다음 다음 단계에 따라 REST 권한을 업데이트하세요:
- .htaccess에서 rewrite 규칙을 주석 해제하거나 추가해 주세요 다시 생성해야 합니다. 주석 처리되지 않았는지 확인해야 하는 줄은 다음과 같습니다:
RewriteRule ^api/rest api.php?type=rest [QSA,L] - REST 역할이 올바르게 설정되어 있는지 다시 확인해 주세요.
이 부분에 대한 지침은 여기에 연결된 섹션의 Magento 쿠폰 설정 가이드에서 안내해 드려요. - 또 다른 일반적인 원인은 다양한 Apache 모듈이 “Authorization: Basic base64 (user:password)” 헤더를 제거할 수 있다는 점입니다.
자세한 내용은 이 게시물에서 확인하세요
Klaviyo에서 이메일에 채워 넣는 쿠폰 코드는 고유하지 않아요. 즉, 모든 수신자가 동일한 코드를 받는 것으로 보여요.
Magento에서 가격 규칙을 만들 때 새 가격 규칙을 특정 쿠폰과 연결하는 옵션은 Specific Coupon으로 설정된 상태로 두고, “Use Auto Generation” 체크박스를 선택해야 해요.
Magento에서 가격 규칙을 클릭한 다음 General Information에서 아래로 스크롤하여 "쿠폰" 줄 옵션으로 이동한 후 이 설정을 "Specific Coupon"으로 변경하세요. 다음으로 여기에서 자동 생성 확인란을 선택하세요. 이렇게 하면 문제가 해결되고 이메일 수신자별로 새 고유 쿠폰 코드를 생성할 수 있어요.