Salesforce CRM과 연동하는 방법

학습 내용

Salesforce CRM을 Klaviyo와 연동하는 방법을 알아보세요. 이 연동을 사용하면 안내에 따라 앱 내 설정 플로우에서 Salesforce 계정을 연결하고, 동기화할 오브젝트를 선택하며, 필드를 매핑할 수 있어요.

이 연동을 사용하면 Klaviyo가 Salesforce 데이터(예: 리드 또는 연락처)를 Klaviyo 프로필로 자동 동기화해 CRM 데이터를 사용해 메시지를 개인화하고 고객을 세그먼트화할 수 있어요.

시작하기 전에 알아야 할 것

시작하기 전에, 다음 사항을 확인해 주세요:

• Salesforce 계정에 로그인되어 있어요.
• 비즈니스에 Salesforce 조직이 여러 개 있는 경우 올바른 조직에 로그인되어 있어요.
• Salesforce 계정에 대한 관리자 액세스 권한이 있어요.
• Salesforce 조직에 API 액세스 권한이 있고, Salesforce 사용자에게도 API를 사용할 권한이 있어요.

Salesforce를 Klaviyo에 연결

1. Klaviyo에 로그인하세요. 그런 다음, 연동 탭을 선택하세요.
2. 앱 둘러보기 를 클릭해 Klaviyo 앱 마켓플레이스를 여세요. Salesforce 앱 목록을 검색한 다음 여세요. 그런 다음 설치를 클릭합니다.
3. Salesforce 연동 설정 플로우로 리디렉션돼요. 1단계에서는 프로덕션 또는 샌드박스 Salesforce 조직에 연결할지 선택한 다음 Klaviyo 클라이언트 앱 설치를 클릭해 주세요.
   

4. Salesforce에서 설치 마법사를 따라 Klaviyo에 연결하려는 Salesforce 조직에서 “Klaviyo Salesforce OAuth Connector” 패키지를 확인하고 설치해 주세요.
   

5. 설치가 완료되면 Klaviyo의 Salesforce 연동 설정 페이지로 돌아가세요. 그런 다음 2단계를 따라 Salesforce에 연결을 클릭하세요.
   

6. 허용 을 클릭해 OAuth 플로우를 완료하고 Klaviyo를 Salesforce에 연결을 마무리해 주세요.
   

동기화할 Salesforce 개체 선택

연결한 후 Klaviyo에 동기화할 Salesforce 개체를 선택하라는 메시지가 표시됩니다.

이제 Klaviyo에 동기화할 최대 3개의 개체 를 선택할 수 있어요. 사용 가능한 옵션은 다음과 같아요:

• 리드 - Salesforce 제품 또는 서비스에 관심을 보인 잠재 고객
• 연락처 - Salesforce 조직의 계정과 연결된 개인
• 계정 - 비즈니스와 관련된 조직 또는 개인(예: 고객, 경쟁사, 파트너)입니다.
• Opportunity - 잠재적 판매 또는 거래
• 기타 - Case 또는 Order와 같은 추가 Salesforce 개체 이름 목록을 쉼표로 구분하여 입력하세요. 개체는 내 Salesforce 조직에서 사용할 수 있어야 합니다.

Salesforce에서 동기화된 객체는 Klaviyo 프로필로 생성되거나 업데이트돼요. 여러 객체를 동기화할 때:

• 선택한 모든 객체에서 유효한 이메일 주소가 있는 레코드가 Klaviyo로 동기화돼요.
• 레코드의 이메일 주소가 기존 Klaviyo 프로필과 일치하면 해당 프로필이 업데이트돼요.
• 레코드가 기존 Klaviyo 프로필과 일치하지 않으면 새 프로필이 생성됩니다.
• 동일한 이메일 주소로 동기화된 여러 객체에 동일한 사람이 존재하는 경우, Klaviyo는 이메일을 기준으로 해당 항목을 단일 프로필 로 통합해요. (필드 매핑은 다음 단계에서 객체별로 설정해요.)

오브젝트를 선택한 후 다음을 클릭해 필드 매핑을 구성해 주세요.

Salesforce 필드를 Klaviyo 속성에 매핑하기

다음으로 Salesforce 필드를 Klaviyo 프로필 속성에 매핑할 거예요. 이메일, 전화번호, 이름, 성 같은 핵심 매핑은 선택한 객체에서 해당 필드를 사용할 수 있으면 미리 매핑돼요. 각 객체에는 유효한 이메일 주소가 포함된 Salesforce 필드를 Klaviyo의 이메일 속성에 매핑해야 해요.

