Posso convalidare un payload di richiesta prima di inviarlo a Experience Platform?
I payload delle richieste possono essere valutati solo dopo essere stati inviati a Experience Platform. Quando si esegue la convalida sincrona, i payload validi restituiscono oggetti JSON compilati, mentre i payload non validi restituiscono messaggi di errore. Durante la convalida asincrona, il servizio rileva e invia eventuali dati non validi a Data Lake, dove possono essere successivamente recuperati per l'analisi. Per ulteriori informazioni, consulta la panoramica sulla convalida in streaming.
Cosa succede quando viene richiesta la convalida sincrona su un perimetro che non la supporta?
Quando la convalida sincrona non è supportata per la posizione richiesta, viene restituita una risposta di errore 501. Per ulteriori informazioni sulla convalida sincrona, consulta la panoramica sulla convalida in streaming.
Come posso garantire che i dati vengano raccolti solo da fonti attendibili?
Experience Platform supporta la raccolta di dati protetti. Quando la raccolta dati autenticati è abilitata, i client devono inviare un token web JSON (JWT) e il relativo ID organizzazione come intestazioni di richiesta. Per ulteriori informazioni su come inviare dati autenticati a Experience Platform, vedere la guida sulla raccolta dati autenticati.
Qual è la latenza per lo streaming dei dati in Real-Time Customer Profile?
Gli eventi in streaming vengono generalmente rispecchiati in Real-Time Customer Profile in meno di 60 secondi. Le latenze effettive possono variare a causa del volume dei dati, delle dimensioni dei messaggi e delle limitazioni della larghezza di banda.
Posso includere più messaggi nella stessa richiesta API?
È possibile raggruppare più messaggi all'interno di un singolo payload di richiesta e inviarli in streaming a Experience Platform. Se utilizzato correttamente, raggruppare più messaggi all’interno di una singola richiesta è un modo eccellente per ottimizzare le operazioni sui dati. Per ulteriori informazioni, consulta il tutorial su invio di più messaggi in una richiesta.
Come posso sapere se i dati che sto inviando vengono ricevuti?
Tutti i dati inviati a Experience Platform (correttamente o altrimenti) vengono memorizzati come file batch prima di essere memorizzati in modo permanente nei set di dati. Lo stato di elaborazione dei batch viene visualizzato all’interno del set di dati a cui sono stati inviati.
Puoi verificare se i dati sono stati acquisiti correttamente controllando l'attività del set di dati tramite l'interfaccia utente di Experience Platform. Fai clic su Set di dati nell'area di navigazione a sinistra per visualizzare un elenco di set di dati. Selezionare il set di dati a cui si sta eseguendo il flusso dall'elenco visualizzato per aprire la relativa pagina Attività set di dati, in cui sono visualizzati tutti i batch inviati durante un periodo di tempo selezionato. Per ulteriori informazioni sull'utilizzo di Experience Platform per monitorare i flussi di dati, vedere la guida al monitoraggio dei flussi di dati di streaming.
Se i dati non vengono acquisiti e desideri recuperarli da Experience Platform, puoi recuperare i batch non riusciti inviando i relativi ID a Data Access API. Per ulteriori informazioni, vedere la guida al recupero dei batch non riusciti.
Perché i miei dati in streaming non sono disponibili nel Data Lake?
Esistono diversi motivi per cui l'acquisizione batch potrebbe non riuscire a raggiungere Data Lake, ad esempio formattazione non valida, dati mancanti o errori di sistema. Per determinare il motivo dell'errore del batch, è necessario recuperare il batch utilizzando Data Ingestion Service API e visualizzarne i dettagli. Per i passaggi dettagliati sul recupero di un batch non riuscito, vedere la guida in recupero di batch non riusciti.
Come si analizza la risposta restituita per la richiesta API?
Puoi analizzare una risposta controllando innanzitutto il codice di risposta del server per determinare se la richiesta è stata accettata. Se viene restituito un codice di risposta corretto, è possibile rivedere l'oggetto array responses
per determinare lo stato dell'attività di acquisizione.
Una richiesta API a messaggio singolo riuscita restituisce il codice di stato 200. Una richiesta di API per messaggi in batch completata o parzialmente completata restituisce il codice di stato 207.
Il seguente JSON è un oggetto di risposta di esempio per una richiesta API con due messaggi: uno riuscito e uno non riuscito. I messaggi inviati correttamente restituiscono una proprietà xactionId
. I messaggi che non riescono a trasmettere restituiscono una proprietà statusCode
e una risposta message
con ulteriori informazioni.
{
"inletId": "9b0cb233972f3b0092992284c7353f5eead496218e8441a79b25e9421ea127f5",
"batchId": "1565638336649:1750:244",
"receivedTimeMs": 1565638336705,
"responses": [
{
"xactionId": "1565650704337:2124:92:3"
},
{
"statusCode": 400,
"message": "inletId: [9b0cb233972f3b0092992284c7353f5eead496218e8441a
79b25e9421ea127f5]
imsOrgId: [{ORG_ID}]
Message has unknown xdm format"
}
]
}
Perché i miei messaggi inviati non vengono ricevuti da Real-Time Customer Profile?
Se Real-Time Customer Profile rifiuta un messaggio, è probabile che le informazioni di identità non siano corrette. Questo può essere il risultato della fornitura di un valore o uno spazio dei nomi non valido per un’identità.
Esistono due tipi di spazi dei nomi di identità: predefinito e personalizzato. Quando si utilizzano spazi dei nomi personalizzati, assicurarsi che lo spazio dei nomi sia stato registrato in Identity Service. Per ulteriori informazioni sull'utilizzo degli spazi dei nomi predefiniti e personalizzati, consulta la panoramica dello spazio dei nomi delle identità.
È possibile utilizzare Experience Platform UI per visualizzare ulteriori informazioni sul motivo per cui l'acquisizione di un messaggio non è riuscita. Fai clic su Monitoraggio nell'area di navigazione a sinistra, quindi visualizza la scheda Streaming end-to-end per visualizzare i batch di messaggi inviati in streaming durante un periodo di tempo selezionato.