API Dataverse cho Customer Insights - Data
Nếu bạn đang sử dụng Customer Insights - Data API, chẳng hạn như truy vấn Hồ sơ khách hàng hoặc lấy tư cách thành viên phân khúc, chúng tôi khuyên bạn nên di chuyển API của mình sang Dataverse API. Hỗ trợ truy vấn siêu dữ liệu, chẳng hạn như nhận định nghĩa phân đoạn và quản lý quy trình công việc, sẽ sớm có trên Dataverse API.
Nếu bạn đang bắt đầu truy vấn dữ liệu bằng API, chúng tôi khuyên bạn nên sử dụng Dataverse API.
Quan trọng
Nên sử dụng Dataverse API để đọc dữ liệu (GET) chứ không phải để ghi dữ liệu (POST/PATCH/PUT) vì nó có thể gây ra sự cố với Customer Insights - Data quá trình xử lý.
Dataverse API có những ưu điểm sau:
Khả năng mở rộng để lọc và sắp xếp
Cải thiện quy mô và hiệu suất
Trải nghiệm API nhất quán trên Dynamics 365 và Power Platform ứng dụng
Các truy vấn mẫu
Để bắt đầu sử dụng Dataverse API, hãy tạo đăng ký ứng dụng trong Azure và yêu cầu cấp quyền cho Dataverse và cấp quyền cho Trình xem ứng dụng của bạn trên Customer Insights - Data.
Sửa đổi các mẫu truy vấn để chúng hoạt động trên các môi trường mục tiêu:
{serviceRoot}:
{Organization URI}/api/data/v9.2/trong đó {URI của tổ chức} là URI của Dataverse đối tượng thuê liên quan đến môi trường của bạn. Ví dụ:https://{mydvorg}.crm.dynamics.com{CID}: GUID của hồ sơ khách hàng thống nhất. Ví dụ:
ce759201f786d590bf2134bff576c369.{AlternateKey}: Mã định danh khóa chính của bản ghi khách hàng trong nguồn dữ liệu. Ví dụ:
CNTID_1002.{DSname}: Chuỗi có tên bảng của nguồn dữ liệu được đưa vào Customer Insights - Data. Ví dụ:
Website_contacts.{SegmentName}: Chuỗi có tên bảng đầu ra của một phân đoạn. Ví dụ:
Male_under_40.{CookieId}: Mã định danh cho mỗi khách truy cập trang web. Thông tin này được tạo tự động khi sử dụng tập lệnh theo dõi web. Ví dụ:
3f43317e-d1ef-4cd3-9917-2d3342111d1a.
Quý khách hàng
Các truy vấn mẫu cho bảng CustomerProfile và phân khúc thành viên.
| Loại truy vấn | Ví dụ: | Lưu ý |
|---|---|---|
| Nhận tất cả khách hàng | {serviceRoot}/msdynci_customerprofiles |
|
| Nhận khách hàng theo ID | {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID}' |
|
| Nhận khách hàng bằng khóa thay thế | {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK}' |
Các khóa thay thế vẫn tồn tại trong bảng khách hàng hợp nhất theo định dạng msdynci_DSname_TableName_PrimaryKeyColumnName |
| Nhận các thuộc tính đã chọn cho khách hàng | {serviceRoot}/msdynci_customerprofiles?$select=msdynci_fullname&$filter=msdynci_customerid eq '{CID}' |
|
| Lấy khách hàng theo ID (In) | {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID1}' or msdynci_customerid eq '{CID2}' |
|
| Nhận khách hàng bằng Khóa thay thế (In) | {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK1}' or {msdynci_alternate_column} eq '{AK2}' |
|
| Tìm kiếm khách hàng | {serviceRoot}/msdynci_customerprofiles?$filter=contains(msdynci_lastname,'string')&$top=10 |
|
| Lấy tất cả khách hàng là thành viên của một phân khúc | {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"')&$select=msdynci_customerid |
|
| Có được khách hàng nếu họ là thành viên của một phân khúc | {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"') and msdynci_customerid eq '{CID}'&$select=msdynci_customerid |
|
| Nhận tất cả các thành viên phân khúc của một khách hàng | {serviceRoot}/msdynci_segmentmemberships?$filter=msdynci_customerid eq '{CID}'&$select=msdynci_segments |
Cá nhân hóa Web
Các truy vấn mẫu để cá nhân hóa trang web của bạn dựa trên CookieId. Phản hồi trả về cả khách hàng đã biết và chưa biết.
| Loại truy vấn | Ví dụ: | Lưu ý |
|---|---|---|
| Nhận khách hàng bằng CookieId | {serviceRoot}/msdynci_personalizationprofiles(cookieid='{cookieId}') |
|
| Nhận khách hàng theo CookieId và bao gồm Phân đoạn, Biện pháp, Hoạt động | {serviceRoot}/msdynci_personalizationprofiles(cookieid='{cookieId}',include=['segmentmembership','measures','unifiedactivity']) |
|
| Nhận lượt xem trang gần đây (10 trang gần đây nhất) của khách hàng theo CookieId | {serviceRoot}/msdynci_pageviews(cookieid='{cookieId}',top=10) |
Có thể thay đổi để trả về tối đa 200 lượt xem trang gần đây |
| Nhận các lần nhấp vào trang gần đây (10 lần gần đây nhất) của khách hàng theo CookieId | {serviceRoot}/msdynci_pageclicks(cookieid='{cookieId}',top=10) |
Có thể thay đổi để trả về tối đa 200 lần nhấp vào trang gần đây |
Hoạt động thống nhất
Các truy vấn mẫu cho bảng UnifiedActivity .
| Loại truy vấn | Ví dụ: | Lưu ý |
|---|---|---|
| Nhận tất cả các hoạt động của khách hàng | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' |
|
| Nhận tất cả các hoạt động của khách hàng trong một khoảng thời gian | {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 |
|
| Nhận tất cả các hoạt động của một activityType của một khách hàng | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}' |
|
| Nhận tất cả các hoạt động của activityDisplayName của một khách hàng | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}' |
|
| Lấy tất cả các hoạt động của khách hàng và sắp xếp chúng | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc |
Ví dụ khác
Các truy vấn mẫu cho các bảng khác.
| Loại truy vấn | Ví dụ: | Lưu ý |
|---|---|---|
| Nhận tất cả các biện pháp của khách hàng | {serviceRoot}/msdynci_customermeasures?$filter=msdynci_customerid eq '{CID}' |
|
| Làm giàu thương hiệu của khách hàng | {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'BrandShareOfVoiceFromMicrosoft' |
|
| Làm giàu thêm lợi ích của khách hàng | {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'InterestShareOfVoiceFromMicrosoft' |
|
| Nhận kết quả mô hình AI của khách hàng | {serviceRoot}/msdynci_predictions?$filter=msdynci_customerid eq '{CID}' and msdynci_modelprovider eq 'ChurnModel' |
Các bước tiếp theo
Hầu hết các bảng đều có sẵn trong Customer Insights - Data . Dataverse Để biết thêm thông tin, hãy xem Bảng trong Dataverse.
Dataverse cung cấp hỗ trợ toàn diện cho việc thử nghiệm API của họ, ví dụ thông qua Insomnia. Để biết thêm thông tin, hãy xem Sử dụng Insomnia với Dataverse Web API.
Để biết thêm thông tin về Dataverse giới hạn dịch vụ API, hãy xem Microsoft Dataverse tổng quan về giới hạn API.
Để biết thêm thông tin về cách sử dụng Dataverse API, hãy xem Truy vấn dữ liệu bằng Web API.