API di Dataverse per Customer Insights - Data

  • Articolo

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. Questo ID viene generato automaticamente quando si utilizza lo script di rilevamento 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.

Tipo di query Esempio Nota
Ottieni un cliente da CookieId {serviceRoot}/msdynci_personalizationprofiles(cookieid='{cookieId}')
Ottieni un cliente da CookieId e includi segmenti, misure, attività {serviceRoot}/msdynci_personalizationprofiles(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) Può essere modificato 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) Può essere modificato per restituire fino a 200 clic sulla pagina recenti

Impegno unificato

Esempi di query per la tabella UnifiedActivity:

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 2017-01-01T00:00:00Z and msdynci_activitytime lt 2017-01-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