설명서Experience Platform대상 안내서

Microsoft Dynamics 365 연결

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 관리자
  • 사용자

개요 overview

Microsoft Dynamics 365은(는) 생산성 응용 프로그램 및 AI 도구와 함께 ERP(전사적 자원 관리) 및 CRM(고객 관계 관리)을 결합하여 전체적인 더 유연하고 통제된 운영, 더 나은 성장 가능성 및 비용 절감을 제공하는 클라우드 기반의 비즈니스 응용 프로그램 플랫폼입니다.

이 Adobe Experience Platform 대상은(는) 대상 내의 ID를 Dynamics 365 (으)로 업데이트할 수 있는 Contact Entity Reference API을(를) 활용합니다.

Dynamics 365은(는) 인증 메커니즘으로 권한 부여가 있는 OAuth 2를 사용하여 Contact Entity Reference API과(와) 통신합니다. Dynamics 365 인스턴스에 대한 인증 지침은 대상에 대한 인증 섹션에서 아래에 더 나와 있습니다.

사용 사례 use-cases

마케터는 Adobe Experience Platform 프로필의 속성에 따라 개인화된 경험을 사용자에게 제공할 수 있습니다. Adobe Experience Platform에서 대상 및 프로필이 업데이트되는 즉시 사용자 피드에 표시하기 위해 오프라인 데이터에서 대상을 작성하고 이 대상을 Dynamics 365 (으)로 보낼 수 있습니다.

전제 조건 prerequisites

Experience Platform 사전 요구 사항 prerequisites-in-experience-platform

Dynamics 365 대상에 대한 데이터를 활성화하기 전에 Experience Platform에서 만든 스키마, 데이터 세트 및 대상이 있어야 합니다.

대상 상태에 대한 지침이 필요한 경우 대상 멤버십 세부 정보 스키마 필드 그룹에 대한 Adobe 설명서를 참조하세요.

Microsoft Dynamics 365개 필수 구성 요소 prerequisites-destination

플랫폼에서 Dynamics 365 계정으로 데이터를 내보내려면 Dynamics 365의 다음 필수 구성 요소를 참고하십시오.

Microsoft Dynamics 365 계정이 있어야 합니다. prerequisites-account

아직 계정이 없는 경우 Dynamics 365 평가판 페이지로 이동하여 등록하고 계정을 만드십시오.

Dynamics 365 내에 필드 만들기 prerequisites-custom-field

Dynamics 365 내의 대상 상태를 업데이트하는 데 사용할 필드 데이터 형식을 Single Line of Text(으)로 하는 Simple 유형의 Experience Platform 정의 필드를 만드십시오.

추가 지침이 필요한 경우 Dynamics 365 필드(특성) 만들기 또는 편집 설명서를 참조하십시오.

Dynamics 365에서 만든 사용자 지정 필드의 사용자 지정 접두사 ​을(를) 기록하십시오. 대상 세부 정보를 입력하십시오 단계 동안 이 접두사가 필요합니다. 자세한 내용은 Dynamics 365 설명서의 필드 만들기 및 편집 섹션을 참조하십시오.
사용자 지정 접두사를 표시하는 Dynamics 365 UI 스크린샷입니다.

Dynamics 365 내의 예제 설정이 아래에 표시되어 있습니다.
사용자 지정 필드를 보여주는 Dynamics 365 UI 스크린샷입니다.

Azure Active Directory 내에서 응용 프로그램 및 응용 프로그램 사용자 등록 prerequisites-app-user

Dynamics 365이(가) 리소스에 액세스할 수 있도록 하려면 Azure Account (으)로 Azure Active Directory에 로그인하고 다음을 만들어야 합니다.

  • Azure Active Directory 응용 프로그램
  • 서비스 주체
  • 애플리케이션 암호

Azure Active Directory에서 응용 프로그램 사용자를 만들고을(를) 새로 만든 응용 프로그램과 연결해야 합니다.

Dynamics 365 자격 증명 수집 gather-credentials

Dynamics 365 CRM 대상에 인증하기 전에 아래 항목을 적어 두십시오.

