Guida alla risoluzione dei problemi in tempo reale del profilo cliente

Questo documento fornisce le risposte alle domande frequenti sul Profilo cliente in tempo reale e una guida alla risoluzione dei problemi per gli errori 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 puoi 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 esperti di marketing di promuovere esperienze coordinate, coerenti e rilevanti per i clienti su più canali.

Domande frequenti

Di seguito è riportato un elenco delle risposte alle domande più frequenti sul Profilo del cliente in tempo reale.

Quali tipi di dati sono accettati per Profilo cliente in tempo reale?

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

Come tutti i servizi Platform, Profile richiede che i suoi dati siano strutturati semanticamente in uno schema Experience Data Model (XDM). A sua volta, questo schema deve avere un'identità primaria definita ed essere abilitato per l'utilizzo in 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 Profilo.

Dove sono memorizzati i dati del profilo?

Profilo cliente in tempo reale mantiene il proprio archivio dati (denominato "archivio profili"), separato dal Data Lake che contiene altri dati della piattaforma acquisiti.

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

Se i dati sono stati acquisiti in un set di dati non di profilo, devi riacquisire tali dati 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 profili.

Se desideri aggiungere dati precedentemente acquisiti all’archivio profili, segui l’ esercitazione sulla configurazione del set di dati per creare un nuovo set di dati o convertire un set di dati esistente da abilitare per il profilo, quindi riassimila i dati desiderati in tale set di dati.

Come posso visualizzare i dati del profilo acquisito?

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

Utilizzo dell’API

Se conosci gli ID delle entità profilo a cui desideri accedere, puoi utilizzare l’endpoint /entities (Accesso profilo) nell’API del profilo per cercare tali entità. Per ulteriori informazioni, consulta la sezione sulle entità nella guida per gli sviluppatori.

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

Utilizzo dell’interfaccia

Nell’interfaccia utente Experience Platform, la scheda Browse nell’area di lavoro Profiles 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 al profilo .

Puoi anche visualizzare un elenco dei segmenti nella scheda Browse nell’ area di lavoro Segments . Dopo aver selezionato un segmento, viene visualizzato un esempio di profili qualificati per quel segmento. Puoi quindi selezionare uno qualsiasi di questi profili elencati per visualizzarne i dettagli. Per ulteriori informazioni, consulta la Panoramica dell’interfaccia utente di segmentazione .

Codici di errore

Di seguito è riportato un elenco di messaggi di errore che potresti incontrare quando lavori con l’API del profilo cliente in tempo reale. Se l'errore che incontri non è elencato qui, puoi trovarlo nella Guida generale alla risoluzione dei problemi della piattaforma.

Impossibile cercare lo schema dell'attributo calcolato per il percorso fornito

{
  "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. Assicurati 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 di sistema dello schema.

La funzione con lo stesso nome esiste già per lo schema specificato o definedOn

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

Quando si crea 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 restituito dell'espressione non è lo 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"
}

Quando si crea 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 sotto la proprietà dataSetID o batchID del payload, rispettivamente. Per ulteriori informazioni, consulta la sezione su creazione di una richiesta di cancellazione nella guida per gli sviluppatori di profili .

Batch non trovato per il set di dati del profilo

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

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

La destinazione di proiezione non è ancora stata creata

{
  "status":404,
  "title":"The projection destination has not yet been created.",
  "type":"http://ns.adobe.com/adobecloud/problem/missing-entity"
}

Questo errore si verifica quando la destinationId fornita in una richiesta POST /config/projections non è valida. Prima di riprovare, verifica di aver fornito un ID di destinazione valido. Per creare una nuova destinazione, segui i passaggi descritti nella Guida per gli sviluppatori di profili.

Tipo di supporto 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. Verificare di aver fornito un valore Content-Type valido per l'endpoint utilizzato.

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

Endpoint Content-Type
/config/projections application/vnd.adobe.platform.projectionConfig+json; version=1
/config/destinations application/vnd.adobe.platform.projectionDestination+json; version=1

In questa pagina