Muistiinpano
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää kirjautua sisään tai vaihtaa hakemistoa.
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää vaihtaa hakemistoa.
Jos käytät Customer Insights - Data APIa, siirrä API:t Dataverse API:iin.
Jos olet uusi datakyselyissä API:n avulla, käytä Dataverse-rajapintoja.
Tärkeää
Käytä Dataverse-rajapintoja vain datan lukemiseen (GET). Älä käytä niitä datan (POST, PATCH tai PUT) kirjoittamiseen, koska se voi aiheuttaa ongelmia Customer Insights - Data -käsittelyssä.
Dataverse-rajapinnat tarjoavat seuraavat edut:
Laajennetut suodatus- ja lajitteluominaisuudet
Parempi skaalautuvuus ja suorituskyky
Yhdenmukainen ohjelmointirajapinnan kokemus Dynamics 365:ssä ja Power Platform -sovelluksissa
Esimerkkikyselyt
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. Esimerkiksi:https://{mydvorg}.crm.dynamics.com{CID}: yhtenäisen asiakastietueen GUID-tunnus. Esimerkiksi:
ce759201f786d590bf2134bff576c369.{AlternateKey}: asiakastietueen perusavaimen tunnus tietolähteessä. Esimerkiksi:
CNTID_1002.{DSname}: Merkkijono, jossa on sen tietolähteen taulukon nimi, joka käsitellään Customer Insights - Datassa. Esimerkiksi:
Website_contacts.{SegmentName}: Merkkijono, jolla on segmentin tulostaulukon nimi. Esimerkiksi:
Male_under_40.{CookieId}: Kunkin verkkosivuston kävijän tunniste, joka luodaan automaattisesti verkkoseurantakomentosarjaa käytettäessä. Esimerkiksi:
3f43317e-d1ef-4cd3-9917-2d3342111d1a.
Asiakas
CustomerProfile-taulukon ja segmentin jäsenyyksien esimerkkikyselyt.
| Kyselytyyppi | Esimerkki | Muistio |
|---|---|---|
| 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 |
Verkkopersonointi
Esimerkkikyselyt sivuston muokkaamiseksi CookieId-tunnuksen perusteella. Vastaus palauttaa sekä tunnetut että tuntemattomat asiakkaat. Voit käyttää Dataversen verkkoseurantaa ja personointia varten luotuihin taulukoihin.
| Kyselytyyppi | Esimerkki | Muistio |
|---|---|---|
| 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_p13nviews(cookieid='{cookieId}',top=10) |
Voit muuttaa tämän kyselyn palauttamaan jopa 200 viimeisintä sivun katselua. |
| Hae uusimmat (10 viimeistä) asiakkaan sivujen napsautusta CookieId-tunnuksen mukaan | {serviceRoot}/msdynci_p13nactions(cookieid='{cookieId}',top=10) |
Voit muuttaa tämän kyselyn palauttamaan jopa 200 viimeisintä sivun klikkausta. |
| 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
Esimerkkikyselyt UnifiedActivity-taululle , jos et käytä Web Personalizationia.
| Kyselytyyppi | Esimerkki | Muistio |
|---|---|---|
| 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.
| Kyselytyyppi | Esimerkki | Muistio |
|---|---|---|
| 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.