Guida dell’API di Real-Time Customer Profile

Real-Time Customer Profile consente di visualizzare una visione 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 actionable e con marca temporale di ogni interazione con il cliente.

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

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

Per una guida all’utilizzo di Real-Time Customer Profile dati in Experience Platform Interfaccia utente, fare riferimento a Guida utente del profilo.

[Beta]{class="badge informative"}Attributi calcolati {type=Informative} computed-attributes

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 ca/attributes/ endpoint. Per informazioni su come utilizzare gli attributi calcolati, consulta panoramica degli attributi calcolati. Per le operazioni API, visita guida dell’endpoint API per attributi calcolati.

Entità (Profile access) entities

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

Processi di esportazione (Profile export) profile-export

Real-Time Customer Profile i dati 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 del Adobe Experience Platform Segmentation Service API, leggi le guida dell’endpoint "segmentation export jobs" per ulteriori informazioni. Per istruzioni dettagliate su come creare e gestire processi di esportazione per gli attributi del profilo, visita guida dell’endpoint "export jobs".

Criteri di unione merge-policies

Quando si uniscono dati provenienti da più origini in Experience Platform, i criteri di unione sono le regole che Platform utilizza per determinare come assegnare la priorità ai dati e quali dati verranno combinati per creare singoli profili cliente. Utilizzo di Real-Time Customer Profile API, puoi creare nuovi criteri di unione, gestire quelli esistenti e impostare un criterio di unione predefinito per la tua organizzazione. Per utilizzare i criteri di unione tramite l’API, visita la guida dell’endpoint "merge policies".

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

Anteprima stato campione (Profile preview) profile-preview

Quando i dati vengono acquisiti in 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 /previewsamplestatus endpoint, parte dell’API del profilo cliente in tempo reale. 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 /profilepreviewstatus endpoint, fare riferimento al guida dell’endpoint "preview sample status".

Processi di sistema del profilo profile-system-jobs

Dati abilitati per il profilo acquisiti in Platform è memorizzato in Data Lake nonché Real-Time Customer Profile archivio dati. 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. A tal fine è necessario utilizzare l’API per creare un’ Profile System Job, noto anche come "delete request", che possono essere modificati, monitorati o eliminati se necessario. Per scoprire come lavorare con le richieste di eliminazione utilizzando /system/jobs endpoint nella Real-Time Customer Profile , segui i passaggi descritti in guida dell’endpoint "profile system jobs".

Aggiornare gli attributi dei profili update-profile

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 abilitazione di un set di dati per Profilo e upsert.

Passaggi successivi next-steps

Per iniziare a effettuare chiamate utilizzando Real-Time Customer Profile API, leggi guida introduttiva quindi seleziona una delle guide degli endpoint per scoprire come utilizzare ProfileEndpoint correlati. Per lavorare con Profile dati utilizzando Experience Platform Interfaccia utente, fare riferimento a Guida utente di Real-Time Customer Profile.