다음을 통해 공유

Customer Insights - Data용 Dataverse API

  • 아티클

고객 프로필 쿼리 또는 세그먼트 멤버십 가져오기 등 Customer Insights - Data API를 이미 사용하고 있는 경우 대신 API를 Dataverse API로 마이그레이션하는 것이 좋습니다. 세그먼트 정의 가져오기 및 워크플로 관리와 같은 메타데이터 쿼리 지원이 곧 Dataverse API에 제공됩니다.

API를 사용하여 데이터 쿼리를 시작하는 경우 Dataverse API를 대신 사용하는 것이 좋습니다.

중요

Dataverse API는 Customer Insights - Data 처리에 문제를 일으킬 수 있으므로 데이터를 읽기(GET)에만 사용하고 데이터 쓰기(POST/PATCH/PUT)에는 사용하지 않는 것이 좋습니다.

Dataverse API에는 다음과 같은 장점이 있습니다.

  • 필터링 및 정렬을 위한 확장된 기능

  • 규모 및 성능 향상

  • Dynamics 365 및 Power Platform 앱 전반에서 일관된 API 경험

샘플 쿼리

Dataverse API 사용을 시작하려면 Azure에서 애플리케이션 등록을 만들고 Dataverse에 대한 권한을 요청하고 Customer Insights - Data에 대한 뷰어 권한을 앱에 부여합니다.

대상 환경에서 작동하도록 쿼리 샘플을 수정합니다.

  • {serviceRoot}: {Organization URI}/api/data/v9.2/ 여기서 {Organization URI}는 환경과 연결된 Dataverse 테넌트의 URI입니다. 예: https://{mydvorg}.crm.dynamics.com

  • {CID}: 통합 고객 레코드의 GUID입니다. 예: ce759201f786d590bf2134bff576c369.

  • {AlternateKey}: 데이터 원본에 있는 고객 레코드의 기본 키 식별자입니다. 예: CNTID_1002.

  • {DSname}: Customer Insights - Data에 수집되는 데이터 원본의 테이블 이름이 포함된 문자열입니다. 예: Website_contacts.

  • {SegmentName}: 세그먼트의 출력 테이블 이름이 포함된 문자열입니다. 예: Male_under_40.

  • {CookieId}: 웹 추적 스크립트를 사용하면 자동으로 생성되는 각 웹 사이트 방문자의 식별자입니다. 예: 3f43317e-d1ef-4cd3-9917-2d3342111d1a.

고객 님

CustomerProfile 테이블 및 세그먼트 구성원에 대한 샘플 쿼리입니다.

쿼리 유형 예 노트
모든 고객 가져오기 {serviceRoot}/msdynci_customerprofiles
ID로 고객 가져오기 {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID}'
대체 키로 고객 가져오기 {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK}' 대체 키는 통합 고객 테이블에서 msdynci_DSname_TableName_PrimaryKeyColumnName 형식으로 유지됩니다
고객에 대해 선택한 특성 가져오기 {serviceRoot}/msdynci_customerprofiles?$select=msdynci_fullname&$filter=msdynci_customerid eq '{CID}'
ID로 고객 가져오기(In) {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID1}' or msdynci_customerid eq '{CID2}'
대체 키로 고객 가져오기(In) {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK1}' or {msdynci_alternate_column} eq '{AK2}'
고객 검색 {serviceRoot}/msdynci_customerprofiles?$filter=contains(msdynci_lastname,'string')&$top=10
세그먼트의 구성원인 모든 고객 가져오기 {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"')&$select=msdynci_customerid
고객이 세그먼트의 구성원인 경우 고객 가져오기 {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"') and msdynci_customerid eq '{CID}'&$select=msdynci_customerid
고객의 모든 세그먼트의 구성원 가져오기 {serviceRoot}/msdynci_segmentmemberships?$filter=msdynci_customerid eq '{CID}'&$select=msdynci_segments

웹 개인 설정

CookieId를 기반으로 귀하의 웹사이트를 개인 설정하기 위한 샘플 쿼리입니다. 응답은 알려진 고객과 알 수 없는 고객을 모두 반환합니다. 웹 추적 및 개인 설정을 위해 생성된 테이블은 Dataverse에서 사용할 수 있습니다.

쿼리 유형 예 참고
CookieId로 고객 가져오기 {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}')
CookieId로 고객을 가져오고 세그먼트, 측정값, 활동 포함 {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}',include=['segmentmembership','measures','unifiedactivity'])
CookieId로 고객의 최근(최근 10개) 페이지 조회수 가져오기 {serviceRoot}/msdynci_pageviews(cookieid='{cookieId}',top=10) 이 쿼리는 최대 200개의 최근 페이지 조회수를 반환하도록 변경할 수 있습니다
CookieId로 고객의 최근(최근 10개) 페이지 클릭수 가져오기 {serviceRoot}/msdynci_pageclicks(cookieid='{cookieId}',top=10) 이 쿼리는 최대 200개의 최근 페이지 클릭수를 반환하도록 변경할 수 있습니다

통합 활동

UnifiedActivity 테이블에 대한 샘플 쿼리입니다.

쿼리 유형 예 노트
고객의 모든 활동 가져오기 {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}'
일정 기간 내 고객의 모든 활동 가져오기 {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytime gt 2017-01-01T00:00:00Z and msdynci_activitytime lt 2017-01-01T00:00:00Z
고객 activityType의 모든 활동 가져오기 {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}'
고객 activityDisplayName의 모든 활동 가져오기 {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}'
고객의 모든 활동 가져오기 및 정렬하기 {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc

다른 예제

다른 테이블에 대한 샘플 쿼리입니다.

쿼리 유형 예 노트
고객의 모든 측정값 가져오기 {serviceRoot}/msdynci_customermeasures?$filter=msdynci_customerid eq '{CID}'
풍부한 고객 브랜드 가져오기 {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'BrandShareOfVoiceFromMicrosoft'
풍부한 고객 관심사 가져오기 {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'InterestShareOfVoiceFromMicrosoft'
고객의 AI 모델 결과 가져오기 {serviceRoot}/msdynci_predictions?$filter=msdynci_customerid eq '{CID}' and msdynci_modelprovider eq 'ChurnModel'

다음 단계