Merk
Tilgang til denne siden krever autorisasjon. Du kan prøve å logge på eller endre kataloger.
Tilgang til denne siden krever autorisasjon. Du kan prøve å endre kataloger.
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
De fleste Customer Insights - Data-tabellene tilgjengelige i Dataverse. Hvis du vil ha mer informasjon, kan du se Tabeller i Dataverse.
Dataverse har omfattende støtte for testing av API-ene, for eksempel via Insomnia. Vil du vite mer, kan du se Bruk Insomnia med nett-API for Dataverse.
Hvis du vil ha mer informasjon om tjenestegrenser for Dataverse-API, kan du se Oversikt over Microsoft Dataverse-API-grenser.
Hvis du vil ha mer informasjon om hvordan du bruker Dataverse-API-er, kan du se Spør data ved hjelp av nett-API-en.