Anteprima dell’endpoint di stato di esempio (anteprima profilo)

Adobe Experience Platform consente di acquisire dati dei clienti da più sorgenti per creare un profilo solido e unificato per ciascuno dei singoli clienti. Man mano che 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 lavoro di esempio possono essere visualizzati utilizzando l’ /previewsamplestatus endpoint , parte dell’API Profilo cliente in tempo reale. Questo endpoint può essere utilizzato anche per elencare le distribuzioni dei profili per set di dati e namespace di identità, nonché per generare più rapporti al fine di acquisire visibilità nella composizione dell’archivio profili della tua organizzazione. Questa guida descrive i passaggi necessari per visualizzare queste metriche utilizzando l’ endpoint API /previewsamplestatus .

NOTA

Sono disponibili endpoint di stima e anteprima nell’API del servizio di segmentazione di Adobe Experience Platform che consentono di visualizzare informazioni di riepilogo sulle definizioni dei segmenti per assicurarsi di isolare il pubblico previsto. Per trovare i passaggi dettagliati per l’utilizzo dell’anteprima dei segmenti e degli endpoint di stima, visita la guida alle anteprime e agli endpoint di stima, parte della guida per gli sviluppatori API Segmentation.

Introduzione

L'endpoint API utilizzato in questa guida fa parte dell' Real-time Customer Profile API. Prima di continuare, controlla la guida introduttiva per i collegamenti alla relativa documentazione, una guida per la lettura delle chiamate API di esempio in questo documento e informazioni importanti sulle intestazioni necessarie per effettuare correttamente le chiamate a qualsiasi API Experience Platform.

Frammenti di profilo e profili uniti

Questa guida fa riferimento sia ai "frammenti di profilo" che ai "profili uniti". È importante comprendere la differenza tra questi termini prima di procedere.

Ogni singolo 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, è probabile che la tua organizzazione abbia più frammenti di profilo relativi al singolo cliente che appaiono in più set di dati.

Quando i frammenti di profilo vengono acquisiti in Platform, vengono uniti (in base a un criterio di unione) per creare un singolo profilo per quel 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.

Per ulteriori informazioni sui profili e il loro ruolo all'interno dell'Experience Platform, inizia leggendo la Panoramica sul profilo cliente in tempo reale.

Modalità di attivazione del processo di esempio

Poiché i dati abilitati per Profilo cliente in tempo reale vengono acquisiti in Platform, vengono memorizzati nell’archivio dati Profilo. Quando l’acquisizione dei record nell’archivio profili aumenta o diminuisce il conteggio totale dei profili di oltre il 5%, viene attivato un processo di campionamento per aggiornare il conteggio. Il modo in cui il campione viene attivato dipende dal tipo di acquisizione utilizzato:

  • Per flussi di lavoro di dati in streaming, viene eseguito un controllo su base oraria per determinare se la soglia di aumento o diminuzione del 5% è stata soddisfatta. In caso affermativo, viene attivato automaticamente un processo di esempio per aggiornare il conteggio.
  • Per l'acquisizione batch, entro 15 minuti dal corretto inserimento di un batch nell'archivio profili, se viene soddisfatta la soglia di aumento o diminuzione del 5%, viene eseguito un processo per aggiornare il conteggio. Utilizzando l’API di profilo puoi visualizzare in anteprima il processo di esempio più recente, oltre a elencare la distribuzione dei profili per set di dati e per namespace di identità.

Il conteggio dei profili e i profili per metriche dello spazio dei nomi sono disponibili anche nella sezione Profiles dell’interfaccia utente di Experience Platform. Per informazioni su come accedere ai dati del profilo utilizzando l'interfaccia utente, visita la Profile guida all'interfaccia utente.

Visualizza lo stato dell’ultimo esempio

Puoi eseguire una richiesta di GET all’endpoint /previewsamplestatus per visualizzare i dettagli dell’ultimo processo di esempio riuscito eseguito per l’organizzazione IMS. Ciò include il numero totale di profili nel campione, nonché la metrica di conteggio dei profili, o il numero totale di profili di cui la tua organizzazione dispone all’interno dell’Experience Platform.