자격 증명
설명
예
Client ID
Azure Active Directory 응용 프로그램에 대한 Dynamics 365 클라이언트 ID입니다. 자세한 내용은 Dynamics 365 설명서를 참조하세요.
ababbaba-abab-baba-acac-acacacacacac
Client Secret
Azure Active Directory 응용 프로그램에 대한 Dynamics 365 클라이언트 암호입니다. Dynamics 365 설명서에서 #2 옵션을 사용합니다.
지침을 위한 abcde~abcdefghijklmnopqrstuvwxyz12345678.
Tenant ID
Azure Active Directory 응용 프로그램에 대한 Dynamics 365 테넌트 ID입니다. 자세한 내용은 Dynamics 365 설명서를 참조하세요.
1234567-aaaa-12ab-ba21-1234567890
Region
환경 URL과 연결된 Microsoft 영역입니다.
지침은 Dynamics 365 설명서를 참조하세요.
도메인이 아래와 같은 경우 대상.
에 인증할 때 드롭다운 선택기에서 CRM 필드에 강조 표시된 값을 제공해야 합니다. org57771b33.crm.dynamics.com
예: 회사가 북미(NAM) 지역에서 프로비저닝된 경우 URL은 crm.dynamics.com이고 crm을(를) 선택해야 합니다. 회사가 캐나다(CAN) 지역에서 프로비저닝된 경우 URL은 crm3.dynamics.com이고 crm3을(를) 선택해야 합니다.
Environment URL
자세한 내용은 Dynamics 365 설명서를 참조하세요.
Dynamics 365 도메인이 아래와 같은 경우 강조 표시된 값이 필요합니다.
org57771b33.crm.dynamics.com

가드레일 guardrails

요청 제한 및 할당 페이지에서 Dynamics 365 라이선스와 연결된 Dynamics 365 API 제한을 자세히 설명합니다. 데이터와 페이로드가 이러한 제한 내에 있는지 확인해야 합니다.

지원되는 ID supported-identities

Dynamics 365은(는) 아래 표에 설명된 ID 업데이트를 지원합니다. ID에 대해 자세히 알아보세요.

대상 ID
예
설명
고려 사항
contactid
7eb682f1-ca75-e511-80d4-00155d2a68d1
연락처에 대한 고유 식별자.
필수. 자세한 내용은 Dynamics 365 설명서를 참조하세요.

지원되는 대상자 supported-audiences

이 섹션에서는 이 대상으로 내보낼 수 있는 모든 대상에 대해 설명합니다.

이 대상은 Experience Platform 세그먼테이션 서비스를 통해 생성된 모든 대상의 활성화를 지원합니다.

내보내기 유형 및 빈도 export-type-frequency

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

항목
유형
참고
내보내기 유형
프로필 기반
  • 필드 매핑에 따라 원하는 스키마 필드 (예: 이메일 주소, 전화번호, 성) ​과(와) 함께 대상자의 모든 구성원을 내보냅니다.
  • Dynamics 365의 각 대상 상태는 대상 예약 단계 동안 제공된 매핑 ID 값을 기반으로 플랫폼에서 해당 대상 상태로 업데이트됩니다.
내보내기 빈도
스트리밍
  • 스트리밍 대상은 "항상" API 기반 연결입니다. 대상자 평가를 기반으로 Experience Platform에서 프로필이 업데이트되는 즉시 커넥터가 업데이트 다운스트림을 대상 플랫폼으로 전송합니다. 스트리밍 대상에 대해 자세히 알아보세요.

대상에 연결 connect

IMPORTANT
대상에 연결하려면 대상 보기 및 대상 관리 액세스 제어 권한이 필요합니다. 액세스 제어 개요를 읽거나 제품 관리자에게 문의하여 필요한 권한을 받으십시오.

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

대상 > 카탈로그 내에서 Dynamics 365 검색 또는 CRM 범주 아래에서 찾을 수 있습니다.

대상으로 인증 authenticate

대상에 인증하려면 대상에 연결 ​을 선택하세요.
인증 방법을 보여 주는 플랫폼 UI 스크린샷입니다.

