쿼리 문자열로 양식 필드 자동 채우기
마지막 업데이트 날짜: 2025년 9월 17일
명시된 경우를 제외하고 다음 구독 중 어느 것에서나 사용할 수 있습니다.
연락처로 보내기 전에 페이지 URL에 쿼리 문자열을 추가하여 페이지의 양식 필드를 자동으로 채울 수 있습니다. 추가된 쿼리 문자열에 따라 필드가 채워집니다. 이 기능은 숨겨진 양식 필드에도 적용됩니다. 예를 들어 사용자 지정 UTM 속성을 만들고 UTM 매개변수를 사용하여 숨겨진 양식 필드를 자동으로 채울 수 있습니다.
제한 사항 및 고려 사항 이해하기
- 쿼리 문자열은 종속 양식 필드를 자동으로 채울 수 없습니다.
- 종속 양식 필드는 쿼리 문자열 내의 여러 값을 기반으로 트리거할 수 없습니다.
사전 정의된 값으로 정적 쿼리 문자열 만들기
정적 쿼리 문자열이 포함된 URL을 만들려면 자동 입력하려는 필드의 내부 속성 이름을 복사한 다음 페이지 URL 끝에 추가해야 합니다.
속성의 내부 이름 복사
- HubSpot 계정의 상단 탐색 모음에서 settings 설정 아이콘을 클릭합니다.
- 왼쪽 사이드바 메뉴에서 속성으로 이동합니다.
- 값을 미리 채울 속성 이름을 클릭합니다.
- 속성의 내부 이름을 복사합니다. 내부 속성 이름에 대해 자세히 알아보세요.
- 양식에서 값을 자동 입력하려는 다른 모든 속성에 대해 이 과정을 반복합니다.
정적 쿼리 문자열로 URL 만들기
내부 속성 이름을 복사한 후에는 연락처에 보낼 페이지 URL을 설정할 수 있습니다:
- 브라우저에서 양식이 있는 페이지로 이동합니다. 그런 다음 URL을 복사합니다.
- 페이지 URL 끝에 물음표(?) 를 추가합니다.
- 속성의 내부 이름과 등호를 추가하고 필드에 자동 입력할 값을 추가합니다. 속성의 필드 유형에 따라 값을 추가하는 규칙을 참고하세요:
- 단일 확인란: 쿼리 문자열에는 예 또는 아니오가 아닌 참 또는 거짓 값이 포함되어야 합니다.
- 날짜 선택기: 쿼리 문자열에는 YYYY-MM-DD 형식의 날짜 값이 포함되어야 합니다.
- 다중 확인란: 쿼리 문자열 값은 여러 값을 세미콜론으로 구분하여 속성의 값 옵션과 정확히 일치해야 합니다.
- 라디오 선택/드롭다운 선택: 쿼리 문자열 값은 속성의 값 옵션과 정확히 일치해야 합니다.
- 모든 필드 유형: 쿼리 문자열을 만들 때 이 규칙은 모든 필드 유형에 적용됩니다.
- 속성 값의 공백은 %20으로 구분해야 합니다.
- 여러 개의 서로 다른 속성은 앰퍼샌드(&)로 구분해야 합니다.
정적 쿼리 문자열이 포함된 URL 예시
정적 쿼리 문자열로 URL을 만든 후에는 이메일 및 페이지 등의 콘텐츠에서 링크로 사용할 수 있습니다. 링크를 클릭하는 연락처는 쿼리 문자열에 미리 정의된 값으로 자동 입력된 페이지의 양식을 보게 됩니다. 다음은 올바른 형식의 정적 쿼리 문자열이 포함된 URL의 예와 분석입니다:http://www.domain.com/marketing-offer?firstname=John&lastname=Smith&email=jsmith@email.com
&favorite_season=Winter%20Season&favorite_fast_food=Burger;Taco&number_property=7
&will_you_come_to_the_party=Maybe&do_you_like_parties=true&date_of_party=2018-10-24
- 쿼리 문자열의 시작 부분 및 한 줄 텍스트 필드:?firstname=John
- 한줄 텍스트 필드: &lastname=Smith
- 한 줄 텍스트 필드: &email=jsmith@email.com
- 드롭다운 선택 필드: &favorite_season=Winter%20Season
- 여러 개의 체크박스 필드: &favorite_fast_food=버거;타코
- 숫자 필드: &favorite_number=7
- 라디오 선택 필드: &will_you_come_to_the_party=Maybe
- 단일 체크박스 필드: &do_you_like_parties=true
- 날짜 선택 필드: &date_of_party=2018-10-2
개인화 토큰으로 동적 쿼리 문자열 만들기
동적 쿼리 문자열을 만들려면 마케팅 허브 프로페셔널 또는 엔터프라이즈 구독이 필요합니다.
개인화 토큰을 사용하여 알려진 연락처 속성을 기반으로 양식 필드를 자동으로 채우는 동적 쿼리 문자열을 만들 수 있습니다.
참고하세요:
- 개인화 토큰이 포함된 동적 쿼리 문자열은 URL이 HubSpot 양식이 있는 HubSpot 호스팅 페이지로 연결될 때만 올바르게 작동합니다.
- URL이 HubSpot 독립형 양식 페이지로 연결되는 경우에는 이 기능이 작동하지 않습니다.
- 또한 동적 쿼리 문자열이 포함된 URL은 HubSpot 콘텐츠 또는 HubSpot 추적 코드가 있는 외부 페이지에 배치되어야 합니다.
개인화 토큰 검색
먼저 쿼리 문자열을 만드는 데 필요한 개인화 토큰을 검색합니다. 속성에 대한 개인화 토큰을 검색하려면 다음과 같이 하세요:
- HubSpot 계정에서 마케팅 > 이메일로 이동합니다.
- 이메일 생성을 클릭하거나 임시 이메일의 이름을 클릭합니다.
- 서식 있는 텍스트 도구 모음에서 개인화를 클릭합니다.
- 개인화 토큰을 설정합니다:
- 대화 상자에서 양식에 자동 입력할 개인화 토큰을 선택합니다.
- 개인화 토큰을 삽입할 때 이 속성의 전역 기본값 사용 확인란을 선택합니다.
- 필요에 따라 개인화 토큰을 계속 추가합니다.

