Jagamisviis:

Dataverse’i API-d Customer Insights - Data jaoks

  • Artikkel

Kui kasutate juba Customer Insights - Data API-sid, näiteks esitate päringuid kliendiprofiilile või saate segment liikmesust, soovitame API-d Dataverse selle asemel API-desse üle viia. Metaandmete päringute tugi, nagu segment definitsiooni hankimine ja töövoohaldus, jõuab peagi API-desse Dataverse .

Kui alustate API-de abil andmete küsimist, soovitame selle asemel kasutada Dataverse API-sid.

Oluline

API-sid on soovitatav kasutada Dataverse ainult andmete lugemiseks (GET) ja mitte andmete kirjutamiseks (POST/PATCH/PUT), kuna see võib põhjustada töötlemisega Customer Insights - Data seotud probleeme.

Dataverse API-del on järgmised eelised:

  • Laiendatud võimalused filtreerimiseks ja sortimiseks

  • Täiustatud ulatus ja jõudlus

  • Järjepidev API kasutuskogemus kõigis Dynamics 365 ja Power Platform rakendustes

Näidispäringud

API-de kasutamise Dataverse alustamiseks looge Azure’is rakenduse registreerimine ning taotlege rakenduse vaatajale õigusi ja Dataverse andke neile õigused . Customer Insights - Data

Muutke päringunäidiseid, et need töötaksid sihtkeskkondades.

  • {serviceRoot}: {Organization URI}/api/data/v9.2/ kus {organisatsiooni URI} on teie keskkonnaga seotud rentniku URI Dataverse . Näiteks: https://{mydvorg}.crm.dynamics.com

  • {CID}: ühtse kliendikirje GUID. Näiteks: ce759201f786d590bf2134bff576c369.

  • {AlternateKey}: andmeallikas kliendikirje primaarvõtme identifikaator. Näiteks: CNTID_1002.

  • {DSname}: String allaneelatava Customer Insights - Data andmeallikas tabelinimega. Näiteks: Website_contacts.

  • {SegmentName}: string segment väljundtabeli nimega. Näiteks: Male_under_40.

  • {CookieId}: Iga veebisaidi külastaja identifikaator. See luuakse automaatselt veebijälgimisskripti kasutamisel. Näiteks: 3f43317e-d1ef-4cd3-9917-2d3342111d1a.

klient

Kliendiprofiili tabeli näidispäringud ja segment liikmesused.

Päringutüüp Näide Märkus.
Hankige kõik kliendid {serviceRoot}/msdynci_customerprofiles
Kliendi hankimine ID järgi {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID}'
Hankige klient alternatiivvõti järgi {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK}' Alternatiivvõtmed jäävad ühtses klienditabelis püsima vormingus msdynci_DSname_TableName_PrimaryKeyColumnName
Kliendi jaoks valitud atribuutide hankimine {serviceRoot}/msdynci_customerprofiles?$select=msdynci_fullname&$filter=msdynci_customerid eq '{CID}'
Klientide hankimine ID-de (In) järgi {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID1}' or msdynci_customerid eq '{CID2}'
Hankige kliente alternatiivvõtmete (in) abil {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK1}' or {msdynci_alternate_column} eq '{AK2}'
Otsige kliente {serviceRoot}/msdynci_customerprofiles?$filter=contains(msdynci_lastname,'string')&$top=10
Hankige kõik kliendid, kes on segment liikmed {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"')&$select=msdynci_customerid
Hankige klient, kui ta on segment liige {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"') and msdynci_customerid eq '{CID}'&$select=msdynci_customerid
Hankige kõik kliendi segment liikmesused {serviceRoot}/msdynci_segmentmemberships?$filter=msdynci_customerid eq '{CID}'&$select=msdynci_segments

Veebi isikupärastamine

Näidispäringud teie veebisaidi isikupärastamiseks CookieID põhjal. Vastus tagastab nii tuntud kui ka tundmatud kliendid.

Päringutüüp Näide Märkus.
Hankige klient CookieID abil {serviceRoot}/msdynci_personalizationprofiles(cookieid='{cookieId}')
Hankige klient CookieID abil ja lisage segmendid, mõõdud, tegevused {serviceRoot}/msdynci_personalizationprofiles(cookieid='{cookieId}',include=['segmentmembership','measures','unifiedactivity'])
Kliendi hiljutiste (viimase 10) lehevaatamiste hankimine CookieID poolt {serviceRoot}/msdynci_pageviews(cookieid='{cookieId}',top=10) Seda saab muuta, et tagastada kuni 200 hiljutist lehevaatamist
Kliendi hiljutiste (viimased 10) leheklikkide hankimine CookieID poolt {serviceRoot}/msdynci_pageclicks(cookieid='{cookieId}',top=10) Seda saab muuta, et tagastada kuni 200 hiljutist leheklikki

Ühtne tegevus

Tabeli UnifiedActivity näidispäringud .

Päringutüüp Näide Märkus.
Hankige kõik kliendi tegevused {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}'
Hankige kõik kliendi tegevused teatud aja jooksul {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
Hankige kõik tegevuse tegevusedKliendi tüüp {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}'
Hankige kõik tegevusega seotud tegevusedKliendi Kuvanimi {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}'
Hankige kõik kliendi tegevused ja sorteerige need {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc

Muud näited

Näidispäringud muude tabelite kohta.

Päringutüüp Näide Märkus.
Hankige kõik kliendi mõõdud {serviceRoot}/msdynci_customermeasures?$filter=msdynci_customerid eq '{CID}'
Hankige kliendi rikastatud kaubamärke {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'BrandShareOfVoiceFromMicrosoft'
Saage kliendi rikastatud huvid {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'InterestShareOfVoiceFromMicrosoft'
Kliendi AI-mudeli tulemuste hankimine {serviceRoot}/msdynci_predictions?$filter=msdynci_customerid eq '{CID}' and msdynci_modelprovider eq 'ChurnModel'

Järgmised toimingud