아래의 필수 필드를 입력하십시오. 자세한 내용은 Dynamics 365 자격 증명 수집 섹션을 참조하십시오.

  • 클라이언트 ID: Azure Active Directory 응용 프로그램의 Dynamics 365 클라이언트 ID입니다.
  • 테넌트 ID: Azure Active Directory 응용 프로그램의 Dynamics 365 테넌트 ID입니다.
  • 클라이언트 암호: Azure Active Directory 응용 프로그램에 대한 Dynamics 365 클라이언트 암호입니다.
  • 지역: Dynamics 365 지역. 예를 들어 회사가 북미(NAM) 지역에 프로비저닝된 경우 URL은 crm.dynamics.com이고 crm을(를) 선택해야 합니다. 회사가 캐나다(CAN) 지역에서 프로비저닝된 경우 URL은 crm3.dynamics.com이고 crm3을(를) 선택해야 합니다.
  • 환경 URL: Dynamics 365 환경 URL.

제공된 세부 정보가 유효하면 UI에 녹색 확인 표시와 함께 연결됨 상태가 표시됩니다. 그런 다음 다음 다음 단계로 진행할 수 있습니다.

대상 세부 정보 입력 destination-details

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

  • 이름: 나중에 이 대상을 인식할 수 있는 이름입니다.
  • 설명: 나중에 이 대상을 식별하는 데 도움이 되는 설명입니다.
  • 사용자 지정 접두사: Dynamics 365에서 만든 사용자 지정 필드의 Customization prefix. 자세한 내용은 Dynamics 365 설명서의 필드 만들기 및 편집 섹션을 참조하십시오.

경고 활성화 enable-alerts

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

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

이 대상으로 대상자 활성화 activate

IMPORTANT
  • 데이터를 활성화하려면 대상 보기, 대상 활성화, 프로필 보기 및 세그먼트 보기 액세스 제어 권한이 필요합니다. 액세스 제어 개요를 읽거나 제품 관리자에게 문의하여 필요한 권한을 받으십시오.
  • ID ​을(를) 내보내려면 ID 그래프 보기 액세스 제어 권한이 필요합니다.
    대상자를 대상으로 활성화하려면 워크플로에서 강조 표시된 ID 네임스페이스를 선택하십시오. {width="100" modal="regular"}

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

매핑 고려 사항 및 예제 mapping-considerations-example

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

  1. 매핑 단계에서 새 매핑 추가 ​를 선택합니다. 화면에 새 매핑 행이 표시됩니다.
    새 매핑 추가를 위한 플랫폼 UI 스크린샷 예

  2. 원본 필드 선택 창에서 ID 네임스페이스 선택 범주를 선택하고 contactid을(를) 선택합니다.
    Source 매핑에 대한 플랫폼 UI 스크린샷 예

  3. 대상 필드 선택 창에서 원본 필드를 매핑할 대상 필드 유형을 선택합니다.

    • ID 네임스페이스 선택: 소스 필드를 목록의 ID 네임스페이스에 매핑하려면 이 옵션을 선택하십시오.

      Contactid에 대한 Target 매핑을 보여 주는 Platform UI 스크린샷

    • XDM 프로필 스키마와 Dynamics 365 인스턴스 간에 다음 매핑을 추가합니다.
      |XDM 프로필 스키마|Dynamics 365 인스턴스| 필수|
      |—|—|
      |contactid|contactid| 예 |

    • 사용자 지정 특성 선택: 소스 필드를 특성 이름 필드에 정의한 사용자 지정 특성에 매핑하려면 이 옵션을 선택하십시오. 지원되는 특성의 전체 목록은 Dynamics 365 설명서를 참조하세요.

      이메일에 대한 대상 매핑을 보여 주는 플랫폼 UI 스크린샷

      note important
      IMPORTANT
      • 대상 필드 이름은 lowercase에 있어야 합니다.
      • 또한 Dynamics 365 날짜 또는 타임스탬프 대상 필드에 매핑된 날짜 또는 타임스탬프 원본 필드가 있는 경우 매핑된 값이 비어 있지 않은지 확인하십시오. 내보낸 필드 값이 비어 있으면 Bad request reported while pushing events to the destination. Please contact the administrator and try again. 오류 메시지가 표시되고 데이터가 업데이트되지 않습니다. Dynamics 365 제한입니다.

    • 예를 들어 업데이트할 값에 따라 XDM 프로필 스키마와 Dynamics 365 인스턴스 사이에 다음 매핑을 추가합니다.
      |XDM 프로필 스키마|Dynamics 365 인스턴스|
      |—|—|
      |person.name.firstName|firstname|
      |person.name.lastName|lastname|
      |personalEmail.address|emailaddress1|

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

      Target 매핑을 보여 주는 Platform UI 스크린샷 예입니다.

