Dela via

Dataverse API:er för Customer Insights - Data

  • Artikel

Om du redan använder API:er för Customer Insights - Data för att fråga efter data, till exempel fråga efter kundprofil eller få segmentmedlemskap, rekommenderar vi att du i stället migrerar dina API:er till Dataverse API:er istället. Stöd för att fråga på metadata, till exempel få segmentdefinition och arbetsflödeshantering, kommer snart till Dataverse API:er.

Om du kommer igång med att fråga efter data med API:er rekommenderar vi att du använder Dataverse API:er i stället.

Viktigt!

Vi rekommenderar att du endast använder Dataverse API:er för att läsa data (GET) och inte skriva data (POST/PATCH/PUT) eftersom det kan orsaka problem med Customer Insights - Data som bearbetar.

Dataverse API:er har följande fördelar:

  • Utökade funktioner för filtrering och sortering

  • Förbättrad skala och prestanda

  • Enhetlig API-upplevelse i Dynamics 365 och Power Platform-appar

Exempelfrågor

För att komma igång med Dataverse API:er, skapa en programregistrering i Azure och begära behörigheter för Dataverse och ge din app visningsprogrammet på Customer Insights - Data.

Ändra frågeexempel så att de fungerar i målmiljöerna:

  • {serviceRoot}: {Organization URI}/api/data/v9.2/ där {organisations- URI} är URI för den Dataverse klientorganisationen för miljön. Till exempel: https://{mydvorg}.crm.dynamics.com

  • {CID}: GUID för en enhetlig kundpost. Exempel: ce759201f786d590bf2134bff576c369.

  • {AlternateKey}: Identifierare för den primära nyckeln för en kundpost i en datakälla. Exempel: CNTID_1002.

  • {DSname}: Sträng med tabellnamnet för en datakälla som förs in i Customer Insights - Data. Exempel: Website_contacts.

  • {SegmentName}: Sträng med utdatatabellnamnet för ett segment. Exempel: Male_under_40.

  • {CookieId}: Identifierare för varje webbplatsbesökare, som genereras automatiskt när du använder webbspårningsskriptet. Exempel: 3f43317e-d1ef-4cd3-9917-2d3342111d1a.

Kunder

Exempelfrågor för tabellen CustomerProfile och segmentmedlemskap.

Frågetyp Exempel Kommentar
Hämta alla kunder {serviceRoot}/msdynci_customerprofiles
Hämta en kund efter ID {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID}'
Hämta en kund efter alternativ nyckel {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK}' Alternativa nycklar bevaras i den enhetliga kundtabellen i msdynci_DSname_TableName_PrimaryKeyColumnName
Få utvalda attribut för en kund {serviceRoot}/msdynci_customerprofiles?$select=msdynci_fullname&$filter=msdynci_customerid eq '{CID}'
Hämta kund efter ID (In) {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID1}' or msdynci_customerid eq '{CID2}'
Hämta kunder efter alternativ nyckel (In) {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK1}' or {msdynci_alternate_column} eq '{AK2}'
Sök efter kunder {serviceRoot}/msdynci_customerprofiles?$filter=contains(msdynci_lastname,'string')&$top=10
Skaffa alla kunder som är medlemmar i ett segment {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"')&$select=msdynci_customerid
Hämta en kund om de är medlem i ett segment {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"') and msdynci_customerid eq '{CID}'&$select=msdynci_customerid
Få alla segmentmedlemskap för en kund {serviceRoot}/msdynci_segmentmemberships?$filter=msdynci_customerid eq '{CID}'&$select=msdynci_segments

Personanpassning för webb

Exempelfrågor för att anpassa din webbplats baserat på CookieId. Svaret returnerar både kända och okända kunder. Tabellerna som skapats för webbspårning och personanpassning finns i Dataverse.

Frågetyp Exempel Obs
Hämta en kund efter CookieId {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}')
Skaffa en kund med CookieId och inkludera segment, mått, aktiviteter {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}',include=['segmentmembership','measures','unifiedactivity'])
Hämta senaste (senaste 10) sidvyerna för en kund med CookieId {serviceRoot}/msdynci_pageviews(cookieid='{cookieId}',top=10) Den här frågan kan ändras så att den returnerar upp till 200 senaste sidvisningar
Hämta senaste (senaste 10) sidklicken för en kund med CookieId {serviceRoot}/msdynci_pageclicks(cookieid='{cookieId}',top=10) Den här frågan kan ändras så att den returnerar upp till 200 senaste sidklickningar

Enhetlig aktivitet

Exempelfrågor för tabellen UnifiedActivity:

Frågetyp Exempel Kommentar
Få alla aktiviteter hos en kund {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}'
Få alla aktiviteter för en kund inom en tidsperiod {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytime gt 2017-01-01T00:00:00Z and msdynci_activitytime lt 2017-01-01T00:00:00Z
Hämta alla aktiviteter för en activityType för en kund {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}'
Hämta alla aktiviteter för en activityDisplayName för en kund {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}'
Få alla aktiviteter hos en kund och sortera dem {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc

Andra exempel

Exempelfrågor för andra tabeller.

Frågetyp Exempel Kommentar
Få alla mått på en kund {serviceRoot}/msdynci_customermeasures?$filter=msdynci_customerid eq '{CID}'
Få berikade varumärken från en kund {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'BrandShareOfVoiceFromMicrosoft'
Få berikade intressen från en kund {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'InterestShareOfVoiceFromMicrosoft'
Få AI-modellresultat från en kund {serviceRoot}/msdynci_predictions?$filter=msdynci_customerid eq '{CID}' and msdynci_modelprovider eq 'ChurnModel'

Nästa steg