Magento 연동 시스템 요구 사항 참조

학습 내용

Magento 1 또는 2와 최적의 동기화를 위한 시스템 요구 사항을 알아보세요. Magento 스토어 관리자는 시스템 사양 및 구성에 대한 책임이 있습니다. 시스템이 Klaviyo와 함께 작동하도록 구성하면 원활한 연동 경험을 제공할 수 있어요.

2.4.0 미만의 Magento 2 버전은 지원되지 않아요.

API 권한 구성

기존 Magento 1 연동의 경우 SOAP API 사용자는 모든 리소스에 대한 전체 액세스 권한이 필요해요. 리소스 액세스가 전체로 설정되어 있는지 확인해 주세요.

Magento 2의 경우 Klaviyo 확장 프로그램을 설치하고 구성한 다음 OAuth를 설정하고 요청된 API 권한을 승인해 주세요. Magento 2 연동 가이드를 따라 Magento에서 설정을 완료하고 Klaviyo에서 연동을 활성화해 주세요.

필요한 API 권한이 없으면 Klaviyo가 Magento 스토어의 API와 제대로 상호작용할 수 없고, 그로 인해 연동이 스토어에서 데이터를 가져오지 못하게 돼요.

필수 API 엔드포인트에 대한 액세스를 활성화하세요

Klaviyo는 특정 엔드포인트에서 데이터를 요청해요. 시스템 구성에서 이러한 엔드포인트에 대한 액세스를 허용해야 해요. 보안 제어 또는 URL 리디렉션 로직이 Klaviyo의 이러한 엔드포인트 접근성에 미치는 영향을 고려하세요. Klaviyo에서 예상한 API 엔드포인트에 액세스할 수 없으면 Magento 데이터의 일부 또는 전체를 동기화할 수 없으며, 애플리케이션에서 오류 보고가 표시돼요.

Magento 2의 경우 스토어에 공개적으로 액세스할 수 있는 호스트 이름이 있어야 해요. OAuth 인증을 위해 Klaviyo가 /oauth/token/request 및 /oauth/token/access에 도달할 수 있도록 허용하고, /index.php/rest 아래의 REST API에도 액세스할 수 있도록 해 주세요. 인증에 실패하면 Magento 2 문제 해결 가이드를 따라 해 주세요.

모든 Klaviyo 연동 아웃바운드 트래픽은 예측 가능하고 고정된 IP 주소 세트 뒤에 있으므로 이 트래픽이 Klaviyo에서 오는 것임을 높은 수준으로 확신할 수 있어요. 이 주소를 허용 목록에 추가하는 것을 권장해요.

과거 데이터 동기화 API 요청을 위한 시스템 용량

연동을 활성화하면 Klaviyo가 고객 레코드, 주문 레코드, 제품 카탈로그를 포함한 과거 데이터를 동기화하기 위해 API 요청을 자동으로 큐에 추가해요. 마케터가 가능한 한 빨리 계정에서 이 데이터를 사용할 수 있도록 빠르게 처리하려고 해요. 또한 동시성을 제한하고 재시도를 원활하게 처리해 책임감 있게 진행하려고 해요. 스토어에 과거 데이터 양이 많거나 리소스 용량이 제한되어 있거나 다른 애플리케이션에서 대규모 API 요청을 보내는 경우, 인프라가 과거 데이터 동기화를 지원할 수 있도록 준비되어 있는지 확인하기 위해 Magento 관리자와 상담하는 것을 권장해요. 관리자는 리소스를 일시적으로 늘리거나 오토 스케일링을 적용하는 방안을 고려할 수 있어요.

SSL 인증서 유효성을 확인하세요.

SSL 인증서는 웹사이트의 신원을 디지털 방식으로 인증하고, 웹 브라우저와 웹 서버 간에 암호화된 연결을 가능하게 해요. 웹사이트의 SSL 인증서는 사이트의 오리진 서버에서 호스팅돼요. 유효한 SSL 인증서는 결제를 안전하게 처리하고, 비밀번호 로그인을 보호하며, 웹 양식을 안전하게 유지하는 데 매우 중요해요. SSL 서버 테스트를 사용해 웹사이트의 SSL 인증서를 확인할 수 있어요.

웹사이트의 SSL 인증서가 만료되면 Magento 연동이 비활성화될 수 있어요. 이 경우 호스팅 제공업체에서 도메인과 중간 인증서를 업데이트해야 해요. 인증서가 어디에 있는지 확실하지 않다면 호스팅 제공업체에 문의해 도움을 받아보세요.

충분한 서버 메모리 할당

제품, 제품 이미지, 저장된 이메일, 정적 콘텐츠 페이지를 위한 디스크 공간은 PHP 메모리와 별개예요. 디스크 공간이 충분하다고 해서 PHP에 Klaviyo의 API 요청을 처리할 만큼의 메모리가 충분하다는 뜻은 아니에요.

Klaviyo 연동에 1GB 이상의 메모리를 할당하는 것을 권장하지만, 필수 최소값은 512MB예요. 서버가 Klaviyo의 요청에 응답할 수 있을 만큼 충분한 리소스를 할당할 수 없으면 연동 오류가 발생해요. Klaviyo-Magento 연동은 과거 데이터 동기화부터 시작하므로, 연동을 활성화하기 전에 Magento와 서버에서 메모리 설정을 확인하는 것이 좋습니다.

Magento 웹 서버에서 사용 중인 PHP memory_limit 설정을 확인해 주세요. PHP의 기본값은 128MB이지만, 호스팅 구성에서 이 값을 재정의할 수 있어요. Magento 관리자가 php.ini에서 이 설정을 업데이트할 수 있어요. Magento 2의 경우 Adobe의 PHP 설정 안내도 함께 따라 주세요.

동기화에 UTC 타임스탬프를 사용하세요

Klaviyo는 최근 Magento 데이터를 요청하고 API에서 반환된 타임스탬프를 해석하기 위해 협정 세계시(UTC)를 사용해요. 타임스탬프가 올바르지 않으면 동기화하는 동안 레코드가 누락되거나 Klaviyo에서 잘못된 시간에 표시될 수 있어요.

Magento 관리자에게 스토어의 API에서 반환되는 타임스탬프가 UTC인지 확인해 달라고 요청해 주세요. 최근 레코드가 누락되거나 시간이 잘못 표시되면 스토어의 시간대 설정을 변경하기 전에 해당 타임스탬프와 서버 구성을 확인해 주세요.

추가 자료