Genera il rapporto di sovrapposizione dei set di dati

Il rapporto di sovrapposizione del set di dati fornisce visibilità nella composizione dell’organizzazione Profile archivia esponendo i set di dati che contribuiscono maggiormente al pubblico di destinazione (profili).

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

Questa esercitazione descrive i passaggi necessari per generare il rapporto di sovrapposizione del set di dati utilizzando Real-time Customer Profile API e interpreta i risultati per la tua organizzazione.

Introduzione

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

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

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

Dopo aver completato l’esercitazione sull’autenticazione e aver raccolto i valori per le intestazioni richieste, puoi iniziare a effettuare chiamate all’API del cliente in tempo reale.

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

Se hai familiarità con l’utilizzo della riga di comando, puoi utilizzare la seguente richiesta cURL per generare il rapporto di sovrapposizione del set di dati eseguendo una richiesta GET a /previewsamplestatus/report/dataset/overlap.

Richiesta

La richiesta seguente utilizza il 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-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 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 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

Una richiesta corretta restituisce lo stato HTTP 200 (OK) e il rapporto di sovrapposizione del set di dati. Il rapporto include data , contenente elenchi di set di dati separati da virgole e il rispettivo conteggio dei profili. Per informazioni dettagliate su come leggere il rapporto, consulta la sezione interpretazione dei dati del rapporto di sovrapposizione del 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 dei set di dati utilizzando Postman

Postman è una piattaforma collaborativa per lo sviluppo delle 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 seguenti schermate utilizzano l’interfaccia Postman .

Richiesta

Per richiedere il rapporto di sovrapposizione dei set di dati tramite Postman, completa i seguenti passaggi:

  • Utilizzando il menu a discesa , seleziona GET come tipo di richiesta.
  • Immetti le intestazioni richieste nel KEY colonna:
    • Authorization
    • x-api-key
    • x-gw-ims-org-id
  • Immetti i valori generati durante l'autenticazione nel VALUE , sostituendo le parentesi graffe ({{ }}) e qualsiasi contenuto tra parentesi graffe.
  • Immetti il percorso della richiesta con o senza l'opzione opzionale date parametro:
    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 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 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

Al termine del tipo di richiesta, delle intestazioni, dei valori e del percorso, seleziona Invia per inviare la richiesta API e generare il rapporto.

Risposta

Una richiesta corretta restituisce lo stato HTTP 200 (OK) e il rapporto di sovrapposizione del set di dati. Il rapporto include data , contenente elenchi di set di dati separati da virgole e il rispettivo conteggio dei profili. Per informazioni dettagliate su come leggere il rapporto, consulta la sezione interpretazione dei dati del rapporto di sovrapposizione del set di dati.

Interpretare i dati del rapporto di sovrapposizione del set di dati

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 dei set di dati come elenchi separati da virgole. Le sezioni seguenti forniscono informazioni aggiuntive relative ai componenti del rapporto.

Timestamp rapporto

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

Elenco degli ID dei set di dati

La data l'oggetto include combinazioni univoche di ID di set di dati come elenchi separati da virgole con il rispettivo conteggio di profilo per quella combinazione di set di dati.

NOTA

La somma di tutti i conteggi di profilo associati a ciascuna 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:

  • 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.
  • Ci sono 107 profili che sono costituiti solo da dati provenienti da un set di dati 5eeda0032af7bb19162172a7.
  • L’organizzazione dispone di un totale di 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 di profilo sia nell’API che nell’interfaccia utente di Experience Platform, consulta la sezione Documentazione sulla panoramica del profilo.

In questa pagina