Kopīgot, izmantojot

Dataverse API pakalpojumam Customer Insights - Data

  • Raksts

Ja jau izmantojat Customer Insights - Data API, piemēram, vaicājat klienta profilam vai saņemat segments dalību, ieteicams tā vietā migrēt API uz Dataverse API. Drīzumā Dataverse API būs pieejams atbalsts metadatu vaicājumiem, piemēram, segments definīcijas iegūšanai un darbplūsmas pārvaldībai.

Ja sākat datu vaicājumus, izmantojot API, ieteicams tā vietā izmantot Dataverse API.

Svarīgi

API ieteicams izmantot Dataverse tikai datu lasīšanai (GET), nevis datu rakstīšanai (POST/PATCH/PUT), jo tas var radīt problēmas ar Customer Insights - Data apstrādi.

Dataverse API ir šādas priekšrocības:

  • Paplašinātas filtrēšanas un kārtošanas iespējas

  • Uzlabots mērogs un veiktspēja

  • Konsekventa API pieredze Dynamics 365 un Power Platform lietotnēs

Vaicājumu paraugi

Lai sāktu darbu ar API, izveidojiet lietojumprogrammas reģistrāciju pakalpojumā Azure un pieprasiet atļaujas un Dataverse piešķiriet programmai Viewer atļaujas Dataverse . Customer Insights - Data

Modificējiet vaicājumu paraugus, lai tie darbotos mērķa vidēs:

  • {serviceRoot}: {Organization URI}/api/data/v9.2/ kur {organizācijas URI} ir nomnieka Dataverse URI, kas saistīts ar jūsu vidi. Piemēram: https://{mydvorg}.crm.dynamics.com

  • {CID}: vienota klienta ieraksta GUID. Piemēram: ce759201f786d590bf2134bff576c369.

  • {AlternateKey}: klienta ieraksta primārās atslēgas identifikators datu avots. Piemēram: CNTID_1002.

  • {DSname}: virkne ar tabulas nosaukumu datu avots, kas tiek uzņemta Customer Insights - Data. Piemēram: Website_contacts.

  • {SegmentName}: virkne ar izvades tabulas nosaukumu segments. Piemēram: Male_under_40.

  • {CookieId}: katra tīmekļa vietnes apmeklētāja identifikators. Tas tiek automātiski ģenerēts, izmantojot tīmekļa izsekošanas skriptu. Piemēram: 3f43317e-d1ef-4cd3-9917-2d3342111d1a.

klient

Vaicājumu paraugi tabulai CustomerProfile un dalība segments.

Vaicājuma tips Piemērs Piezīmes
Iegūstiet visus klientus {serviceRoot}/msdynci_customerprofiles
Klienta iegūšana pēc ID {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID}'
Iegūstiet klientu, izmantojot alternatīvā atslēga {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK}' Vienotajā klientu tabulā pastāv alternatīvās atslēgas formātā msdynci_DSname_TableName_PrimaryKeyColumnName
Atlasīto atribūtu iegūšana klientam {serviceRoot}/msdynci_customerprofiles?$select=msdynci_fullname&$filter=msdynci_customerid eq '{CID}'
Klientu piesaistīšana pēc ID (In) {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID1}' or msdynci_customerid eq '{CID2}'
Piesaistiet klientus, izmantojot alternatīvos taustiņus (In) {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK1}' or {msdynci_alternate_column} eq '{AK2}'
Meklēt klientus {serviceRoot}/msdynci_customerprofiles?$filter=contains(msdynci_lastname,'string')&$top=10
Iegūstiet visus klientus, kas ir segments dalībnieki {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"')&$select=msdynci_customerid
Klienta iegūšana, ja viņš ir segments dalībnieks {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"') and msdynci_customerid eq '{CID}'&$select=msdynci_customerid
Visu segments klienta dalības iegūšana {serviceRoot}/msdynci_segmentmemberships?$filter=msdynci_customerid eq '{CID}'&$select=msdynci_segments

Tīmekļa personalizēšana

Vaicājumu paraugi, lai personalizētu jūsu vietni , pamatojoties uz CookieId. Atbilde atgriež gan zināmus, gan nezināmus klientus.

Vaicājuma tips Piemērs Piezīmes
Iegūstiet klientu, izmantojot CookieId {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}')
Iegūstiet klientu, izmantojot CookieId, un iekļaujiet segmentus, pasākumus, aktivitātes {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}',include=['segmentmembership','measures','unifiedactivity'])
Iegūstiet nesenus (pēdējos 10) klienta lapu skatījumus, izmantojot CookieId {serviceRoot}/msdynci_pageviews(cookieid='{cookieId}',top=10) To var mainīt, lai atgrieztu līdz pat 200 neseniem lapu skatījumiem
Saņemiet nesenos (pēdējos 10) klienta klikšķus uz lapas, izmantojot CookieId {serviceRoot}/msdynci_pageclicks(cookieid='{cookieId}',top=10) To var mainīt, lai atgrieztu līdz pat 200 pēdējiem lapu klikšķiem

Vienota darbība

Vaicājumu paraugi tabulai UnifiedActivity .

Vaicājuma tips Piemērs Piezīmes
Iegūstiet visas klienta darbības {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}'
Iegūstiet visas klienta darbības noteiktā laika periodā {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
Visu aktivitātes darbību iegūšanaKlienta veids {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}'
Visu darbību iegūšanaRādītājklienta vārds {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}'
Iegūstiet visas klienta darbības un kārtojiet tās {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc

Citi piemēri

Vaicājumu paraugi citām tabulām.

Vaicājuma tips Piemērs Piezīmes
Iegūstiet visus klienta mērus {serviceRoot}/msdynci_customermeasures?$filter=msdynci_customerid eq '{CID}'
Iegūstiet bagātinātus klienta zīmolus {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'BrandShareOfVoiceFromMicrosoft'
Iegūstiet bagātinātas klienta intereses {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'InterestShareOfVoiceFromMicrosoft'
Klienta AI modeļa rezultātu iegūšana {serviceRoot}/msdynci_predictions?$filter=msdynci_customerid eq '{CID}' and msdynci_modelprovider eq 'ChurnModel'

Nākamās darbības