(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 설명서 참조: 세그먼트 멤버십 세부 정보 스키마 필드 그룹 세그먼트 상태에 대한 지침이 필요한 경우.

플랫폼에서 로 활성화하는 각 세그먼트에 대해 Salesforce Marketing Cloud, 유형의 속성을 만들어야 합니다. Text 다음 범위 내 Salesforce. 사용 Salesforce Marketing Cloud Contact Builder 속성을 만듭니다. 속성 필드 이름은 (API) Salesforce Marketing Cloud 대상 필드 및 은(는) Email Demographics system attribute-set. 비즈니스 요구 사항에 따라 최대 4000자로 필드 문자를 정의할 수 있습니다. 다음을 참조하십시오. Salesforce Marketing Cloud 데이터 확장 데이터 유형 속성 유형에 대한 추가 정보는 설명서 페이지를 참조하십시오.

다음을 참조하십시오. Salesforce Marketing Cloud 에 대한 설명서 속성 만들기 속성 만들기에 대한 지침이 필요한 경우.

의 데이터 디자이너 화면의 예 Salesforce Marketing Cloud속성을 추가할 가 아래에 표시되어 있습니다.

의 보기 Salesforce Marketing Cloud Email Demographics 속성 세트는 다음과 같습니다.

다음 (API) Salesforce Marketing Cloud 대상이 을 사용합니다. Salesforce Marketing Cloud Search Attribute-Set Definitions REST API 내에서 정의된 속성 및 해당 속성 세트를 동적으로 읽어들이기 Salesforce Marketing Cloud.

다음 위치에 표시됩니다. Target 필드 다음을 설정할 때 선택 창 매핑 (으)로 이동하는 워크플로우 대상에 대한 세그먼트 활성화. 내에 정의된 속성에 대한 매핑만 Salesforce Marketing Cloud Email Demographics attribute-set이 지원됩니다.

의 속성 작성 예 Salesforce Marketing Cloud이 아래에 표시되어 있습니다.

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

다음으로: Salesforce Marketing Cloud 은(는) 사용자 정의 역할을 지원합니다. 사용 사례에 따라 사용자는 관련 역할을 할당하여에서 속성을 업데이트해야 합니다. Salesforce Marketing Cloud attribute-sets. 사용자에게 할당된 역할의 예는 다음과 같습니다.

의 역할에 따라 Salesforce Marketing Cloud 사용자가 할당되었으므로 Salesforce Marketing Cloud 업데이트하려는 필드가 포함된 속성 세트입니다.

이 대상에 대한 액세스 권한이 필요하므로 Email Demographics system attribute-set, 다음을 허용해야 합니다. Email 아래와 같이:

액세스 수준을 제한하려면 세분화된 권한을 사용하여 개별 액세스를 재정의할 수도 있습니다.

다음을 참조하십시오. 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를 선택하거나 사용자 지정 속성 선택 카테고리에 추가하고 속성 선택 Email Demographics 필요에 따라 속성이 표시됩니다. 다음 (API) Salesforce Marketing Cloud 대상이 을 사용합니다. Salesforce Marketing Cloud Search Attribute-Set Definitions REST API 내에서 정의된 속성 및 해당 속성 세트를 동적으로 읽어들이기 Salesforce Marketing Cloud. 다음 위치에 표시됩니다. Target 필드 팝업 을 사용하여 매핑 다음에서 워크플로우에 세그먼트 활성화. 참고: 내에 정의된 속성에 대한 매핑만 Salesforce Marketing Cloud Email Demographics 속성 세트가 지원됩니다.

   • XDM 프로필 스키마와 간에 다음 매핑을 추가하려면 이 단계를 반복합니다 (API) Salesforce Marketing Cloud: |소스 필드|Target 필드| 필수| |—|—| |IdentityMap: contactKey|Identity: salesforceContactKey| Mandatory |\

     |xdm: person.name.firstName|Attribute: Email Demographics.First Name| - |
     |xdm: personalEmail.address|Attribute: Email Addresses.Email Address| - |

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

     

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

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

다음을 수행할 때 세그먼트 내보내기 예약 단계: 플랫폼 세그먼트를 속성 위치: 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 필드 이름.

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

사용 사례에 따라 활성화된 모든 세그먼트를 동일한 세그먼트에 매핑할 수 있습니다 Salesforce Marketing Cloud 필드 이름 또는 다름 필드 이름 위치: (API) 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 설명서 지정된 속성 그룹의 지정된 정보로 연락처가 업데이트되는 방법을 설명합니다.

변경 로그

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

Business.Adobe.com 리소스