(API) Salesforce Marketing Cloud 연결

개요

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

비교 대상 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그런 다음 마케팅 캠페인 이메일을 보내는 데 사용할 수 있습니다.

전제 조건

Experience Platform의 사전 요구 사항

에 대한 데이터를 활성화하기 전에 (API) Salesforce Marketing Cloud 대상, 다음 항목이 있어야 합니다. 스키마, a 데이터 세트, 및 세그먼트 생성 위치 Experience Platform.

의 사전 요구 사항 (API) Salesforce Marketing Cloud

Platform에서 로 데이터를 내보내려면 다음 전제 조건을 참고하십시오. Salesforce Marketing Cloud 계정:

다음을 수행해야 합니다. Salesforce Marketing Cloud account

A Salesforce Marketing Cloud 다음에 대한 구독이 있는 계정 Marketing Cloud Engagement 계속하려면 제품이 필수입니다.

다음 대상에게 연결 Salesforce 지원 이 없는 경우 Salesforce Marketing Cloud 계정 또는 계정에 다음 항목이 없습니다. Marketing Cloud Engagement 제품 구독.

다음 내에서 속성 만들기 Salesforce Marketing Cloud

대상자를 활성화할 때 (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이 아래에 표시되어 있습니다.

내에서 사용자 역할 및 권한 할당 Salesforce Marketing Cloud

다음으로: 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 자격 증명

에 인증하기 전에 아래 항목을 적어 두십시오. (API) Salesforce Marketing Cloud 대상.

가드레일

• Salesforce는 다음을 수행합니다. 비율 제한.
  • 다음을 참조하십시오. Salesforce Marketing Cloud 설명서 실행 중에 발생할 수 있는 가능한 제한을 해결하고 오류를 줄이려면
  • 다음을 참조하십시오. Salesforce Marketing Cloud 참여 가격 책정 페이지 대상 전체 버전 비교 차트 다운로드 플랜에 따라 적용되는 제한을 자세히 설명하는 pdf입니다.
  • 다음 API 개요 페이지 세부 정보 추가 제한.
  • 참조 여기 이러한 세부 정보를 대조하는 페이지용입니다.
• 의 수 오브젝트당 허용되는 사용자 정의 필드 는 Salesforce 버전에 따라 다릅니다.
  • 다음을 참조하십시오. Salesforce 설명서 추가 지침을 참조하십시오.
  • 다음에 대해 정의된 제한에 도달한 경우 오브젝트당 허용되는 사용자 정의 필드 다음 범위 내 Salesforce Marketing Cloud 다음을 수행해야 합니다
    • 에서 새 속성을 추가하기 전에 이전 속성을 제거합니다. Salesforce Marketing Cloud.
    • 제공된 값으로 이러한 이전 속성 이름을 사용하는 Platform 대상에서 활성화된 모든 대상을 업데이트하거나 제거합니다 매핑 ID 다음 기간 동안 대상자 예약 단계.

지원되는 ID

(API) Salesforce Marketing Cloud 는 아래 표에 설명된 id 활성화를 지원합니다. 자세히 알아보기 id.

지원되는 대상자

이 섹션에서는 이 대상으로 내보낼 수 있는 대상자 유형을 설명합니다.

내보내기 유형 및 빈도

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

대상에 연결

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

다음 범위 내 대상 > 카탈로그, 검색 (API) Salesforce Marketing Cloud. 또는 아래에서 찾을 수 있습니다 이메일 마케팅 범주.

대상으로 인증

대상에 인증하려면 아래의 필수 필드를 입력한 다음 을(를) 선택합니다. 대상에 연결. 다음을 참조하십시오. 수집 Salesforce Marketing Cloud 자격 증명 섹션에 자세히 설명되어 있습니다.

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

대상 세부 정보 입력

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

• 이름: 나중에 이 대상을 인식할 수 있는 이름입니다.
• 설명: 나중에 이 대상을 식별하는 데 도움이 되는 설명입니다.

경고 활성화

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

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

이 대상으로 대상자 활성화

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

매핑 고려 사항 및 예제

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

XDM 필드를 (API) Salesforce Marketing Cloud 대상 필드에서 아래 단계를 수행합니다.

1. 다음에서 매핑 단계, 선택 새 매핑 추가. 화면에 새 매핑 행이 표시됩니다.
   

2. 다음에서 소스 필드 선택 창에서 다음을 선택합니다. 속성 선택 범주를 선택한 다음 XDM 속성을 선택하거나 ID 네임스페이스 선택 id를 선택합니다.

3. 다음에서 대상 필드 선택 창에서 다음을 선택합니다. 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 |

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

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

1. 선택 대상 > 찾아보기 대상 목록으로 이동합니다.
   

2. 대상을 선택하고 상태가 다음과 같은지 확인합니다. 활성화됨.
   

3. 다음으로 전환 Activation data 탭을 누른 다음 대상 이름을 선택합니다.
   

4. 대상자 요약을 모니터링하고 프로필 수가 세그먼트 내에서 만든 수에 해당하는지 확인합니다.
   

5. 에 로그인합니다 Salesforce Marketing Cloud 웹 사이트입니다. 그런 다음 로 이동합니다 Audience Builder > Contact Builder > All contacts > Email 페이지를 만들고 대상자의 프로필이 추가되었는지 확인합니다.
   

6. 프로필이 업데이트되었는지 확인하려면 이메일 을(를) 페이지를 만들고 대상의 프로필 속성 값이 업데이트되었는지 확인합니다. 성공하면 각 대상자 상태가에서 확인할 수 있습니다. Salesforce Marketing Cloud 이(가) 다음을 기반으로 플랫폼에서 해당 대상 상태로 업데이트되었습니다. 매핑 ID 에 제공된 값 대상자 예약 단계.
   

데이터 사용 및 관리

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

오류 및 문제 해결

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

• 데이터 흐름 실행을 확인할 때 다음 오류 메시지가 표시될 수 있습니다. Unknown errors encountered while pushing events to the destination. Please contact the administrator and try again.
  

  • 이 오류를 수정하려면 다음을 확인하십시오. 매핑 ID 활성화 워크플로에서 제공한 (API) Salesforce Marketing Cloud 대상이 사용자가 만든 속성의 이름과 정확히 일치합니다. 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 추가할 계정 관리자 Experience Platform IP 주소 (으)로 Salesforce Marketing Cloud 계정의 신뢰할 수 있는 IP 범위입니다. 다음을 참조하십시오. Salesforce Marketing Cloud Marketing Cloud에 허용 목록에 포함할 IP 주소 추가 지침이 필요한 경우 설명서를 참조하십시오.

추가 리소스

• Salesforce Marketing Cloud API
• Salesforce Marketing Cloud 설명서 연락처가 지정된 정보로 업데이트되는 방법을 설명합니다.

변경 로그

이 섹션에서는 이 대상 커넥터에 대한 기능 및 중요 설명서 업데이트를 캡처합니다.