Scaricare i punteggi in Customer AI

Questo documento funge da guida per il download dei punteggi per Customer AI.

Introduzione

Customer AI consente di scaricare i punteggi in formato file Parquet. Questa esercitazione richiede di aver letto e completato il download dei punteggi di Customer AI nella sezione guida introduttiva guida.

Inoltre, per accedere ai punteggi per Customer AI, è necessario che sia disponibile un’istanza di servizio con uno stato di esecuzione riuscito. Per creare una nuova istanza di servizio, visita Configurazione di un’istanza di Customer AI. Se hai creato di recente un'istanza di servizio ed è ancora in fase di formazione e valutazione, ti preghiamo di consentire 24 ore per il completamento dell'esecuzione.

Al momento, sono disponibili due modi per scaricare i punteggi di Customer AI:

  1. Se desideri scaricare i punteggi a livello individuale e/o non hai abilitato Profilo cliente in tempo reale, inizia con ricerca dell’ID set di dati.
  2. Se il profilo è abilitato e desideri scaricare i segmenti configurati utilizzando Customer AI, passa a scaricare un segmento configurato con Customer AI.

Trova l’ID del set di dati

Nell’istanza del servizio per informazioni di Customer AI, fai clic sul pulsante Altre azioni menu a discesa nella navigazione in alto a destra, quindi seleziona Punteggi di accesso.

altre azioni

Viene visualizzata una nuova finestra di dialogo contenente un collegamento alla documentazione del download dei punteggi e l’ID del set di dati per l’istanza corrente. Copia l’ID del set di dati negli Appunti e procedi al passaggio successivo.

ID set di dati

Recupera l'ID batch

Utilizzando l’ID del set di dati del passaggio precedente, devi effettuare una chiamata all’API del catalogo per recuperare un ID batch. Per questa chiamata API vengono utilizzati parametri di query aggiuntivi per restituire l’ultimo batch di successo anziché un elenco di batch appartenenti all’organizzazione. Per restituire batch aggiuntivi, aumenta il numero del parametro della query dei limiti alla quantità desiderata da restituire. Per ulteriori informazioni sui tipi di parametri di query disponibili, consulta la guida su filtraggio dei dati del catalogo utilizzando i parametri di query.

Formato API

GET /batches?&dataSet={DATASET_ID}&createdClient=acp_foundation_push&status=success&orderBy=desc:created&limit=1
Parametro Descrizione
{DATASET_ID} L’ID del set di dati disponibile nella finestra di dialogo "Access Scores" (Punteggi di accesso).

Richiesta

curl -X GET 'https://platform.adobe.io/data/foundation/catalog/batches?dataSet=5cd9146b31dae914b75f654f&createdClient=acp_foundation_push&status=success&orderBy=desc:created&limit=1' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Risposta

Una risposta corretta restituisce un payload contenente un oggetto ID batch. In questo esempio, il valore chiave per l'oggetto restituito è l'ID batch 01E5QSWCAASFQ054FNBKYV6TIQ. Copia il tuo ID batch da utilizzare nella prossima chiamata API.

{
    "01E5QSWCAASFQ054FNBKYV6TIQ": {
        "status": "success",
        "tags": {
            "Tags": [ ... ],
        },
        "relatedObjects": [
            {
                "type": "dataSet",
                "id": "5cd9146b31dae914b75f654f"
            }
        ],
        "id": "01E5QSWCAASFQ054FNBKYV6TIQ",
        "externalId": "01E5QSWCAASFQ054FNBKYV6TIQ",
        "replay": {
            "predecessors": [
                "01E5N7EDQQP4JHJ93M7C3WM5SP"
            ],
            "reason": "Replacing for 2020-04-09",
            "predecessorListingType": "IMMEDIATE"
        },
        "inputFormat": {
            "format": "parquet"
        },
        "imsOrg": "412657965Y566A4A0A495D4A@AdobeOrg",
        "started": 1586715571808,
        "metrics": {
            "partitionCount": 1,
            "outputByteSize": 2380339,
            "inputFileCount": -1,
            "inputByteSize": 2381007,
            "outputRecordCount": 24340,
            "outputFileCount": 1,
            "inputRecordCount": 24340
        },
        "completed": 1586715582735,
        "created": 1586715571217,
        "createdClient": "acp_foundation_push",
        "createdUser": "sensei_exp_attributionai@AdobeID",
        "updatedUser": "acp_foundation_dataTracker@AdobeID",
        "updated": 1586715583582,
        "version": "1.0.5"
    }
}

Recupera la prossima chiamata API con il tuo ID batch

Una volta ottenuto l’ID batch, puoi effettuare una nuova richiesta GET a /batches. La richiesta restituisce un collegamento utilizzato come richiesta API successiva.

Formato API

GET batches/{BATCH_ID}/files
Parametro Descrizione
{BATCH_ID} ID batch recuperato nel passaggio precedente recuperare l'ID batch.

Richiesta

Utilizzando il tuo ID batch, effettua la seguente richiesta.

curl -X GET 'https://platform.adobe.io/data/foundation/export/batches/035e2520-5e69-11ea-b624-51evfeba55d1/files' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Risposta

Una risposta corretta restituisce un payload contenente un _links oggetto. All'interno di _links un oggetto href con una nuova chiamata API come valore. Copia questo valore per passare al passaggio successivo.

