API di Dataverse per Customer Insights - Data
Se stai già utilizzando le API di Customer Insights - Data, ad esempio eseguire query su un profilo cliente o ottenere le appartenenze ai segmenti, ti consigliamo di eseguire la migrazione delle tue API alle API Dataverse. Il supporto per l'interrogazione dei metadati, come ottenere la definizione del segmento e la gestione del flusso di lavoro, sarà presto disponibile per le API Dataverse.
Se stai iniziando a interrogare i dati utilizzando le API, ti consigliamo di utilizzare le API Dataverse.
Importante
Si consiglia di utilizzare le API Dataverse solo per leggere i dati (GET) e non per scrivere i dati (POST/PATCH/PUT) poiché possono causare problemi con l'elaborazione di Customer Insights - Data.
Le API Dataverse presentano i seguenti vantaggi:
Funzionalità estese per il filtraggio e l'ordinamento
Prestazioni e scalabilità migliorate
Esperienza API coerente tra le app Dynamics 365 e Power Platform
Query di esempio
Per iniziare a utilizzare le API Dataverse, creare una registrazione dell'applicazione in Azure e richiedere le autorizzazioni per Dataverse e concedere le autorizzazioni Visualizzatore all'app in Customer Insights - Data.
Modificare gli esempi di query perché funzionino negli ambienti di destinazione:
{serviceRoot}:
{Organization URI}/api/data/v9.2/
dove {URI dell'organizzazione} è l'URI del tenant Dataverse associato al tuo ambiente. Ad esempio:https://{mydvorg}.crm.dynamics.com
{CID}: GUID di un record cliente unificato. Ad esempio:
ce759201f786d590bf2134bff576c369
.{AlternateKey}: identificatore della chiave primaria di un record cliente in un origine dati. Ad esempio:
CNTID_1002
.{DSname}: stringa con il nome del tavolo di un'origine dati che viene inserito in Customer Insights - Data. Ad esempio:
Website_contacts
.{SegmentName}: stringa con il nome della tabella di output di un segmento. Ad esempio:
Male_under_40
.{CookieId}: identificatore per ciascun visitatore del sito Web, generato automaticamente quando si utilizza lo script di monitoraggio Web. Ad esempio:
3f43317e-d1ef-4cd3-9917-2d3342111d1a
.
Cliente
Query di esempio per la tabella CustomerProfile e l'appartenenza al segmento.
Tipo di query | Esempio | Nota |
---|---|---|
Ottieni tutti i clienti | {serviceRoot}/msdynci_customerprofiles |
|
Recupera un cliente per ID | {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID}' |
|
Recupera un cliente per chiave alternativa | {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK}' |
Le chiavi alternative persistono nella tabella clienti unificata nel formato msdynci_DSname_TableName_PrimaryKeyColumnName |
Ottieni gli attributi selezionati per un cliente | {serviceRoot}/msdynci_customerprofiles?$select=msdynci_fullname&$filter=msdynci_customerid eq '{CID}' |
|
Recupera clienti in base all'ID (In) | {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID1}' or msdynci_customerid eq '{CID2}' |
|
Recupera clienti per chiavi alternative (In) | {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK1}' or {msdynci_alternate_column} eq '{AK2}' |
|
Ricerca di clienti | {serviceRoot}/msdynci_customerprofiles?$filter=contains(msdynci_lastname,'string')&$top=10 |
|
Ottieni tutti i clienti che sono membri di un segmento | {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"')&$select=msdynci_customerid |
|
Recupera un cliente se è membro di un segmento | {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"') and msdynci_customerid eq '{CID}'&$select=msdynci_customerid |
|
Ottieni tutte le appartenenze ai segmenti di un cliente | {serviceRoot}/msdynci_segmentmemberships?$filter=msdynci_customerid eq '{CID}'&$select=msdynci_segments |
Personalizzazione Web
Query di esempio per personalizzare il tuo sito web in base al CookieId. La risposta restituisce sia i clienti conosciuti sia i clienti sconosciuti. Le tabelle create per il monitoraggio e la personalizzazione del Web sono disponibili in Dataverse.
Tipo di query | Esempio | Nota |
---|---|---|
Ottieni un cliente da CookieId | {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}') |
|
Ottieni un cliente da CookieId e includi segmenti, misure, attività | {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}',include=['segmentmembership','measures','unifiedactivity']) |
|
Ottieni le visualizzazioni di pagina recenti (ultime 10) di un cliente da CookieId | {serviceRoot}/msdynci_pageviews(cookieid='{cookieId}',top=10) |
Questa query può essere modificata per restituire fino a 200 visualizzazioni di pagina recenti |
Ottieni i clic sulla pagina recenti (ultimi 10) di un cliente da CookieId | {serviceRoot}/msdynci_pageclicks(cookieid='{cookieId}',top=10) |
Questa query può essere modificata per restituire fino a 200 clic recenti sulla pagina |
Ottieni tutte le attività di un cliente | {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' |
|
Ottieni tutte le attività di un cliente entro un periodo di tempo | {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 |
|
Ottieni tutte le attività di un activityType di un cliente | {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}' |
|
Ottieni tutte le attività di activityDisplayName di un cliente | {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}' |
|
Ottieni tutte le attività di un cliente e ordinale | {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc |
Impegno unificato
Query di esempio per la tabella UnifiedActivity se Personalizzazione Web non è in uso.
Tipo di query | Esempio | Nota |
---|---|---|
Ottieni tutte le attività di un cliente | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' |
|
Ottieni tutte le attività di un cliente entro un periodo di tempo | {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 |
|
Ottieni tutte le attività di un activityType di un cliente | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}' |
|
Ottieni tutte le attività di activityDisplayName di un cliente | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}' |
|
Ottieni tutte le attività di un cliente e ordinale | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc |
Altri esempi
Query di esempio per altre tabelle:
Tipo di query | Esempio | Nota |
---|---|---|
Ottieni tutte le misure di un cliente | {serviceRoot}/msdynci_customermeasures?$filter=msdynci_customerid eq '{CID}' |
|
Ottieni marchi arricchiti di un cliente | {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'BrandShareOfVoiceFromMicrosoft' |
|
Ottieni interessi arricchiti di un cliente | {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'InterestShareOfVoiceFromMicrosoft' |
|
Ottieni risultati del modello di intelligenza artificiale di un cliente | {serviceRoot}/msdynci_predictions?$filter=msdynci_customerid eq '{CID}' and msdynci_modelprovider eq 'ChurnModel' |
Passaggi successivi
La maggior parte delle tabelle di Customer Insights - Data sono disponibili in Dataverse. Per altre informazioni, consultare Tabelle in Dataverse.
Dataverse offre un supporto esteso per testarne le API, ad esempio tramite Insomnia. Per maggiori informazioni, vedi Utilizzare Insomnia con l'API Web Dataverse.
Per altre informazioni sui limiti del servizio API Dataverse, vedi Panoramica dei limiti delle API Microsoft Dataverse.
Per ulteriori informazioni su come utilizzare le API Dataverse, vedi Eseguire query sui dati utilizzando l'API Web.