- 서식 있는 텍스트 도구 모음에서 더 보기를 클릭하고 codef 소스 코드 아이콘을 선택하여 이메일의 HTML을 확인합니다.
- 소스 코드에서 이메일 본문에 추가된 각 개인화 토큰의 원시 코드를 볼 수 있습니다. 각 토큰은 이중 대괄호 {{ }}로 묶여 있습니다. 토큰(예:
{{ contact.firstname }}
)을 강조 표시한 다음 마우스 오른쪽 버튼을 클릭하고 복사를 선택합니다. - 양식에 미리 채우려는 모든 개인화 토큰에 대해 이 과정을 반복합니다.
- 대화 상자 하단에서 취소를 클릭하고 닫아 소스 코드를 종료합니다.
동적 쿼리 문자열로 URL 만들기
개인화 토큰을 사용하여 동적 쿼리 문자열이 포함된 URL을 만듭니다. 이 URL은 이메일 및 페이지와 같은 HubSpot 콘텐츠의 링크 또는 HubSpot 추적 코드가 있는 외부 페이지로 사용할 수 있습니다. 링크를 클릭하는 연락처는 쿼리 문자열의 필드 값을 알고 있는 경우 페이지에 자신의 정보로 자동 채워진 양식을 보게 됩니다.
동적 쿼리 문자열로 URL을 만들려면 다음과 같이 하세요:
- 브라우저에서 양식이 있는 페이지로 이동합니다. 그런 다음 URL을 복사합니다.
- 페이지 URL 및 개인화 토큰을 사용하여 동적 쿼리 문자열의 형식을 지정합니다:
- 페이지 URL 끝에 물음표(?)를 추가합니다.
- 속성의 내부 이름 뒤에 등호 및 개인화 토큰을 추가합니다. 토큰에서 모든 공백이 제거되었는지 확인합니다(예: {{contact.firstname}} ).
- 여러 속성을 앰퍼샌드(&)로 구분합니다.
- 다음은 올바른 형식의 동적 쿼리 문자열이 포함된 URL의 예입니다:
http://www.domain.com/marketing-offer?firstname={{contact.firstname}}&lastname={{contact.lastname}}&email={{contact.email}}
