Del via

Dataverse-API-er for Customer Insights - Data

  • Artikkel

Hvis du allerede bruker API-er for Customer Insights - Data, for eksempel spørre en kundeprofil eller få segmentmedlemskap, anbefaler vi at du overfører API-ene til Dataverse-API-er i stedet. Støtte for spørring av metadata, for eksempel henting av segmentdefinisjon og arbeidsflytbehandling, kommer snart til Dataverse-API-er.

Hvis du kommer i gang med å spørre etter data ved hjelp av API-er, anbefaler vi at du bruker Dataverse-API-er i stedet.

Viktig

Vi anbefaler at du bruker Dataverse-API-er bare til å lese data (GET) og ikke til å skrive data (POST/PATCH/PUT) siden dette kan føre til problemer med Customer Insights - Data-behandling.

Dataverse-API-er har 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. 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å webområdet. Dette genereres automatisk når websporingsskriptet brukes. Eksempel: 3f43317e-d1ef-4cd3-9917-2d3342111d1a.

Kunde

Eksempelspørringer for tabellen CustomerProfile og segmentmedlemskap.

Spørringstype Eksempel Merk
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

Nettilpasning

Eksempelspørringer for å tilpasse webområdet basert på CookieId. Svaret returnerer både kjente og ukjente kunder.

Spørringstype Eksempel Merk
Få en kunde ved hjelp av CookieId {serviceRoot}/msdynci_personalizationprofiles(cookieid='{cookieId}')
Hent en kunde etter CookieId og inkluder segmenter, mål, aktiviteter {serviceRoot}/msdynci_personalizationprofiles(cookieid='{cookieId}',include=['segmentmembership','measures','unifiedactivity'])
Få nylige (siste 10) sidevisninger for en kunde etter CookieId {serviceRoot}/msdynci_pageviews(cookieid='{cookieId}',top=10) Dette kan endres til å returnere opptil 200 nylige sidevisninger
Få nylige (siste 10) sideklikk for en kunde etter CookieId {serviceRoot}/msdynci_pageclicks(cookieid='{cookieId}',top=10) Dette kan endres til å returnere opptil 200 nylige sideklikk

Enhetlig aktivitet

Eksempelspørringer for UnifiedActivity-tabellen:

Spørringstype Eksempel Merk
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 2017-01-01T00:00:00Z and msdynci_activitytime lt 2017-01-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 Merk
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