Il conteggio dei profili viene generato dopo l’unione dei frammenti di profilo per formare un singolo profilo per ogni singolo cliente. In altre parole, quando i frammenti di profilo vengono uniti restituiscono un conteggio di "1" profilo perché sono tutti correlati allo stesso individuo.

Il conteggio dei profili include anche profili con attributi (dati record) e profili contenenti solo dati di serie temporali (eventi), ad esempio profili Adobe Analytics. Il processo di esempio viene aggiornato regolarmente man mano che i dati del profilo vengono acquisiti, al fine di fornire un numero totale aggiornato di profili all’interno di Platform.

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 eseguito correttamente per l'organizzazione.

NOTA

In questo esempio di risposta, numRowsToRead e totalRows sono uguali tra loro. A seconda del numero di profili di cui dispone l’organizzazione nell’Experience Platform, ciò potrebbe accadere. Tuttavia, in genere questi due numeri sono diversi, con numRowsToRead come numero minore, perché rappresenta il campione come 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 Numero totale di profili uniti nel campione.
sampleJobRunning Valore booleano che restituisce true quando è in corso un processo di esempio. Fornisce la trasparenza della latenza che si verifica dal momento in cui un file batch viene caricato in quando viene effettivamente aggiunto all’archivio profili.
cosmosDocCount Numero totale di documenti in Cosmo.
totalFragmentCount Numero totale di frammenti di profilo nell’archivio profili.
lastSuccessfulBatchTimestamp Timestamp ultimo inserimento batch riuscito.
streamingDriven Questo campo è stato dichiarato obsoleto e non contiene alcun significato per la risposta.
totalRows Numero totale di profili uniti nell’Experience Platform, noto anche come "conteggio dei profili".
lastBatchId ID acquisizione ultimo batch.
status Stato dell’ultimo campione.
samplingRatio Rapporto tra i profili uniti campionati (numRowsToRead) e i profili uniti totali (totalRows), espresso in percentuale in formato decimale.
mergeStrategy Strategia di unione utilizzata nel campione.
lastSampledTimestamp Data e ora dell’ultimo esempio riuscito.

Elencare la distribuzione dei profili per set di dati

Per visualizzare la distribuzione dei profili per set di dati, puoi eseguire una richiesta GET all’endpoint /previewsamplestatus/report/dataset .

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, viene restituito il rapporto più recente per tale data. Se un report non esiste per la data specificata, viene restituito un errore 404 (Non trovato). Se non viene specificata alcuna data, viene restituito il rapporto più recente. Formato: AAAA-MM-GG. Esempio: date=2024-12-31

Richiesta

La richiesta seguente utilizza il parametro date 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 un array data contenente un elenco di oggetti set di dati. La risposta mostrata è stata troncata per mostrare tre set di dati.

NOTA

