Customer Insights - Data:n Dataverse-ohjelmointirajapinnat

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