Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
[Questo articolo fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]
La funzionalità quasi in tempo reale ti consente di vedere, in pochi secondi, le ultime interazioni che i tuoi clienti hanno effettuato con i tuoi prodotti o servizi.
Gli aggiornamenti pianificati includono un numero elevato di record e diverse operazioni complesse. Innanzitutto, i dati vengono estratti dall'origine dati. Successivamente, i dati vengono unificati e quindi arricchiti con ulteriori informazioni. Ogni esecuzione di questo processo può richiedere da minuti a ore.
La funzionalità in tempo reale fornisce immediatamente i dati per l'utilizzo, fino a quando il successivo aggiornamento pianificato non estrae questi dati dall'origine dati.
Gli aggiornamenti in tempo reale hanno una data di scadenza dopo la quale non sovrascrivono più il valore dall'origine dati:
- Gli aggiornamenti del profilo vengono conservati per quattro ore
- Le attività vengono mantenute per 30 giorni
Questi valori sono parametri di chiamata API che è possibile modificare. Hanno lo scopo di garantire che i dati di origine rimangano la fonte di verità. Se si desidera che gli aggiornamenti in tempo reale siano inclusi più a lungo, aggiungerli a un'origine dati in modo che vengano estratti durante il successivo aggiornamento pianificato.
Suggerimento
Tutti i dati acquisiti o modificati utilizzando queste API si applicano direttamente alle tabelle Dataverse corrispondenti. Ciò ti consente di sfruttare il resto dell'ecosistema e delle funzionalità di Dataverse per realizzare scenari aziendali end-to-end.
Importante
- Si tratta di una funzionalità di anteprima.
- Le funzionalità di anteprima non sono progettate per l'uso in produzione e possono avere funzionalità limitate. Queste funzionalità sono disponibili prima di una versione ufficiale in modo che i clienti possano ottenere l'accesso anticipato e fornire commenti e suggerimenti.
Aggiornamento in tempo reale dei campi unificati del profilo cliente
I profili aggiornati vengono visualizzati nella vista della scheda cliente o in qualsiasi altra visualizzazione entro pochi secondi.
Poiché le operazioni in tempo reale vengono eseguite dopo l'unificazione dei dati, si applicano solo ai profili cliente unificati. Di conseguenza, le modifiche al profilo in tempo reale non aggiornano le misure, l'appartenenza ai segmenti o gli arricchimenti.
Limitazioni
- I profili cliente possono essere aggiornati, ma non creati o eliminati.
- L'esportazione degli aggiornamenti in tempo reale in sistemi esterni, come Power BI, non è possibile.
Creazione di attività in tempo reale
L'API in tempo reale consente di pubblicare una nuova attività dal tuo sistema di origine (un singolo record di origine) a un profilo cliente unificato. La nuova attività è disponibile entro pochi secondi come attività unificata nella sequenza temporale del profilo cliente unificato. La sequenza temporale è visualizzabile dalla vista della scheda cliente o da qualsiasi altra integrazione della sequenza temporale configurata.
Annotazioni
- Le attività non cambiano una volta create.
- I segmenti e le misure non vengono aggiornati in base alla nuova attività.
- Le attività aggiunte solo tramite l'API in tempo reale non fanno parte delle esportazioni e non vengono visualizzate in PowerBI.
Esistono due modi per connettersi all'API in tempo reale:
- Indirettamente, utilizzando il connettore Dynamics 365 Customer Insights
- Direttamente, con il codice
Entrambi i metodi condividono i seguenti prerequisiti:
- A Customer Insights - Ambiente dei dati
- Profili cliente unificati
- Attività configurate ed eseguite
- Autorizzazioni di collaboratore o amministratore per autenticare il tuo account
Connessione a Dynamics 365 Customer Insights - Data
L'API in tempo reale può inserire dati da un connettore Power Platform dedicato, il connettore Dynamics 365 Customer Insights, senza la necessità di scrivere e distribuire alcun codice. Il connettore può eseguire le stesse azioni in tempo reale dell'API. È necessaria una licenza valida per i connettori Premium. Per ulteriori informazioni, vedi Domande frequenti sulle licenze di Power Apps e Power Automate.
- Power Platform Power Apps e/o Power Automate
- App per la logica di Azure
Per informazioni dettagliate sulla creazione di flussi, vedere la documentazione di Power Automate.
Connessione diretta all'API in tempo reale
È possibile utilizzare le funzionalità in tempo reale creando la propria pipeline e connettendosi direttamente all'API in tempo reale. È possibile pubblicare un'attività nel formato del sistema di origine o nel formato UnifiedActivity. Per ottenere il formato, effettuare una chiamata API a /api/instances/{instanceId}/manage/tables/UnifiedActivity.
I dettagli di questa API, inclusi i parametri e le risposte, sono disponibili nella sezione TableData del riferimento API. Per ulteriori informazioni, consulta Utilizzare le API.