콘텐츠로 건너뛰기
주의:: 이 문서는 사용자의 편의를 위해 제공됩니다. 이 문서는 번역 소프트웨어를 사용하여 자동으로 번역되었으며 교정을 거치지 않았을 수 있습니다. 이 문서의 영어 버전이 가장 최신의 정보를 확인할 수 있는 공식 버전으로 간주해야 합니다. 여기에서 액세스할 수 있습니다..

쿼리 문자열로 양식 필드 자동 채우기

마지막 업데이트 날짜: 2월 21, 2025

명시된 경우를 제외하고 다음 구독 중 어느 것에서나 사용할 수 있습니다.

모든 제품 및 플랜

연락처로 보내기 전에 페이지 URL에 쿼리 문자열을 추가하여 페이지의 양식 필드를 자동으로 채울 수 있습니다. 추가된 쿼리 문자열에 따라 필드가 채워집니다. 이 기능은 숨겨진 양식 필드에도 적용됩니다. 예를 들어 사용자 지정 UTM 속성을 만들고 UTM 매개변수를 사용하여 숨겨진 양식 필드를 자동으로 채울 수 있습니다.

쿼리 문자열이 포함된 URL을 만들려면 미리 채우려는 필드의 내부 속성 이름을 복사한 다음 페이지 URL 끝에 추가해야 합니다.

참고: 쿼리 문자열을 사용하여 종속 양식 필드를 자동으로 채우는 것은 불가능합니다. 또한 HubSpot은 쿼리 문자열 내의 여러 값을 기반으로 종속 필드를 트리거할 수 없습니다

속성의 내부 이름 복사

속성의 내부 이름을 찾으려면:

  • HubSpot 계정의 상단 탐색 모음에서 settings 설정 아이콘을 클릭합니다.
  • 왼쪽 사이드바 메뉴에서 속성으로 이동합니다.
  • 값을 미리 채울 속성 이름을 클릭합니다.
  • 속성의 내부 이름을 복사합니다. 여기에서 내부 이름에 대해 자세히 알아보세요.
  • 양식에서 값을 미리 채우려는 다른 모든 속성에 대해 이 과정을 반복합니다.


사전 정의된 값으로 정적 쿼리 문자열 만들기

내부 속성 이름을 복사한 후 연락처에 보낼 페이지 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

개인화 토큰으로 동적 쿼리 문자열 만들기(Marketing Hub Professional 또는 Enterprise만 해당)

개인화 토큰을 사용하여 알려진 연락처 속성을 기반으로 양식 필드를 자동으로 채우는 동적 쿼리 문자열을 만들 수 있습니다.

참고하세요:

  • 개인화 토큰이 포함된 동적 쿼리 문자열은 URL이 HubSpot 양식이 있는 HubSpot 호스팅 페이지로 연결될 때만 올바르게 작동합니다.
  • URL이 HubSpot 독립형 양식 페이지로 연결되는 경우에는 이 기능이 작동하지 않습니다.
  • 또한 동적 쿼리 문자열이 포함된 URL은 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}}

 

New Call-to-action
이 문서가 도움이 되었나요?
이 양식은 문서 피드백에만 사용됩니다. HubSpot으로 도움을 받는 방법 알아보기.