Salesforce CRM 연결

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:
대상

작성 대상:

관리자
사용자

개요 overview

Salesforce CRM은(는) 인기 있는 CRM(고객 관계 관리) 플랫폼이며 아래에 설명된 프로필 유형을 지원합니다.

리드 - 리드는 판매하는 제품이나 서비스에 관심이 있는(또는 관심이 없는) 사람 또는 회사의 이름입니다.
연락처 - 연락처는 담당자 중 한 명이 관계를 맺고 잠재 고객으로 자격을 얻은 개인입니다.

이 Adobe Experience Platform 대상은(는) 위에서 설명한 두 유형의 프로필을 모두 지원하는 Salesforce composite API을(를) 활용합니다.

세그먼트를 활성화할 때 리드 또는 연락처 중 하나를 선택하고 특성 및 대상 데이터를 Salesforce CRM (으)로 업데이트할 수 있습니다.

Salesforce CRM은(는) 암호 부여가 있는 OAuth 2를 인증 메커니즘으로 사용하여 Salesforce REST API와 통신합니다. Salesforce CRM 인스턴스에 대한 인증 지침은 대상에 대한 인증 섹션에서 아래에 더 나와 있습니다.

사용 사례 use-cases

마케터는 Adobe Experience Platform 프로필의 속성에 따라 개인화된 경험을 사용자에게 제공할 수 있습니다. 오프라인 데이터에서 대상을 작성하고 이 대상을 Salesforce CRM으로 보내어 Adobe Experience Platform에서 대상 및 프로필이 업데이트되는 즉시 CRM 멤버십을 업데이트할 수 있습니다.

전제 조건 prerequisites

Experience Platform의 사전 요구 사항 prerequisites-in-experience-platform

Salesforce CRM 대상으로 데이터를 활성화하기 전에 Experience Platform에서 만든 스키마, 데이터 세트 및 세그먼트가 있어야 합니다.

Salesforce CRM의 필수 구성 요소 prerequisites-destination

Platform에서 Salesforce 계정으로 데이터를 내보내려면 Salesforce CRM에서 다음 사전 요구 사항을 참고하십시오.

Salesforce 계정이 있어야 합니다. prerequisites-account

아직 계정이 없는 경우 Salesforce 평가판 페이지로 이동하여 등록하고 Salesforce 계정을 만드십시오.

Salesforce 내에서 연결된 앱 구성 prerequisites-connected-app

먼저 Salesforce 계정 내에 Salesforce 연결된 앱이 없는 경우 구성해야 합니다. Salesforce CRM은(는) 연결된 앱을 활용하여 Salesforce에 연결합니다.

그런 다음 Salesforce connected app에 대해 OAuth Settings for API Integration을(를) 사용하도록 설정합니다. 자세한 내용은 Salesforce 설명서를 참조하세요.

또한 Salesforce connected app에 대해 아래에 언급된 범위를 선택해야 합니다.

chatter_api
lightning
visualforce
content
openid
full
api
web
refresh_token
offline_access

마지막으로 Salesforce 계정 내에서 password 부여가 활성화되었는지 확인하십시오. 지침이 필요한 경우 Salesforce 특별 시나리오에 대한 OAuth 2.0 사용자 이름 암호 흐름 설명서를 참조하십시오.

IMPORTANT

Salesforce 계정 관리자가 신뢰할 수 있는 IP 범위에 대한 액세스를 제한한 경우 해당 관리자에게 연락하여 Experience Platform IP를 허용 목록에추가된으로 받아야 합니다. 추가 지침이 필요한 경우 Salesforce 연결된 앱에 대한 신뢰할 수 있는 IP 범위에 대한 액세스 제한 설명서를 참조하십시오.

Salesforce 내에 사용자 지정 필드 만들기 prerequisites-custom-field

대상을 Salesforce CRM 대상으로 활성화할 때 대상 일정 단계에서 활성화된 각 대상에 대해 매핑 ID 필드에 값을 입력해야 합니다.

Salesforce CRM에서는 Experience Platform에서 들어오는 대상을 올바르게 읽고 해석하고 Salesforce 내의 대상 상태를 업데이트하려면 이 값이 필요합니다. 대상 상태에 대한 지침이 필요한 경우 대상 멤버십 세부 정보 스키마 필드 그룹에 대한 Experience Platform 설명서를 참조하세요.

