양식 처리기에 외부 양식 연결
양식 처리기를 만들고 게시한 후 외부 양식을 구성하여 Salesforce에 데이터를 보냅니다.
필수 Edition
지원되는 Edition을 확인하세요.
| 필요한 사용자 권한 | |
|---|---|
| 양식 처리기 만들기: | Marketing Cloud 관리자 권한 집합 AND 모든 CMS 작업 영역 공동작업자 역할 |
| 양식 처리기 게시: | Marketing Cloud 관리자 권한 집합 AND 콘텐츠 관리자 또는 콘텐츠 관리자의 CMS 작업 영역 공동작업자 역할 |
| CORS 허용 목록 구성: | 모든 데이터 수정 |
다음 단계를 완료하기 전에 양식 처리기를 만들고 게시합니다.
양식에서 Salesforce로 데이터를 보내는 방법에는 두 가지가 있습니다. 사이트의 구조 및 기능에 가장 적합한 연결 유형을 선택합니다.
| JavaScript 코드 조각(클라이언트측) | 직접 게시 URL(서버측) |
|
|---|---|---|
| 작동 방법 | 방문자가 양식을 제출하면 페이지의 스크립트가 양식 데이터를 Salesforce로 보냅니다. | 양식이 페이지에 스크립트가 없는 Salesforce URL에 데이터를 직접 게시합니다. |
| 사이트에 추가하기 | 페이지의 HTML에 붙여 넣는 <script> 태그 및 양식 속성입니다. |
양식 또는 웹후크 대상에 대한 작업으로 설정한 URL입니다. |
| 가장 적합한 | HTML을 제어하고 스크립트를 추가할 수 있는 페이지입니다. | 사용자 정의 스크립트를 허용하지 않는 타사 양식 빌더, 엄격한 콘텐츠 보안 정책(CSP) 규칙이 있는 페이지, 백엔드 서버에서 게시되는 양식 |
| 웹 추적 지원 | 예 | 아니요 |
| ID 확인 지원 | 예 | 아니요 |
| CORS 허용 목록 항목 필요 | 예 | 예 |
두 방법 모두 동일한 양식 처리기에 데이터를 보내고 동일한 플로를 트리거합니다. 두 방법 모두 CORS 허용 목록에서 도메인을 인증해야 합니다.
연결 유형 중 하나에서 양식의 각 필드에 양식 처리기의 해당 외부 필드 이름과 정확하게 일치하는 HTML name 특성을 사용해야 합니다. 이름이 일치하지 않을 경우 양식 처리기가 값을 수집하지 않습니다. 예를 들어 외부 필드 이름 email_address을 Email 필드에 매핑한 경우 양식의 해당 필드에 대한 name 특성도 email_address이어야 합니다.
옵션 1: 클라이언트측 연결을 사용하도록 양식 구성
페이지의 HTML을 제어하고 스크립트를 추가할 수 있는 경우 이 방법을 사용합니다. 스크립트가 방문자의 브라우저에서 실행되므로 이 방법은 웹 추적 및 ID 확인을 지원합니다. 따라서 이 방법은 양식 제출을 방문자의 웹 활동에 연결할 수 있습니다.
- 양식 처리기를 게시합니다.
-
코드 조각 탭의 클라이언트측 양식 처리기 아래에서 추적 스크립트를 복사합니다. 스크립트는 이 예와 유사합니다.
<script async src="https://YOUR_DOMAIN/lp/assets/scripts/external-form-handler-host.min.js" onload="SFDCFormHandler.init('https://YOUR_DOMAIN/lp')"></script> -
사이트의 HTML 코드에서 닫는
</body>태그 앞에 스크립트를 붙여넣습니다. -
코드 조각 탭에서 양식 특성을 복사합니다. 특성은 이 예와 유사합니다.
<form id="CONTENT_KEY" data-uma-forms="true"></form> -
HTML에서
<form>태그에id및data-uma-forms특성을 추가합니다. -
각 양식 필드의 HTML
name특성이 매핑된 외부 필드 이름과 일치하는지 확인합니다. - CORS 허용 목록에 양식을 호스팅하는 도메인을 추가합니다. 이 단계를 수행하면 도메인에서 Salesforce에 제출을 보낼 수 있습니다.
- 사용자 참여를 모니터링하려면 웹 추적을 설정합니다.
방문자가 양식을 제출하면 스크립트가 Salesforce에 데이터를 보내고 양식 처리기가 제출을 처리하고 플로를 트리거합니다. 그러면 양식 처리기가 구성한 성공 또는 오류 URL로 리디렉션합니다.
옵션 2: 서버측 연결을 사용하도록 양식 구성
페이지에 코드를 추가하거나 코드에 사용자 정의 구성을 수행할 수 없는 경우 서버측 연결을 사용합니다. 이 방법을 사용하면 양식 처리기가 대상 URL을 제공하고 해당 URL에 데이터를 보내도록 양식을 구성합니다. 스크립트를 포함하지 않으므로 이 방법은 사용자 정의 JavaScript를 허용하지 않는 양식 도구에서 작동합니다. 이 방법은 엄격한 콘텐츠 보안 정책(CSP) 규칙이 있는 페이지와 백엔드 서버에서 제출하는 양식에도 유용합니다.
-
양식 처리기의 코드 조각 탭의 서버측 양식 처리기 아래에서 양식 작업 URL을 복사합니다. URL은 이 예와 유사합니다.
https://YOUR_DOMAIN/lp/cms/form/submit/v1/CONTENT_KEY -
양식을 구성하여 Salesforce에 데이터를 보냅니다. 구현 단계는 양식을 구현하는 방법에 따라 다릅니다.
타사 양식 빌더 또는 플러그인을 사용하는 경우 타사 도구의 설정에서 양식의 작업, URL 후행 또는 웹후크 대상을 구성할 수 있는 필드를 찾습니다. 해당 필드에 Salesforce URL을 입력합니다. HTML을 수정할 수 있지만 스크립트를 추가할 수 없는 경우 <form>태그의action특성을 Salesforce URL로 설정하고method특성을POST로 설정합니다.양식에서 백엔드 프로세스를 사용하는 경우 application/x-www-form-urlencoded인코딩을 사용하여 양식 데이터와 함께 Salesforce URL로 POST 요청을 보냅니다. -
각 필드의 이름이 매핑된 외부 필드 이름과 정확하게 일치하는지 확인합니다.
양식 처리기는 정확하게 일치하는 경우에만 필드를 수집합니다.
- CORS 허용 목록에 양식을 호스팅하는 도메인을 추가합니다. 이 단계를 수행하면 도메인에서 Salesforce에 제출을 보낼 수 있습니다.
CORS 허용 목록 구성
두 연결 방법 모두 Salesforce에서 양식 제출을 수락하기 전에 도메인을 인가해야 합니다. 도메인에 권한을 부여하지 않을 경우 Salesforce가 처리하기 전에 제출을 차단합니다. 도메인을 인증하려면 CORS 허용 목록에 추가합니다.
-
양식을 호스팅하는 도메인을 식별합니다(예:
https://www.example.com). 모든 하위 도메인을 인가하려면https://*.example.com와 같은 와일드카드를 사용합니다. - CORS 허용 목록에 도메인을 추가합니다.
