(API) Salesforce Marketing Cloud 연결

개요

Salesforce Marketing Cloud (이전의 ExactTarget)은 방문자와 고객이 자신의 경험을 개인화할 수 있도록 여정을 작성하고 사용자 지정할 수 있는 디지털 마케팅 제품군입니다.

중요

이 연결과 다른 연결의 차이점을 확인합니다 Salesforce Marketing Cloud 연결 이메일 마케팅 카탈로그 섹션에 있습니다. 다른 Salesforce Marketing Cloud 연결을 사용하면 파일을 지정된 저장소 위치로 내보낼 수 있지만 API 기반 스트리밍 연결입니다.

이 Adobe Experience Platform 대상 활용 Salesforce 업데이트 연락처 REST API: 새 Salesforce 세그먼트 내에서 연락처 데이터를 활성화한 후 비즈니스 요구에 대한 연락처 데이터를 추가/업데이트할 수 있습니다.

Salesforce Marketing Cloud은 Salesforce REST API와 통신하기 위해 인증 메커니즘으로 클라이언트 자격 증명과 함께 OAuth 2를 사용합니다. Salesforce 인스턴스를 인증하는 지침은 아래에 나와 있습니다. 대상에 인증 섹션을 참조하십시오.

사용 사례

Salesforce Marketing Cloud 대상을 사용하는 방법과 시기를 더 잘 이해할 수 있도록 Adobe Experience Platform 고객이 이 대상을 사용하여 해결할 수 있는 샘플 사용 사례입니다.

마케팅 캠페인을 위해 연락처에 전자 메일 보내기

주택 임대 플랫폼의 판매부에서는 대상 고객 대상으로 마케팅 이메일을 방송하려고 합니다. 플랫폼의 마케팅 팀은 새 연락처를 추가하거나 기존 연락처를 업데이트할 수 있습니다 (및 해당 이메일 주소) Adobe Experience Platform을 통해 고유한 오프라인 데이터에서 세그먼트를 작성하고 이러한 세그먼트를 Salesforce Marketing Cloud으로 전송하여 마케팅 캠페인 이메일을 전송하는 데 사용할 수 있습니다.

전제 조건

Experience Platform 사전 요구 사항

Salesforce Marketing Cloud 대상으로 데이터를 활성화하기 전에 스키마, 데이터 세트, 및 세그먼트 에서 생성됨 Experience Platform.

Salesforce CRM의 사전 요구 사항

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

Salesforce 계정이 있어야 합니다.

Salesforce로 이동 재판 Salesforce 계정이 아직 없는 경우 등록하고 만들 페이지입니다.

Salesforce 내에서 사용자 지정 필드 만들기

유형의 사용자 지정 속성을 만들어야 합니다 Text Area Long: Salesforce Marketing Cloud 내에서 세그먼트 상태를 업데이트하는 데 사용할 Experience Platform입니다. 세그먼트를 대상에 활성화하는 워크플로우에서 세그먼트 예약 단계별로 사용자 지정 속성을 활성화한 각 세그먼트에 대한 매핑 ID로 사용합니다.

자세한 내용은 Salesforce Marketing Cloud 설명서를 참조하십시오. 사용자 지정 필드 만들기 추가 지침이 필요한 경우

중요

Salesforce Marketing Cloud 계정 내의 "이메일 인구 통계" 속성 세트 아래에 사용자 지정 속성을 만들어야 합니다.

노트

개체당 허용되는 사용자 지정 속성의 수는 Salesforce 버전에 따라 달라집니다. 자세한 내용은 Salesforce 설명서 를 참조하십시오. 개체당 허용되는 사용자 지정 필드 추가 지침이 필요한 경우
Salesforce 내에서 이 제한에 도달한 경우, 새 mappingId를 사용하기 전에 Experience Platform 내의 이전 세그먼트에 대해 세그먼트 상태를 저장하는 데 사용된 사용자 지정 특성을 Salesforce에서 제거해야 합니다.

자세한 내용은 Adobe Experience Platform 설명서 을 참조하십시오. 세그먼트 멤버십 세부 정보 스키마 필드 그룹 세그먼트 상태에 대한 지침이 필요한 경우.

Salesforce 자격 증명 수집

Salesforce Marketing Cloud 대상을 인증하기 전에 아래 항목을 참고하십시오.