플랫폼에서 Salesforce CRM (으)로 활성화하는 각 대상에 대해 Salesforce 내에 Text Area (Long) 유형의 사용자 지정 필드를 만들어야 합니다. 비즈니스 요구 사항에 따라 256~131,072자 사이의 모든 크기의 필드 문자 길이를 정의할 수 있습니다. 사용자 지정 필드 형식에 대한 자세한 내용은 Salesforce 사용자 지정 필드 형식 설명서 페이지를 참조하세요. 필드 만들기에 대한 지원이 필요한 경우 Salesforce 설명서를 참조하여 사용자 지정 필드 만들기를 참조하십시오.

IMPORTANT

필드 이름에 공백 문자를 포함하지 마십시오. 대신 밑줄 (_) 문자를 구분 기호로 사용하십시오.
Salesforce 내에서 활성화된 각 플랫폼 세그먼트에 대해 매핑 ID 내에 지정된 값과 정확히 일치하는 필드 이름 을(를) 가진 사용자 정의 필드를 만들어야 합니다. 예를 들어 아래 스크린샷에는 이름이 crm_2_seg인 사용자 지정 필드가 표시됩니다. 대상을 이 대상으로 활성화할 때 crm_2_seg을(를) 매핑 ID(으)로 추가하여 Experience Platform의 대상 대상을 이 사용자 지정 필드에 채웁니다.

Salesforce, 1단계 - 데이터 형식 선택 에서 사용자 지정 필드를 만드는 예는 다음과 같습니다.
사용자 지정 필드 만들기, 1단계 - 데이터 형식을 선택하는 방법을 보여 주는 Salesforce UI 스크린샷

Salesforce, 2단계 - 사용자 정의 필드에 대한 세부 정보를 입력 하는 사용자 정의 필드 생성의 예는 다음과 같습니다.
사용자 정의 필드 만들기, 2단계를 보여주는 Salesforce UI 스크린샷 - 사용자 정의 필드에 대한 세부 정보를 입력합니다.

TIP

Platform 대상에 사용되는 사용자 정의 필드와 Salesforce 내의 다른 사용자 정의 필드를 구별하기 위해 사용자 정의 필드를 만들 때 인식 가능한 접두사 또는 접미사를 포함할 수 있습니다. 예를 들어 test_segment 대신 Adobe_test_segment 또는 test_segment_Adobe을(를) 사용합니다.
Salesforce에 이미 다른 사용자 정의 필드가 만들어져 있는 경우 플랫폼 세그먼트와 동일한 이름을 사용하여 Salesforce의 대상자를 쉽게 식별할 수 있습니다.

NOTE

Salesforce의 개체는 25개의 외부 필드로 제한됩니다. 사용자 지정 필드 특성을(를) 참조하십시오.
이 제한은 언제든지 최대 25개의 Experience Platform 대상 멤버십을 활성화할 수 있음을 의미합니다.
Salesforce 내에서 이 제한에 도달한 경우 새 매핑 ID 을(를) 사용하려면 먼저 Experience Platform 내에서 이전 대상자에 대한 대상 상태를 저장하는 데 사용된 Salesforce의 사용자 지정 특성을 제거해야 합니다.

Salesforce CRM 자격 증명 수집 gather-credentials

Salesforce CRM 대상에 인증하기 전에 아래 항목을 적어 두십시오.

자격 증명

설명

예

Username

Salesforce 계정 사용자 이름입니다.

Password

Salesforce 계정 암호입니다.

Security Token

대상에 대한 인증을(를) 수행할 때 암호(으)로 사용할 연결된 문자열을 만들기 위해 나중에 Salesforce 암호 끝에 추가할 Salesforce 보안 토큰입니다.
보안 토큰이 없는 경우 Salesforce 인터페이스에서 다시 생성하는 방법에 대해 알아보려면 Salesforce 설명서를 참조하여 보안 토큰을 다시 설정하십시오.

Custom Domain

