Scaricare i punteggi nell’Attribution AI

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

Introduzione

Attribution AI consente di scaricare i punteggi nel formato di file Parquet. Questo tutorial richiede di aver letto e terminato la sezione download dei punteggi di Attribution AI nella guida introduttiva.

Inoltre, per accedere ai punteggi di Attribution AI, è necessario disporre di un’istanza del servizio con uno stato di esecuzione corretto. Per creare una nuova istanza del servizio, visita la guida utente di Attribution AI. Se di recente è stata creata un’istanza del servizio per la quale si sta ancora eseguendo l’apprendimento e il punteggio, attendi 24 ore per il completamento dell’esecuzione.

Trovare l’ID del set di dati dataset-id

Nell'istanza del servizio per approfondimenti Attribution AI, fai clic sul menu a discesa Altre azioni nell'area di navigazione in alto a destra, quindi seleziona Punteggi di accesso.

Viene visualizzata una nuova finestra di dialogo contenente un collegamento alla documentazione relativa al 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.

Recuperare l’ID batch retrieve-your-batch-id

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 riuscito invece di un elenco di batch appartenenti alla tua organizzazione. Per restituire batch aggiuntivi, aumentare il numero del parametro di query limit fino alla quantità desiderata. Per ulteriori informazioni sui tipi di parametri di query disponibili, visitare la guida su filtraggio dei dati del catalogo tramite parametri di query.

Formato API

GET /batches?&dataSet={DATASET_ID}&createdClient=acp_foundation_push&status=success&orderBy=desc:created&limit=1

Richiesta

curl -X GET 'https://platform.adobe.io/data/foundation/catalog/batches?&dataSet=5e8f81ce7a4ecb18a8d25b22&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

In caso di esito positivo, la risposta restituisce un payload contenente un oggetto ID batch. In questo esempio, il valore Key dell'oggetto restituito è l'ID batch 01E5QSWCAASFQ054FNBKYV6TIQ. Copia il tuo ID batch da utilizzare nella chiamata API successiva.

{
    "01E5QSWCAASFQ054FNBKYV6TIQ": {
        "status": "success",
        "tags": {
            "Tags": [ ... ],
        },
        "relatedObjects": [
            {
                "type": "dataSet",
                "id": "5e8f81cf7a4ecb28a8d85b22"
            }
        ],
        "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 chiamata API successiva con il tuo ID batch retrieve-the-next-api-call-with-your-batch-id

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

Richiesta

Utilizzando il tuo ID batch, effettua la seguente richiesta.

curl -X GET 'https://platform.adobe.io/data/foundation/export/batches/01E5QSWCAASFQ054FNBKYV6TIQ/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 oggetto _links. All'interno dell'oggetto _links è presente un href con una nuova chiamata API come valore. Copia questo valore per passare al passaggio successivo.

{
    "data": [
        {
            "dataSetFileId": "01E5QSWCAASFQ054FNBKYV6TIQ-1",
            "dataSetViewId": "5e8f81cf7a4ecb28a8d85b22",
            "version": "1.0.0",
            "created": "1586715582571",
            "updated": "1586715582571",
            "isValid": false,
            "_links": {
                "self": {
                    "href": "https://platform.adobe.io:443/data/foundation/export/files/01E5QSWCXXYFQ054FNBKYV2BAQ-1"
                }
            }
        }
    ],
    "_page": {
        "limit": 100,
        "count": 1
    }
}

Recuperare i file retrieving-your-files

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

Formato API

GET files/{DATASETFILE_ID}

Richiesta

curl -X GET 'https://platform.adobe.io/data/foundation/export/files/01E5QSWCAASFQ054FNBKYV6TIQ-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 abbreviato per migliorarne la leggibilità. In questo caso, per accedere al file devi seguire l’URL di ciascun file.

{
    "data": [
        {
            "name": "part-00000-tid-5614147572541837832-908bd66a-d856-47fe-b7da-c8e7d22a4097-1370467-1.c000.snappy.parquet",
            "length": "2380211",
            "_links": {
                "self": {
                    "href": "https://platform.adobe.io:443/data/foundation/export/files/01E5QSWCXXYFQ054FNBKYV2BAQ-1?path=part-00000-trd-5714147572541837832-938bd66a-d556-41fe-b7da-c8e7d22a4097-1320467-1.c000.snappy.parquet"
                }
            }
        }
    ],
    "_page": {
        "limit": 100,
        "count": 1
    }
}

Copiare il valore href per qualsiasi oggetto file nell'array data, quindi procedere al passaggio successivo.

Scaricare i dati del file

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

Formato API

GET files/{DATASETFILE_ID}?path={FILE_NAME}

Richiesta

curl -X GET 'https://platform.adobe.io:443/data/foundation/export/files/01E5QSWCXXYFQ054FNBKYV2BAQ-1?path=part-00000-trd-5714147572541837832-938bd66a-d556-41fe-b7da-c8e7d22a4097-1320467-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 'file.parquet'

Risposta

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

I punteggi scaricati saranno in formato Parquet e per visualizzarli sarà necessario un lettore con shell Spark o Parquet. Per la visualizzazione del punteggio non elaborato, puoi utilizzare gli strumenti Apache Parquet. Gli strumenti Parquet possono analizzare i dati con Spark.

Passaggi successivi

In questo documento sono descritti i passaggi necessari per scaricare i punteggi delle Attribution AI. Per ulteriori informazioni sugli output di punteggio, visita la documentazione Input e output di IA per l'attribuzione.

Accesso ai punteggi con il Snowflake

Puoi accedere ai punteggi aggregati delle Attribution AI tramite il Snowflake. Al momento, devi inviare un messaggio e-mail al supporto degli Adobi all’indirizzo attributionai-support@adobe.com per configurare e ricevere le credenziali per il Snowflake per il tuo account di lettore.

Una volta elaborata la richiesta, l’Adobe di supporto ti fornirà l’URL dell’account di lettura da Snowflake e le credenziali corrispondenti:

Una volta ottenute le credenziali e l’URL, puoi eseguire una query sulle tabelle modello, aggregate per data di contatto o data di conversione.

Ricerca dello schema nel Snowflake

Utilizzando le credenziali fornite, accedi al Snowflake. Fai clic sulla scheda Fogli di lavoro nell'area di navigazione principale in alto a sinistra, quindi passa alla directory del database nel pannello a sinistra.

Fare clic su Seleziona schema nell'angolo superiore destro della schermata. Nel popover visualizzato, verificare che sia selezionato il database corretto. Quindi, fai clic sul menu a discesa Schema e seleziona uno degli schemi elencati. Puoi eseguire query dirette dalle tabelle di punteggio elencate nello schema selezionato.

Collegamento di Power BI al Snowflake (opzionale)

Le credenziali di Snowflake possono essere utilizzate per impostare una connessione tra Power BI Desktop e i database di Snowflake.

Digitare innanzitutto l'URL del Snowflake nella casella Server. Successivamente, in Warehouse, digitare "XSMALL". Quindi, digita il nome utente e la password.

Una volta stabilita la connessione, selezionare il database di Snowflake, quindi lo schema appropriato. È ora possibile caricare tutte le tabelle.