대상자 내보내기 예약 및 예제 schedule-audience-export-example

활성화 워크플로의 대상 내보내기 예약 단계에서 플랫폼 대상을 Dynamics 365의 사용자 지정 필드 특성에 수동으로 매핑해야 합니다.

이렇게 하려면 각 대상을 선택한 다음 매핑 ID 필드에 Dynamics 365의 해당 사용자 지정 필드 특성을 입력하십시오.

IMPORTANT
매핑 ID ​에 사용된 값은 Dynamics 365 내에 만든 사용자 지정 필드 특성의 이름과 정확히 일치해야 합니다. 사용자 지정 필드 특성을 찾는 방법에 대한 지침이 필요한 경우 Dynamics 365 설명서를 참조하세요.

예제는 아래에 나와 있습니다.
대상자 내보내기 일정을 보여 주는 Platform UI 스크린샷 예입니다.

데이터 내보내기 유효성 검사 exported-data

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

  1. 대상 목록으로 이동하려면 대상 > 찾아보기 ​를 선택하십시오.
    검색 대상을 표시하는 플랫폼 UI 스크린샷입니다.

  2. 대상을 선택하고 상태가 활성화됨 ​인지 확인하십시오.
    대상 데이터 흐름이 실행되는 Platform UI 스크린샷입니다.

  3. Activation data 탭으로 전환한 다음 대상 이름을 선택합니다.
    대상 활성화 데이터를 보여주는 플랫폼 UI 스크린샷 예입니다.

  4. 대상자 요약을 모니터링하고 프로필 수가 대상자 내에서 만든 수에 해당하는지 확인합니다.
    대상을 표시하는 Platform UI 스크린샷 예입니다.

  5. Dynamics 365 웹 사이트에 로그인한 다음 Customers > Contacts 페이지로 이동하여 대상자의 프로필이 추가되었는지 확인합니다. 대상 예약 단계 동안 제공된 매핑 ID 값을 기반으로 Dynamics 365의 각 대상 상태가 플랫폼의 해당 대상 상태로 업데이트되었음을 확인할 수 있습니다.
    대상 상태가 업데이트된 연락처 페이지를 표시하는 Dynamics 365 UI 스크린샷.

데이터 사용 및 관리 data-usage-governance

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

오류 및 문제 해결 errors-and-troubleshooting

이벤트를 대상으로 푸시하는 동안 알 수 없는 오류 발생 unknown-errors

데이터 흐름 실행을 확인할 때 다음 오류 메시지가 나타나면 Bad request reported while pushing events to the destination. Please contact the administrator and try again.

잘못된 요청 오류를 표시하는 Platform UI 스크린샷입니다.

이 오류를 수정하려면 Platform 대상에 대해 Dynamics 365에서 제공한 매핑 ID ​이(가) 유효하고 Dynamics 365 내에 있는지 확인하십시오.

추가 리소스 additional-resources

Dynamics 365 설명서의 추가 유용한 정보는 다음과 같습니다.

변경 로그

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

변경 로그 보기
table 0-row-3 1-row-3 2-row-3 3-row-3 layout-auto
릴리스 월 업데이트 유형 설명
2023년 10월 설명서 업데이트 매핑 고려 사항 및 예제 단계에서 모든 대상 특성 이름이 소문자여야 함을 나타내는 지침을 업데이트했습니다.
2023년 8월 기능 및 설명서 업데이트 Dynamics 365의 기본 솔루션 내에서 만들어지지 않은 사용자 지정 필드에 대한 Dynamics 365 사용자 지정 필드 접두사에 대한 지원을 추가했습니다. 대상 세부 정보를 채우기 단계에서 새 입력 필드 사용자 지정 접두사 ​을(를) 추가했습니다. (PLATIR-31602).
2022년 11월 초기 릴리스 초기 대상 릴리스 및 설명서 게시.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6