동기화할 Salesforce 객체를 여러 개 선택한 경우 각 객체별로 별도로 필드 매핑을 구성하세요. 이렇게 하면 각 객체의 어떤 필드가 Klaviyo 프로필 속성이 될지 제어할 수 있어요.

매핑 추가 또는 편집

• 현재 선택된 객체 에 대해 추가 Salesforce 필드를 매핑하려면 매핑 추가 를 사용해 주세요.
• 왼쪽에서 Salesforce 필드를 선택하고 오른쪽에서 해당 Klaviyo 속성을 선택해 주세요.
• 필요한 경우 휴지통 아이콘 을 사용해 매핑을 삭제해 주세요.
• 동기화된 각 객체에 대해 이 과정을 반복해 주세요.
  

동일한 Klaviyo 프로필 속성(예: 전화번호 또는 도시)이 여러 Salesforce 객체에서 매핑되어 있으면, 한 객체를 동기화할 때 다른 객체에서 동기화된 값을 덮어쓸 수 있어요. 각 객체의 값을 각각 유지해야 한다면, 필드를 별도의 맞춤 속성으로 매핑해 주세요.

CSV를 통해 매핑을 가져오기(선택 사항)

구독 취소 처리(선택 사항)

Salesforce에서 Email Opt Out이 true일 때 Klaviyo 프로필을 이메일 구독 취소로 표시하려면 Salesforce에서 구독 취소 동기화를 선택하세요. 이 옵션은 선택한 객체에 Email Opt Out 필드가 있을 때만 사용할 수 있어요. Email Opt Out을 다시 false로 변경해도 Klaviyo에서 해당 프로필이 다시 구독 처리되지는 않아요.

여러 개의 객체를 선택했다면, 각 객체를 구성한 후 다음을 클릭해 다음 객체로 이동해 주세요. 마지막 객체에서는 아래 설명대로 설정을 완료해 주세요.

설정 완료

매핑이 완료되면 설정 완료를 클릭해 주세요. Klaviyo가 연동을 최종 처리해요(보통 몇 초 정도 걸려요). Salesforce 계정이 성공적으로 연결되고 동기화되면 확인 메시지가 표시돼요.

Salesforce 동기화를 모니터링하고 데이터를 확인하기

Salesforce 연동은 1시간마다 Klaviyo로 동기화돼요.

프로필 데이터를 확인해 주세요

1. 오디언스 > 프로필로 이동하세요.
2. Salesforce 레코드의 이메일 주소를 검색한 다음 Enter 키를 누르세요.
3. 일치하는 프로필을 열고 매핑된 속성을 Salesforce와 비교해 보세요.

Lead 객체를 동기화하는 경우 Became Lead 이벤트도 확인해 주세요:

1. 애널리틱스 > 지표로 이동한 다음 Salesforce로 필터링하고 리드가 됨을 클릭해 주세요. 활동 피드를 선택해 주세요.
2. 연동에서 데이터 동기화가 시작되면 이 활동 피드에 Salesforce 아이콘이 있는 리드가 됨 이벤트가 추가된 것을 볼 수 있어요.
3. 일별 리드 활동을 비교하려면 차트를 선택하고 Salesforce에서 사용한 것과 동일한 날짜 범위를 사용해 주세요. 유효한 이메일 주소가 있는 레코드만 동기화되며, 동일한 이메일 주소를 가진 여러 레코드가 하나의 Klaviyo 프로필을 공유할 수 있어요.
4. 어제의 데이터 포인트 위에 마우스를 올리거나 차트 아래의 표를 사용해 리드가 됨 이벤트 수를 확인한 다음 Salesforce 리드 데이터와 비교해 보세요.
5. 개수가 다르면 같은 표준 시간대를 비교하고 있는지 확인한 뒤, 매시간 동기화로 인한 시간차를 감안해 주세요. 또한 누락되었거나 유효하지 않은 이메일 주소가 있는지도 확인해 주세요. Klaviyo 표준 시간대를 확인하는 방법은 다음과 같습니다.
   • 왼쪽 하단에서 계정 이름을 클릭합니다.
   • 설정 > 계정을 선택합니다.
   • 시간대까지 아래로 스크롤하세요.

Klaviyo의 Salesforce 지표 및 프로필 속성

Klaviyo는 Lead 객체를 동기화할 때 Became Lead 지표를 동기화합니다. 이 이벤트는 Salesforce의 리드 생성 날짜를 사용하며, 이벤트 데이터에 Salesforce 필드를 포함하지 않습니다. 다른 Salesforce 객체는 Became Lead 이벤트를 생성하지 않고 프로필 속성을 업데이트합니다.

