HubSpot 양식 문제 해결
마지막 업데이트 날짜: 2026년 4월 24일
명시된 경우를 제외하고 다음 구독 중 어느 것에서나 사용할 수 있습니다.
HubSpot 양식을 사용하면 웹사이트에서 리드를 생성하고, 방문자 및 연락처에 대한 중요한 정보를 HubSpot에 수집할 수 있습니다. 양식 작동 방식이나 제출과 관련해 문제가 발생한다면, 자주 발생하는 문제와 해결 방법을 확인해 보세요.
일반적인 문제 해결 단계
양식 제출에 문제가 있는 경우, 이는 HubSpot 양식 자체 또는 양식이 삽입된 페이지 중 하나에 기인할 수 있습니다. 문제를 해결하려면 HubSpot 양식을 테스트해 볼 수 있습니다:
- 다른 브라우저 탭에서 양식의 독립형 페이지 URL을 열어보세요. 이 독립형 페이지에는 양식에 영향을 줄 수 있는 요소가 없습니다.
- 양식에 테스트 제출을 수행해 보세요.
- 테스트 제출 내용을 확인하세요 :
- 제출이 성공했다면, 문제는 양식이 삽입된 페이지와 관련이 있을 가능성이 높습니다. 스크립트나 첨부된 스타일시트 등 제출에 영향을 미쳤을 수 있는 페이지 내 요소에 대해 개발자에게 문의하십시오.
- 제출 시에도 동일한 오류가 발생한다면 HubSpot 지원팀에 문의하십시오.
일반적인 양식 동작 문제 해결
다음은 양식을 설정할 때 발생할 수 있는 일반적인 문제와 해결을 위한 일반적인 단계입니다. 양식을 업데이트한 후 게시하고 양식을 다시 확인하십시오.
| 오류 | 오류 해결 단계 |
실제 폼에 필드가 표시되지 않음 |
다른 브라우저 탭에서 양식의 독립형 페이지 URL을 확인하여 업데이트된 양식이 게시되었는지 확인하십시오. 양식을 페이지에 추가했을 때 일부 필드가 여전히 표시되지 않는다면, 양식에 프로그레시브 필드가 포함되어 있고 HubSpot이 이전 상호작용이나 테스트에서 방문자를 기억하고 있기 때문일 가능성이 높습니다. 방문자가 이전에 해당 필드를 작성했거나 연락처에 해당 속성에 대한 값이 이미 있는 경우, 프로그레시브 필드는 숨겨집니다. 필드가 항상 표시되도록 하려면, 프로그레시브 양식 필드가 아닌 일반 양식 필드로 필드를 추가하십시오. |
HubSpot 페이지에 추가된 양식이 양식 편집기(레거시)와 동일한 감사 메시지를 표시하지 않음 |
(레거시) 양식을 HubSpot 페이지에 추가하면, 페이지 편집기에서 설정한 감사 메시지가 양식 편집기의 설정을 덮어씁니다. 이는 양식이 인라인 감사 메시지 또는 HubSpot 페이지나 외부 페이지로 리디렉션되도록 설정된 경우에 발생합니다. 따라서 레거시 편집기에서 생성된 양식을 HubSpot 페이지에 추가할 때는 페이지 편집기의 양식 모듈 내에서 인라인 감사 메시지를 설정하거나 다른 페이지로 리디렉션해야 합니다. 이는 조건부 양식 리디렉션이나 예약 페이지로 리디렉션하는 경우에는 적용되지 않습니다. 이러한 설정은 양식 편집기에서 설정된 경우 우선 적용됩니다. |
폼 편집기에서 해당 속성을 필드로 사용할 수 없습니다 |
특정 속성이 양식 필드로 표시되지 않는 경우, 해당 속성이 양식에 표시되도록 설정되지 않았기 때문일 수 있습니다. 양식에 속성을 표시하려면 다음을 수행하십시오:
|
감사 페이지에 스마트 콘텐츠가 표시되지 않습니다 |
감사 페이지에서는 스마트 콘텐츠를 사용할 수 없습니다. 방문자가 양식을 제출하고 감사 페이지로 리디렉션될 때, 양식을 처리하고 HubSpot이 해당 연락처가 감사 페이지의 스마트 콘텐츠 규칙을 충족하는지 판단할 시간이 충분하지 않습니다. |
안전하지 않은 리치 텍스트 HTML오류가발생했습니다 |
'안전하지 않은 리치 텍스트 HTML을 제공했습니다'라는 오류는 양식에 허용되지 않는 HTML 태그나 속성이 포함된 경우 발생합니다 . 이 오류를 해결하고 양식을 저장하려면 양식 내리치 텍스트 영역의소스 코드를 다음 사항과 대조하여 확인하십시오.
|
일반적인 양식 제출 문제 해결
다음은 양식 제출 시 발생할 수 있는 일반적인 문제와 해결을 위한 일반적인 단계입니다. 양식을 업데이트한 후, 양식을 다시 게시하고 확인해 볼 수 있습니다.
| 오류 | 오류 해결 단계 |
문의 건수보다 양식 제출 건수가 더 많음 / 양식 제출에 대한 문의 기록이 생성되지 않음 |
양식의 '제출' 버튼을 클릭하고 처리가 완료되면 양식 제출 내역이 기록됩니다. 양식 제출 횟수가 생성된 연락처 수보다 많은 일반적인 원인은 다음과 같습니다:
|
연락처가 양식을 제출할 때 페이지 조회 기록이 생성되지 않음 |
페이지 뷰를 정확하게 추적하려면, 사이트에 HubSpot 추적 코드가 설치되어 있고 정상적으로 작동하는지 확인하십시오. 추적 코드가 설치되어 있고 정상적으로 작동하지만, 연락처의 '페이지 조회수' 속성 값이 여전히 '0'인 경우, 연락처가 양식을 제출할 때 쿠키가 차단되었기 때문일 가능성이 높습니다. 이는 다음과 같은 여러 가지 이유로 발생할 수 있습니다:
|
양식 제출이 관련 개체의 활동 타임라인에 표시되지 않음 |
연관된 개체의 활동 타임라인에 양식 제출 내역을 표시하려면:
예를 들어, 양식에 '회사' 속성 필드가 포함되어 있고 양식 제출 시 이 필드가 입력되었다면, 해당 양식 제출 내역은 연락처와 연결된 회사의 활동 타임라인에 표시됩니다. 필드가 항상 입력되도록 하려면 양식 필드를 필수 항목으로 설정할 수 있습니다. |
연락처 레코드 오류 |
이메일 주소가 없는 양식 제출로 연락처 생성을 허용하지 않는 경우, 양식 제출 내역에'연락처 레코드 없음'이 표시될 수 있는 두 가지 이유가 있습니다:
|
기록 없음 오류 |
이 오류는 HubSpot이 제출이 발생한 위치를 파악할 수 없음을 의미합니다. 이는 다음 두 가지 이유 때문일 수 있습니다:
|
양식 제출 후 페이지 방문이 기록되지 않음 |
양식 제출이 페이지 방문으로 기록되지 않는 경우, 대부분 방문자의 IP 주소가 사이트 분석에서 제외되었기 때문입니다.
|
이 제출에 대한 쿠키가 발견되지 않음오류 |
이 오류는 다음의 원인으로 발생할 수 있습니다:
|
연락처의 양식 제출에서 파일이 제거됨 |
HubSpot 양식 도구에는 양식 제출 시 의심스러운 파일이 업로드되는 것을 방지하는 바이러스 탐지 기능이 탑재되어 있습니다. 방문자가 파일이 포함된 양식을 제출하고 바이러스가 탐지되면, 제출 내역에 [파일 이름]이 제출에서 제거되었습니다라는메시지가 표시됩니다. |
양식 알림에 추가 회사 정보가 표시됨 |
HubSpot 데이터베이스에 추가적인 회사 정보가 있는 경우, HubSpot은 알림 하단에 이 정보를 자동으로 채워 넣습니다. |
연락처의 IP 국가, IP 주 또는 IP 도시 값이 누락되었습니다 |
HubSpot은 방문자의 IP 주소를 해당 지리적 위치와 매칭하기 위해 여러 제3자 데이터베이스를 활용합니다. 연락처의 ‘IP 국가’, ‘IP 주/지역’ 또는 ‘IP 도시’ 항목이 비어 있는 데에는 두 가지 이유가 있습니다:
|
일반적인 양식 표시 문제 해결
다음은 HubSpot 또는 외부 페이지에 양식이 표시되지 않는 일반적인 문제와 해결을 위한 일반적인 단계입니다.
| 오류 | 오류 해결 단계 |
HubSpot 페이지 또는 외부 페이지에 양식이 표시되지 않음 |
양식이 HubSpot 또는 외부 페이지에 표시되지 않는 경우, 페이지에 있는 충돌하는 코드 때문에 표시되지 않을 수 있습니다. 가장 흔한 원인은 OneTrust의 쿠키를 수락하지 않은 방문자를 포함한 모든 방문자에게 양식을 표시하려면 해당 스크립트를 외부에서 관리해야 합니다. 다음 옵션을 고려해 보십시오:
참고: 문제 해결 단계를 검토하고, 동의 배너를 처리하며, 개인정보 처리방침을 고려할 때, 귀사의 구체적인 비즈니스 상황에 맞는 규정 준수 조언을 제공해 줄 수 있는 가장 적합한 자문처는 법무팀입니다. |
외부 페이지에 양식이 표시되지 않음 |
양식이 외부 페이지에 표시되지 않는 경우, 양식 삽입 코드나 웹사이트 호스트에 문제가 있을 수 있습니다. 외부에 삽입된 양식의 문제 해결 방법을 알아보세요. |
외부 페이지에서 삽입된 양식이 잘못된 위치에 표시됨 |
외부 페이지에 HubSpot 양식을 삽입한 후 양식이 원하는 위치와 다르게 표시되는 경우, 다음이 원인일 수 있습니다:
양식 삽입 코드를 업데이트하여 이러한 문제를 해결하는 방법에 대해 자세히 알아보세요. |
이 양식을 불러오는 데 문제가 발생했습니다. 계속하려면 여기를 클릭하세요. |
HubSpot 양식은 필드 유효성 검사, 종속 필드, 동적 오류 메시지 등의 기능을 추가하기 위해 JavaScript로 제작되었습니다. 그러나 이는 Ghostery나 Privacy Badger와 같은 리소스 차단 브라우저 확장 프로그램이 활성화된 경우 양식의 로딩 및 표시를 차단할 수 있음을 의미합니다. '계속하려면 여기를 클릭하세요' 텍스트는 HubSpot이 관리하는 보호 도메인인 https://www.hubspot.com/products/marketing/forms?utm_source=share.hsforms.com&utm_medium=referral&utm_campaign=hsforms-redirect로 연결되는 하이퍼링크입니다. 방문자가 이 링크를 클릭하면 양식을 제출할 수 있는 독립형 양식 페이지로 이동합니다. 이 링크에는 쿼리 문자열에 포함된 원본 양식 삽입 코드의 전체 컨텍스트와 제목, URL과 같은 원본 페이지 정보가 포함됩니다. 이 독립형 페이지의 양식은 원본 양식과 똑같이 작동합니다. 독립형 페이지에서 양식을 제출하면 원본 양식에서 제출할 때와 동일한 분석 정보가 전달됩니다. |