Salesforce 도메인 접두사입니다.
Salesforce 인터페이스에서 이 값을 가져오는 방법을 알아보려면 Salesforce 설명서를 참조하세요.

Salesforce 도메인이
인 경우 d5i000000isb4eak-dev-ed.my.salesforce.com,
값으로 d5i000000isb4eak-dev-ed이(가) 필요합니다.

Client ID

Salesforce Consumer Key.
Salesforce 인터페이스에서 이 값을 가져오는 방법에 대해 알아보려면 Salesforce 설명서를 참조하세요.

Client Secret

Salesforce Consumer Secret.
Salesforce 인터페이스에서 이 값을 가져오는 방법에 대해 알아보려면 Salesforce 설명서를 참조하세요.

가드레일 guardrails

Salesforce은(는) 요청, 속도 및 시간 제한을 적용하여 트랜잭션 로드 균형을 조정합니다. 자세한 내용은 API 요청 제한 및 할당을 참조하세요.

Salesforce 계정 관리자가 IP 제한을 적용한 경우 Salesforce 계정의 신뢰할 수 있는 IP 범위에 Experience Platform IP 주소를 추가해야 합니다. 추가 지침이 필요한 경우 Salesforce 연결된 앱에 대한 신뢰할 수 있는 IP 범위에 대한 액세스 제한 설명서를 참조하십시오.

IMPORTANT

세그먼트를 활성화할 때 연락처 또는 리드 유형 중 하나를 선택해야 합니다. 대상자에게 선택한 유형에 따라 적절한 데이터 매핑이 있는지 확인해야 합니다.

지원되는 ID supported-identities

Salesforce CRM은(는) 아래 표에 설명된 ID 업데이트를 지원합니다. ID에 대해 자세히 알아보세요.

대상 ID

설명

고려 사항

SalesforceId

세그먼트를 통해 내보내거나 업데이트하는 연락처 또는 잠재 고객 ID에 대한 Salesforce CRM 식별자입니다.

필수

내보내기 유형 및 빈도 export-type-frequency

대상 내보내기 유형 및 빈도에 대한 자세한 내용은 아래 표를 참조하십시오.

항목

유형

참고

내보내기 유형

프로필 기반

필드 매핑에 따라 원하는 스키마 필드 (예: 이메일 주소, 전화 번호, 성) 과(와) 함께 세그먼트의 모든 멤버를 내보냅니다.
Salesforce CRM의 각 대상 상태는 대상 예약 단계 동안 제공된 매핑 ID 값을 기반으로 플랫폼에서 해당 대상 상태로 업데이트됩니다.

내보내기 빈도

스트리밍

스트리밍 대상은 "항상" API 기반 연결입니다. 대상자 평가를 기반으로 Experience Platform에서 프로필이 업데이트되는 즉시 커넥터가 업데이트 다운스트림을 대상 플랫폼으로 전송합니다. 스트리밍 대상에 대해 자세히 알아보세요.

대상에 연결 connect

IMPORTANT

대상에 연결하려면 대상 보기 및 대상 관리 액세스 제어 권한이 필요합니다. 액세스 제어 개요를 읽거나 제품 관리자에게 문의하여 필요한 권한을 받으십시오.

이 대상에 연결하려면 대상 구성 자습서에 설명된 단계를 따르십시오. 대상 구성 워크플로에서 아래 두 섹션에 나열된 필드를 채웁니다.

대상 > 카탈로그 내에서 Salesforce CRM 검색 또는 CRM 범주 아래에서 찾을 수 있습니다.

대상으로 인증 authenticate

대상에 인증하려면 아래의 필수 필드를 입력한 다음 대상에 연결 을(를) 선택하십시오. 자세한 내용은 수집 Salesforce CRM 자격 증명 섹션을 참조하십시오.

자격 증명

설명

사용자 이름

Salesforce 계정 사용자 이름입니다.

암호

Salesforce 보안 토큰과 함께 추가된 Salesforce 계정 암호로 구성된 연결된 문자열.
연결된 값은 {PASSWORD}{TOKEN} 형식입니다.
참고: 중괄호나 공백을 사용하지 마십시오.
예를 들어 Salesforce 암호가 MyPa$$w0rd123이고 Salesforce 보안 토큰이 TOKEN12345....0000인 경우 암호 필드에서 사용할 연결된 값은 MyPa$$w0rd123TOKEN12345....0000입니다.