자격 증명	설명	예
Salesforce Marketing Cloud 접두사	자세한 내용은 Salesforce Marketing Cloud 도메인 접두사 추가 지침	도메인이 다음과 같은 경우 강조 표시된 값이 필요합니다. `mcq4jrssqdlyc4lph19nnqgzzs84`.login.exacttarget.com
클라이언트 ID 클라이언트 암호	자세한 내용은 Salesforce 설명서 추가 지침이 필요한 경우	r23kxxxxxxxx0z05xxxxxx ipxxxxxxxxxxT4xxxxxxxxxx

지원되는 ID

Salesforce Marketing Cloud은 아래 표에 설명된 ID의 활성화를 지원합니다. 추가 정보 id.

Target ID	설명	고려 사항
contactKey	Salesforce 연락처 키 자세한 내용은 Salesforce 설명서 추가 지침이 필요한 경우	필수입니다

내보내기 유형 및 빈도

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

항목	유형	참고
내보내기 유형	프로필 기반	원하는 스키마 필드와 함께 세그먼트의 모든 구성원을 내보냅니다(예: 전자 메일 주소, 전화 번호, 성)을 선택한 대로 대상 활성화 워크플로우.
내보내기 빈도	스트리밍	스트리밍 대상은 "항상 설정" API 기반 연결입니다. 세그먼트 평가를 기반으로 Experience Platform에서 프로필이 업데이트되는 즉시 커넥터는 업데이트 다운스트림을 대상 플랫폼으로 보냅니다. 자세한 내용 스트리밍 대상.

대상에 연결

중요

대상에 연결하려면 대상 관리 액세스 제어 권한. 다음 문서를 참조하십시오. 액세스 제어 개요 또는 제품 관리자에게 문의하여 필요한 권한을 얻으십시오.

이 대상에 연결하려면 대상 구성 자습서. 대상 구성 워크플로우에서 아래 두 섹션에 나열된 필드를 채웁니다.

카탈로그

대상에 인증

대상을 인증하려면 필요한 필드를 입력하고 을(를) 선택합니다 대상에 연결.

Salesforce Marketing Cloud 인증 방법을 보여주는 샘플 스크린샷

하위 도메인: Salesforce Marketing Cloud 도메인 접두사. 예를 들어 도메인이 mcq4jrssqdlyc4lph19nnqgzzs84.login.exacttarget.com를 채울 때는 강조 표시된 값이 필요합니다.
클라이언트 ID: Salesforce 클라이언트 ID입니다.
클라이언트 암호: Salesforce 클라이언트 암호입니다.

제공된 세부 정보가 유효한 경우 UI에 연결됨 녹색 확인 표시가 있는 상태에서 다음 단계로 진행할 수 있습니다.

대상 세부 사항 채우기

대상에 대한 세부 사항을 구성하려면 아래 필수 및 선택적 필드를 입력합니다. UI에서 필드 옆에 있는 별표는 필드가 필수임을 나타냅니다.

Salesforce Marketing Cloud에 대한 세부 사항을 채우는 방법을 보여주는 샘플 스크린샷

이름: 나중에 이 대상을 인식하는 이름입니다.
설명: 나중에 이 대상을 식별하는 데 도움이 되는 설명입니다.
고객 이름: 이 값은 어떤 값이든 될 수 있지만 값은 필수입니다. 그렇지 않으면 대상 활성화가 실패합니다.

경고 활성화

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

대상 연결에 대한 세부 정보 제공을 마치면 를 선택합니다 다음.

세그먼트를 이 대상에 활성화

중요

데이터를 활성화하려면 대상 관리, 대상 활성화, 프로필 보기, 및 세그먼트 보기 액세스 제어 권한. 다음 문서를 참조하십시오. 액세스 제어 개요 또는 제품 관리자에게 문의하여 필요한 권한을 얻으십시오.

읽기 스트리밍 세그먼트 내보내기 대상으로 프로필 및 세그먼트를 활성화합니다 대상 세그먼트를 이 대상으로 활성화하는 방법에 대한 지침입니다.

매핑 고려 사항 및 예

Adobe Experience Platform에서 Salesforce Marketing Cloud 대상으로 대상 데이터를 올바르게 전송하려면 필드 매핑 단계를 수행해야 합니다. 매핑은 플랫폼 계정의 Experience Data Model(XDM) 스키마 필드와 대상 대상의 해당 상당 요소 간에 링크를 만드는 작업으로 이루어집니다. XDM 필드를 Salesforce Marketing Cloud 대상 필드에 올바르게 매핑하려면 아래 단계를 따르십시오.

