쿼리 문자열을 사용하여 양식 입력란에 자동으로 값 채우기

양식을 연락처에게 전송하기 전에 페이지 URL에 쿼리 문자열을 추가하여 양식 필드를 자동으로 채울 수 있습니다. 숨겨진 필드를 포함한 모든 양식 필드는 추가된 쿼리 문자열에 따라 자동으로 채워집니다. 예를 들어, 사용자 지정 UTM 속성을 생성하고 UTM 매개변수를 사용하여 숨겨진 양식 필드를 자동으로 채울 수 있습니다.

시작하기 전에

• 쿼리 문자열로는 종속 양식 필드를 자동으로 채울 수 없습니다.
• 종속 양식 입력란은 쿼리 문자열 내의 여러 값을 기반으로 트리거될 수 없습니다.

미리 정의된 값을 사용하여 정적 쿼리 문자열 생성

정적 쿼리 문자열이 포함된 URL을 생성하려면, 자동으로 채워지기를 원하는 필드의 내부 속성 이름을 복사한 다음, 페이지 URL의 끝에 추가해야 합니다.

속성의 내부 이름을 복사합니다

1. HubSpot 계정의 상단 탐색 모음에서 설정 아이콘을 클릭합니다.
2. 왼쪽 사이드바 메뉴에서 ‘속성’으로 이동합니다.
3. 속성 이름을 클릭하여 값을 미리 채워 넣으세요.
4. 속성의 내부 이름을 복사합니다. 내부 속성 이름에 대해 자세히 알아보세요.
5. 양식에서 값을 자동으로 채우려는 다른 속성에 대해서도 이 과정을 반복하십시오.

정적 쿼리 문자열을 사용하여 URL 생성

내부 속성 이름을 복사한 후, 연락처에게 전송할 페이지 URL을 설정할 수 있습니다:

1. 브라우저에서 양식이 있는 페이지로 이동합니다. 그런 다음 URL을 복사합니다.
2. 페이지 URL 끝에 물음표(?) 를 추가합니다. 페이지 URL에 이미 쿼리 매개변수가 있는 경우, 대신 앰퍼샌드(&) 를 추가합니다.
3. 속성의 내부 이름을 입력한 뒤, 등호(=)를 붙이고 필드에 자동으로 채워질 값을 입력하세요. 속성의 필드 유형에 따라 값을 추가할 때의 규칙을 유의하세요:
   • 단일 체크박스: 쿼리 문자열에는 '예'나 '아니요'가 아닌 'true' 또는 'false' 값이 포함되어야 합니다.
   • 날짜 선택기: 쿼리 문자열에는 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=Burger;Tacos
• 숫자 입력란: &favorite_number=7
• 라디오 버튼 선택 필드: &will_you_come_to_the_party=Maybe
• 단일 체크박스 입력란: &do_you_like_parties=true
• 날짜 선택기 필드: &date_of_party=2018-10-2

개인화 토큰을 사용하여 동적 쿼리 문자열 생성

개인화 토큰을 사용하여 알려진 연락처 속성을 기반으로 양식 필드를 자동으로 채우는 동적 쿼리 문자열을 생성하세요.

개인화 토큰 가져오기

쿼리 문자열을 생성하는 데 필요한 개인화 토큰을 가져옵니다.

1. HubSpot 계정에서 더 보기를 클릭한 다음 마케팅 > 이메일로 이동하세요. 더 보기가 계정에 표시되지 않으면 바로 마케팅 > 이메일로 이동하세요.
2. '이메일 작성'을 클릭하거나 이메일 초안의 이름을 클릭합니다.
3. 서식 있는 텍스트 도구 모음에서 ‘개인화’를 클릭합니다.
4. 개인화 토큰을 설정하세요:
   
   • 대화 상자에서 양식에 자동으로 채워질 개인화 토큰을 선택합니다.
   • 개인화 토큰을 삽입할 때 ‘이 속성의 전역 기본값 사용’ 확인란을 선택합니다.
   • 필요에 따라 개인화 토큰을 계속 추가하십시오.

5. 리치 텍스트 도구 모음에서 [더 보기 ] 를 클릭하고 [codef 소스 코드] 아이콘을 선택하여 이메일의 HTML을 확인하십시오.
6. 소스 코드에서 이메일 본문에 추가된 각 개인화 토큰의 원본 코드를 확인할 수 있습니다. 각 토큰은 이중 중괄호 {{ }}로 둘러싸여 있습니다. 토큰(예: {{ contact.firstname }})을 강조 표시한 다음, 마우스 오른쪽 버튼을 클릭하고 ‘복사’를 선택하세요.
7. 양식에 미리 채워 넣으려는 모든 개인화 토큰에 대해 이 과정을 반복하세요.
8. 대화 상자 하단에서 ‘취소’를 클릭한 후 닫기를 눌러 소스 코드에서 나갑니다 .

동적 쿼리 문자열을 사용하여 URL 생성

개인화 토큰을 사용하여 동적 쿼리 문자열이 포함된 URL을 생성하세요. 이 URL은 이메일이나 페이지와 같은 HubSpot 콘텐츠 내의 링크로 사용하거나, HubSpot 추적 코드가 포함된 외부 페이지에서 사용할 수 있습니다. 링크를 클릭한 연락처는 쿼리 문자열의 필드에 대해 알려진 값이 있는 경우, 해당 정보가 자동으로 입력된 양식을 페이지에서 확인할 수 있습니다.

동적 쿼리 문자열이 포함된 URL을 생성하려면:

1. 브라우저에서 양식이 있는 페이지로 이동합니다. 그런 다음 URL을 복사합니다.
2. 페이지 URL과 개인화 토큰을 사용하여 동적 쿼리 문자열을 구성합니다:
   • 페이지 URL 끝에 물음표(?) 를 추가합니다. 페이지 URL에 이미 쿼리 매개변수가 있는 경우, 대신 앰퍼샌드(&) 를 추가합니다.
   • 속성의 내부 이름을 입력한 뒤 등호(=)와 개인화 토큰을 추가합니다. 토큰에서 공백을 모두 제거해야 합니다(예: {{contact.firstname}} ).
   • 여러 속성은 앰퍼샌드(&)로 구분하십시오.

다음은 올바르게 형식화된 동적 쿼리 문자열이 포함된 URL의 예시입니다:

http://www.domain.com/marketing-offer?firstname={{contact.firstname}}&lastname={{contact.lastname}}&email={{contact.email}}

다음 단계

숨겨진 양식 필드를 사용하여 연락처 속성 값을 전달하는 방법을 알아보세요.