(API) Salesforce Marketing Cloud 연결
개요 overview
(API) Salesforce Marketing Cloud(이전 이름: ExactTarget)은(는) 방문자와 고객이 자신의 경험을 개인화할 수 있도록 여정을 만들고 사용자 지정할 수 있는 디지털 마케팅 세트입니다.
B2B 마케팅을 지향하는 Salesforce Marketing Cloud Account Engagement과(와) 비교하여 (API) Salesforce Marketing Cloud 대상은 트랜잭션 의사 결정 주기가 짧은 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 인스턴스에 대한 인증 지침은 대상에 대한 인증 섹션에서 아래에 더 나와 있습니다.
사용 사례 use-cases
(API) Salesforce Marketing Cloud 대상을 사용하는 방법과 시기를 더 잘 이해할 수 있도록 Adobe Experience Platform 고객이 이 대상을 사용하여 해결할 수 있는 샘플 사용 사례를 소개합니다.
마케팅 캠페인을 위해 연락처에 이메일 보내기 use-case-send-emails
홈 임대 플랫폼의 판매 부서에서 마케팅 이메일을 타겟팅된 고객 대상자에게 브로드캐스트하려고 합니다. 플랫폼의 마케팅 팀은 Adobe Experience Platform을 통해 새 연락처를 추가하고 기존 연락처 (및 해당 이메일 주소) 을(를) 업데이트하고, 자신의 오프라인 데이터에서 대상을 만들고, 이러한 대상을 Salesforce Marketing Cloud에 보낼 수 있습니다. 그런 다음 마케팅 캠페인 이메일을 보내는 데 사용할 수 있습니다.
전제 조건 prerequisites
Experience Platform의 사전 요구 사항 prerequisites-in-experience-platform
(API) Salesforce Marketing Cloud 대상에 대한 데이터를 활성화하기 전에 Experience Platform에서 만든 스키마, 데이터 세트 및 세그먼트가 있어야 합니다.
(API) Salesforce Marketing Cloud의 필수 구성 요소 prerequisites-destination
Platform에서 Salesforce Marketing Cloud 계정으로 데이터를 내보내려면 다음 전제 조건을 참고하십시오.
Salesforce Marketing Cloud 계정이 있어야 합니다. prerequisites-account
계속하려면 Marketing Cloud Engagement 제품에 대한 구독이 있는 Salesforce Marketing Cloud 계정이 필요합니다.
Salesforce Marketing Cloud 계정이 없거나 계정에 Marketing Cloud Engagement 제품 구독이 없는 경우 Salesforce 지원에 문의하세요.
Salesforce Marketing Cloud 내 특성 만들기 prerequisites-attribute
대상을 (API) Salesforce Marketing Cloud 대상으로 활성화할 때 대상 일정 단계에서 활성화된 각 대상에 대해 매핑 ID 필드에 값을 입력해야 합니다.
Salesforce에서는 Experience Platform에서 들어오는 대상을 올바르게 읽고 해석하고 Salesforce Marketing Cloud 내의 대상 상태를 업데이트하려면 이 값이 필요합니다. 대상 상태에 대한 지침이 필요한 경우 대상 멤버십 세부 정보 스키마 필드 그룹에 대한 Experience Platform 설명서를 참조하세요.
플랫폼에서 Salesforce로 활성화하는 각 대상에 대해 Salesforce Marketing Cloud 내의 Email Demographics 데이터 확장에 연결된 Text
유형의 특성이 있어야 합니다. 특성을 만들려면 Salesforce Marketing Cloud Contact Builder을(를) 사용합니다. 특성 만들기에 대한 지침이 필요한 경우 Salesforce Marketing Cloud 설명서를 참조하여 특성 만들기를 참조하세요.
특성 필드 이름은 매핑 단계 동안 (API) Salesforce Marketing Cloud 대상 필드에 사용됩니다. 비즈니스 요구 사항에 따라 최대 4000자로 필드 문자를 정의할 수 있습니다. 특성 유형에 대한 자세한 내용은 Salesforce Marketing Cloud 데이터 확장 데이터 유형 설명서 페이지를 참조하십시오.
특성을 추가할 Salesforce Marketing Cloud의 데이터 디자이너 화면의 예는 다음과 같습니다.
Email Demographics 데이터 확장 내의 대상 상태에 해당하는 특성이 있는 Salesforce Marketing Cloud Email Data 특성 그룹의 보기가 아래에 표시되어 있습니다.
(API) Salesforce Marketing Cloud 대상은 Salesforce Marketing Cloud Search Attribute-Set Definitions REST API를 사용하여 Salesforce Marketing Cloud 내에 정의된 데이터 확장과 연결된 특성을 동적으로 검색합니다.
워크플로우에서 매핑을(를) 대상에 대한 대상을 활성화(으)로 설정할 때 대상 필드 선택 창에 표시됩니다.
salesforce_mc_segment_1
인 특성이 표시됩니다. 대상을 이 대상으로 활성화할 때 salesforce_mc_segment_1
을(를) 매핑 ID(으)로 추가하여 Experience Platform의 대상 대상을 이 특성에 채웁니다.Salesforce Marketing Cloud에서 특성을 만든 예는 다음과 같습니다.
- 속성을 만들 때 필드 이름에 공백 문자를 포함하지 마십시오. 대신 밑줄
(_)
문자를 구분 기호로 사용하십시오. - 플랫폼 대상에 사용되는 특성과 Salesforce Marketing Cloud 내의 다른 특성을 구별하기 위해 Adobe 세그먼트에 사용되는 특성에 인식 가능한 접두사 또는 접미사를 포함할 수 있습니다. 예를 들어
test_segment
대신Adobe_test_segment
또는test_segment_Adobe
을(를) 사용합니다. - Salesforce Marketing Cloud에 다른 특성이 이미 만들어져 있는 경우 플랫폼 세그먼트와 동일한 이름을 사용하여 Salesforce Marketing Cloud의 대상자를 쉽게 식별할 수 있습니다.
Salesforce Marketing Cloud 내에서 사용자 역할 및 권한 할당 prerequisites-roles-permissions
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 페이지를 참조하세요.
Salesforce Marketing Cloud 자격 증명 수집 gather-credentials
(API) Salesforce Marketing Cloud 대상에 인증하기 전에 아래 항목을 적어 두십시오.
인 경우
mcq4jrssqdlyc4lph19nnqgzzs84
.login.exacttarget.com,값으로
mcq4jrssqdlyc4lph19nnqgzzs84
을(를) 제공해야 합니다.가드레일 guardrails
-
Salesforce에서 특정 비율 제한을 적용합니다.
- 실행 중에 발생할 수 있는 가능한 제한을 해결하고 오류를 줄이려면 Salesforce Marketing Cloud 설명서를 참조하세요.
- 전체 버전 비교 차트를 다운로드 하려면 Salesforce Marketing Cloud 참여 가격 페이지를 참조하세요. 이 PDF는 플랜에 의해 적용된 제한에 대해 자세히 설명합니다.
- API 개요 페이지에서 추가 제한을 자세히 설명합니다.
- 이러한 세부 정보를 대조하는 페이지에 대해서는 여기를 참조하세요.
-
오브젝트당 허용되는 사용자 정의 필드 의 수는 Salesforce 버전에 따라 다릅니다.
지원되는 ID supported-identities
(API) Salesforce Marketing Cloud은(는) 아래 표에 설명된 ID 활성화를 지원합니다. ID에 대해 자세히 알아보세요.
지원되는 대상자 supported-audiences
이 섹션에서는 이 대상으로 내보낼 수 있는 대상자 유형을 설명합니다.
내보내기 유형 및 빈도 export-type-frequency
대상 내보내기 유형 및 빈도에 대한 자세한 내용은 아래 표를 참조하십시오.
- 필드 매핑에 따라 원하는 스키마 필드 (예: 이메일 주소, 전화 번호, 성) 과(와) 함께 세그먼트의 모든 멤버를 내보냅니다.
- Salesforce Marketing Cloud의 각 세그먼트 상태는 대상 예약 단계 동안 제공된 매핑 ID 값을 기반으로 플랫폼에서 해당 대상 상태로 업데이트됩니다.
대상에 연결 connect
이 대상에 연결하려면 대상 구성 자습서에 설명된 단계를 따르십시오. 대상 구성 워크플로에서 아래 두 섹션에 나열된 필드를 채웁니다.
대상 > 카탈로그 내에서 (API) Salesforce Marketing Cloud을(를) 검색합니다. 또는 이메일 마케팅 범주에서 찾을 수 있습니다.
대상으로 인증 authenticate
대상에 인증하려면 아래의 필수 필드를 입력한 다음 대상에 연결 을(를) 선택하십시오. 자세한 내용은 수집 Salesforce Marketing Cloud 자격 증명 섹션을 참조하십시오.
예를 들어 도메인이
인 경우
mcq4jrssqdlyc4lph19nnqgzzs84
.login.exacttarget.com,값으로
mcq4jrssqdlyc4lph19nnqgzzs84
을(를) 제공해야 합니다.Client ID
.Client Secret
.
제공된 세부 정보가 유효하면 UI에 녹색 확인 표시와 함께 연결됨 상태가 표시됩니다. 그런 다음 다음 다음 단계로 진행할 수 있습니다.
대상 세부 정보 입력 destination-details
대상에 대한 세부 정보를 구성하려면 아래의 필수 및 선택 필드를 채우십시오. UI에서 필드 옆에 있는 별표는 필드가 필수임을 나타냅니다.
- 이름: 나중에 이 대상을 인식할 수 있는 이름입니다.
- 설명: 나중에 이 대상을 식별하는 데 도움이 되는 설명입니다.
경고 활성화 enable-alerts
경고를 활성화하여 대상에 대한 데이터 흐름 상태에 대한 알림을 받을 수 있습니다. 목록에서 경고를 선택하여 데이터 흐름 상태에 대한 알림을 수신합니다. 경고에 대한 자세한 내용은 UI를 사용하여 대상 경고 구독에 대한 안내서를 참조하십시오.
대상 연결에 대한 세부 정보를 모두 제공했으면 다음 을 선택합니다.
이 대상으로 대상자 활성화 activate
이 대상으로 대상을 활성화하는 방법에 대한 지침은 프로필 및 대상을 스트리밍 대상 내보내기 대상으로 활성화를 참조하십시오.
매핑 고려 사항 및 예제 mapping-considerations-example
대상 데이터를 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에서 검색할 수 있는 특성 수에 대한 페이지 매김 제한이 적용됩니다. 즉, 매핑 단계 동안 대상 필드 스키마에 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 사이에 다음 매핑을 추가하려면 다음 단계를 반복합니다.
table 0-row-3 1-row-3 2-row-3 3-row-3 소스 필드 대상 필드 필수 IdentityMap: contactKey
Identity: salesforceContactKey
Mandatory
xdm: personalEmail.address
Salesforce Marketing Cloud Email Addresses 데이터 확장의 Attribute: Email Address
.새 연락처를 추가할 때 Mandatory
.xdm: person.name.firstName
원하는 Salesforce Marketing Cloud 데이터 확장의 Attribute: First Name
.- -
이러한 매핑을 사용하는 예는 다음과 같습니다.
-
대상 연결에 대한 매핑을 제공했으면 다음 을 선택합니다.
대상자 내보내기 예약 및 예제 schedule-segment-export-example
대상 내보내기 예약 단계를 수행할 때 Salesforce Marketing Cloud의 특성에 플랫폼 대상을 수동으로 매핑해야 합니다.
이렇게 하려면 각 세그먼트를 선택한 다음 (API) Salesforce Marketing Cloud 매핑 ID 필드에 Salesforce Marketing Cloud의 특성 이름을 입력하십시오. 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 필드 이름 내에 지정된 값과 정확히 일치해야 합니다.
활성화된 각 플랫폼 세그먼트에 대해 이 섹션을 반복합니다.
위에 표시된 이미지를 기반으로 한 일반적인 예는 다음과 같을 수 있습니다.
salesforce_mc_segment_1
salesforce_mc_segment_1
salesforce_mc_segment_2
salesforce_mc_segment_2
데이터 내보내기 유효성 검사 exported-data
대상을 올바르게 설정했는지 확인하려면 아래 단계를 수행하십시오.
-
대상 목록으로 이동하려면 대상 > 찾아보기 를 선택하십시오.
-
대상을 선택하고 상태가 활성화됨 인지 확인하십시오.
-
Activation data 탭으로 전환한 다음 대상 이름을 선택합니다.
-
대상자 요약을 모니터링하고 프로필 수가 세그먼트 내에서 만든 수에 해당하는지 확인합니다.
-
Salesforce Marketing Cloud 웹 사이트에 로그인합니다. 그런 다음 Audience Builder > Contact Builder > All contacts > Email 페이지로 이동하여 대상자의 프로필이 추가되었는지 확인합니다.
-
프로필이 업데이트되었는지 확인하려면 이메일 페이지로 이동하여 대상자의 프로필에 대한 특성 값이 업데이트되었는지 확인하십시오. 성공하면 대상 예약 단계에서 제공된 매핑 ID 값을 기반으로 Salesforce Marketing Cloud의 각 대상 상태가 플랫폼에서 해당 대상 상태로 업데이트되었음을 확인할 수 있습니다.
데이터 사용 및 관리 data-usage-governance
데이터를 처리할 때 모든 Adobe Experience Platform 대상이 데이터 사용 정책을 준수합니다. Adobe Experience Platform에서 데이터 거버넌스를 적용하는 방법에 대한 자세한 내용은 데이터 거버넌스 개요를 참조하십시오.
오류 및 문제 해결 errors-and-troubleshooting
이벤트를 Salesforce Marketing Cloud에 푸시하는 동안 알 수 없는 오류 발생 unknown-errors
-
데이터 흐름 실행을 확인할 때 다음 오류 메시지가 표시될 수 있습니다.
Unknown errors encountered while pushing events to the destination. Please contact the administrator and try again.
- 이 오류를 수정하려면 활성화 워크플로에서 (API) Salesforce Marketing Cloud 대상에 제공한 매핑 ID 이(가) Salesforce Marketing Cloud에서 만든 특성의 이름과 정확히 일치하는지 확인하십시오. 자세한 내용은 Salesforce Marketing Cloud🔗 섹션 내의 특성 만들기를 참조하세요.
-
세그먼트를 활성화할 때 다음 오류 메시지가 표시될 수 있습니다.
The client's IP address is unauthorized for this account. Allowlist the client's IP address...
- 이 오류를 해결하려면 Salesforce Marketing Cloud 계정 관리자에게 문의하여 Salesforce Marketing Cloud 계정의 신뢰할 수 있는 IP 범위에 Experience Platform IP 주소를 추가하십시오. 추가 지침이 필요한 경우 Salesforce Marketing Cloud IP 주소 설명서를 참조하여 Marketing Cloud의 허용 목록에 포함하십시오.
추가 리소스 additional-resources
변경 로그 changelog
이 섹션에서는 이 대상 커넥터에 대한 기능 및 중요 설명서 업데이트를 캡처합니다.
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 layout-auto | ||
---|---|---|
릴리스 월 | 업데이트 유형 | 설명 |
2023년 10월 | 설명서 업데이트 |
|
2023년 4월 | 설명서 업데이트 |
|
2023년 2월 | 설명서 업데이트 | Salesforce Marketing Cloud Engagement이(가) 이 대상을 사용하기 위한 필수 구독임을 호출하는 참조 링크를 포함하도록 (API) Salesforce Marketing Cloud의 필수 구성 요소 섹션을 업데이트했습니다. |
2023년 2월 | 기능 업데이트 | 대상에서 잘못된 구성으로 인해 잘못된 포맷의 JSON이 Salesforce로 전송되는 문제가 해결되었습니다. 이로 인해 일부 사용자는 활성화 시 많은 ID가 실패했음을 보게 되었습니다. (PLATIR-26299) |
2023년 1월 | 설명서 업데이트 | |
2022년 10월 | 초기 릴리스 | 초기 대상 릴리스 및 설명서 게시. |