Delen via

Dataverse-API's voor Customer Insights - Data

  • Artikel

Als u al API's van Customer Insights - Data gebruikt om gegevens op te vragen, zoals het opvragen van een klantprofiel of het verkrijgen van segmentlidmaatschappen, raden we u aan uw API's te migreren naar Dataverse-API's. Ondersteuning voor het opvragen van metagegevens, zoals segmentdefinitie en workflowbeheer, komt binnenkort beschikbaar in Dataverse API's.

Als u aan de slag gaat met het opvragen van gegevens met behulp van API's, raden we u aan in plaats daarvan Dataverse API's te gebruiken.

Belangrijk

Het wordt aanbevolen Dataverse-API's alleen te gebruiken om gegevens te lezen (GET) en niet om gegevens te schrijven (POST/PATCH/PUT), aangezien dit problemen kan veroorzaken bij de verwerking van Customer Insights - Data.

Dataverse-API's hebben de volgende voordelen:

  • Uitgebreide mogelijkheden voor filteren en sorteren

  • Verbeterde schalingsmogelijkheden en prestaties

  • Consistente API-ervaring in Dynamics 365- en Power Platform-apps

Voorbeeldquery's

Als u aan de slag wilt gaan met Dataverse-API's, maakt u een toepassingsregistratie in Azure en vraagt u toestemming voor Dataverse en kent u viewermachtigingen voor uw app toe in Customer Insights - Data.

Wijzig de queryvoorbeelden om ze te laten werken in de doelomgevingen:

  • {serviceRoot}: {Organization URI}/api/data/v9.2/ waarbij {Organisatie-URI} de URI is van de Dataverse-tenant die aan uw omgeving is gekoppeld. Bijvoorbeeld: https://{mydvorg}.crm.dynamics.com

  • {CID}: GUID van een geharmoniseerde klantenrecord. Voorbeeld: ce759201f786d590bf2134bff576c369.

  • {AlternateKey}: id van de primaire sleutel van een klantenrecord in een gegevensbron. Voorbeeld: CNTID_1002.

  • {DSname}: tekenreeks met de tabelnaam van een gegevensbron die wordt opgenomen in Customer Insights - Data. Voorbeeld: Website_contacts.

  • {SegmentName}: tekenreeks met de uitvoertabelnaam van een segment. Voorbeeld: Male_under_40.

  • {CookieId}Identificatie voor elke websitebezoeker, die automatisch wordt gegenereerd bij gebruik van het webtraceringscript. Voorbeeld: 3f43317e-d1ef-4cd3-9917-2d3342111d1a.

klant

Voorbeeldquery's voor de tabel CustomerProfile en segmentlidmaatschappen.

Querytype Voorbeeld Notitie
Alle klanten ophalen {serviceRoot}/msdynci_customerprofiles
Een klant op id ophalen {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID}'
Een klant op alternatieve sleutel ophalen {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK}' Alternatieve sleutels blijven van kracht in de geharmoniseerde klantentabel in de notatie msdynci_DSname_TableName_PrimaryKeyColumnName
Geselecteerde kenmerken ophalen voor een klant {serviceRoot}/msdynci_customerprofiles?$select=msdynci_fullname&$filter=msdynci_customerid eq '{CID}'
Klanten ophalen op id's (In) {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID1}' or msdynci_customerid eq '{CID2}'
Klanten ophalen op alternatieve sleutels (In) {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK1}' or {msdynci_alternate_column} eq '{AK2}'
Zoeken naar klanten {serviceRoot}/msdynci_customerprofiles?$filter=contains(msdynci_lastname,'string')&$top=10
Alle klanten ophalen die lid zijn van een segment {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"')&$select=msdynci_customerid
Een klant ophalen als deze lid is van een segment {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"') and msdynci_customerid eq '{CID}'&$select=msdynci_customerid
Alle segmentlidmaatschappen van een klant ophalen {serviceRoot}/msdynci_segmentmemberships?$filter=msdynci_customerid eq '{CID}'&$select=msdynci_segments

Persoonlijke instellingen voor het web

Voorbeeldquery's om uw website te personaliseren op basis van de CookieId. Het antwoord retourneert zowel bekende als onbekende klanten. De tabellen die zijn gemaakt voor Webtracering en personalisatietabellen zijn beschikbaar in Dataverse.

Querytype Voorbeeld Notitie
Een klant ophalen op CookieId {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}')
Een klant ophalen op CookieId en segmenten, metingen, activiteiten opnemen {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}',include=['segmentmembership','measures','unifiedactivity'])
Recente (laatste 10) paginaweergaven van een klant ophalen via CookieId {serviceRoot}/msdynci_pageviews(cookieid='{cookieId}',top=10) Deze query kan worden gewijzigd om maximaal 200 recente paginaweergaven te retourneren
Recente (laatste 10) paginaklikken van een klant ophalen via CookieId {serviceRoot}/msdynci_pageclicks(cookieid='{cookieId}',top=10) Deze query kan worden gewijzigd om maximaal 200 recente paginakliks te retourneren

Geharmoniseerde activiteit

Voorbeeldquery's voor de tabel UnifiedActivity.

Querytype Voorbeeld Notitie
Alle activiteiten van een klant ophalen {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}'
Alle activiteiten van een klant binnen een tijdsperiode ophalen {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
Alle activiteiten van een activityType van een klant ophalen {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}'
Alle activiteiten van activityDisplayName van een klant ophalen {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}'
Alle activiteiten van een klant ophalen en deze sorteren {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc

Andere voorbeelden

Voorbeeldquery's voor andere tabellen.

Querytype Voorbeeld Notitie
Alle metingen van een klant ophalen {serviceRoot}/msdynci_customermeasures?$filter=msdynci_customerid eq '{CID}'
Verrijkte merken van een klant ophalen {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'BrandShareOfVoiceFromMicrosoft'
Verrijkte interesses van een klant ophalen {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'InterestShareOfVoiceFromMicrosoft'
AI-modelresultaten van een klant ophalen {serviceRoot}/msdynci_predictions?$filter=msdynci_customerid eq '{CID}' and msdynci_modelprovider eq 'ChurnModel'

Volgende stappen