Делите путем

Dataverse API-ји за Customer Insights - Data

  • Чланак

Ако већ користите Customer Insights - Data АПИ-је, као што је упит корисничког профила или добијање сегмент чланства, препоручујемо да уместо тога мигрирате своје АПИ-је на Dataverse АПИ-је. Подршка за упите метаподатака, као што су дефиниција сегмент и управљање радним процесом, ускоро долази АПИ-јима Dataverse .

Ако започињете са упитима података помоћу АПИ-ја, препоручујемо да уместо тога користите Dataverse АПИ-је.

Важно

Препоручује се да користите Dataverse АПИ-је само за читање података (ГЕТ), а не за писање података (ПОСТ / ПАТЦХ / ПУТ) јер то може изазвати проблеме са Customer Insights - Data обрадом.

Dataverse АПИ -ји имају следеће предности:

  • Проширене могућности за филтрирање и сортирање

  • Побољшана скала и перформансе

  • Конзистентно АПИ искуство у Дyнамицс 365 и Power Platform апликацијама

Примери упита

Да бисте започели са коришћењем Dataverse АПИ-ја, креирајте регистрацију апликације у Азуре-у и затражите дозволе за Dataverse и доделите дозволе Customer Insights - Data за прегледач апликације.

Измените узорке упита да би они радили на циљним окружењима:

  • {serviceRoot}: {Organization URI}/api/data/v9.2/ где је УРИ { организације УРИ станара повезаног } са Dataverse вашим окружењем. На пример: https://{mydvorg}.crm.dynamics.com

  • {CID}: ГУИД јединственог записа о клијентима. На пример: ce759201f786d590bf2134bff576c369.

  • {AlternateKey}: Идентификатор примарног кључа записа клијента у < ДИЦТ__извор података > дата соурце. На пример: CNTID_1002.

  • {DSname}: Стринг са именом табеле < ДИЦТ__извор података > дата соурце који се уноси Customer Insights - Data. На пример: Website_contacts.

  • {SegmentName}: Стринг са именом излазне табеле сегмент. На пример: Male_under_40.

  • {CookieId}: Идентификатор за сваког посетиоца веб сајта. Ово се аутоматски генерише када се користи скрипта за праћење веба. На пример: 3f43317e-d1ef-4cd3-9917-2d3342111d1a.

клијенту

Примери упита за табелу ЦустомерПрофиле и сегмент чланства.

Тип упита Пример Белешка
Набавите све купце {serviceRoot}/msdynci_customerprofiles
Набавите купца по ИД-у {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID}'
Набавите купца од < ДИЦТ__Алтернативни кључ > Алтернате Кеy {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK}' Алтернативни тастери остају у јединственој табели купаца у формату мсдyнци_ДСнаме_ТаблеНаме_ПримарyКеyЦолумнНаме
Набавите изабране атрибуте за купца {serviceRoot}/msdynci_customerprofiles?$select=msdynci_fullname&$filter=msdynci_customerid eq '{CID}'
Добијајте купце по ИД-овима (У) {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

Веб персонализација

Примери упита за персонализацију вашег веб сајта на основу ЦоокиеИд-а. одговор враћа и познате и непознате купце.

Тип упита Пример Белешка
Набавите клијента путем ЦоокиеИд {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}')
Набавите купца помоћу ЦоокиеИд-а и укључите сегменте, мере, активности {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}',include=['segmentmembership','measures','unifiedactivity'])
Набавите недавне (последње КСНУМКС) приказе страница клијента од стране ЦоокиеИд {serviceRoot}/msdynci_pageviews(cookieid='{cookieId}',top=10) Ово се може променити да се врати до 200 недавних приказа страница
Набавите недавне (последње КСНУМКС) кликове на страницу клијента од стране ЦоокиеИд {serviceRoot}/msdynci_pageclicks(cookieid='{cookieId}',top=10) Ово се може променити да се врати до 200 недавних кликова на страницу

Обједињена активност

Примери упита за табелу УнифиедАцтивити .

Тип упита Пример Белешка
Набавите све активности купца {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'
Набавите резултате АИ модела купца {serviceRoot}/msdynci_predictions?$filter=msdynci_customerid eq '{CID}' and msdynci_modelprovider eq 'ChurnModel'

Следећи кораци