Guida alla risoluzione dei problemi di Real-Time Customer Profile

Questo documento fornisce le risposte alle domande più frequenti su Real-Time Customer Profile, nonché una guida alla risoluzione dei problemi relativi agli errori più comuni. Per domande e risoluzione dei problemi relativi ad altri servizi in Adobe Experience Platform, consulta la guida alla risoluzione dei problemi di Experience Platform.

Con Real-Time Customer Profile è possibile visualizzare una visualizzazione olistica di ogni singolo cliente combinando dati provenienti da più canali, inclusi online, offline, CRM e di terze parti. Questo consente agli addetti al marketing di distribuire esperienze coordinate, coerenti e rilevanti per i clienti su più canali.

Domande frequenti

Di seguito è riportato un elenco di risposte alle domande più frequenti su Real-Time Customer Profile.

Quali tipi di dati sono accettati per Real-Time Customer Profile?

Il profilo accetta sia i dati record che quelli della serie temporale, purché i dati in questione contengano almeno un valore di identità che associa i dati a una singola persona univoca.

Come tutti i servizi di Platform, il profilo richiede che i suoi dati siano strutturati semanticamente in uno schema Experience Data Model (XDM). A sua volta, questo schema deve avere una identità primaria definita ed essere abilitato per l'utilizzo nel profilo.

Se non conosci XDM, inizia con Panoramica XDM per ulteriori informazioni. Quindi, consulta la guida utente XDM per i passaggi su come impostare i campi di identità e abilitare uno schema per il profilo.

Dove vengono memorizzati i dati del profilo?

Real-Time Customer Profile mantiene il proprio archivio dati (denominato "archivio profili"), separato dal Data Lake che contiene altri dati di Platform acquisiti.

Se ho già acquisito i dati in Platform, posso renderli disponibili nell’archivio Profili?

Se i dati sono stati acquisiti in un set di dati non di profilo, devi acquisirli nuovamente in un set di dati abilitato per il profilo per renderli disponibili nell’archivio Profili. È possibile abilitare un set di dati esistente per il profilo, tuttavia tutti i dati acquisiti prima di tale configurazione non verranno ancora visualizzati nell’archivio dei profili.

Se desideri aggiungere dati precedentemente acquisiti all'archivio profili, segui il tutorial sulla configurazione del set di dati per creare un nuovo set di dati o convertire un set di dati esistente da abilitare per Profilo, quindi riacquisisci i dati desiderati in tale set di dati.

Come posso visualizzare i dati del profilo acquisiti?

Esistono diversi metodi per visualizzare i dati del profilo, a seconda che si utilizzi l’API o l’interfaccia utente.

Mediante l’API

Se si conoscono gli ID delle entità profilo a cui si desidera accedere, è possibile utilizzare l'endpoint /entities (accesso profilo) nell'API profilo per cercare tali entità. Per ulteriori informazioni, consulta la sezione sulle entità nella guida per gli sviluppatori.

Puoi anche utilizzare l’API del servizio di segmentazione di Adobe Experience Platform per accedere ai singoli profili dei clienti idonei per l’iscrizione a un pubblico. Per ulteriori informazioni, vedere Panoramica del servizio di segmentazione.

Utilizzo dell’interfaccia utente

Nell'interfaccia utente di Experience Platform, la scheda Sfoglia nell'area di lavoro Profili ti consente di visualizzare il conteggio totale dei profili e di cercare i singoli profili in base al loro valore di identità. Per ulteriori informazioni, consulta la Guida utente del profilo.

Puoi anche visualizzare un elenco dei tuoi tipi di pubblico nella scheda Sfoglia nell'area di lavoro Tipi di pubblico. Dopo aver selezionato un pubblico, viene visualizzato un campione di profili idonei per quel pubblico. Puoi quindi selezionare uno di questi profili elencati per visualizzarne i dettagli. Per ulteriori informazioni, vedi Panoramica dell'interfaccia utente di segmentazione.

Codici di errore

Di seguito è riportato un elenco di messaggi di errore che possono verificarsi quando si lavora con l’API Profilo cliente in tempo reale. Se l'errore riscontrato non è elencato qui, è possibile trovarlo nella Guida alla risoluzione dei problemi di Platform generale.

Impossibile cercare lo schema dell’attributo calcolato per il percorso specificato

{
  "code": "400",
  "message": "Could not lookup schema of the computed attribute for the provided path"
}

Durante la creazione di un nuovo attributo calcolato, questo errore si verifica quando il sistema non è riuscito a trovare lo schema fornito nel payload della richiesta. Verificare di aver fornito l'ID tenant corretto nella proprietà path del payload e che i valori di schema.name siano un nome di schema valido.

Se non conosci il tuo ID tenant, puoi recuperarlo seguendo i passaggi descritti nella Guida per gli sviluppatori del registro degli schemi.

Esiste già una funzione con lo stesso nome per lo schema specificato o definedOn

{
  "code": "400",
  "message": "Function with the same name already exists for the specified schema or definedOn"
}

Durante la creazione di un nuovo attributo calcolato, questo errore si verifica quando la proprietà name fornita è già utilizzata per lo schema indicato in schema.name. Sostituisci il valore con un nome univoco prima di riprovare.

Lo schema di ritorno dell’espressione non è lo stesso dello schema dell’attributo calcolato nello schema XDM

{
  "code": "400",
  "message": "Return schema of the expression is not same as the schema of the computed attribute in the XDM schema"
}

Durante la creazione di un nuovo attributo calcolato, questo errore si verifica quando la proprietà name fornita è già utilizzata per lo schema indicato in schema.name. Sostituisci il valore con un nome univoco prima di riprovare.

Richiesta di eliminazione non valida (processo di sistema del profilo)

{
  "code": "400",
  "message": "Invalid delete request (Profile System Job)"
}

Questo errore si verifica quando viene fornito un payload non valido per un processo di eliminazione del sistema. Assicurati di fornire un set di dati o un ID batch valido rispettivamente sotto la proprietà dataSetID o batchID del payload. Per ulteriori informazioni, consulta la sezione sulla creazione di una richiesta di eliminazione nella guida per gli sviluppatori di profili.

Batch non trovato per il set di dati profilo

{
  "requestId":"LlTmQkhgHKFGHGHnIkmUxcIL4YTFSpQw",
  "errors":{
    "400":[
      {
        "code":"400",
        "message":"Batch not found for profile dataset '5da688d2c4e60518ad25b7b1'"
      }
    ]
  }
}

Questo errore si verifica quando non è possibile trovare un batch valido durante il tentativo di creare una richiesta di eliminazione per i dati del profilo. Prima di riprovare, verifica di aver immesso l’ID corretto per un set di dati abilitato per il profilo.

Tipo di file multimediale non supportato

{
  "status": 415,
  "title": "HTTP 415 Unsupported Media Type",
  "type": "http://ns.adobe.com/adobecloud/problem/unsupported-media-type"
}

Questo errore si verifica quando si invia una richiesta POST o PUT con un’intestazione Content-Type non valida. Verifica di fornire un valore Content-Type valido per l’endpoint in uso.

La maggior parte degli endpoint di profilo accetta "application/json" per l’intestazione Content-Type, con le seguenti eccezioni: