Salesforce Marketing Cloud 통합을 사용하면 가입한 모든 사람이 이메일 주소를 연락처 키로 하여 Marketing Cloud에 연락처로 생성되거나 업데이트됩니다. 보통 설정에는 Salesforce 관리자의 도움이 필요합니다.
준비 사항
- Salesforce Marketing Cloud 계정과 Setup > Installed Packages에 액세스할 수 있는 사용자(보통 Marketing Cloud 관리자).
- 모든 기본 통합이 포함된 Scratcher 요금제. 버튼이 잠겨 있다면 체험, 요금제 및 체험 종료 후를 참고하세요.
1단계: Marketing Cloud에서 API 자격 증명 만들기
- Marketing Cloud에서 (이름 아래 메뉴의) Setup을 엽니다.
- Apps > Installed Packages로 이동해 New를 클릭합니다. 패키지 이름(예: “Scratcher”)을 지정하고 저장합니다.
- Add Component를 클릭하고 API Integration, 그다음 Server-to-Server를 선택합니다.
- 아래에 나열된 권한을 설정하고 저장합니다.
- 컴포넌트를 엽니다. Client Id, Client Secret, Authentication Base URI, REST Base URI를 복사합니다.
- 패키지가 연락처를 넣을 비즈니스 유닛에 액세스할 수 있는지 확인합니다(패키지의 Access).
- 팀에서 Scratcher 리드용으로 사용하는 데이터 익스텐션의 외부 키를 찾습니다. Contact Builder 또는 Email Studio에서 데이터 익스텐션을 열고 External Key를 복사하세요.
패키지에 필요한 권한
Scratcher는 Marketing Cloud에 정확히 다음 스코프를 요청하므로 컴포넌트에서 이를 허용해야 합니다.
- Contacts > List and Subscribers: Read 및 Write. 이메일로 연락처를 찾고 생성하거나 업데이트하는 데 필요합니다.
- Data > Data Extensions: Write.
그 외에는 필요하지 않습니다.
2단계: Scratcher에 연결하기
- Scratcher에서 설정 > 통합으로 이동해 Salesforce Marketing Cloud를 클릭합니다.
- 필드를 입력합니다.
- Auth Base URL: Authentication Base URI(예:
https://xxxx.auth.marketingcloudapis.com). - Rest Base URL: REST Base URI(예:
https://xxxx.rest.marketingcloudapis.com). - Client ID 및 Client Secret.
- Data extension id: 1단계에서 찾은 외부 키.
- Auth Base URL: Authentication Base URI(예:
- 통합 설치를 클릭합니다. Scratcher가 Marketing Cloud에 로그인해 정보를 확인합니다.
두 URL 모두 Marketing Cloud API 주소(marketingcloudapis.com으로 끝나는 주소)여야 합니다. 다른 주소는 거부됩니다.
3단계: 캠페인에서 켜기
- 편집기에서 연결 > 통합 > Salesforce Marketing Cloud로 이동해 활성화를 클릭합니다.
- 계정을 두 개 이상 연결했다면 계정 선택에서 계정을 고릅니다.
- 필드 매핑에서 필드 매핑 추가를 클릭하고 Scratcher 필드를 선택한 다음 외부 필드 이름에 Marketing Cloud의 속성 이름을 입력합니다.
- 필요하면 **권한으로 필터링(선택 사항)**에서 동의 체크박스를 선택합니다.
- 저장을 클릭한 다음 테스트를 클릭합니다.
참고: 선택할 목록이 없으므로 Scratcher는 활성화를 클릭하는 즉시 전송을 시작합니다. 캠페인이 라이브되기 전에 활성화하거나, 바로 매핑을 설정하세요.
전송 내용
- 이메일 주소는 연락처 키로 사용되며, HTML 이메일이 켜진 상태로 Email Addresses 속성 집합에 저장됩니다.
- 양식의 이름과 성은 Email Demographics에 저장됩니다.
- 매핑한 필드는 입력한 이름으로 Custom Data라는 속성 집합에 저장됩니다. 관리자에게 Contact Builder에서 일치하는 속성 이름으로 해당 속성 집합을 만들어 달라고 요청하세요.
신규 가입자는 1~2분 안에 전송되며, 캠페인의 기존 리드는 통합을 활성화할 때 전송됩니다.
문제 해결
- 설치 시 “All or some of the fields are invalid. The integration failed to validate the fields.”: 두 URL, Client ID와 Secret, 그리고 패키지에 위의 권한이 있는지 확인하세요.
- 알 수 없는 속성으로 전송이 실패하는 경우: 외부 필드 이름이 Custom Data의 속성과 일치하지 않습니다. 이름을 수정하거나 속성을 추가하세요.
- “The Salesforce Marketing Cloud urls must be marketingcloudapis.com addresses.”: 올바른 URL로 통합을 다시 설치하세요.
Sales Cloud처럼 Salesforce와 더 깊이 연결해야 하나요? Enterprise 요금제에서는 함께 구축해 드릴 수 있습니다. 미팅을 예약하세요.