Dataverse API-er for Customer Insights - Data

Hvis du bruker Customer Insights - Data API-er, migrer API-ene dine til Dataverse API-er.

Hvis du er ny på å søke data ved hjelp av API-er, bruk Dataverse-API-er.

Viktig!

Bruk Dataverse-API-er kun for å lese data (GET). Ikke bruk dem til å skrive data (POST, PATCH eller PUT) fordi det kan skape problemer med Customer Insights - Data processing.

Dataverse API-er gir følgende fordeler:

  • Utvidede funksjoner for filtrering og sortering

  • Forbedret skalering og ytelse

  • Ensartet API-opplevelse på tvers av Dynamics 365- og Power Platform-apper

Eksempelspørringer

Du kan komme i gang med Dataverse-API-er ved å opprette en programregistrering i Azure og be om tillatelser for Dataverse og gi appen visningstillatelser på Customer Insights - Data.

Endre spørringseksemplene slik at de fungerer i målmiljøene:

  • {serviceRoot}: {Organization URI}/api/data/v9.2/ der {Organisasjons-URI} er URI for Dataverse-leieren som er tilknyttet miljøet. For eksempel: https://{mydvorg}.crm.dynamics.com

  • {CID}: GUID for en enhetlig kundeoppføring. Eksempel: ce759201f786d590bf2134bff576c369.

  • {AlternateKey}: Identifikator for primærnøkkelen for en kundeoppføring i en datakilde. Eksempel: CNTID_1002.

  • {DSname}: Streng med tabellnavnet for en datakilde som blir innhentet i Customer Insights - Data. Eksempel: Website_contacts.

  • {SegmentName}: Streng med utdatatabellnavnet for et segment. Eksempel: Male_under_40.

  • {CookieId}: Identifikator for hver besøkende på nettstedet, som genereres automatisk når du bruker websporingsskriptet. Eksempel: 3f43317e-d1ef-4cd3-9917-2d3342111d1a.

Kunde

Eksempelspørringer for tabellen CustomerProfile og segmentmedlemskap.

Spørringstype Eksempel Notat
Hent alle kunder {serviceRoot}/msdynci_customerprofiles
Hent en kunde etter ID {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID}'
Hent en kunde etter alternativ nøkkel {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK}' Alternative nøkler beholdes i tabellen over enhetlig kunde i formatet msdynci_DSname_TableName_PrimaryKeyColumnName
Hent valgte attributter for en kunde {serviceRoot}/msdynci_customerprofiles?$select=msdynci_fullname&$filter=msdynci_customerid eq '{CID}'
Hent kunder etter ID-er (In) {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID1}' or msdynci_customerid eq '{CID2}'
Hent kunder etter alternative nøkler (In) {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK1}' or {msdynci_alternate_column} eq '{AK2}'
Søke etter kunder {serviceRoot}/msdynci_customerprofiles?$filter=contains(msdynci_lastname,'string')&$top=10
Hent alle kunder som er medlemmer av et segment {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"')&$select=msdynci_customerid
Hent en kunde hvis vedkommende er medlem av et segment {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"') and msdynci_customerid eq '{CID}'&$select=msdynci_customerid
Hent alle segmentmedlemskaper for en kunde {serviceRoot}/msdynci_segmentmemberships?$filter=msdynci_customerid eq '{CID}'&$select=msdynci_segments

Webpersonalisering

Eksempelspørringer for å tilpasse webområdet basert på CookieId. Svaret returnerer både kjente og ukjente kunder. Du kan få tilgang til tabellene som er opprettet for websporing og personalisering i Dataverse.

Spørringstype Eksempel Notat
Få en kunde ved hjelp av CookieId {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}')
Hent en kunde etter CookieId og inkluder segmenter, mål, aktiviteter {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}',include=['segmentmembership','measures','unifiedactivity'])
Få nylige (siste 10) sidevisninger for en kunde etter CookieId {serviceRoot}/msdynci_p13nviews(cookieid='{cookieId}',top=10) Du kan endre denne spørringen for å returnere opptil 200 nylige sidevisninger.
Få nylige (siste 10) sideklikk for en kunde etter CookieId {serviceRoot}/msdynci_p13nactions(cookieid='{cookieId}',top=10) Du kan endre denne spørringen for å returnere opptil 200 nylige sideklikk.
Hent alle aktiviteter for en kunde {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}'
Hent alle aktiviteter for en kunde innen en tidsperiode {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
Hent alle aktiviteter for en activityType for en kunde {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}'
Hent alle aktiviteter for en activityDisplayName for en kunde {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}'
Hent alle aktiviteter for en kunde og sorter dem {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc

Enhetlig aktivitet

Eksempelforespørsler for UnifiedActivity-tabellen hvis du ikke bruker webpersonalisering.

Spørringstype Eksempel Notat
Hent alle aktiviteter for en kunde {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}'
Hent alle aktiviteter for en kunde innen en tidsperiode {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
Hent alle aktiviteter for en activityType for en kunde {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}'
Hent alle aktiviteter for en activityDisplayName for en kunde {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}'
Hent alle aktiviteter for en kunde og sorter dem {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc

Andre eksempler

Eksempelspørringer for andre tabeller.

Spørringstype Eksempel Notat
Hent alle målinger for en kunde {serviceRoot}/msdynci_customermeasures?$filter=msdynci_customerid eq '{CID}'
Hent supplerte varemerker for en kunde {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'BrandShareOfVoiceFromMicrosoft'
Hent supplerte interesser for en kunde {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'InterestShareOfVoiceFromMicrosoft'
Hent resultater fra modell for kunstig intelligens for en kunde {serviceRoot}/msdynci_predictions?$filter=msdynci_customerid eq '{CID}' and msdynci_modelprovider eq 'ChurnModel'

Neste trinn