{
    "data": [
        {
            "dataSetFileId": "035e2520-5e69-11ea-b624-51ecfeba55d0-1",
            "dataSetViewId": "5e3b2fe3fe4b9f18a8b7a3db",
            "version": "1.0.0",
            "created": "1583361894479",
            "updated": "1583361894479",
            "isValid": false,
            "_links": {
                "self": {
                    "href": "https://platform.adobe.io:443/data/foundation/export/files/035e2520-5e69-11ea-b624-51ecfeba55d0-1"
                }
            }
        }
    ],
    "_page": {
        "limit": 100,
        "count": 1
    }
}

Recupera i file

Utilizzo della href valore ottenuto nel passaggio precedente come chiamata API, effettua una nuova richiesta GET per recuperare la directory file.

Formato API

GET files/{DATASETFILE_ID}
Parametro Descrizione
{DATASETFILE_ID} L'ID dataSetFile viene restituito nella variabile href dal passaggio precedente. È inoltre accessibile nella data matrice sotto il tipo di oggetto dataSetFileId.

Richiesta

curl -X GET 'https://platform.adobe.io:443/data/foundation/export/files/035e2520-5e69-11ea-b624-51ecfeba55d0-1' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Risposta

La risposta contiene un array di dati che può avere una singola voce o un elenco di file appartenenti a tale directory. L'esempio seguente contiene un elenco di file ed è stato condensato per la leggibilità. In questo scenario, devi seguire l’URL di ciascun file per accedere al file .

{
    "data": [
        {
            "name": "part-00000-tid-7597930103898538622-a25f1890-efa9-40eb-a2cb-1b378e93d582-528-1-c000.snappy.parquet",
            "length": "16214531",
            "_links": {
                "self": {
                    "href": "https://platform.adobe.io:443/data/foundation/export/files/035e2520-5e69-11ea-b624-51ecfeba55d0-1?path=part-00000-tid-7597930103898538622-a25f1890-efa9-40eb-a2cb-1b378e93d582-528-1-c000.snappy.parquet"
                }
            }
        },
        {
            "name": "...",
            "length": "16235375",
            "_links": {
                "self": {
                    "href": "..."
                }
            }
        }
    ],
    "_page": {
        "limit": 100,
        "count": 100
    },
    "_links": {
        "next": {
            "href": "..."
        },
        "page": {
            "href": "...",
            "templated": true
        }
    }
}
Parametro Descrizione
_links.self.href L’URL della richiesta di GET utilizzato per scaricare un file nella directory.

Copia il href per qualsiasi oggetto file nel data array, quindi passare al passaggio successivo.

Scaricare i dati del file

Per scaricare i dati del file, effettua una richiesta di GET al "href" valore copiato nel passaggio precedente recupero dei file.

NOTA

Se effettui questa richiesta direttamente nella riga di comando, potrebbe essere richiesto di aggiungere un output dopo le intestazioni della richiesta. Nell'esempio di richiesta seguente viene utilizzato --output {FILENAME.FILETYPE}.

Formato API

GET files/{DATASETFILE_ID}?path={FILE_NAME}
Parametro Descrizione
{DATASETFILE_ID} L'ID dataSetFile viene restituito nella variabile href da un passaggio precedente.
{FILE_NAME} Nome del file.

Richiesta

curl -X GET 'https://platform.adobe.io:443/data/foundation/export/files/035e2520-5e69-11ea-b624-51ecfeba55d0-1?path=part-00000-tid-7597930103898538622-a25f1890-efa9-40eb-a2cb-1b378e93d582-528-1-c000.snappy.parquet' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -O 'filename.parquet'
SUGGERIMENTO

Assicurati di essere nella directory o nella cartella corretta in cui desideri salvare il file prima di effettuare la richiesta GET.

Risposta

La risposta scarica il file richiesto nella directory corrente. In questo esempio il nome del file è "filename.parquet".

Terminale

Scaricare un segmento configurato con Customer AI

Un modo alternativo per scaricare i dati del punteggio è quello di esportare il pubblico in un set di dati. Dopo che un processo di segmentazione è stato completato correttamente (il valore di status attribute is "SUCCEEDED"), puoi esportare il pubblico in un set di dati a cui è possibile accedere e su cui agisce. Per ulteriori informazioni sulla segmentazione, visita il panoramica sulla segmentazione.

IMPORTANTE

Per utilizzare questo metodo di esportazione, è necessario abilitare Profilo cliente in tempo reale per il set di dati.

La esportare un segmento nella guida alla valutazione dei segmenti sono descritti i passaggi necessari per esportare un set di dati per il pubblico. La guida illustra e fornisce esempi di quanto segue:

  • Creare un set di dati di destinazione: Crea il set di dati per contenere i membri del pubblico.
  • Generare profili di pubblico nel set di dati: Popolare il set di dati con i singoli profili XDM in base ai risultati di un processo di segmento.
  • Monitorare l’avanzamento dell’esportazione: Controlla lo stato attuale del processo di esportazione.
  • Leggi i dati sul pubblico: Recupera i singoli profili XDM risultanti che rappresentano i membri del pubblico.

Passaggi successivi

Questo documento descrive i passaggi necessari per scaricare i punteggi di Customer AI. Ora puoi continuare a navigare nell’altro Intelligent Services e le guide che vengono offerte.

In questa pagina