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 verkkosivuston kävijän tunniste, joka luodaan automaattisesti verkkoseurantakomentosarjaa käytettäessä. 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. Verkkoseurantaa ja mukauttamista varten luodut taulukot ovat käytettävissä Dataversessä.
| Kyselyn tyyppi | Esimerkki: | Muistiinpano |
|---|---|---|
| Hae asiakas CookieId-tunnuksen mukaan | {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}') |
|
| Hae asiakas CookieId-tunnuksen mukaan, ja sisällytä segmentit, mittaustulokset, aktiviteetit | {serviceRoot}/msdynci_p13nprofile(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ätä kyselyä voidaan muuttaa palauttamaan enintään 200 viimeisintä sivun näyttökertaa |
| Hae uusimmat (10 viimeistä) asiakkaan sivujen napsautusta CookieId-tunnuksen mukaan | {serviceRoot}/msdynci_pageclicks(cookieid='{cookieId}',top=10) |
Tätä kyselyä voidaan muuttaa palauttamaan enintään 200 viimeisintä sivun napsautusta |
| Asiakkaan kaikkien aktiviteettien noutaminen | {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' |
|
| Asiakkaan kaikkien aktiviteettien noutaminen tietyn ajanjakson aikana | {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytime gt 2024-01-01T00:00:00Z and msdynci_activitytime lt 2024-06-01T00:00:00Z |
|
| Asiakkaan activityType-kohteen kaikkien aktiviteettien noutaminen | {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}' |
|
| Asiakkaan activityDisplayName-kohteen kaikkien aktiviteettien noutaminen | {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}' |
|
| Nouda kaikki asiakkaan aktiviteetit ja lajittele ne | {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc |
Yhdistetty aktiviteetti
UnifiedActivity-taulukon mallikyselyt, jossa verkon mukauttaminen ei ole käytössä.
| Kyselyn tyyppi | Esimerkki: | Muistiinpano |
|---|---|---|
| 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 2024-01-01T00:00:00Z and msdynci_activitytime lt 2024-06-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 laajaa tukea API-rajapintojen testaamiseen esimerkiksi Insomnian kautta. Lisätietoja on aiheessa Insomnian käyttäminen Dataverse-verkko-ohjelmointirajapinnan kanssa.
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.