Dataverse-ohjelmointirajapinnat Customer Insights - Data ‑sovellukselle
Jos Customer Insights - Datan ohjelmointirajapinnat ovat jo käytössä, kuten asiakasprofiilikysely tai segmentin jäsenyyksien hankinta, on suositeltavaa siirtää ohjelmointirajapinnat sen sijaan Dataversen ohjelmointirajapintoihin. Metatietojen kyselyjen, kuten segmenttien määrityksen ja työnkulun hallinnan, tuki on tulossa pian Dataversen ohjelmointirajapinnoille.
Jos olet aloittamassa tietojen kyselyä ohjelmointirajapintojen avulla, suosittelemme Dataversen ohjelmointirajapintoja sen sijaan.
Tärkeää
Dataversen ohjelmointirajapintoja kannattaa käyttää vain tietojen lukuun (GET) eikä tietojen kirjoittamiseen (POST/PATCH/PUT), koska se voi aiheuttaa ongelmia Customer Insights - Data -käsittelyssä.
Dataversen ohjelmointirajapintojen edut:
Laajennetut suodatus- ja lajitteluominaisuudet
Parempi skaalautuvuus ja suorituskyky
Yhdenmukainen ohjelmointirajapinnan kokemus Dynamics 365:ssä ja Power Platform -sovelluksissa
Näytekyselyt
Dataversen ohjelmointirajapintojen käytön aloittaminen edellyttää sovelluksen rekisteröinnin luontia Azuressa ja Dataversen oikeuksien pyytämistä sekä sovelluksen tarkasteluoikeuksien myöntämistä Customer Insights - Datassa.
Muokkaa kyselynäytteitä, jotta ne toimivat kohdeympäristöissä:
{serviceRoot}:
{Organization URI}/api/data/v9.2/, jossa {Organization URI} on ympäristöön liitetyn Dataverse-vuokraajan URI. Esimerkki:https://{mydvorg}.crm.dynamics.com{CID}: yhtenäisen asiakastietueen GUID-tunnus. Esimerkki:
ce759201f786d590bf2134bff576c369.{AlternateKey}: asiakastietueen perusavaimen tunnus tietolähteessä. Esimerkki:
CNTID_1002.{DSname}: Merkkijono, jossa on sen tietolähteen taulukon nimi, joka käsitellään Customer Insights - Datassa. Esimerkki:
Website_contacts.{SegmentName}: Merkkijono, jolla on segmentin tulostaulukon nimi. Esimerkki:
Male_under_40.{CookieId}: Kunkin sivuston vierailijan tunniste. Tämä luodaan automaattisesti, kun käytetään verkon seurantakomentosarjaa. Esimerkki:
3f43317e-d1ef-4cd3-9917-2d3342111d1a.
asiakas
CustomerProfile-taulukon ja segmentin jäsenyyksien esimerkkikyselyt.
| Kyselyn tyyppi | Esimerkki: | Huomautus |
|---|---|---|
| Nouda kaikki asiakkaat | {serviceRoot}/msdynci_customerprofiles |
|
| Asiakkaan noutaminen tunnuksen perusteella | {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID}' |
|
| Asiakkaan noutaminen vaihtoehtoisen avaimen perusteella | {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK}' |
Vaihtoehtoiset avaimet säilyvät yhtenäisessä asiakastaulukossa muodossa msdynci_DSname_TableName_PrimaryKeyColumnName |
| Asiakkaan valittujen määritteiden noutaminen | {serviceRoot}/msdynci_customerprofiles?$select=msdynci_fullname&$filter=msdynci_customerid eq '{CID}' |
|
| Asiakkaiden noutaminen tunnuksen perusteella (sisään) | {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID1}' or msdynci_customerid eq '{CID2}' |
|
| Asiakkaiden noutaminen vaihtoehtoisen avaimen perusteella (sisään) | {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK1}' or {msdynci_alternate_column} eq '{AK2}' |
|
| Hae asiakkaita | {serviceRoot}/msdynci_customerprofiles?$filter=contains(msdynci_lastname,'string')&$top=10 |
|
| Nouda kaikki asiakkaat, jotka ovat segmentin jäseniä | {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"')&$select=msdynci_customerid |
|
| Nouda asiakas, jos hän on segmentin jäsen | {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"') and msdynci_customerid eq '{CID}'&$select=msdynci_customerid |
|
| Asiakkaan kaikkien segmenttijäsenyyksien noutaminen | {serviceRoot}/msdynci_segmentmemberships?$filter=msdynci_customerid eq '{CID}'&$select=msdynci_segments |
Verkon mukauttaminen
Esimerkkikyselyt sivuston muokkaamiseksi CookieId-tunnuksen perusteella. Vastaus palauttaa sekä tunnetut että tuntemattomat asiakkaat.
| Kyselyn tyyppi | Esimerkki: | Muistiinpano |
|---|---|---|
| Hae asiakas CookieId-tunnuksen mukaan | {serviceRoot}/msdynci_personalizationprofiles(cookieid='{cookieId}') |
|
| Hae asiakas CookieId-tunnuksen mukaan, ja sisällytä segmentit, mittaustulokset, aktiviteetit | {serviceRoot}/msdynci_personalizationprofiles(cookieid='{cookieId}',include=['segmentmembership','measures','unifiedactivity']) |
|
| Hae uusimmat (10 viimeistä) asiakkaan sivujen näyttökertaa CookieId-tunnuksen mukaan | {serviceRoot}/msdynci_pageviews(cookieid='{cookieId}',top=10) |
Tämän voi muuttaa palauttamaan enintään 200 uusinta sivujen näyttökertaa |
| Hae uusimmat (10 viimeistä) asiakkaan sivujen napsautusta CookieId-tunnuksen mukaan | {serviceRoot}/msdynci_pageclicks(cookieid='{cookieId}',top=10) |
Tämän voi muuttaa palauttamaan enintään 200 uusinta sivujen napsautusta |
Yhdistetty aktiviteetti
UnifiedActivity-taulukon näytekyselyt:
| Kyselyn tyyppi | Esimerkki: | Huomautus |
|---|---|---|
| Asiakkaan kaikkien aktiviteettien noutaminen | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' |
|
| Asiakkaan kaikkien aktiviteettien noutaminen tietyn ajanjakson aikana | {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 |
|
| Asiakkaan activityType-kohteen kaikkien aktiviteettien noutaminen | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}' |
|
| Asiakkaan activityDisplayName-kohteen kaikkien aktiviteettien noutaminen | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}' |
|
| Nouda kaikki asiakkaan aktiviteetit ja lajittele ne | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc |
Lisää esimerkkejä
Muiden taulukoiden näytekyselyt.
| Kyselyn tyyppi | Esimerkki: | Huomautus |
|---|---|---|
| Asiakkaan kaikkien toimenpiteiden noutaminen | {serviceRoot}/msdynci_customermeasures?$filter=msdynci_customerid eq '{CID}' |
|
| Hanki asiakkaan rikastetut tuotemerkit | {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'BrandShareOfVoiceFromMicrosoft' |
|
| Hanki asiakkaan rikastetut kiinnostuksen kohteet | {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'InterestShareOfVoiceFromMicrosoft' |
|
| Hanki asiakkaan tekoälymallin tulokset | {serviceRoot}/msdynci_predictions?$filter=msdynci_customerid eq '{CID}' and msdynci_modelprovider eq 'ChurnModel' |
Seuraavat vaiheet
Useimmat Customer Insights - Data -taulukot ovat käytettävissä Dataversessa. Lisätietoja on kohdassa Dataversen taulukot.
Dataverse tarjoaa kattavan tuen ohjelmointirajapintojen testaamiseen esimerkiksi Postmanin kautta. Lisätietoja on kohdassa Postman-ympäristön määrittäminen.
Lisätietoja Dataversen ohjelmointirajapinnan palvelurajoituksista on ohjeaiheessa Microsoft Dataversen ohjelmointirajapinnan rajoitusten yleiskuvaus.
Lisätietoja Dataversen ohjelmointirajapintojen käyttämisestä on ohjeaiheessa Tietojen kyseleminen verkko-ohjelmointirajapinnan avulla.