OData 쿼리 예시

참고

Customer Insights - Data 테이블은 Dataverse API를 사용하여 액세스할 수도 있습니다. Dataverse API를 사용하여 더 광범위한 필터링, 더 큰 처리량 및 더 짧은 대기 시간을 제공하는 Customer Insights 데이터를 쿼리하는 것이 좋습니다. 자세한 내용은 Customer Insights의 Dataverse API를 참조하세요.

OData(Open Data Protocol)는 HTTP와 같은 핵심 프로토콜을 기반으로 구축된 데이터 액세스 프로토콜입니다. 웹용 REST와 같이 일반적으로 허용되는 방법론을 사용합니다. OData 서비스를 사용하는 데 사용할 수 있는 다양한 종류의 라이브러리와 도구가 있습니다.

Dynamics 365 Customer Insights - Data API를 기반으로 자체 구현을 구축하는 데 도움이 되도록 자주 요청되는 몇 가지 예제 쿼리를 검토하세요.

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

• {serviceRoot}: https://api.ci.ai.dynamics.com/v1/instances/{instanceId} 여기서 {instanceId}는 쿼리하려는 Customer Insights - Data 환경의 GUID입니다. ListAllInstances 작업을 사용하면 액세스 권한이 있는 {InstanceId}를 찾을 수 있습니다.
• {CID}: 통합 고객 레코드의 GUID입니다. 예: ce759201f786d590bf2134bff576c369
• {AlternateKey}: 데이터 원본에 있는 고객 레코드의 기본 키 식별자입니다. 예: CNTID_1002
• {DSname}: Customer Insights - Data에 수집되는 데이터 원본의 테이블 이름이 포함된 문자열입니다. 예: Website_contacts
• {SegmentName}: Customer Insights - Data에 있는 세그먼트의 출력 테이블 이름이 포함된 문자열입니다. 예: Male_under_40

고객 님

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

쿼리 유형	예	노트
단일 고객 ID	{serviceRoot}/data/Customer?$filter=CustomerId eq '{CID}'
대체 키	{serviceRoot}/data/Customer?$filter={DSname_TableName_PrimaryKeyColumnName} eq '{AlternateKey}'	대체 키는 통합 고객 테이블에 유지됩니다
선택	{serviceRoot}/data/Customer?$select=CustomerId,FullName&$filter=customerid eq '1'
-	{serviceRoot}/data/Customer?$filter=CustomerId in ('{CID1}',’{CID2}’)
대체 키 + In	{serviceRoot}/data/Customer?$filter={DSname_TableName_PrimaryKeyColumnName} in ('{AlternateKey}','{AlternateKey}')
검색	{serviceRoot}/data/Customer?$top=10&$skip=0&$search="string"	검색 문자열에 대한 상위 10개 결과를 반환합니다
세그먼트 구성원 자격	{serviceRoot}/data/Customer?select=*&$filter=IsMemberOfSegment('{SegmentName}')&$top=10	세그먼트화 테이블에서 미리 설정된 행 수를 반환합니다.
고객용 세그먼트 멤버십	{serviceRoot}/data/Customer?$filter=CustomerId eq '{CID}'&IsMemberOfSegment('{SegmentName}')	고객이 지정된 세그먼트의 구성원인 경우 고객 프로필을 반환함

통합 활동

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

쿼리 유형	예	노트
CID 활동	{serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}'	특정 고객 프로필의 활동을 나열합니다
활동 시간 프레임	{serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}' and ActivityTime gt 2017-01-01T00:00:00.000Z and ActivityTime lt 2020-01-01T00:00:00.000Z	시간 프레임의 고객 프로필 활동
활동 유형입니다.	{serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}' and ActivityType eq '{ActivityName}'
표시 이름별 활동	{serviceRoot}/data/UnifiedActivity$filter=CustomerId eq ‘{CID}’ and ActivityTypeDisplay eq ‘{ActivityDisplayName}’
활동 정렬	{serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq ‘{CID}’ & $orderby=ActivityTime asc	오름차순 또는 내림차순 활동 정렬
고객을 위한 모든 활동과 조치	{serviceRoot}/data/Customer?$expand=UnifiedActivity,Customer_Measure&$filter=CustomerId eq '{CID}'	활동 및 측정값은 반환된 고객 프로필의 추가 키/값 쌍입니다

워크플로 관리

데이터 원본 새로 고침, 데이터 통합, 통합 작업 상태 가져오기 등 Customer Insights - Data의 프로세스와 관련된 샘플 쿼리입니다.

쿼리 유형	예	참고
데이터 원본 ID 가져오기	{serviceRoot}/manage/datasources/v2	사용자 환경의 모든 데이터 원본을 반환합니다. 응답에서 특정 데이터 원본에 대한 'friendName'을 확인한 다음 해당 'dataSourceId'를 사용할 수 있습니다.
데이터 원본 새로 고침	{serviceRoot}/manage/workflows/main/jobs?operationType=Ingestion&identifiers='{dataSourceId}'&forceRunRequested=true	데이터 원본을 새로 고치려면 위 응답의 'dataSourceId'를 사용하세요. 이는 POST 요청입니다.
전체 새로 고침 실행	{serviceRoot}/manage/workflows/main/jobs?operationType=all&forceRunRequested=true	환경의 모든 프로세스를 새로 고칩니다. 이는 POST 요청입니다.
프로세스 상태 가져오기	{serviceRoot}/manage/workflows/main/jobs

다른 예제

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

쿼리 유형	예	노트
CID 측정	{serviceRoot}/data/Customer_Measure?$filter=CustomerId eq '{CID}'
보강된 CID 브랜드	{serviceRoot}/data/BrandShareOfVoiceFromMicrosoft?$filter=CustomerId eq '{CID}'
보강된 CID 관심사	{serviceRoot}/data/InterestShareOfVoiceFromMicrosoft?$filter=CustomerId eq '{CID}'
In-Clause + 확장	{serviceRoot}/data/Customer?$expand=UnifiedActivity,Customer_Measure&$filter=CustomerId in ('{CID}', '{CID}')

제한 사항

• Customer Insights API는 기본적으로 최대 100개의 개체를 반환합니다. 표준 페이지 매김 기술을 사용하여 100개 이상의 반환된 개체를 통해 구문 분석할 수 있습니다. 또는 데이터를 내보낼 수 있습니다.

• 다음 쿼리는 지원되지 않습니다.

  • 수집된 원본 테이블의 $filter. Customer Insights - Data가 생성하는 시스템 테이블에서만 $filter 쿼리를 실행할 수 있습니다.
  • $search 쿼리에서 $expand. 예: Customer?$expand=UnifiedActivity$top=10&$skip=0&$search="corey".
  • 특성의 하위 집합만 선택된 경우 $select에서 $expand. 예: Customer?$select=CustomerId,FullName&$expand=UnifiedActivity&$filter=CustomerId eq '{CID}'.
  • $expand는 특정 고객에 대한 브랜드 또는 관심도를 보강합니다. 예: Customer?$expand=BrandShareOfVoiceFromMicrosoft&$filter=CustomerId eq '518291faaa12f6d853c417835d40eb10'.
  • 대체 키를 통해 예측 모델 출력 테이블을 쿼리합니다. 예: OOBModelOutputTable?$filter=HotelCustomerID eq '{AK}'.