WooCommerce 연동 문제 해결하기

학습 내용

아래에 설명된 관련 문제 해결 시나리오를 따라 WooCommerce 연동 설정 문제를 해결하는 방법을 알아보세요. 이 목록에 없는 문제가 발생하는 경우 커뮤니티 또는 지원 팀에 문의해 주세요.

시작하기 전에 알아야 할 것

아직 확인하지 않았다면 연동에 대한 단계별 지침을 위해 WooCommerce 시작하기 가이드를 읽어보세요. 플러그인을 업그레이드하려면 WooCommerce 플러그인 업그레이드 방법 문서를 확인해 보세요.

문제 해결 시나리오

문제를 해결하려면 앱 내에서 받은 오류 메시지를 기준으로 다음 시나리오를 확인해 주세요.

“기능 중단을 방지하려면 다음 플러그인을 비활성화해야 할 수 있어요. 플러그인 이름.”

WordPress에서 활성 캐싱 플러그인 또는 리디렉션 플러그인을 사용 중이면 Klaviyo 연동을 방해하고 연결 문제를 일으킬 수 있어요. 연동 설정 과정에서는 이러한 플러그인을 비활성화하는 것을 권장해요.

“설정을 완료할 수 없습니다.”

이 메시지는 방화벽이 Klaviyo의 요청을 차단하고 있거나, Cloudflare에서 Bot Fight Mode를 활성화했거나, 둘 다 해당한다는 뜻이에요.

해결을 위해 Klaviyo 연동 트래픽을 허용 목록에 추가하고 Bot Fight Mode를 비활성화(활성화되어 있는 경우)하는 것을 모두 권장해요.

1. Klaviyo 연동 트래픽 IP 주소를 허용 목록에 추가하는 방법을 알아보세요.
2. Cloudflare에서 Bot Fight Mode를 비활성화하려면:
   1. Cloudflare 대시보드에 로그인하세요.
   2. 계정과 도메인을 선택하세요.
   3. Security > Bots로 이동하세요.
   4. Bot Fight Mode는 Off로 선택해 주세요.

“WooCommerce 스토어에서 https 및 SSL이 활성화되어 있는지 확인하세요.”

Klaviyo는 스토어 URL이 HTTPS 프로토콜을 준수하기를 기대하며, 이는 웹사이트에 유효한 SSL 인증서가 있다는 의미예요. 웹사이트가 HTTPS가 아니라 HTTP인 경우 문제가 발생할 수 있어요.

SSL Server Test(Qualys SSL Labs 제공)에서 SSL 인증서가 유효한지 확인할 수 있어요.

Klaviyo에서는 테스트가 A 등급으로 통과해야 해요.

“제공된 자격 증명으로 API에 액세스할 수 없습니다.”

로그인하지 않은 사용자의 API 액세스를 방지하도록 사용자 지정을 적용한 경우 이 오류가 표시될 수 있어요. 일반적으로 이는 functions.php WordPress 파일의 함수로, 401 상태 코드 응답을 트리거해요.

이런 사용자 지정이 있다면, 오류를 제거하기 위해 삭제하거나 주석 처리하세요. 이 오류에 대한 자세한 내용은 WooCommerce REST API FAQ에서 확인하세요.

"주문 API에 액세스할 수 없습니다. 연결 설정을 확인한 후 다시 시도하세요"

이 오류는 Klaviyo가 WooCommerce 연동을 검증하고 주문 수를 가져오려고 할 때, 해당 API가 Klaviyo가 예상하는 값을 반환하지 않거나 아무 값도 반환하지 않는다는 의미예요.

연동이 아직 Klaviyo에 공식적으로 연결되지 않았으므로, WooCommerce에서 해결해야 해요.

이 오류에 대한 추가 정보를 얻으려면 주문 수 엔드포인트에 API 호출을 수행해야 하며, 이를 통해 Klaviyo로 전달되는 내용에 대한 인사이트를 더 얻을 수 있어요. 다음은 cURL 요청 예시예요. 사용하려면 스토어 URL, consumer key, consumer secret을 입력하세요.

curl https://STORE_URL/wp-json/wc/v3/orders \
-u CONSUMER_KEY:CONSUMER_SECRET

“Klaviyo 플러그인이 오래되었습니다.”

가끔 웹후크가 Klaviyo에 도달하는 데 지연이 발생해 잠시 동안 이전 설정 페이지가 표시될 수 있어요. 몇 분 후에 자동으로 해결될 거예요.

WordPress에서 Klaviyo에 연결할 때 404 오류 발생

이 문제를 해결하려면 WordPress 사이트에서 고유주소(퍼머링크)가 활성화되어 있는지 확인해 주세요. WooCommerce 인증은 고유주소(퍼머링크)가 활성화되어 있지 않으면 작동하지 않아요.

1. WordPress 사이트로 이동한 다음 설정 > 고유주소로 이동해 주세요.
2. 공통 설정에서 일반 텍스트가 아닌 다른 링크 구조를 선택해 주세요.
3. 변경 사항 저장을 클릭하여 확인하세요.
   

4. 완료되면 Klaviyo와 다시 통합하세요.

설치 실패 - 확장 프로그램을 설치할 수 없었어요

WooCommerce 마켓플레이스를 통해 연동을 설치하려고 할 때 "설치 실패" 오류가 발생할 수 있어요.

WooCommerce 마켓플레이스에서 설치를 성공적으로 완료할 수 없는 경우 Wordpress 플러그인 관리자에서 플러그인을 설치할 수도 있어요.

1. WordPress 관리자에서 플러그인으로 이동하세요.
2. 플러그인 추가를 선택하세요.
3. 플러그인 검색 에서 Klaviyo 를 검색하세요.
4. 지금 설치를 선택하세요.
5. 활성화를 선택하세요.
6. 왼쪽 탐색 메뉴에서 마케팅을 선택한 다음 Klaviyo를 클릭하세요.
7. 시작하려면 계정 연결 을 클릭한 다음, WooCommerce 시작하기 문서에서 WooCommerce 연동 활성화 로 진행해 주세요.
   

추가 자료