Generare il rapporto di sovrapposizione del set di dati

Il rapporto di sovrapposizione dei set di dati fornisce visibilità sulla composizione dell'archivio Profile della tua organizzazione esponendo i set di dati che contribuiscono maggiormente al pubblico indirizzabile (profili).

Oltre a fornire informazioni approfondite sui dati, questo rapporto può aiutarti a intraprendere azioni per ottimizzare l’utilizzo della licenza, ad esempio impostare un limite alla durata di alcuni dati.

Questo tutorial illustra i passaggi necessari per generare il report di sovrapposizione dei set di dati utilizzando l'API Real-Time Customer Profile e interpretare i risultati per la tua organizzazione.

Introduzione

Per utilizzare le API di Adobe Experience Platform, devi prima completare l'esercitazione di autenticazione per raccogliere i valori necessari per le intestazioni richieste. Per ulteriori informazioni sulle API Experience Platform, consulta la guida introduttiva alle API Platform.

Le intestazioni richieste per tutte le chiamate API in questa esercitazione sono:

  • Authorization: Bearer {ACCESS_TOKEN}: l'intestazione Authorization richiede un token di accesso preceduto dalla parola Bearer. È necessario generare un nuovo valore del token di accesso ogni 24 ore.
  • x-api-key: {API_KEY}: API Key è anche noto come Client ID ed è un valore che deve essere generato una sola volta.
  • x-gw-ims-org-id: {ORG_ID}: l'ID organizzazione deve essere generato una sola volta.

Dopo aver completato il tutorial di autenticazione e raccolto i valori per le intestazioni richieste, sei pronto per iniziare a effettuare chiamate all’API cliente in tempo reale.

Genera report di sovrapposizione set di dati utilizzando la riga di comando

Se si ha familiarità con l'utilizzo della riga di comando, è possibile utilizzare la seguente richiesta cURL per generare il report di sovrapposizione del set di dati eseguendo una richiesta GET a /previewsamplestatus/report/dataset/overlap.

Richiesta

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

curl -X GET \
  https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap?date=2021-04-19 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
Parametro
Descrizione
date
Specifica la data del rapporto da restituire. Se in tale data sono stati eseguiti più rapporti, viene restituito il rapporto più recente per tale data. Se non esiste un rapporto per la data specificata, viene restituito un errore di stato HTTP 404 (Non trovato). Se non viene specificata alcuna data, viene restituito il rapporto più recente. Formato: AAAA-MM-GG. Esempio: date=2024-12-31

Risposta

In caso di esito positivo, la richiesta restituisce lo stato HTTP 200 (OK) e il rapporto di sovrapposizione dei set di dati. Il report include un oggetto data, contenente elenchi separati da virgole di set di dati e il rispettivo conteggio dei profili. Per informazioni dettagliate su come leggere il report, vedere la sezione relativa all'interpretazione dei dati del report di sovrapposizione dei set di dati più avanti in questa esercitazione.

{
    "data": {
        "5d92921872831c163452edc8,5da7292579975918a851db57,5eb2cdc6fa3f9a18a7592a98": 123,
        "5d92921872831c163452edc8,5eb2cdc6fa3f9a18a7592a98": 454412,
        "5eeda0032af7bb19162172a7": 107
    },
    "reportTimestamp": "2021-04-19T19:55:31.147"
}

Genera report di sovrapposizione set di dati tramite Postman

Postman è una piattaforma collaborativa per lo sviluppo API ed è utile per visualizzare le chiamate API. Può essere scaricato gratuitamente dal sito Web Postman e fornisce un'interfaccia utente di facile utilizzo per l'esecuzione di chiamate API. Le schermate seguenti utilizzano l’interfaccia di Postman.

Richiesta

La procedura seguente illustra come richiedere il rapporto di sovrapposizione dei set di dati utilizzando Postman:

  • Dal menu a discesa, seleziona GET come tipo di richiesta.

  • Immettere le intestazioni richieste nella colonna KEY:

    • Authorization
    • x-api-key
    • x-gw-ims-org-id
  • Immettere i valori generati durante l'autenticazione nella colonna VALUE, sostituendo le parentesi graffe ({{ }}) e tutto il contenuto all'interno di esse.

  • Immettere il percorso della richiesta con o senza il parametro facoltativo date:
    https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap
    oppure
    https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap?date=YYYY-MM-DD

Parametro
Descrizione
date
Specifica la data del rapporto da restituire. Se in tale data sono stati eseguiti più rapporti, viene restituito il rapporto più recente per tale data. Se non esiste un rapporto per la data specificata, viene restituito un errore di stato HTTP 404 (Non trovato). Se non viene specificata alcuna data, viene restituito il rapporto più recente.
Formato: AAAA-MM-GG. Esempio: date=2024-12-31

Dopo aver completato il tipo di richiesta, le intestazioni, i valori e il percorso, selezionare Invia per inviare la richiesta API e generare il report.

Risposta

In caso di esito positivo, la richiesta restituisce lo stato HTTP 200 (OK) e il rapporto di sovrapposizione dei set di dati. Il report include un oggetto data, contenente elenchi separati da virgole di set di dati e il rispettivo conteggio dei profili. Per informazioni dettagliate su come leggere il report, vedere la sezione sull'interpretazione dei dati del report di sovrapposizione dei set di dati.

Interpretare i dati del rapporto di sovrapposizione del set di dati interpret-the-report

Il rapporto di sovrapposizione dei set di dati generato fornisce una marca temporale che mostra la data e l’ora del rapporto e un oggetto dati che include combinazioni univoche di ID di set di dati come elenchi separati da virgole. Le sezioni seguenti forniscono informazioni aggiuntive relative ai componenti del rapporto.

Timestamp del rapporto

reportTimestamp corrisponde alla data specificata nella richiesta API oppure, se non è stata specificata alcuna data, alla marca temporale del rapporto più recente.

Elenco degli ID dei set di dati

L'oggetto data include combinazioni univoche di ID di set di dati come elenchi separati da virgole con il rispettivo conteggio dei profili per tale combinazione di set di dati.

NOTE
La somma di tutti i conteggi di profili associati a ogni riga del rapporto di sovrapposizione dei set di dati deve corrispondere al numero totale di profili nell’organizzazione.

Per interpretare i risultati del rapporto, considera l’esempio seguente:

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

Questo rapporto fornisce le seguenti informazioni:

  • Sono presenti 123 profili composti da dati provenienti dai seguenti set di dati: 5d92921872831c163452edc8, 5da7292579975918a851db57, 5eb2cdc6fa3f9a18a7592a98.
  • Sono presenti 454.412 profili composti da dati provenienti da questi due set di dati: 5d92921872831c163452edc8 e 5eb2cdc6fa3f9a18a7592a98.
  • Esistono 107 profili composti solo da dati del set di dati 5eeda0032af7bb19162172a7.
  • Nell’organizzazione sono presenti in totale 454.642 profili.

Passaggi successivi

Dopo aver completato questa esercitazione, ora puoi generare il rapporto di sovrapposizione dei set di dati utilizzando l’API Profilo cliente in tempo reale. Per ulteriori informazioni sull'utilizzo dei dati del profilo sia nell'API che nell'interfaccia utente di Experience Platform, consulta la documentazione panoramica profilo.

recommendation-more-help
54550d5b-f1a1-4065-a394-eb0f23a2c38b