에 대해 설정할 수 있는 속성 매핑 목록입니다 Salesforce REST API 은 아래에 제공됩니다. 대상은 Salesforce 검색 속성 집합 정의 REST API Salesforce 내에 정의된 연락처 및 계정별 특성을 검색하려면

중요

특성 이름은 Salesforce 계정에 따라 동일하지만 contactKey 및 personalEmail.address 는 필수입니다.

매핑 단계에서 새 매핑 추가. 이제 화면에 새 매핑 행이 표시됩니다.
소스 필드 선택 창에서 소스 필드를 선택할 때 속성 선택 카테고리를 추가하고 원하는 매핑을 추가합니다.
대상 선택 필드 창에서 대상 필드를 선택하고 ID 네임스페이스 선택 카테고리를 추가하고 원하는 매핑을 추가합니다.
사용자 지정 속성을 매핑하려면 대상 필드 창을 선택하고 대상 필드를 선택한 다음 속성 선택 > 이메일 인구 통계 카테고리. 다음으로 원하는 대상 속성 이름을 입력하고 원하는 매핑을 추가합니다.

예를 들어 XDM 프로필 스키마와 프로필 스키마 사이에 다음 매핑을 추가할 수 있습니다 Salesforce Marketing Cloud 인스턴스:

	XDM 프로필 스키마	Salesforce Marketing Cloud 인스턴스	필수입니다
속성	person.name.firstName personalEmail.address	이메일 인구 통계학적 정보.이름 Email Addresses.Email Address	- 예
ID	contactKey	salesforceContactKey	예

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

세그먼트 내보내기 예약 및 예제

다음을 수행할 때 세그먼트 내보내기 예약 단계별로 Platform 세그먼트를 Salesforce의 사용자 지정 속성에 수동으로 매핑해야 합니다.

이렇게 하려면 각 세그먼트를 선택한 다음 Salesforce의 해당 사용자 지정 속성을 매핑 ID 필드.

중요

매핑 ID에 사용된 값은 "이메일 인구 통계" 속성 세트 아래의 Salesforce 내에서 생성된 사용자 지정 속성의 이름과 정확히 일치해야 합니다.

예는 다음과 같습니다.
세그먼트 내보내기 예약

데이터 내보내기의 유효성 검사

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

선택 대상 > 찾아보기 대상 목록으로 이동합니다.
대상을 선택하고 상태가 맞는지 확인합니다 활성화됨.
로 전환 Activation data 탭을 클릭한 다음 세그먼트 이름을 선택합니다.
세그먼트 요약을 모니터링하고 프로필 수가 세그먼트 내에서 생성된 수에 해당하는지 확인합니다.
Salesforce Marketing Cloud 웹 사이트에 로그인합니다. 그런 다음 Audience Builder > Contact Builder > All contacts > Email 페이지를 방문하여 세그먼트의 프로필이 추가되었는지 확인합니다.
업데이트된 프로필이 있는지 확인하려면 Email 페이지에서 세그먼트의 프로필에 대한 속성 값이 업데이트되었는지 확인합니다.

데이터 사용 및 거버넌스

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

오류 및 문제 해결

Salesforce Marketing Cloud에 이벤트를 푸시하는 동안 알 수 없는 오류가 발생했습니다

데이터 흐름 실행을 확인할 때 아래에 오류 메시지가 표시되면 제공한 매핑 ID가 있는지 확인하십시오 Salesforce CRM 플랫폼 세그먼트가 유효하며 다음 내에 있음 Salesforce CRM.

추가 리소스

Salesforce 개발자 포털

제한

Salesforce에서는 비율 제한.
자세한 내용은 비율 제한 오류 페이지를 클릭하여 발생할 수 있는 오류를 확인합니다.
자세한 내용은 Salesforce Marketing Cloud 참여 가격 책정 페이지 대상 전체 버전 비교 차트 다운로드 계획에 의해 적용되는 제한을 자세히 설명하는 pdf입니다.
다음 API 개요 페이지 세부 사항 추가 제한.
이러한 세부 정보를 수집하는 KB 항목을 사용할 수 있습니다 [여기](https://salesforce.stackexchange.com/questions/205898/marketing-cloud-api-limits#:~:text=Day%2FHour%2FMinute%20Limit&text=We%20recommend%20a%20limit%20of,per%20minute%20for%20SOAP%20calls.&text=As%20has%20be%20added%20in,상호 작용%20with%20the%20REST%2DAPI).

새로운 검색, 검색 기능 개선