Del via

Dataverse-API'er til Customer Insights - Data

  • Artikel

Hvis du allerede bruger Customer Insights - Data-API'er som f.eks. forespørge om en kundeprofil eller få segmentmedlemskaber, anbefales det, at du overfører API'erne til Dataverse API'er i stedet. Understøttelse af metadataforespørgsel, f.eks. definition af segment og arbejdsprocesstyring, kommer snart til Dataverse API'er.

Hvis du er i gang med at forespørge om data ved hjælp af API'er, anbefales det, at du i stedet bruger Dataverse API'er.

Vigtigt

Det anbefales, at du kun bruger Dataverse API'er til at læse data (GET) og ikke til at skrive data (POST/PATCH/PUT), da det kan give problemer i forbindelse med behandling af Customer Insights - Data.

Dataverse API'er har følgende fordele:

  • Udvidede funktioner til filtrering og sortering

  • Forbedret skala og ydeevne

  • Ensartet API-oplevelse på tværs af Dynamics 365 og Power Platform-apps

Eksempelforespørgsler

Du kan komme i gang med at bruge Dataverse API'er ved at oprette en programtilmelding i Azure og anmode om tilladelser til Dataverse og give dine app seertilladelser på Customer Insights - Data.

Du skal ændre forespørgselseksemplerne, så de fungerer i destinationsmiljøerne:

  • {serviceRoot}:, {Organization URI}/api/data/v9.2/ hvor {Organization URI} er URI'et for den Dataverse-lejer, der er knyttet til miljøet. Eksempel: https://{mydvorg}.crm.dynamics.com

  • {CID}: GUID for en ensartet kundepost. Eksempel: ce759201f786d590bf2134bff576c369.

  • {AlternateKey}: Id for den primære nøgle for en kundepost i en datakilde. Eksempel: CNTID_1002.

  • {DSname}: Streng med tabelnavnet på en datakilde, der bliver indtaget i Customer Insights - Data. Eksempel: Website_contacts.

  • {SegmentName}: Streng med outputtabelnavnet på et segment. Eksempel: Male_under_40.

  • {CookieId}: Id for hver enkelt besøgende på webstedet. Dette oprettes automatisk ved brug af websporingsscriptet. Eksempel: 3f43317e-d1ef-4cd3-9917-2d3342111d1a.

Kunde

Eksempelforespørgsler for tabellen CustomerProfile og medlemskaber af segmenter.

Forespørgselstype Eksempel Bemærk
Hent alle kunder {serviceRoot}/msdynci_customerprofiles
Hente en kunde efter id {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID}'
Få en kunde efter alternativ nøgle {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK}' Alternative nøgler bliver ved med at være i den ensartede kundetabel i det format, msdynci_DSname_TableName_PrimaryKeyColumnName
Hent udvalgte attributter for en kunde {serviceRoot}/msdynci_customerprofiles?$select=msdynci_fullname&$filter=msdynci_customerid eq '{CID}'
Hent kunder efter id'er (In) {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID1}' or msdynci_customerid eq '{CID2}'
Hent kunder efter alternative nøgleer (In) {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK1}' or {msdynci_alternate_column} eq '{AK2}'
Søge efter kunder {serviceRoot}/msdynci_customerprofiles?$filter=contains(msdynci_lastname,'string')&$top=10
Hent alle kunder, der er medlem af et segment {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"')&$select=msdynci_customerid
Få en kunde, hvis de er medlem af et segment {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"') and msdynci_customerid eq '{CID}'&$select=msdynci_customerid
Hent alle segment-medlemskaber for en kunde {serviceRoot}/msdynci_segmentmemberships?$filter=msdynci_customerid eq '{CID}'&$select=msdynci_segments

Web-personalisering

Eksempelforespørgsler om at tilpasse dit websted baseret på CookieId. Svaret returnerer både kendte og ukendte kunder.

Forespørgselstype Eksempel Bemærk
Få en kunde efter CookieId {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}')
Få en kunde efter CookieId, og inkluder segmenter, mål, aktiviteter {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}',include=['segmentmembership','measures','unifiedactivity'])
Få seneste (de seneste 10) sidevisninger af en kunde efter CookieId {serviceRoot}/msdynci_pageviews(cookieid='{cookieId}',top=10) Dette kan ændres for at returnere op til 200 seneste sidevisninger
Få seneste (de seneste 10) sideklik for en kunde efter CookieId {serviceRoot}/msdynci_pageclicks(cookieid='{cookieId}',top=10) Dette kan ændres for at returnere op til 200 seneste sideklik

Samlet aktivitet

Eksempelforespørgsler for tabellen UnifiedActivity:

Forespørgselstype Eksempel Bemærk
Hent alle aktiviteter for en kunde {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}'
Hent alle aktiviteter for en kunde inden for en tidsperiode {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
Hent alle aktiviteter for en aktivitetType 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

Andre eksempler

Eksempelforespørgsler for andre tabeller:

Forespørgselstype Eksempel Bemærk
Hent alle mål for en kunde {serviceRoot}/msdynci_customermeasures?$filter=msdynci_customerid eq '{CID}'
Hent berigede mærker for en kunde {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'BrandShareOfVoiceFromMicrosoft'
Hent berigede interesser for en kunde {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'InterestShareOfVoiceFromMicrosoft'
Få resultater af AI-model for en kunde {serviceRoot}/msdynci_predictions?$filter=msdynci_customerid eq '{CID}' and msdynci_modelprovider eq 'ChurnModel'

Næste trin