Guida dell’API di Real-Time Customer Profile

Ultimo aggiornamento: 4 aprile 2025

Creato per:

  • Sviluppatore

Real-Time Customer Profile consente di visualizzare una visualizzazione olistica di ciascuno dei singoli clienti all'interno di Adobe Experience Platform. Profile consente di consolidare dati cliente diversi da più canali, come dati online, offline, del sistema CRM e di terze parti, in una visualizzazione unificata che offre un account utilizzabile e con marca temporale di ogni interazione con il cliente.

L'API Real-Time Customer Profile include più endpoint, descritti di seguito. Per informazioni dettagliate, consulta le guide dei singoli endpoint e fai riferimento alla guida introduttiva per informazioni importanti sulle intestazioni richieste, sulla lettura delle chiamate API di esempio e altro ancora.

Per visualizzare tutti gli endpoint disponibili e le operazioni CRUD, visita il Swagger di riferimento API del profilo cliente in tempo reale.

Per una guida all'utilizzo dei dati di Real-Time Customer Profile nell'interfaccia utente di Experience Platform, fare riferimento alla guida utente del profilo.

Attributi calcolati

Gli attributi calcolati sono funzioni utilizzate per aggregare i dati a livello di evento negli attributi a livello di profilo. Queste funzioni vengono calcolate automaticamente in modo che possano essere utilizzate in segmentazione, attivazione e personalizzazione.

Ogni attributo calcolato contiene un’espressione, o "regola", che valuta i dati in arrivo e memorizza il valore risultante in un attributo di profilo. Questi calcoli consentono di rispondere facilmente a domande relative a fattori quali il valore di acquisto del ciclo di vita, il tempo che intercorre tra un acquisto e l'altro o il numero di aperture dell'applicazione, senza richiedere di eseguire manualmente calcoli complessi ogni volta che le informazioni sono necessarie. Questi valori di attributo calcolati possono quindi essere visualizzati in un profilo, utilizzati per creare un pubblico o accessibili tramite diversi modelli di accesso.

È possibile creare, visualizzare, modificare ed eliminare attributi calcolati utilizzando l'endpoint ca/attributes/. Per informazioni sull'utilizzo degli attributi calcolati, consultare la panoramica degli attributi calcolati. Per le operazioni API, visita la guida dell'endpoint API per attributi calcolati.

Entità (Profile accesso)

Tramite Adobe Experience Platform è possibile accedere ai dati di Real-Time Customer Profile utilizzando le API RESTful o l'interfaccia utente. Per informazioni su come accedere alle entità, più comunemente note come "profili", utilizzando l'API, segui i passaggi descritti nella guida dell'endpoint entità. Per accedere ai profili tramite l'interfaccia utente Experience Platform, fare riferimento alla Guida utente del profilo.

Processi di esportazione (Profile esportazione)

I dati Real-Time Customer Profile possono essere esportati in un set di dati per ulteriore elaborazione, ad esempio per l'esportazione di tipi di pubblico per l'attivazione o per gli attributi di profilo per il reporting. I processi di esportazione per i tipi di pubblico fanno parte dell'API Adobe Experience Platform Segmentation Service. Per ulteriori informazioni, leggere la guida dell'endpoint dei processi di esportazione segmentazione. Per istruzioni dettagliate su come creare e gestire i processi di esportazione per gli attributi del profilo, consulta la guida dell'endpoint dei processi di esportazione.

Criteri di unione

Quando si riuniscono dati provenienti da più origini in Experience Platform, i criteri di unione sono le regole utilizzate da Experience Platform per determinare la priorità dei dati e i dati che verranno combinati per creare profili cliente individuali. Utilizzando l'API Real-Time Customer Profile, è possibile creare nuovi criteri di unione, gestire i criteri esistenti e impostare un criterio di unione predefinito per l'organizzazione. Per utilizzare i criteri di unione tramite l'API, visita la guida dell'endpoint dei criteri di unione.

Per ulteriori informazioni sui criteri di unione e sul loro ruolo in Experience Platform, consulta la panoramica dei criteri di unione.

Anteprima stato campione (Profile anteprima)

Quando i dati vengono acquisiti in Experience Platform, viene eseguito un processo di esempio per aggiornare il conteggio dei profili e altre metriche relative ai dati del profilo cliente in tempo reale. I risultati di questo processo di esempio possono essere visualizzati utilizzando l'endpoint /previewsamplestatus, parte dell'API Real-Time Customer Profile. Questo endpoint può essere utilizzato anche per elencare le distribuzioni di profilo per set di dati e spazio dei nomi delle identità, nonché per generare più rapporti al fine di ottenere visibilità nella composizione dell’archivio profili della tua organizzazione. Per iniziare a utilizzare l'endpoint /profilepreviewstatus, fare riferimento alla guida dell'endpoint di stato di esempio di anteprima.

Processi di sistema del profilo

I dati abilitati per il profilo acquisiti in Experience Platform sono memorizzati nell'archivio dati Data Lake e Real-Time Customer Profile. Talvolta può essere necessario eliminare i dati di profilo associati a un set di dati dall’archivio Profili per rimuovere i dati non più necessari o che sono stati aggiunti per errore. È necessario utilizzare l'API per creare un Profile System Job, noto anche come "delete request", che può essere modificato, monitorato o eliminato se necessario. Per informazioni su come gestire le richieste di eliminazione utilizzando l'endpoint /system/jobs nell'API Real-Time Customer Profile, seguire i passaggi descritti nella guida dell'endpoint dei processi di sistema del profilo.

Aggiornare gli attributi dei profili

A volte può essere necessario aggiornare i dati nell’archivio profili della tua organizzazione. Ad esempio, potrebbe essere necessario correggere i record o modificare un valore di attributo. Questa operazione può essere eseguita tramite l’acquisizione in batch e richiede un set di dati abilitato per il profilo configurato con un tag upsert. Per ulteriori informazioni su come configurare un set di dati per gli aggiornamenti degli attributi, consulta l'esercitazione per abilitare un set di dati per Profilo e upsert.

Passaggi successivi

Per iniziare a effettuare chiamate utilizzando l'API Real-Time Customer Profile, leggere la guida introduttiva, quindi selezionare una delle guide degli endpoint per scoprire come utilizzare endpoint specifici correlati a Profile. Per utilizzare i dati di Profile tramite l'interfaccia utente di Experience Platform, fare riferimento alla Guida utente del profilo cliente in tempo reale.

Pagina precedenteScadenze profilo pseudonimo
Pagina successivaIntroduzione

Experience Platform