Scaricare i punteggi in Attribution AI

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

Introduzione

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

Inoltre, per accedere ai punteggi per Attribution AI, è necessario che sia disponibile un’istanza di servizio con uno stato di esecuzione riuscito. Per creare una nuova istanza del servizio, visita la guida utente Attribution 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.

Trova l’ID del set di dati

Nell'istanza del servizio per informazioni Attribution AI, fai clic sul menu a discesa Altre azioni nella navigazione in alto a destra, quindi seleziona Punti 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 di query limit alla quantità desiderata da restituire. Per ulteriori informazioni sui tipi di parametri di query disponibili, visita la guida sul 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=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: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Risposta

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

NOTA

Nella risposta seguente l'oggetto tags è stato riformato per garantire leggibilità.

{
    "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 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} L'ID batch recuperato nel passaggio precedente recupera l'ID batch.

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: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Risposta

Una risposta corretta restituisce un payload contenente un oggetto _links . All’interno dell’oggetto _links è presente una chiamata href con un nuovo valore API. 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
    }
}

Recupera i file

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}
Parametro Descrizione
{DATASETFILE_ID} L'ID dataSetFile viene restituito nel valore href dal passaggio precedente. È accessibile anche nella matrice data sotto il tipo di oggetto dataSetFileId.

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: {IMS_ORG}' \
  -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-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
    }
}
Parametro Descrizione
_links.self.href L’URL della richiesta di GET utilizzato per scaricare un file nella directory.

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, effettua una richiesta di GET al valore "href" 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. L’esempio di richiesta seguente utilizza --output {FILENAME.FILETYPE}.

Formato API

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

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: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -O 'file.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 è "file.parquet".

Terminale

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

Passaggi successivi

Questo documento descrive i passaggi necessari per scaricare i punteggi delle Attribution AI. Per ulteriori informazioni sulle uscite dei punteggi, visita la documentazione Attribution AI input and output .

Accesso ai punteggi utilizzando il Snowflake

IMPORTANTE

Per ulteriori informazioni sull’accesso ai punteggi utilizzando il Snowflake, contatta attributionai-support@adobe.com .

Puoi accedere ai punteggi aggregati delle Attribution AI tramite il Snowflake. Al momento, è necessario inviare un messaggio e-mail al supporto di Adobe all'indirizzo attributionai-support@adobe.com per impostare e ricevere le credenziali al tuo account lettore per Snowflake.

Una volta che il supporto di Adobe ha elaborato la richiesta, ti viene fornito un URL per l’account del lettore al Snowflake e le credenziali corrispondenti di seguito:

  • URL Snowflake
  • Nome utente
  • Password
NOTA

L'account del lettore consente di eseguire query sui dati utilizzando client sql, fogli di lavoro e soluzioni BI che supportano il connettore JDBC.

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

Ricerca dello schema nel Snowflake

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

Fogli di lavoro e navigazione

Quindi, fai clic su Seleziona schema nell'angolo in alto a destra dello schermo. Nel pover visualizzato, verificare di aver selezionato il database corretto. Quindi, fai clic sul menu a discesa Schema e seleziona uno degli schemi elencati. È possibile eseguire query dirette dalle tabelle dei punteggi elencate sotto lo schema selezionato.

trovare uno schema

Collegamento di PowerBI al Snowflake (facoltativo)

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

Innanzitutto, nella casella Server, digita l’URL del Snowflake. Quindi, in Warehouse, digitare "XSMALL". Quindi, digita il tuo nome utente e la tua password.

esempio di POWERBI

Dopo aver stabilito la connessione, seleziona il database di Snowflake, quindi seleziona lo schema appropriato. Ora è possibile caricare tutte le tabelle.

In questa pagina