사용자 지정 도메인

Salesforce 도메인 접두사입니다.
예를 들어 도메인이 d5i000000isb4eak-dev-ed.my.salesforce.com 이면 d5i000000isb4eak-dev-ed을(를) 값으로 제공해야 합니다.

클라이언트 ID

Salesforce이(가) 앱 Consumer Key에 연결했습니다.

클라이언트 암호

Salesforce이(가) 앱 Consumer Secret에 연결했습니다.

인증 방법을 보여 주는 플랫폼 UI 스크린샷입니다.

제공된 세부 정보가 유효하면 UI에 녹색 확인 표시와 함께 연결됨 상태가 표시됩니다. 그런 다음 다음 다음 단계로 진행할 수 있습니다.

대상 세부 정보 입력 destination-details

대상에 대한 세부 정보를 구성하려면 아래의 필수 및 선택 필드를 채우십시오. UI에서 필드 옆에 있는 별표는 필드가 필수임을 나타냅니다.

이름: 나중에 이 대상을 인식할 수 있는 이름입니다.
설명: 나중에 이 대상을 식별하는 데 도움이 되는 설명입니다.
Salesforce ID 유형:
- 내보내거나 업데이트하려는 ID가 연락처 유형인 경우 연락처 을(를) 선택하십시오.
- 내보내거나 업데이트하려는 ID가 리드 유형인 경우 리드 를 선택하십시오.

대상 세부 정보를 표시하는 플랫폼 UI 스크린샷입니다.

경고 활성화 enable-alerts

경고를 활성화하여 대상에 대한 데이터 흐름 상태에 대한 알림을 받을 수 있습니다. 목록에서 경고를 선택하여 데이터 흐름 상태에 대한 알림을 수신합니다. 경고에 대한 자세한 내용은 UI를 사용하여 대상 경고 구독에 대한 안내서를 참조하십시오.

대상 연결에 대한 세부 정보를 모두 제공했으면 다음 을 선택합니다.

이 대상으로 대상자 활성화 activate

IMPORTANT

데이터를 활성화하려면 대상 보기, 대상 활성화, 프로필 보기 및 세그먼트 보기 액세스 제어 권한이 필요합니다. 액세스 제어 개요를 읽거나 제품 관리자에게 문의하여 필요한 권한을 받으십시오.
ID 을(를) 내보내려면 ID 그래프 보기 액세스 제어 권한이 필요합니다.

{width="100" modal="regular"}

이 대상으로 대상을 활성화하는 방법에 대한 지침은 프로필 및 대상을 스트리밍 대상 내보내기 대상으로 활성화를 참조하십시오.

매핑 고려 사항 및 예제 mapping-considerations-example

대상 데이터를 Adobe Experience Platform에서 Salesforce CRM 대상으로 올바르게 보내려면 필드 매핑 단계를 거쳐야합니다. 매핑은 Platform 계정의 XDM(Experience Data Model) 스키마 필드와 대상 대상의 해당 필드 간에 링크를 만드는 것으로 구성됩니다.

대상 필드 에 지정된 특성은 요청 본문을 형성하므로 특성 매핑 표에 설명된 대로 정확히 이름을 지정해야 합니다.

Source 필드 에 지정된 특성은 이러한 제한을 따르지 않습니다. 필요에 따라 매핑할 수 있지만 Salesforce 설명서에 따라 입력 데이터 형식이 유효한지 확인합니다. 입력 데이터가 올바르지 않으면 Salesforce에 대한 업데이트 호출이 실패하고 연락처/잠재 고객이 업데이트되지 않습니다.

XDM 필드를 (API) Salesforce CRM 대상 필드에 올바르게 매핑하려면 다음 단계를 따르십시오.

매핑 단계에서 새 매핑 추가 를 선택하면 화면에 새 매핑 행이 표시됩니다.
소스 필드 선택 창에서 특성 선택 범주를 선택하고 XDM 특성을 선택하거나 ID 네임스페이스 선택 을 선택하고 ID를 선택합니다.

