문제 해결

버튼이 안 떠요

가장 흔한 원인부터 순서대로 정리했습니다. 위에서부터 하나씩 확인해 보세요.

1. 휴대폰에서 확인하셨나요? PC에서는 버튼이 보여도 누르면 QR 코드만 나옵니다. 측정 화면은 휴대폰에서 확인해 주세요.
2. 스크립트가 불러와지나요? 브라우저 개발자 도구의 Network 탭에서 PerfittSize.js가 200으로 내려오는지 봐 주세요. 보이지 않는다면 스크립트 태그가 빠졌거나 head 밖에 있는 경우입니다.
3. API 키가 맞나요? apiKey= 뒤의 값이 펄핏이 발급해 드린 키와 같은지 확인해 주세요.
4. 상품이 펄핏에 등록돼 있나요? 펄핏에 상품 데이터가 없거나 추천할 수 없는 상품으로 분류돼 있으면 버튼이 나타나지 않습니다. 새로 올린 상품이라면 상품 코드를 담당자에게 보내 주세요.
5. 버튼 영역(Selector)이 페이지에 있나요? Console에서 document.querySelector('#perfitt-block-1')을 실행했을 때 null이 나오면 버튼이 들어갈 영역이 없다는 뜻이니, HTML에 영역을 추가해 주세요.
6. 연동값이 제대로 읽히나요? 브랜드, 모델 번호 같은 연동 항목을 페이지에서 읽지 못하면 상품을 찾을 수 없습니다. 연동 방법의 Selector가 지금 페이지 구조와 맞는지 확인해 주세요.

PC에서 버튼을 누르면 QR 코드만 나와요

걱정하지 않으셔도 됩니다. 정상 동작이에요. 발 측정은 휴대폰 카메라로 하기 때문에, PC에서는 측정 화면 대신 휴대폰으로 이어 주는 QR 코드를 보여 드립니다. 휴대폰으로 QR을 찍으면 같은 상품의 측정 화면이 열리고, 결과는 PC 화면에도 나타납니다.

설정을 바꿨는데 반영이 안 돼요

펄핏 스크립트와 설정은 CDN과 브라우저에 잠시 저장(캐시)됩니다. 펄핏이 설정을 바꾼 뒤 몇 분 지나서 다시 열어 보시거나, 시크릿 창에서 확인해 보세요. 그래도 그대로라면 담당자에게 알려 주세요. 바로 확인해 드리겠습니다.

측정했는데 다른 페이지에서 결과가 사라져요

측정 결과는 브라우저 저장소(localStorage)에 보관됩니다. 시크릿 창이거나, 브라우저 설정에서 저장소를 막아 두었거나, 펄핏이 들어 있는 iframe에 저장소를 막는 sandbox 속성이 붙어 있으면 페이지를 옮길 때 결과가 사라질 수 있습니다. 로그인한 고객이라면 customerId를 연동해 두면 다음에 방문해도 결과가 유지돼요. 연동 항목

카메라가 안 켜져요

브라우저에서 카메라 권한을 거부하셨다면 주소창의 권한 설정에서 다시 허용해 주세요. 앱 안의 웹뷰라면 앱이 카메라 권한을 넘겨 줘야 합니다. 설정 방법은 안드로이드 카메라 권한에, iOS 안내도 함께 있어요.

iOS에서 "동작 및 방향 접근 허용" 팝업이 떠요

정상적인 동작이니 안심하셔도 됩니다. 옆면을 촬영할 때 휴대폰 기울기로 촬영 각도를 안내하기 때문에 iOS가 허용 여부를 묻는 것이에요. 허용하지 않아도 촬영은 할 수 있지만 기울기 안내는 꺼집니다. 자세히 보기

페이지를 이동하면 버튼이 안 바뀌어요 (SPA)

SPA는 페이지를 새로 읽지 않아서 스크립트가 다시 실행되지 않습니다. 상품이 바뀔 때마다 window.initializePerfittSize({ productId })를 호출해 주세요. SPA 가이드

추천 사이즈가 안 나와요

버튼은 뜨는데 추천 사이즈 대신 안내만 나온다면 대부분 상품 쪽 문제입니다.

1. 추천 가능 상품인가요? 펄핏에 등록되지 않았거나 등록 대기 중인 상품은 측정은 되지만 추천은 나오지 않습니다. brand와 modelNo를 연동했으면 등록 요청이 자동으로 가 있으니, 담당자에게 상품 코드로 진행 상황을 물어보세요.
2. 사이즈 옵션이 읽히나요? 사이즈 옵션 영역의 셀렉터가 틀리면 판매 사이즈를 못 읽어 추천이 비거나 품절 사이즈가 추천될 수 있습니다. 사이즈 옵션 영역
3. 연동값이 맞나요? 다른 상품의 productId가 읽히면 엉뚱한 신발이 추천됩니다. Console에서 PerfittSize.productId가 지금 보는 상품인지 확인하세요.

상품 이름·이미지가 비어요 (연동값이 안 읽혀요)

결과 화면에 상품 이름이나 이미지가 비면 그 항목을 못 읽은 것입니다.

1. 셀렉터가 지금 페이지에 있나요? Console에서 document.querySelector('셀렉터')로 요소가 잡히는지 확인하세요. 쇼핑몰 개편 뒤에 깨지는 경우가 가장 많습니다.
2. 값이 늦게 그려지나요? 자바스크립트로 나중에 그리는 값은 펄핏이 최대 5초 기다립니다. 더 늦으면 수동 실행 모드로 직접 넘기세요.
3. 읽는 방법이 맞나요? 연동 방법에서 그 항목에 맞는 방법(JSON-LD, 자바스크립트 변수 등)으로 바꿀 수 있습니다.

버튼 색이 안 바뀌어요

펄핏이 설정을 바꾼 뒤에도 CDN과 브라우저 캐시 때문에 몇 분 걸릴 수 있습니다. 시크릿 창에서 다시 열어 보고, 그래도 그대로면 요청한 색상 코드와 함께 담당자에게 알려 주세요.

로그인했는데 이전 측정 결과가 안 보여요

이전 측정을 다시 쓰려면 customerId가 연동되어 있어야 하고, 측정할 때도 로그인 상태였어야 합니다. customerId 없이는 다른 기기나 브라우저로 결과가 이어지지 않습니다. 연동 항목