각 객체에서 동기화되는 프로필 속성은 해당 객체의 필드 매핑에 따라 달라져요. 해당 Salesforce 필드를 사용할 수 있으면 Klaviyo가 다음 매핑을 미리 채워요:

• FirstName → 이름
• LastName → 성
• 제목 → 제목
• 회사 → 조직
• 도로명 주소 → 주소 1
• 도시 → 도시
• 주/도 → 주/도
• PostalCode → 우편번호
• 국가 → 국가
• 위도 → 위도
• 경도 → 경도
• 전화 → 전화번호
• 이메일 → 이메일

Website, LeadSource, Status, Industry, NumberOfEmployees 같은 다른 사용 가능한 필드를 동기화하려면 해당 필드의 매핑을 추가해 주세요.

그런 다음 이러한 속성을 세그먼트, 플로우에서 사용하고, 메시지 템플릿에 고객 속성을 동적으로 채우는 데 사용할 수 있어요.

문제 해결

설치 및 인증 문제

기본 인증에서 OAuth로 마이그레이션

OAuth가 지원되기 전에 Salesforce 연동을 설정했다면, Salesforce 애플리케이션이 기본 인증을 사용해 Klaviyo에 연결되어 있을 수 있습니다.

연동에 이제 OAuth 인증이 필요합니다가 표시되면 아래 단계에 따라 마이그레이션해 주세요. 이 마이그레이션 안내 메시지가 표시되는 동안에는 Klaviyo에서 기본 인증 자격 증명을 업데이트할 수 없어요.

1. Klaviyo와 연결된 Salesforce 조직에 로그인해 주세요.
2. Klaviyo에서 Salesforce 연동의 설정 탭을 여세요. OAuth 인증이 이제 필요합니다 배너에서 외부 Klaviyo 앱을 클릭해 연결된 Salesforce 조직에 “Klaviyo Salesforce OAuth Connector” 패키지를 설치하세요.

3. 설치가 완료되면 Salesforce 연동의 설정 탭으로 돌아가 업데이트를 클릭해 주세요. Salesforce에서 메시지가 표시되면 연결을 완료하려면 허용을 클릭해 주세요.

자세한 내용은 이 가이드 상단의 “Salesforce를 Klaviyo에 연결” 섹션을 참고해 주세요.

오류 “외부 Klaviyo 앱이 설치되어 있지 않습니다. 설치한 후 다시 시도해 주세요.”

이 오류는 인증(또는 재인증)하려는 Salesforce Org에 “Klaviyo Salesforce OAuth Connector” 패키지가 설치되어 있지 않음을 나타내요.

다음을 확인해 주세요:

1. Salesforce에 로그인되어 있어요.
2. Klaviyo와 연동된 Salesforce 조직에 로그인되어 있습니다. 비즈니스에 Salesforce 조직이 여러 개 있는 경우, 잘못된 조직에 로그인되어 있을 수 있습니다.
3. 올바른 Salesforce 조직에 로그인되어 있는데도 이 오류가 계속 발생한다면 Salesforce에서 설치된 패키지를 검색해 “Klaviyo Salesforce OAuth Connector” 패키지가 설치되어 있는지 확인해 주세요. 설치되어 있지 않다면 연동 설정 플로우에서 1단계를 다시 수행해 패키지를 설치해 주세요(이 가이드 상단의 “Connect Salesforce to Klaviyo” 섹션 참고). 또는 기존 연동이 있고 OAuth로 마이그레이션하는 중이라면 하이퍼링크된 “external Klaviyo app” 텍스트를 클릭해 패키지를 설치해 주세요(위의 “Migrate to OAuth” 섹션 참고).

그래도 문제가 계속 발생하면 지원 팀에 문의하세요.

계정 불일치 오류 메시지

비즈니스에 여러 Salesforce 조직이 있는 경우, 연동을 다시 인증할 때 현재 Klaviyo에 연결된 Salesforce 조직에 로그인되어 있는지 확인해 주세요.

Klaviyo에서 다른 Salesforce 조직에 다시 연결하고 있다고 감지하면 계정 불일치 오류가 표시돼요:

오류를 해결하려면 다음 중 하나를 수행해 주세요:

1. 기존 Salesforce 조직 다시 연결: 창을 닫고 Salesforce에서 로그아웃한 다음, 현재 Klaviyo에 연결된 Salesforce 조직에 로그인하고 다시 시도해 주세요.
2. 다른 Salesforce 조직에 연결: 연동을 제거하면 Salesforce 객체 매핑이 삭제되며, 이후 다시 구성해야 해요. 연동 제거를 클릭하고, Klaviyo에서 Salesforce 연동을 다시 설치한 다음, 새 Salesforce 조직을 사용해 설정을 완료해 주세요.

