Поділитися через

API Dataverse для Customer Insights - Data

  • Стаття

Якщо ви вже користуєтеся Customer Insights - Data API, наприклад надсилаєте запит у профіль клієнта або отримуєте членство в сегментах, радимо перенести API на Dataverse API. Незабаром в API з’явиться Dataverse підтримка запиту метаданих, як-от визначення сегментів та керування робочим процесом.

Якщо ви тільки починаєте запитувати дані за допомогою API, радимо використовувати Dataverse API.

Важливо

Рекомендується використовувати Dataverse API лише для зчитування даних (GET) і не для запису даних (POST/PATCH/PUT), оскільки це може спричинити проблеми з Customer Insights - Data обробкою.

Dataverse API мають такі переваги:

  • Розширені можливості для фільтрації та сортування

  • Покращений масштаб і продуктивність

  • Узгоджена робота з API для Dynamics 365 і Power Platform додатків

Приклади запитів

Щоб розпочати використання API, Dataverse зареєструйте програму в Azure і запитайте дозволи та Dataverse надайте дозвіл на використання програми Viewer. Customer Insights - Data

Змініть зразки запитів, щоб вони працювали в цільових середовищах:

  • {serviceRoot}: {Organization URI}/api/data/v9.2/ де {URI} організації - це URI клієнта, пов’язаного Dataverse з вашим середовищем. Наприклад: 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}'
Отримання клієнтів за ідентифікаторами (In) {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID1}' or msdynci_customerid eq '{CID2}'
Отримуйте клієнтів за допомогою альтернативних ключів (вхід) {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_p13nprofile(cookieid='{cookieId}')
Отримайте клієнта за допомогою CookieId і включіть сегменти, показники, дії {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}',include=['segmentmembership','measures','unifiedactivity'])
Отримання останніх (останніх 10) переглядів сторінок клієнта за допомогою CookieId {serviceRoot}/msdynci_pageviews(cookieid='{cookieId}',top=10) Це можна змінити, щоб повернути до 200 нещодавніх переглядів сторінок
Отримання останніх (останніх 10) кліків на сторінку клієнта за допомогою CookieId {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
Отримати всі активності діяльностіТип клієнта {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}'
Отримати всі активності діяльностіВідобразитиІм’я клієнта {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'

Наступні кроки