(API) Salesforce Marketing Cloud (이전 이름: ExactTarget)은 방문자와 고객이 자신의 경험을 개인화할 수 있도록 여정을 구축하고 맞춤화할 수 있는 디지털 마케팅 제품군입니다.
이 연결과 다른 연결의 차이점을 참고하십시오. Salesforce Marketing Cloud 연결 이메일 마케팅 카탈로그 섹션에 있습니다. API 기반 스트리밍 연결인 반면, 다른 Salesforce Marketing Cloud 연결에서는 지정된 저장소 위치로 파일을 내보낼 수 있습니다.
비교 대상 Salesforce Marketing Cloud Account Engagement 보다 지향적인 것 B2B 마케팅, (API) Salesforce Marketing Cloud destination은 다음에 이상적입니다. B2C 트랜잭션 의사 결정 주기가 짧은 사용 사례입니다. 타겟 대상의 행동을 나타내는 더 큰 데이터 세트를 통합하여 연락처, 특히 외부의 데이터 세트에서 우선 순위를 지정하고 세그먼트화하여 마케팅 캠페인을 조정하고 개선할 수 있습니다 Salesforce. 참고: Experience Platform은 Salesforce Marketing Cloud Account Engagement.
이 Adobe Experience Platform 대상 을 활용합니다. Salesforce Marketing Cloud 연락처 업데이트 API를 통해 다음을 수행할 수 있습니다. 연락처 추가 및 연락처 데이터 업데이트 새 항목 내에서 활성화한 후 비즈니스 요구 사항 Salesforce Marketing Cloud 세그먼트.
Salesforce Marketing Cloud 클라이언트 자격 증명이 포함된 OAuth 2를 인증 메커니즘으로 사용하여 Salesforce Marketing Cloud API. 에 대한 인증 지침 Salesforce Marketing Cloud 인스턴스는 다음보다 아래에 있습니다. 대상에 인증 섹션.
을(를) 사용하는 방법과 시기를 더 잘 이해할 수 있도록 (API) Salesforce Marketing Cloud destination은 Adobe Experience Platform 고객이 이 대상을 사용하여 해결할 수 있는 샘플 사용 사례입니다.
홈 임대 플랫폼의 판매 부서에서 마케팅 이메일을 타겟팅된 고객 대상자에게 브로드캐스트하려고 합니다. 플랫폼의 마케팅 팀이 새 연락처를 추가하거나 기존 연락처를 업데이트할 수 있습니다. (및 해당 이메일 주소) Adobe Experience Platform을 통해 자신의 오프라인 데이터에서 대상을 작성하고 이러한 대상을 로 보냅니다. Salesforce Marketing Cloud그런 다음 마케팅 캠페인 이메일을 보내는 데 사용할 수 있습니다.
에 대한 데이터를 활성화하기 전에 (API) Salesforce Marketing Cloud 대상, 다음 항목이 있어야 합니다. 스키마, a 데이터 세트, 및 세그먼트 생성 위치 Experience Platform.
Platform에서 로 데이터를 내보내려면 다음 전제 조건을 참고하십시오. Salesforce Marketing Cloud 계정:
A Salesforce Marketing Cloud 다음에 대한 구독이 있는 계정 Marketing Cloud Engagement 계속하려면 제품이 필수입니다.
다음 대상에게 연결 Salesforce 지원 이 없는 경우 Salesforce Marketing Cloud 계정 또는 계정에 다음 항목이 없습니다. Marketing Cloud Engagement 제품 구독.
대상자를 활성화할 때 (API) Salesforce Marketing Cloud 대상, 다음에 값을 입력해야 합니다. 매핑 ID 에서 활성화된 각 대상자에 대한 필드 대상자 일정 단계.
Salesforce Experience Platform에서 들어오는 대상을 올바르게 읽고 해석하고 내에서 대상 상태를 업데이트하려면 이 값이 필요합니다. Salesforce Marketing Cloud. 다음에 대한 Experience Platform 설명서 참조: 대상자 멤버십 세부 정보 스키마 필드 그룹 대상 상태에 대한 지침이 필요한 경우.
Platform에서 로 활성화하는 각 대상에 대해 Salesforce, 유형의 속성이 있어야 합니다. Text
에 연결됨 Email Demographics 다음 범위 내의 데이터 확장 Salesforce Marketing Cloud. 사용 Salesforce Marketing Cloud Contact Builder 속성을 만듭니다. 다음을 참조하십시오. Salesforce Marketing Cloud 에 대한 설명서 속성 만들기 속성 만들기에 대한 지침이 필요한 경우.
속성 필드 이름은 (API) Salesforce Marketing Cloud 다음 기간 동안 타겟 필드: 매핑 단계. 비즈니스 요구 사항에 따라 최대 4000자로 필드 문자를 정의할 수 있습니다. 다음을 참조하십시오. Salesforce Marketing Cloud 데이터 확장 데이터 유형 속성 유형에 대한 추가 정보는 설명서 페이지를 참조하십시오.
의 데이터 디자이너 화면의 예 Salesforce Marketing Cloud속성을 추가할 가 아래에 표시되어 있습니다.
의 보기 Salesforce Marketing Cloud Email Data 내의 대상 상태에 해당하는 속성을 가진 속성 그룹 Email Demographics 데이터 확장은 아래에 표시되어 있습니다.
다음 (API) Salesforce Marketing Cloud 대상이 을 사용합니다. Salesforce Marketing Cloud Search Attribute-Set Definitions REST API 내에서 정의된 데이터 확장 및 연결된 속성을 동적으로 검색하기 Salesforce Marketing Cloud.
다음 위치에 표시됩니다. 대상 필드 다음을 설정할 때 선택 창 매핑 (으)로 이동하는 워크플로우 대상에 대상 활성화.
다음 범위 내 Salesforce Marketing Cloud를 사용하여 속성을 만들어야 합니다. 필드 이름 내에 지정된 값과 정확히 일치하는 매핑 ID 활성화된 각 플랫폼 세그먼트에 대해. 예를 들어 아래 스크린샷에는 라는 속성이 표시됩니다 salesforce_mc_segment_1
. 이 대상에 대한 대상자를 활성화할 때 다음을 추가합니다. salesforce_mc_segment_1
다음으로: 매핑 ID Experience Platform의 대상자 대상자를 이 속성으로 채우기 위한 것입니다.
의 속성 작성 예 Salesforce Marketing Cloud이 아래에 표시되어 있습니다.
(_)
문자를 구분 기호로 사용했습니다.test_segment
, 사용 Adobe_test_segment
또는 test_segment_Adobe
.다음으로: Salesforce Marketing Cloud 은(는) 사용자 정의 역할을 지원하며 사용 사례에 따라 내에서 속성을 업데이트하려면 사용자에게 관련 역할을 할당해야 합니다. Salesforce Marketing Cloud. 사용자에게 할당된 역할의 예는 다음과 같습니다.
의 역할에 따라 Salesforce Marketing Cloud 사용자가 할당되었으므로 Salesforce Marketing Cloud 업데이트하려는 필드에 연결된 데이터 확장입니다.
이 대상에 대한 액세스 권한이 필요하므로 data extension
, 허용해야 합니다. 예: Email
data extension 아래와 같이 허용해야 합니다.
액세스 수준을 제한하려면 세분화된 권한을 사용하여 개별 액세스를 재정의할 수도 있습니다.
다음을 참조하십시오. Marketing Cloud Roles 및 Marketing Cloud Roles and Permissions 페이지 를 참조하십시오.
에 인증하기 전에 아래 항목을 적어 두십시오. (API) Salesforce Marketing Cloud 대상.
자격 증명 | 설명 | 예 |
---|---|---|
하위 도메인 | 다음을 참조하십시오 Salesforce Marketing Cloud domain prefix 에서 이 값을 가져오는 방법을 알아보려면 Salesforce Marketing Cloud 인터페이스. | 다음의 경우 Salesforce Marketing Cloud 도메인:mcq4jrssqdlyc4lph19nnqgzzs84 .login.exacttarget.com, 다음을 제공해야 합니다. mcq4jrssqdlyc4lph19nnqgzzs84 을 값으로 추가합니다. |
클라이언트 ID | 다음을 참조하십시오. Salesforce Marketing Cloud 설명서 에서 이 값을 가져오는 방법을 알아보려면 Salesforce Marketing Cloud 인터페이스. | r23kxxxxxxxx0z05xxxxxx |
클라이언트 암호 | 다음을 참조하십시오. Salesforce Marketing Cloud 설명서 에서 이 값을 가져오는 방법을 알아보려면 Salesforce Marketing Cloud 인터페이스. | ipxxxxxxxxxxT4xxxxxxxxxx |
(API) Salesforce Marketing Cloud 는 아래 표에 설명된 id 활성화를 지원합니다. 자세히 알아보기 id.
대상 ID | 설명 | 고려 사항 |
---|---|---|
contactKey | Salesforce Marketing Cloud 연락처 키. 다음을 참조하십시오. Salesforce Marketing Cloud 설명서 추가 지침이 필요한 경우. | 필수입니다 |
이 섹션에서는 이 대상으로 내보낼 수 있는 대상자 유형을 설명합니다.
대상자 원본 | 지원됨 | 설명 |
---|---|---|
Segmentation Service | ✓ 덧신 | Experience Platform을 통해 생성된 대상자 세분화 서비스. |
사용자 정의 업로드 | X | 대상 가져옴 csv 파일에서 Experience Platform으로 변환했습니다. |
대상 내보내기 유형 및 빈도에 대한 자세한 내용은 아래 표를 참조하십시오.
항목 | 유형 | 참고 |
---|---|---|
내보내기 유형 | 프로필 기반 |
|
내보내기 빈도 | 스트리밍 | 스트리밍 대상은 "항상" API 기반 연결입니다. 대상자 평가를 기반으로 Experience Platform에서 프로필이 업데이트되는 즉시 커넥터가 업데이트 다운스트림을 대상 플랫폼으로 전송합니다. 자세한 내용 스트리밍 대상. |
이 대상에 연결하려면 다음과같이 하십시오. 대상 구성 자습서. 대상 구성 워크플로에서 아래 두 섹션에 나열된 필드를 채웁니다.
다음 범위 내 대상 > 카탈로그, 검색 (API) Salesforce Marketing Cloud. 또는 아래에서 찾을 수 있습니다 이메일 마케팅 범주.
대상에 인증하려면 아래의 필수 필드를 입력한 다음 을(를) 선택합니다. 대상에 연결. 다음을 참조하십시오. 수집 Salesforce Marketing Cloud 자격 증명 섹션에 자세히 설명되어 있습니다.
(API) Salesforce Marketing Cloud 대상 | Salesforce Marketing Cloud |
---|---|
하위 도메인 | 사용자 Salesforce Marketing Cloud 도메인 접두사입니다. 예를 들어 도메인이 입니다. mcq4jrssqdlyc4lph19nnqgzzs84 .login.exacttarget.com, 다음을 제공해야 합니다. mcq4jrssqdlyc4lph19nnqgzzs84 을 값으로 추가합니다. |
클라이언트 ID | 사용자 Salesforce Marketing Cloud Client ID . |
클라이언트 암호 | 사용자 Salesforce Marketing Cloud Client Secret . |
제공된 세부 정보가 유효한 경우 UI에 연결됨 상태가 녹색 확인 표시로 표시되면 다음 단계로 진행할 수 있습니다.
대상에 대한 세부 정보를 구성하려면 아래의 필수 및 선택 필드를 채우십시오. UI에서 필드 옆에 있는 별표는 필드가 필수임을 나타냅니다.
경고를 활성화하여 대상에 대한 데이터 흐름 상태에 대한 알림을 받을 수 있습니다. 목록에서 경고를 선택하여 데이터 흐름 상태에 대한 알림을 수신합니다. 경고에 대한 자세한 내용은 다음 안내서를 참조하십시오. UI를 사용하여 대상 경고 구독.
대상 연결에 대한 세부 정보를 제공했으면 을 선택합니다. 다음.
읽기 스트리밍 대상자 내보내기 대상으로 프로필 및 대상자 활성화 이 대상에 대한 대상자 활성화에 대한 지침을 참조하십시오.
대상 데이터를 Adobe Experience Platform에서 로 올바르게 보내려면 (API) Salesforce Marketing Cloud 대상, 필드 매핑 단계를 거쳐야 합니다. 매핑은 Platform 계정의 XDM(Experience Data Model) 스키마 필드와 대상 대상의 해당 필드 간에 링크를 만드는 것으로 구성됩니다.
XDM 필드를 (API) Salesforce Marketing Cloud 대상 필드에서 아래 단계를 수행합니다.
속성 이름은 인 경우와 같습니다. Salesforce Marketing Cloud 계정, 두 항목에 대한 매핑 contactKey
및 personalEmail.address
필수 항목입니다.
와 통합 Salesforce Marketing Cloud API는 Experience Platform이 Salesforce에서 검색할 수 있는 속성 수의 페이지 매김 제한을 받습니다. 다음 기간 동안 매핑 단계: target 필드 스키마는 Salesforce 계정에서 최대 2000개의 속성을 표시할 수 있습니다.
다음에서 매핑 단계, 선택 새 매핑 추가. 화면에 새 매핑 행이 표시됩니다.
다음에서 소스 필드 선택 창에서 다음을 선택합니다. 속성 선택 범주를 선택한 다음 XDM 속성을 선택하거나 ID 네임스페이스 선택 id를 선택합니다.
다음에서 대상 필드 선택 창에서 다음을 선택합니다. ID 네임스페이스 선택 id를 선택하거나 속성 선택 카테고리에 추가하고 필요에 따라 표시된 데이터 확장에서 속성을 선택합니다. 다음 (API) Salesforce Marketing Cloud 대상이 을 사용합니다. Salesforce Marketing Cloud Search Attribute-Set Definitions REST API 내에서 정의된 데이터 확장 및 연결된 속성을 동적으로 검색하기 Salesforce Marketing Cloud. 다음 위치에 표시됩니다. 대상 필드 팝업 을 사용하여 매핑 다음에서 대상자 활성화 워크플로.
XDM 프로필 스키마와 간에 다음 매핑을 추가하려면 이 단계를 반복합니다 (API) Salesforce Marketing Cloud:
소스 필드 | 대상 필드 | 필수입니다 |
---|---|---|
IdentityMap: contactKey |
Identity: salesforceContactKey |
Mandatory |
xdm: personalEmail.address |
Attribute: Email Address 다음에서 Salesforce Marketing Cloud Email Addresses 데이터 확장. |
Mandatory 새 연락처를 추가할 때 사용됩니다. |
xdm: person.name.firstName |
Attribute: First Name 원하는 대로 Salesforce Marketing Cloud 데이터 확장. |
- |
이러한 매핑을 사용하는 예는 다음과 같습니다.
대상 연결에 대한 매핑 제공을 마쳤으면 다음을 선택합니다. 다음.
다음을 수행할 때 대상자 내보내기 예약 단계: 플랫폼 대상자를 속성 위치: Salesforce Marketing Cloud.
이렇게 하려면 각 세그먼트를 선택한 다음 속성 이름을 입력합니다. Salesforce Marketing Cloud 다음에서 (API) Salesforce Marketing Cloud 매핑 ID 필드. 다음을 참조하십시오. 다음 범위 내에서 속성 만들기 Salesforce Marketing Cloud 속성 만들기에 대한 지침 및 모범 사례에 대한 섹션 Salesforce Marketing Cloud.
예를 들어 Salesforce Marketing Cloud 속성은 입니다. salesforce_mc_segment_1
에서 이 값을 지정합니다. (API) Salesforce Marketing Cloud 매핑 ID Experience Platform의 대상자 대상자를 이 속성으로 채우기 위한 것입니다.
의 예제 속성 Salesforce Marketing Cloud 다음이 표시됩니다.
의 위치를 나타내는 예 (API) Salesforce Marketing Cloud 매핑 ID 다음이 표시됩니다.
표시된 대로 (API) Salesforce Marketing Cloud 매핑 ID 은(는) 내에 지정된 값과 정확히 일치해야 합니다. Salesforce Marketing Cloud 필드 이름.
활성화된 각 플랫폼 세그먼트에 대해 이 섹션을 반복합니다.
위에 표시된 이미지를 기반으로 한 일반적인 예는 다음과 같을 수 있습니다.
| (API) Salesforce Marketing Cloud 세그먼트 이름 | Salesforce Marketing Cloud 필드 이름 | (API) Salesforce Marketing Cloud 매핑 ID | | — | — | — | | salesforce mc 대상 1 | salesforce_mc_segment_1
| salesforce_mc_segment_1
| | salesforce mc 대상 2 | salesforce_mc_segment_2
| salesforce_mc_segment_2
|
대상을 올바르게 설정했는지 확인하려면 아래 단계를 수행하십시오.
선택 대상 > 찾아보기 대상 목록으로 이동합니다.
대상을 선택하고 상태가 다음과 같은지 확인합니다. 활성화됨.
다음으로 전환 Activation data 탭을 누른 다음 대상 이름을 선택합니다.
대상자 요약을 모니터링하고 프로필 수가 세그먼트 내에서 만든 수에 해당하는지 확인합니다.
에 로그인합니다 Salesforce Marketing Cloud 웹 사이트입니다. 그런 다음 로 이동합니다 Audience Builder > Contact Builder > All contacts > Email 페이지를 만들고 대상자의 프로필이 추가되었는지 확인합니다.
프로필이 업데이트되었는지 확인하려면 이메일 을(를) 페이지를 만들고 대상의 프로필 속성 값이 업데이트되었는지 확인합니다. 성공하면 각 대상자 상태가에서 확인할 수 있습니다. Salesforce Marketing Cloud 이(가) 다음을 기반으로 플랫폼에서 해당 대상 상태로 업데이트되었습니다. 매핑 ID 에 제공된 값 대상자 예약 단계.
모두 Adobe Experience Platform 대상은 데이터를 처리할 때 데이터 사용 정책을 준수합니다. 방법에 대한 자세한 정보 Adobe Experience Platform 데이터 거버넌스 시행, 다음을 참조하십시오. 데이터 거버넌스 개요.
데이터 흐름 실행을 확인할 때 다음 오류 메시지가 표시될 수 있습니다. Unknown errors encountered while pushing events to the destination. Please contact the administrator and try again.
세그먼트를 활성화할 때 다음과 같은 오류 메시지가 표시될 수 있습니다. The client's IP address is unauthorized for this account. Allowlist the client's IP address...
이 섹션에서는 이 대상 커넥터에 대한 기능 및 중요 설명서 업데이트를 캡처합니다.
릴리스 월 | 업데이트 유형 | 설명 |
---|---|---|
2023년 10월 | 설명서 업데이트 |
|
2023년 4월 | 설명서 업데이트 |
|
2023년 2월 | 설명서 업데이트 | 다음을 업데이트했습니다. (API) Salesforce Marketing Cloud의 사전 요구 사항 다음을 호출하는 참조 링크를 포함하는 섹션 Salesforce Marketing Cloud Engagement 은(는) 이 대상을 사용하기 위한 필수 구독입니다. |
2023년 2월 | 기능 업데이트 | 대상에서 잘못된 구성으로 인해 잘못된 포맷의 JSON이 Salesforce로 전송되는 문제가 해결되었습니다. 이로 인해 일부 사용자는 활성화 시 많은 ID가 실패했음을 보게 되었습니다. (PLATIR-26299) |
2023년 1월 | 설명서 업데이트 |
|
2022년 10월 | 초기 릴리스 | 초기 대상 릴리스 및 설명서 게시. |