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를 기반으로 귀하의 웹사이트를 개인 설정하기 위한 샘플 쿼리입니다. 응답은 알려진 고객과 알 수 없는 고객을 모두 반환합니다.
쿼리 유형 | 예 | 참고 |
---|---|---|
CookieId로 고객 가져오기 | {serviceRoot}/msdynci_personalizationprofiles(cookieid='{cookieId}') |
|
CookieId로 고객을 가져오고 세그먼트, 측정값, 활동 포함 | {serviceRoot}/msdynci_personalizationprofiles(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_unifiedactivities?$filter=msdynci_customerid eq '{CID}' |
|
일정 기간 내 고객의 모든 활동 가져오기 | {serviceRoot}/msdynci_unifiedactivities?$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_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}' |
|
고객 activityDisplayName의 모든 활동 가져오기 | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}' |
|
고객의 모든 활동 가져오기 및 정렬하기 | {serviceRoot}/msdynci_unifiedactivities?$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' |
다음 단계
대부분의 Customer Insights - Data 테이블은 Dataverse에서 사용할 수 있습니다. 자세한 내용은 Dataverse의 테이블을 참조하세요.
예를 들어 Dataverse는 Postman을 통해 API를 테스트하기 위한 광범위한 지원을 제공합니다. 자세한 내용은 Postman 환경 설정을 참조하세요.
Dataverse API 서비스 한도에 대한 자세한 내용은 Microsoft Dataverse API 한도 개요를 참조하세요.
Dataverse API 사용 방법에 대한 자세한 내용은 웹 API를 사용하여 데이터 쿼리를 참조하십시오.