대상 필드 선택 창에서 ID 네임스페이스 선택 을(를) 선택하고 ID를 선택하거나 사용자 지정 특성 선택 범주를 선택하고 필요에 따라 특성을 선택하거나 특성 이름 필드를 사용하여 특성을 정의합니다. 지원되는 특성에 대한 지침은 Salesforce CRM 설명서를 참조하세요.

XDM 프로필 스키마와 (API) Salesforce CRM 사이에 다음 매핑을 추가하려면 다음 단계를 반복합니다.

연락처 작업

세그먼트 내에서 연락처 와 함께 작업하는 경우 연락처에 대한 Salesforce의 개체 참조 를 참조하여 업데이트할 필드에 대한 매핑을 정의하십시오.
위의 링크에서 필드 설명에 언급된 단어 Required 을(를) 검색하여 필수 필드를 식별할 수 있습니다.

내보내거나 업데이트할 필드에 따라 XDM 프로필 스키마와 (API) Salesforce CRM 사이에 매핑을 추가합니다.

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
소스 필드	대상 필드	참고
`IdentityMap: crmID`	`Identity: SalesforceId`	`Mandatory`
`xdm: person.name.lastName`	`Attribute: LastName`	`Mandatory` 질문에 답합니다. 연락처의 성(최대 80자).
`xdm: person.name.firstName`	`Attribute: FirstName`	연락처의 이름은 최대 40자입니다.
`xdm: personalEmail.address`	`Attribute: Email`	연락처의 이메일 주소입니다.

이러한 매핑을 사용하는 예는 다음과 같습니다.

잠재 고객 작업

세그먼트 내에서 리드 를 사용하여 작업하는 경우 리드에 대한 Salesforce의 개체 참조를 참조하여 업데이트할 필드에 대한 매핑을 정의하십시오.
위의 링크에서 필드 설명에 언급된 단어 Required 을(를) 검색하여 필수 필드를 식별할 수 있습니다.

내보내거나 업데이트할 필드에 따라 XDM 프로필 스키마와 (API) Salesforce CRM 사이에 매핑을 추가합니다.

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
소스 필드	대상 필드	참고
`IdentityMap: crmID`	`Identity: SalesforceId`	`Mandatory`
`xdm: person.name.lastName`	`Attribute: LastName`	`Mandatory` 질문에 답합니다. 리드 최대 80자의 성.
`xdm: b2b.companyName`	`Attribute: Company`	`Mandatory` 질문에 답합니다. 리드의 회사.
`xdm: personalEmail.address`	`Attribute: Email`	잠재 고객의 이메일 주소입니다.

이러한 매핑을 사용하는 예는 다음과 같습니다.

대상 연결에 대한 매핑을 제공했으면 다음 을 선택합니다.

대상자 내보내기 예약 및 예제 schedule-segment-export-example

대상 내보내기 예약 단계를 수행할 때 플랫폼에서 활성화된 대상을 Salesforce의 해당 사용자 지정 필드에 수동으로 매핑해야 합니다.

이렇게 하려면 각 세그먼트를 선택한 다음 Salesforce CRM 매핑 ID 필드의 Salesforce에서 사용자 지정 필드 이름을 입력하십시오. Salesforce에서 사용자 지정 필드를 만드는 방법에 대한 지침 및 모범 사례를 보려면 다음 섹션 내에서 사용자 지정 필드 만들기 Salesforce를 참조하세요.

예를 들어 Salesforce 사용자 지정 필드가 crm_2_seg인 경우 Salesforce CRM 매핑 ID 에 이 값을 지정하여 Experience Platform의 대상 대상을 이 사용자 지정 필드로 채웁니다.

Salesforce의 사용자 지정 필드 예가 아래에 표시되어 있습니다.
사용자 지정 필드를 표시하는 Salesforce UI 스크린샷입니다.

Salesforce CRM 매핑 ID 의 위치를 나타내는 예는 다음과 같습니다.
대상자 내보내기 일정을 보여 주는 Platform UI 스크린샷 예

위에 표시된 대로 Salesforce 필드 이름 은(는) Salesforce CRM 매핑 ID 내에 지정된 값과 정확히 일치합니다.

