Adobe Experience Platform consente di acquisire dati dei clienti da più origini per creare profili unificati solidi per i singoli clienti. Poiché i dati abilitati per il profilo cliente in tempo reale vengono acquisiti, Platformvengono memorizzati nell'archivio dati del profilo.
Quando l’inserimento di record nell’archivio profili aumenta o diminuisce il conteggio totale dei profili di oltre il 5%, viene attivato un processo per aggiornare il conteggio. Per i flussi di lavoro dei dati in streaming, viene effettuato un controllo ogni ora per determinare se è stata raggiunta la soglia di incremento o riduzione del 5%. In caso affermativo, viene attivato automaticamente un processo per aggiornare il conteggio. Per l’inserimento batch, entro 15 minuti dal corretto inserimento di un batch nell’archivio profili, se viene raggiunta la soglia di incremento o riduzione del 5%, viene eseguito un processo per aggiornare il conteggio. Utilizzando l'API Profile è possibile visualizzare in anteprima l'ultimo processo di esempio riuscito, nonché la distribuzione del profilo di elenco per set di dati e per namespace di identità.
Queste metriche sono disponibili anche nella Profiles sezione dell'interfaccia utente del Experience Platform . Per informazioni su come accedere ai dati del profilo utilizzando l'interfaccia utente, consulta la guida Profile utente.
L'endpoint API utilizzato in questa guida è parte dell' Real-time Customer Profile API. Prima di continuare, consultate la guida introduttiva per i collegamenti alla documentazione correlata, una guida alla lettura delle chiamate API di esempio in questo documento e informazioni importanti sulle intestazioni richieste necessarie per effettuare correttamente chiamate a qualsiasi Experience Platform API.
Questa guida fa riferimento sia ai "frammenti di profilo" che ai "profili uniti". È importante comprendere la differenza tra questi termini prima di procedere.
Ciascun profilo cliente è composto da più frammenti di profilo che sono stati uniti per formare una singola vista del cliente. Ad esempio, se un cliente interagisce con il tuo marchio su più canali, l'organizzazione avrà più frammenti di profilo correlati a tale singolo cliente che saranno visualizzati in più set di dati. Quando questi frammenti vengono assimilati in Piattaforma, vengono uniti (in base ai criteri di unione) per creare un unico profilo per il cliente. Pertanto, è probabile che il numero totale di frammenti di profilo sia sempre superiore al numero totale di profili uniti, in quanto ogni profilo è composto da più frammenti.
Potete eseguire una richiesta di GET all' /previewsamplestatus
endpoint per visualizzare i dettagli dell'ultimo processo di esempio eseguito correttamente per l'organizzazione IMS. Ciò include il numero totale di profili nell'esempio, nonché la metrica del conteggio dei profili, o il numero totale di profili di cui dispone l'organizzazione all'interno Experience Platform. Il conteggio dei profili viene generato dopo l'unione dei frammenti di profilo per creare un unico profilo per ciascun cliente. In altre parole, l'organizzazione potrebbe avere più frammenti di profilo correlati a un singolo cliente che interagisce con il proprio marchio tra canali diversi, ma tali frammenti sarebbero uniti (in base al criterio di unione predefinito) e restituirebbero un conteggio di profilo pari a "1" perché tutti correlati allo stesso individuo.
Il conteggio dei profili include anche profili con attributi (dati di record) e profili contenenti solo dati di serie temporali (eventi), come profili Adobe Analytics. Il processo di esempio viene aggiornato regolarmente durante l’assimilazione dei dati del profilo, al fine di fornire un numero totale aggiornato di profili all’interno della piattaforma.
Formato API
GET /previewsamplestatus
Richiesta
curl -X GET \
https://platform.adobe.io/data/core/ups/previewsamplestatus \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {IMS_ORG}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
Risposta
La risposta include i dettagli dell'ultimo processo di esempio riuscito eseguito per l'organizzazione IMS.
In questo esempio, la risposta numRowsToRead
e totalRows
sono uguali tra loro. A seconda del numero di profili di cui dispone la vostra organizzazione nel Experience Platform, questo potrebbe essere il caso. Tuttavia, in genere questi due numeri sono diversi, con numRowsToRead
un numero minore poiché rappresenta il campione come un sottoinsieme del numero totale di profili (totalRows
).
{
"numRowsToRead": "41003",
"sampleJobRunning": {
"status": true,
"submissionTimestamp": "2020-08-01 17:57:57.0"
},
"cosmosDocCount": "\"300803\"",
"totalFragmentCount": 47429,
"lastSuccessfulBatchTimestamp": "\"null\"",
"streamingDriven": "\"false\"",
"totalRows": "41003",
"lastBatchId": "\"null\"",
"status": "TASK_FINISHED",
"samplingRatio": 1.0,
"mergeStrategy": "timestampOrdered_auto",
"lastSampledTimestamp": "2020-08-01 17:57:57.0"
}
Proprietà | Descrizione |
---|---|
numRowsToRead |
Il numero totale di profili uniti nell'esempio. |
sampleJobRunning |
Un valore booleano che restituisce true se è in corso un processo di esempio. Fornisce la trasparenza della latenza che si verifica da quando un file batch viene caricato quando viene effettivamente aggiunto all'archivio dei profili. |
cosmosDocCount |
Totale del numero di documenti in Cosmo. |
totalFragmentCount |
Numero totale di frammenti di profilo nell'archivio profili. |
lastSuccessfulBatchTimestamp |
Timestamp ultimo caricamento batch riuscito. |
streamingDriven |
Questo campo è stato dichiarato obsoleto e non contiene alcun significato per la risposta. |
totalRows |
Numero totale di profili uniti nella piattaforma Experience, noti anche come 'profilo count'. |
lastBatchId |
ID assimilazione ultimo batch. |
status |
Stato dell’ultimo campione. |
samplingRatio |
Rapporto tra i profili uniti campionati (numRowsToRead ) e i profili uniti totali (totalRows ), espressi in percentuale in formato decimale. |
mergeStrategy |
Strategia di unione utilizzata nel campione. |
lastSampledTimestamp |
Timestamp ultimo esempio riuscito. |
Per visualizzare la distribuzione dei profili per set di dati, puoi eseguire una richiesta di GET all' /previewsamplestatus/report/dataset
endpoint.
Formato API
GET /previewsamplestatus/report/dataset
GET /previewsamplestatus/report/dataset?{QUERY_PARAMETERS}
Parametro | Descrizione |
---|---|
date |
Specifica la data del rapporto da restituire. Se alla data sono stati eseguiti più rapporti, verrà restituito il rapporto più recente per quella data. Se non esiste un rapporto per la data specificata, verrà restituito un errore 404. Se non viene specificata alcuna data, verrà restituito il rapporto più recente. Formato: AAAA-MM-GG. Esempio: date=2024-12-31 |
Richiesta
La richiesta seguente utilizza il date
parametro per restituire il report più recente per la data specificata.
curl -X GET \
https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset?date=2020-08-01 \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {IMS_ORG}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
Risposta
La risposta include una data
matrice contenente un elenco di oggetti dataset. La risposta mostrata è stata troncata per mostrare tre set di dati.
Se esistevano più rapporti per la data, verrà restituita solo l'ultima. Se per la data specificata non esisteva un report dataset, viene restituito lo stato HTTP 404 (non trovato).
{
"data": [
{
"sampleCount": 12577,
"samplePercentage": 0.306734,
"fullIDsCount": 20988,
"fullIDsPercentage": 0.511865,
"name": "CRM Profiles",
"description": "Profiles from the CRM.",
"value": "5f160106be34361915754b9c",
"streamingIngestionEnabled": "",
"createdUser": "{CREATED_USER}",
"reportTimestamp": "2020-08-01T17:57:58.697",
},
{
"sampleCount": 12938,
"samplePercentage": 0.315538,
"fullIDsCount": 21796,
"fullIDsPercentage": 0.531571,
"name": "AAM Authenticated Profiles",
"description": "This data set contains AAM authenticated profiles.",
"value": "5dc77ec6eed47f18a796ca90",
"streamingIngestionEnabled": "",
"createdUser": "{CREATED_USER}",
"reportTimestamp": "2020-08-01T17:57:58.697"
},
{
"sampleCount": 22725,
"samplePercentage": 0.554228,
"fullIDsCount": 41003,
"fullIDsPercentage": 1.0,
"name": "Loyalty Program Members",
"description": "Members of the loyalty program at all levels.",
"value": "5d0fda92274e55144d4de620",
"streamingIngestionEnabled": "",
"createdUser": "{CREATED_USER}",
"reportTimestamp": "2020-08-01T17:57:58.697"
}
],
"reportTimestamp": "2020-08-01T17:57:58.697"
}
Proprietà | Descrizione |
---|---|
sampleCount |
Il numero totale di profili uniti campionati con questo ID set di dati. |
samplePercentage |
Percentuale sampleCount del numero totale di profili uniti campionati (il numRowsToRead valore restituito nell' ultimo statodel campione), espressa in formato decimale. |
fullIDsCount |
Numero totale di profili uniti con questo ID set di dati. |
fullIDsPercentage |
Percentuale fullIDsCount del numero totale di profili uniti (il totalRows valore restituito nell' ultimo statodel campione), espressa in formato decimale. |
name |
Nome del set di dati, come fornito durante la creazione del set di dati. |
description |
Descrizione del dataset, come fornito durante la creazione del dataset. |
value |
ID del set di dati. |
streamingIngestionEnabled |
Indica se il set di dati è abilitato per l’assimilazione in streaming. |
createdUser |
L'ID utente dell'utente che ha creato il set di dati. |
reportTimestamp |
Il timestamp del report. Se durante la richiesta è stato fornito un date parametro, il rapporto restituito è relativo alla data specificata. Se non viene fornito alcun date parametro, viene restituito il rapporto più recente. |
Potete eseguire una richiesta di GET all' /previewsamplestatus/report/namespace
endpoint per visualizzare la suddivisione per namespace identità in tutti i profili uniti nell'archivio profili. Gli spazi dei nomi delle identità sono un componente importante di Adobe Experience Platform Identity Service che funge da indicatori del contesto a cui si riferiscono i dati dei clienti. Per ulteriori informazioni, visitare la panoramica dello spazio nomiidentità.
Il numero totale di profili per namespace (aggiungendo insieme i valori mostrati per ogni namespace) sarà sempre superiore alla metrica del conteggio dei profili, perché un profilo potrebbe essere associato a più spazi dei nomi. Ad esempio, se un cliente interagisce con il tuo marchio su più di un canale, a quel singolo cliente saranno associati più spazi dei nomi.
Formato API
GET /previewsamplestatus/report/namespace
GET /previewsamplestatus/report/namespace?{QUERY_PARAMETERS}
Parametro | Descrizione |
---|---|
date |
Specifica la data del rapporto da restituire. Se alla data sono stati eseguiti più rapporti, verrà restituito il rapporto più recente per quella data. Se non esiste un rapporto per la data specificata, verrà restituito un errore 404. Se non viene specificata alcuna data, verrà restituito il rapporto più recente. Formato: AAAA-MM-GG. Esempio: date=2024-12-31 |
Richiesta
La richiesta seguente non specifica un date
parametro e pertanto restituisce il report più recente.
curl -X GET \
https://platform.adobe.io/data/core/ups/previewsamplestatus/report/namespace \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {IMS_ORG}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
Risposta
La risposta include una data
matrice, con singoli oggetti che contengono i dettagli per ogni spazio dei nomi. La risposta mostrata è stata troncata per mostrare quattro spazi dei nomi.
{
"data": [
{
"sampleCount": 12148,
"samplePercentage": 0.296271,
"reportTimestamp": "2020-08-01T17:57:58.697",
"fullIDsFragmentCount": 13141,
"fullIDsCount": 12631,
"fullIDsPercentage": 0.308051,
"code": "Email",
"value": "6"
},
{
"sampleCount": 6989,
"samplePercentage": 0.170451,
"reportTimestamp": "2020-08-01T17:57:58.697",
"fullIDsFragmentCount": 7543,
"fullIDsCount": 7042,
"fullIDsPercentage": 0.171744,
"code": "ECID",
"value": "4"
},
{
"sampleCount": 888,
"samplePercentage": 0.021657,
"reportTimestamp": "2020-08-01T17:57:58.697",
"fullIDsFragmentCount": 3801,
"fullIDsCount": 3206,
"fullIDsPercentage": 0.078189,
"code": "AAID",
"value": "10"
},
{
"sampleCount": 21809,
"samplePercentage": 0.531888,
"reportTimestamp": "2020-08-01T17:57:58.697",
"fullIDsFragmentCount": 27023,
"fullIDsCount": 21936,
"fullIDsPercentage": 0.534985,
"code": "Phone",
"value": "7"
}
],
"reportTimestamp": "2020-08-01T17:57:58.697"
}
Proprietà | Descrizione |
---|---|
sampleCount |
Il numero totale di profili uniti campionati nello spazio dei nomi. |
samplePercentage |
Percentuale sampleCount dei profili uniti campionati (il numRowsToRead valore restituito nello stato dell'ultimo campione), espressa in formato decimale. |
reportTimestamp |
Il timestamp del report. Se durante la richiesta è stato fornito un date parametro, il rapporto restituito è relativo alla data specificata. Se non viene fornito alcun date parametro, viene restituito il rapporto più recente. |
fullIDsFragmentCount |
Numero totale di frammenti di profilo nello spazio dei nomi. |
fullIDsCount |
Il numero totale di profili uniti nello spazio dei nomi. |
fullIDsPercentage |
Percentuale fullIDsCount dei profili uniti totali (il totalRows valore restituito nello stato dell'ultimo campione), espressa in formato decimale. |
code |
Indica code lo spazio dei nomi. Questo si può trovare quando si utilizzano gli spazi dei nomi mediante l'API Adobe Experience Platform Identity Service e viene indicato anche come Identity symbol nell'interfaccia utente del Experience Platform . Per ulteriori informazioni, visitare la panoramica dello spazio nomiidentità. |
value |
Il id valore dello spazio dei nomi. Questo è possibile quando si utilizzano gli spazi dei nomi mediante l'API del servizio identità. |
Potete inoltre utilizzare stime e anteprime simili per visualizzare le informazioni a livello di riepilogo relative alle definizioni dei segmenti, in modo da garantire l'isolamento dell'audience prevista. Per trovare i passaggi dettagliati per l'utilizzo delle anteprime e delle stime dei segmenti tramite l' Adobe Experience Platform Segmentation Service API, visita la guida alleanteprime e alle stime degli endpoint, parte della guida per gli sviluppatori di Segmentation API.