Se per la data sono presenti più rapporti, viene restituito solo l’ultimo rapporto. Se non esiste un rapporto del set di dati per la data fornita, 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 di set di dati.
samplePercentage La sampleCount come percentuale del numero totale di profili uniti campionati (il valore numRowsToRead come restituito nel stato dell'ultimo campione), espresso in formato decimale.
fullIDsCount Il numero totale di profili uniti con questo ID di set di dati.
fullIDsPercentage La fullIDsCount come percentuale del numero totale di profili uniti (il valore totalRows restituito nel stato dell'ultimo campione), espresso in formato decimale.
name Nome del set di dati, come fornito durante la creazione del set di dati.
description Descrizione del set di dati, come fornito durante la creazione del set di dati.
value ID del set di dati.
streamingIngestionEnabled Se il set di dati è abilitato per l’acquisizione in streaming.
createdUser ID utente dell’utente che ha creato il set di dati.
reportTimestamp La marca temporale del rapporto. Se durante la richiesta è stato fornito un parametro date , il rapporto restituito è relativo alla data fornita. Se non viene fornito alcun parametro date, viene restituito il rapporto più recente.

Distribuzione dei profili in base allo spazio dei nomi identità

Puoi eseguire una richiesta di GET all’endpoint /previewsamplestatus/report/namespace per visualizzare la suddivisione per namespace di identità in tutti i profili uniti nel tuo archivio profili. Ciò include sia le identità standard fornite da Adobe, sia le identità personalizzate definite dalla tua organizzazione.

Gli spazi dei nomi di identità sono un componente importante del servizio Adobe Experience Platform Identity che funge da indicatori del contesto a cui si riferiscono i dati dei clienti. Per ulteriori informazioni, inizia leggendo la panoramica dello spazio dei nomi di identità.

NOTA

Il numero totale di profili per namespace (aggiunta insieme dei valori mostrati per ogni namespace) può essere maggiore della metrica di conteggio dei profili, perché un profilo può essere associato a più namespace. Ad esempio, se un cliente interagisce con il tuo marchio su più di un canale, a quel singolo cliente saranno associati più namespace.

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, viene restituito il rapporto più recente per tale data. Se un report non esiste per la data specificata, viene restituito un errore 404 (Non trovato). Se non viene specificata alcuna data, viene restituito il rapporto più recente. Formato: AAAA-MM-GG. Esempio: date=2024-12-31

Richiesta

La richiesta seguente non specifica un parametro date e pertanto restituisce il rapporto 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 un array data con singoli oggetti contenenti i dettagli di ogni namespace. La risposta mostrata è stata troncata per mostrare quattro namespace.

{
  "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 Numero totale di profili uniti campionati nello spazio dei nomi.
samplePercentage La sampleCount come percentuale dei profili uniti campionati (il valore numRowsToRead come restituito nel stato dell'ultimo campione), espresso in formato decimale.
reportTimestamp La marca temporale del rapporto. Se durante la richiesta è stato fornito un parametro date , il rapporto restituito è relativo alla data fornita. Se non viene fornito alcun parametro date, viene restituito il rapporto più recente.
fullIDsFragmentCount Numero totale di frammenti di profilo nello spazio dei nomi.
fullIDsCount Numero totale di profili uniti nello spazio dei nomi.
fullIDsPercentage Il fullIDsCount come percentuale del totale dei profili uniti (il valore totalRows restituito nello stato ultimo campione), espresso in formato decimale.
code Il code per lo spazio dei nomi. Questo si può trovare quando si lavora con i namespace utilizzando l’ API del servizio Adobe Experience Platform Identity ed è indicato anche come simbolo di identità nell’interfaccia utente di Experience Platform. Per ulteriori informazioni, visita la panoramica dello spazio dei nomi identità.
value Il valore id per lo spazio dei nomi. Questo si può trovare quando si utilizzano i namespace utilizzando l’ API del servizio Identity.

Genera il rapporto di sovrapposizione dei set di dati

Il rapporto di sovrapposizione dei set di dati fornisce visibilità nella composizione dell’archivio profili della tua organizzazione esponendo i set di dati che contribuiscono maggiormente al pubblico di destinazione (profili uniti). Oltre a fornire informazioni approfondite sui dati, questo rapporto può essere utile per ottimizzare l’utilizzo della licenza, ad esempio per impostare un TTL per alcuni set di dati.

Puoi generare il rapporto di sovrapposizione dei set di dati eseguendo una richiesta di GET all’ endpoint /previewsamplestatus/report/dataset/overlap .

Per istruzioni dettagliate su come generare il rapporto di sovrapposizione dei set di dati utilizzando la riga di comando o l’interfaccia utente Postman, consulta l’ esercitazione sulla generazione del rapporto di sovrapposizione dei set di dati.

Formato API

GET /previewsamplestatus/report/dataset/overlap
GET /previewsamplestatus/report/dataset/overlap?{QUERY_PARAMETERS}
Parametro Descrizione
date Specifica la data del rapporto da restituire. Se più rapporti sono stati eseguiti nella stessa data, viene restituito il rapporto più recente per tale data. Se un report non esiste per la data specificata, viene restituito un errore 404 (Non trovato). Se non viene specificata alcuna data, viene restituito il rapporto più recente. Formato: AAAA-MM-GG. Esempio: date=2024-12-31

Richiesta

La richiesta seguente utilizza il parametro date per restituire il report più recente per la data specificata.

curl -X GET \
  https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap?date=2021-12-29 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \

Risposta

Una richiesta corretta restituisce lo stato HTTP 200 (OK) e il rapporto di sovrapposizione del set di dati.

{
    "data": {
        "5d92921872831c163452edc8,5da7292579975918a851db57,5eb2cdc6fa3f9a18a7592a98": 123,
        "5d92921872831c163452edc8,5eb2cdc6fa3f9a18a7592a98": 454412,
        "5eeda0032af7bb19162172a7": 107
    },
    "reportTimestamp": "2021-12-29T19:55:31.147"
}
Proprietà Descrizione
data L'oggetto data contiene elenchi di set di dati separati da virgole e i rispettivi conteggi dei profili.
reportTimestamp La marca temporale del rapporto. Se durante la richiesta è stato fornito un parametro date , il rapporto restituito è relativo alla data fornita. Se non viene fornito alcun parametro date, viene restituito il rapporto più recente.

Interpretazione del rapporto di sovrapposizione del set di dati

I risultati del rapporto possono essere interpretati dai set di dati e dai conteggi dei profili nella risposta. Considera l'oggetto report di esempio data seguente:

  "5d92921872831c163452edc8,5da7292579975918a851db57,5eb2cdc6fa3f9a18a7592a98": 123,
  "5d92921872831c163452edc8,5eb2cdc6fa3f9a18a7592a98": 454412,
  "5eeda0032af7bb19162172a7": 107

Questo rapporto fornisce le seguenti informazioni:

  • Esistono 123 profili composti da dati provenienti dai seguenti set di dati: 5d92921872831c163452edc8, 5da7292579975918a851db57, 5eb2cdc6fa3f9a18a7592a98.
  • Esistono 454.412 profili composti da dati provenienti da questi due set di dati: 5d92921872831c163452edc8 e 5eb2cdc6fa3f9a18a7592a98.
  • Esistono 107 profili costituiti solo da dati del set di dati 5eeda0032af7bb19162172a7.
  • L’organizzazione dispone di un totale di 454.642 profili.

Genera il rapporto di sovrapposizione dello spazio dei nomi identità

Il rapporto di sovrapposizione dello spazio dei nomi di identità fornisce visibilità nella composizione dell’archivio profili della tua organizzazione esponendo i namespace di identità che contribuiscono maggiormente al pubblico di destinazione (profili uniti). Ciò include sia i namespace di identità standard forniti dall’Adobe, sia i namespace di identità personalizzati definiti dall’organizzazione.

Puoi generare il rapporto di sovrapposizione dello spazio dei nomi di identità eseguendo una richiesta di GET all’ endpoint /previewsamplestatus/report/namespace/overlap .

Formato API

GET /previewsamplestatus/report/namespace/overlap
GET /previewsamplestatus/report/namespace/overlap?{QUERY_PARAMETERS}
Parametro Descrizione
date Specifica la data del rapporto da restituire. Se più rapporti sono stati eseguiti nella stessa data, viene restituito il rapporto più recente per tale data. Se un report non esiste per la data specificata, viene restituito un errore 404 (Non trovato). Se non viene specificata alcuna data, viene restituito il rapporto più recente. Formato: AAAA-MM-GG. Esempio: date=2024-12-31

Richiesta

La richiesta seguente utilizza il parametro date per restituire il report più recente per la data specificata.

curl -X GET \
  https://platform.adobe.io/data/core/ups/previewsamplestatus/report/namespace/overlap?date=2021-12-29 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \

Risposta

Una richiesta corretta restituisce lo stato HTTP 200 (OK) e il rapporto di sovrapposizione dello spazio dei nomi di identità.

{
    "data": {
        "Email,crmid,loyal": 2,
        "ECID,Email,crmid": 7,
        "ECID,Email,mobilenr": 12,
        "AAID,ECID,loyal": 1,
        "mobilenr": 25,
        "AAID,ECID": 1508,
        "ECID,crmid": 1,
        "AAID,ECID,crmid": 2,
        "Email,crmid": 328,
        "CORE": 49,
        "AAID": 446,
        "crmid,loyal": 20988,
        "Email": 10904,
        "crmid": 249,
        "ECID,Email": 74,
        "Phone": 40,
        "Email,Phone,loyal": 48,
        "AAID,AVID,ECID": 85,
        "Email,loyal": 1002,
        "AAID,ECID,Email,Phone,crmid": 5,
        "AAID,ECID,Email,crmid,loyal": 23,
        "AAID,AVID,ECID,Email,crmid": 2,
        "AVID": 3,
        "AAID,ECID,Phone": 1,
        "loyal": 43,
        "ECID,Email,crmid,loyal": 6,
        "AAID,ECID,Email,Phone,crmid,loyal": 1,
        "AAID,ECID,Email": 2,
        "AAID,ECID,Email,crmid": 142,
        "AVID,ECID": 24,
        "ECID": 6565
    },
    "reportTimestamp": "2021-12-29T16:55:03.624"
}
Proprietà Descrizione
data L’oggetto data contiene elenchi separati da virgole con combinazioni univoche di codici dello spazio dei nomi di identità e dei rispettivi conteggi dei profili.
Codici dei namespace Il code è un formato breve per ciascun nome dello spazio dei nomi di identità. È possibile trovare una mappatura di ciascun code nel relativo name utilizzando l’ API del servizio Adobe Experience Platform Identity. Nell’interfaccia utente di Experience Platform, il simbolo code è anche denominato simbolo di identità . Per ulteriori informazioni, visita la panoramica dello spazio dei nomi identità.
reportTimestamp La marca temporale del rapporto. Se durante la richiesta è stato fornito un parametro date , il rapporto restituito è relativo alla data fornita. Se non viene fornito alcun parametro date, viene restituito il rapporto più recente.

Interpretazione del rapporto di sovrapposizione dello spazio dei nomi identità

I risultati del rapporto possono essere interpretati dalle identità e dai conteggi dei profili nella risposta. Il valore numerico di ogni riga indica quanti profili sono composti da quell’esatta combinazione di spazi dei nomi di identità standard e personalizzati.

Prendi in considerazione il seguente estratto dall'oggetto data :

  "AAID,ECID,Email,crmid": 142,
  "AVID,ECID": 24,
  "ECID": 6565

Questo rapporto fornisce le seguenti informazioni:

  • Sono disponibili 142 profili composti da AAID, ECID e Email identità standard, nonché da uno spazio dei nomi di identità crmid personalizzato.
  • Sono disponibili 24 profili composti da AAID e ECID spazi dei nomi di identità.
  • Esistono 6.565 profili che includono solo un'identità ECID.

Genera il report dei profili sconosciuti

Puoi ottenere un’ulteriore visibilità nella composizione dell’archivio profili dell’organizzazione tramite il rapporto dei profili sconosciuti. Un "profilo sconosciuto" si riferisce a qualsiasi profilo inattivo o non vincolato per un determinato periodo di tempo. Un profilo "unstitched" è un profilo che contiene un solo frammento di profilo, mentre un profilo "inattivo" è qualsiasi profilo che non ha aggiunto nuovi eventi per il periodo di tempo specificato. Il rapporto dei profili sconosciuti fornisce una suddivisione dei profili per un periodo di 7, 30, 60, 90 e 120 giorni.

Puoi generare il rapporto dei profili sconosciuti eseguendo una richiesta di GET all’endpoint /previewsamplestatus/report/unknownProfiles .

Formato API

GET /previewsamplestatus/report/unknownProfiles

Richiesta

La richiesta seguente restituisce il report dei profili sconosciuti.

curl -X GET \
  https://platform.adobe.io/data/core/ups/previewsamplestatus/report/unknownProfiles \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \

Risposta

Una richiesta corretta restituisce lo stato HTTP 200 (OK) e il rapporto dei profili sconosciuti.

NOTA

Ai fini della presente guida, il rapporto è stato troncato per includere solo i periodi di tempo "120days" e “7days”. Il rapporto completo sui profili sconosciuti fornisce una suddivisione dei profili per un periodo di 7, 30, 60, 90 e 120 giorni.

{
  "data": {
      "totalNumberOfProfiles": 63606,
      "totalNumberOfEvents": 130977,
      "unknownProfiles": {
          "120days": {
              "countOfProfiles": 1644,
              "eventsAssociated": 26824,
              "nsDistribution": {
                  "Email": {
                      "countOfProfiles": 18,
                      "eventsAssociated": 95
                  },
                  "loyal": {
                      "countOfProfiles": 26,
                      "eventsAssociated": 71
                  },
                  "ECID": {
                      "countOfProfiles": 1600,
                      "eventsAssociated": 26658
                  }
              }
          },
          "7days": {
              "countOfProfiles": 1782,
              "eventsAssociated": 29151,
              "nsDistribution": {
                  "Email": {
                      "countOfProfiles": 19,
                      "eventsAssociated": 97
                  },
                  "ECID": {
                      "countOfProfiles": 1734,
                      "eventsAssociated": 28591
                  },
                  "loyal": {
                      "countOfProfiles": 29,
                      "eventsAssociated": 463
                  }
              }
          }
      }
  },
  "reportTimestamp": "2025-08-25T22:14:55.186"
}
Proprietà Descrizione
data L'oggetto data contiene le informazioni restituite per il report dei profili sconosciuti.
totalNumberOfProfiles Numero totale di profili univoci nell’archivio profili. Equivale al conteggio del pubblico indirizzabile. Include profili noti e sconosciuti.
totalNumberOfEvents Numero totale di ExperienceEvents nell’archivio profili.
unknownProfiles Un oggetto contenente un raggruppamento di profili sconosciuti (non uniti e inattivi) per periodo di tempo. Il rapporto dei profili sconosciuti fornisce una suddivisione dei profili per periodi di tempo di 7, 30, 60, 90 e 120 giorni.
countOfProfiles Il conteggio dei profili sconosciuti per il periodo di tempo o il conteggio dei profili sconosciuti per lo spazio dei nomi.
eventsAssociated Il numero di ExperienceEvents per l'intervallo di tempo o il numero di eventi per lo spazio dei nomi.
nsDistribution Un oggetto contenente singoli namespace di identità con la distribuzione di profili ed eventi sconosciuti per ogni namespace. Nota: Aggiungendo insieme il totale countOfProfiles per ogni namespace di identità nell'oggetto nsDistribution è uguale a countOfProfiles per il periodo di tempo. Lo stesso vale per eventsAssociated per namespace e per il totale eventsAssociated per periodo di tempo.
reportTimestamp La marca temporale del rapporto.

Interpretazione del rapporto sui profili sconosciuti

I risultati del rapporto possono fornire informazioni sul numero di profili inattivi e non uniti di cui dispone l’organizzazione all’interno del relativo archivio profili.

Prendi in considerazione il seguente estratto dall'oggetto data :

  "7days": {
    "countOfProfiles": 1782,
    "eventsAssociated": 29151,
    "nsDistribution": {
      "Email": {
        "countOfProfiles": 19,
        "eventsAssociated": 97
      },
      "ECID": {
        "countOfProfiles": 1734,
        "eventsAssociated": 28591
      },
      "loyal": {
        "countOfProfiles": 29,
        "eventsAssociated": 463
      }
    }
  }

Questo rapporto fornisce le seguenti informazioni:

  • Esistono 1.782 profili che contengono un solo frammento di profilo e non hanno nuovi eventi negli ultimi sette giorni.
  • Sono presenti 29.151 ExperienceEvents associati ai 1.782 profili sconosciuti.
  • Sono presenti 1.734 profili sconosciuti che contengono un singolo frammento di profilo dallo spazio dei nomi identità di ECID.
  • Sono presenti 28.591 eventi associati ai 1.734 profili sconosciuti che contengono un singolo frammento di profilo dallo spazio dei nomi identità di ECID.

Passaggi successivi

Ora che sai come visualizzare in anteprima i dati di esempio nell’archivio profili ed eseguire più rapporti sui dati, puoi anche utilizzare gli endpoint della stima e dell’anteprima dell’API del servizio di segmentazione per visualizzare informazioni di riepilogo relative alle definizioni dei segmenti. Queste informazioni consentono di isolare il pubblico previsto nel segmento. Per ulteriori informazioni sulle operazioni con le anteprime e le stime dei segmenti utilizzando l'API di segmentazione, visita la guida all'anteprima e alla stima degli endpoint.

In questa pagina