사용 사례에 따라 활성화된 모든 대상을 동일한 Salesforce 사용자 정의 필드 또는 Salesforce CRM의 다른 필드 이름 에 매핑할 수 있습니다. 위에 표시된 이미지를 기반으로 한 일반적인 예는 다음과 같을 수 있습니다.

Salesforce CRM 세그먼트 이름

Salesforce 필드 이름

Salesforce CRM 매핑 ID

crm_1_seg

crm_1_seg

crm_2_seg

crm_2_seg

활성화된 각 플랫폼 세그먼트에 대해 이 섹션을 반복합니다.

데이터 내보내기 유효성 검사 exported-data

대상을 올바르게 설정했는지 확인하려면 아래 단계를 수행하십시오.

대상 목록으로 이동하려면 대상 > 찾아보기 를 선택하십시오.
대상을 선택하고 상태가 활성화됨 인지 확인하십시오.
활성화 데이터 탭으로 전환한 다음 대상 이름을 선택합니다.
대상자 요약을 모니터링하고 프로필 수가 세그먼트 내에서 만든 수에 해당하는지 확인합니다.
마지막으로 Salesforce 웹 사이트에 로그인하여 대상자의 프로필이 추가 또는 업데이트되었는지 확인합니다.

연락처 작업
- Platform 세그먼트 내에서 연락처 를 선택한 경우 Apps > Contacts 페이지로 이동합니다.
- 연락처 를 선택하고 필드가 업데이트되었는지 확인하십시오. 대상 예약 중에 제공된 매핑 ID 값을 기반으로 Salesforce CRM의 각 대상 상태가 플랫폼의 해당 대상 상태로 업데이트되었음을 확인할 수 있습니다.
잠재 고객 작업
- Platform 세그먼트 내에서 리드 를 선택한 경우 Apps > Leads 페이지로 이동합니다.
- 잠재 고객 을 선택하고 필드가 업데이트되었는지 확인하십시오. 대상 예약 중에 제공된 매핑 ID 값을 기반으로 Salesforce CRM의 각 대상 상태가 플랫폼의 해당 대상 상태로 업데이트되었음을 확인할 수 있습니다.

데이터 사용 및 관리 data-usage-governance

데이터를 처리할 때 모든 Adobe Experience Platform 대상이 데이터 사용 정책을 준수합니다. Adobe Experience Platform에서 데이터 거버넌스를 적용하는 방법에 대한 자세한 내용은 데이터 거버넌스 개요를 참조하십시오.

오류 및 문제 해결 errors-and-troubleshooting

이벤트를 대상으로 푸시하는 동안 알 수 없는 오류 발생 unknown-errors

데이터 흐름 실행을 확인할 때 다음 오류 메시지가 표시될 수 있습니다. Unknown errors encountered while pushing events to the destination. Please contact the administrator and try again.
- 이 오류를 수정하려면 활성화 워크플로에서 Salesforce CRM 대상에 제공한 매핑 ID 이(가) Salesforce에서 만든 사용자 지정 필드 형식의 값과 정확히 일치하는지 확인하십시오. 지침은 Salesforce🔗 섹션 내에서 사용자 지정 필드 만들기를 참조하세요.
세그먼트를 활성화할 때 다음 오류 메시지가 표시될 수 있습니다. The client's IP address is unauthorized for this account. Allowlist the client's IP address...
- 이 오류를 해결하려면 Salesforce 계정 관리자에게 문의하여 Salesforce 계정의 신뢰할 수 있는 IP 범위에 Experience Platform IP 주소를 추가하십시오. 추가 지침이 필요한 경우 Salesforce 연결된 앱에 대한 신뢰할 수 있는 IP 범위에 대한 액세스 제한 설명서를 참조하십시오.

추가 리소스 additional-resources

Salesforce 개발자 포털의 추가 유용한 정보는 다음과 같습니다.

빠른 시작
레코드 만들기
사용자 지정 권장 사항 대상
복합 리소스 사용
이 대상은 단일 레코드 업데이트 API 호출 대신 여러 레코드 업데이트 API를 활용합니다.

recommendation-more-help

7f4d1967-bf93-4dba-9789-bb6b505339d6