Microsoft Dynamics 365 연결

개요 overview

Microsoft Dynamics 365 는 생산성 애플리케이션 및 AI 도구와 함께 ERP(전사적 자원 관리) 및 CRM(고객 관계 관리)을 결합하여 전체적인 원활하고 더욱 통제된 운영, 향상된 성장 잠재력 및 비용 절감을 제공하는 클라우드 기반의 비즈니스 애플리케이션 플랫폼입니다.

이 Adobe Experience Platform 대상 을 활용합니다. Contact Entity Reference API: 대상자 내의 ID를 업데이트할 수 있습니다. Dynamics 365.

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

사용 사례 use-cases

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

전제 조건 prerequisites

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

에 대한 데이터를 활성화하기 전에 Dynamics 365 대상, 다음 항목이 있어야 합니다. 스키마, a 데이터 세트, 및 대상 생성 위치 Experience Platform.

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

Microsoft Dynamics 365 전제 조건 prerequisites-destination

에서 다음 전제 조건을 참고하십시오. Dynamics 365: 데이터를 플랫폼에서 로 내보내기 Dynamics 365 계정:

다음을 수행해야 합니다. Microsoft Dynamics 365 account prerequisites-account

로 이동 Dynamics 365 체험판 아직 계정이 없는 경우 등록하고 계정을 만들 수 있는 페이지입니다.

다음 범위 내에 필드 만들기 Dynamics 365 prerequisites-custom-field

유형의 사용자 정의 필드 만들기 Simple (필드 데이터 유형 포함) Single Line of Text 다음 기간 내에 대상자 상태를 업데이트하는 데 사용할 Experience Platform Dynamics 365.

다음을 참조하십시오. 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 다음을 생성합니다.

  • An Azure Active Directory 애플리케이션
  • 서비스 주체
  • 애플리케이션 암호

또한 다음을 수행해야 합니다 응용 프로그램 사용자 만들기 위치: Azure Active Directory 새로 만든 응용 프로그램과 연결합니다.

수집 Dynamics 365 자격 증명 gather-credentials

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

자격 증명
설명
Client ID
다음 Dynamics 365 클라이언트 ID Azure Active Directory 응용 프로그램. 다음을 참조하십시오. Dynamics 365 설명서 지침을 참조하십시오.
ababbaba-abab-baba-acac-acacacacacac
Client Secret
다음 Dynamics 365 에 대한 클라이언트 암호 Azure Active Directory 응용 프로그램. 다음 내에서 #2 옵션을 사용합니다. Dynamics 365 설명서.
abcde~abcdefghijklmnopqrstuvwxyz12345678 지침을 참조하십시오.
Tenant ID
다음 Dynamics 365 에 대한 임차인 ID Azure Active Directory 응용 프로그램. 다음을 참조하십시오. 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 와 연계된 API 제한 Dynamics 365 라이센스. 데이터와 페이로드가 이러한 제한 내에 있는지 확인해야 합니다.

지원되는 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: Dynamics 365 클라이언트 ID Azure Active Directory 응용 프로그램.
  • 임차인 ID: Dynamics 365 에 대한 임차인 ID Azure Active Directory 응용 프로그램.
  • 클라이언트 암호: Dynamics 365 에 대한 클라이언트 암호 Azure Active Directory 응용 프로그램.
  • 지역: 사용자 Dynamics 365 지역. 예를 들어, 회사가 북미(NAM) 지역에 프로비저닝된 경우 URL은 다음과 같습니다. crm.dynamics.com 다음을 선택해야 합니다. crm. 회사가 캐나다(CAN) 지역에서 프로비저닝된 경우 URL은 다음과 같습니다. crm3.dynamics.com 다음을 선택해야 합니다. crm3.
  • 환경 URL: 사용자 Dynamics 365 환경 URL.

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

대상 세부 정보 입력 destination-details

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

  • 이름: 나중에 이 대상을 인식할 수 있는 이름입니다.
  • 설명: 나중에 이 대상을 식별하는 데 도움이 되는 설명입니다.
  • 사용자 지정 접두사: Customization prefix 만든 사용자 정의 필드 Dynamics 365. 다음을 참조하십시오. 필드 만들기 및 편집 의 섹션 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. 다음에서 매핑 단계, 선택 새 매핑 추가. 화면에 새 매핑 행이 표시됩니다.
    새 매핑 추가에 대한 Platform UI 스크린샷 예입니다.

  2. 다음에서 소스 필드 선택 창에서 다음을 선택합니다. ID 네임스페이스 선택 범주 및 선택 contactid.
    소스 매핑용 플랫폼 UI 스크린샷 예입니다.

  3. 다음에서 대상 필드 선택 창에서 소스 필드를 매핑할 대상 필드의 유형을 선택합니다.

    • ID 네임스페이스 선택: 이 옵션을 선택하여 소스 필드를 목록의 id 네임스페이스에 매핑합니다.

      연락처에 대한 Target 매핑을 보여주는 플랫폼 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

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

이렇게 하려면 각 대상자를 선택한 다음, 해당 사용자 정의 필드 속성을 다음에서 입력합니다. Dynamics 365 다음에서 매핑 ID 필드.

IMPORTANT
에 사용되는 값 매핑 ID 은(는) 내에서 만든 사용자 정의 필드 속성의 이름과 정확히 일치해야 합니다. Dynamics 365. 다음을 참조하십시오 Dynamics 365 설명서 사용자 지정 필드 속성을 찾는 방법에 대한 지침이 필요한 경우.

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

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

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

  1. 선택 대상 > 찾아보기 대상 목록으로 이동합니다.
    찾아보기 대상을 보여 주는 플랫폼 UI 스크린샷입니다.

  2. 대상을 선택하고 상태가 다음과 같은지 확인합니다. 활성화됨.
    데이터 흐름 실행 대상을 보여 주는 플랫폼 UI 스크린샷입니다.

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

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

  5. 에 로그인합니다 Dynamics 365 웹 사이트를 방문한 다음 Customers > Contacts 페이지를 만들고 대상자의 프로필이 추가되었는지 확인합니다. 에서 각 대상자 상태를 확인할 수 있습니다. Dynamics 365 이(가) 다음을 기반으로 플랫폼에서 해당 대상 상태로 업데이트되었습니다. 매핑 ID 다음 기간 동안 제공된 값: 대상자 예약 단계.
    대상자 상태가 업데이트된 연락처 페이지를 표시하는 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 스크린샷입니다.

이 오류를 수정하려면 다음을 확인하십시오. 매핑 ID 에 을(를) 제공했습니다. Dynamics 365 플랫폼 대상자가 유효하고 다음 내에 존재합니다. 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