필드 매핑 경고 및 오류

Klaviyo는 데이터가 안정적으로 동기화될 수 있도록 Salesforce 필드 매핑을 지속적으로 검증해요. 매핑된 Salesforce 필드를 사용할 수 없게 되면(예: 삭제, 이름 변경, 또는 권한 변경) 연동 설정에서 경고 또는 오류가 표시될 수 있어요.

필수가 아닌 필드를 사용할 수 없을 때

매핑된 Salesforce 필드를 더 이상 사용할 수 없고 필수 항목이 아니라면 Klaviyo는 다음을 수행해요:

• 누락된 필드가 무엇인지 표시하는 경고를 표시해 주세요.
• 사용 가능한 다른 모든 필드 동기화를 계속하세요.
• 사용할 수 없는 필드는 업데이트되거나 제거될 때까지 이후 동기화에서 제외해 주세요.

이를 해결하려면:

1. Klaviyo에서 Salesforce 연동을 열고 설정을 선택해 주세요.
2. 영향을 받은 객체의 작업 메뉴를 열고 편집을 선택해 주세요.
3. 유효하지 않은 필드 매핑을 업데이트하거나 제거해 주세요.
4. 저장을 클릭합니다.
5. 과거 동기화는 현재 프로필 값을 덮어쓸 수 있지만, 기존 프로필 속성은 삭제하지 않아요. 과거 동기화 실행을 선택해 수정된 매핑을 기존 레코드에 적용하거나, 동기화 건너뛰기를 선택해 일반적인 시간별 업데이트를 계속하세요.

업데이트가 완료되면 동기화가 예상대로 계속 진행돼요.

이메일에 매핑된 필드를 사용할 수 없는 경우

Klaviyo의 이메일 속성에 매핑된 Salesforce 필드를 더 이상 개체에서 사용할 수 없는 경우(예: 스키마 변경 또는 권한 문제로 인해) Klaviyo는 다음을 수행해요:

• Email에 매핑된 필드가 누락되었다는 오류를 표시하세요.
• 영향을 받는 개체에 대한 데이터 동기화를 중지하세요.
• 동기화를 복원하려면 필드 매핑을 업데이트하라는 메시지가 표시돼요.

이를 해결하려면:

1. Klaviyo에서 Salesforce 연동을 열고 설정을 선택해 주세요.
2. 영향을 받은 객체의 작업 메뉴를 열고 편집을 선택해 주세요.
3. 유효한 이메일 주소가 포함된 사용 가능한 Salesforce 필드를 Klaviyo의 Email 속성에 매핑해 주세요.
4. 저장을 클릭합니다.
5. 과거 동기화는 현재 프로필 값을 덮어쓸 수 있지만, 기존 프로필 속성은 삭제하지 않아요. 수정된 이메일 매핑으로 기존 레코드를 다시 시도하려면 과거 동기화 실행을 선택하고, 일반적인 매시간 업데이트를 계속하려면 동기화 건너뛰기를 선택해 주세요.

Email 필드가 다시 성공적으로 매핑되면, 데이터 동기화가 자동으로 재개돼요.

Klaviyo에서 프로필이 누락됨

Salesforce 레코드가 Klaviyo에서 프로필로 표시되지 않는 경우, 먼저 동기화하는 각 객체에 대해 유효한 이메일 필드가 매핑되어 있는지 확인해 주세요. Klaviyo는 이메일 주소를 프로필을 생성하거나 업데이트하기 위한 필수 식별자로 사용하므로, 이메일 필드가 매핑되지 않았거나 유효한 이메일 값이 없는 레코드는 프로필로 동기화되지 않아요. 다음 사항을 확인해 주세요:

• Salesforce 이메일 필드는 선택한 모든 객체에 대해 Klaviyo의 이메일 속성에 매핑됩니다.
• 매핑된 이메일 필드에는 Salesforce의 실제 이메일 값이 포함되어 있어요. 비어 있거나 유효하지 않은 이메일은 레코드가 프로필로 동기화되는 것을 방해할 수 있어요.

이메일 매핑을 수정한 후 변경 사항을 저장하고 과거 데이터 동기화 실행을 선택해 기존 레코드를 다시 시도해 주세요. 대신 Salesforce에서 이메일 값을 수정했다면, 업데이트된 레코드는 다음 매시간 동기화 때 반영됩니다.

결과

이제 Klaviyo 계정을 Salesforce CRM과 통합하고 동기화된 데이터를 검토했어요.

추가 자료