Descargar puntuaciones en Attribution AI

Este documento sirve como guía para descargar puntuaciones para Attribution AI.

Primeros pasos

Attribution AI le permite descargar puntuaciones en el formato de archivo Parquet. Este tutorial requiere que haya leído y terminado la sección de descargas de puntuaciones de Attribution AI en la guía introducción.

Además, para acceder a las puntuaciones de Attribution AI, debe tener disponible una instancia de servicio con un estado de ejecución correcto. Para crear una nueva instancia de servicio, visite la guía del usuario de Attribution AI. Si ha creado recientemente una instancia de servicio y sigue siendo de formación y puntuación, espere 24 horas para que termine de ejecutarse.

Búsqueda del ID del conjunto de datos

En la instancia de servicio para obtener información sobre las Attribution AI, haga clic en el menú desplegable Más acciones en la navegación superior derecha y, a continuación, seleccione Puntuaciones de acceso.

más acciones

Aparece un nuevo cuadro de diálogo que contiene un vínculo a la documentación de descarga de puntuaciones y el ID del conjunto de datos para la instancia actual. Copie el ID del conjunto de datos en el portapapeles y continúe con el paso siguiente.

ID de conjunto de datos

Recuperar el ID de lote

Con el ID del conjunto de datos del paso anterior, debe realizar una llamada a la API del catálogo para recuperar un ID de lote. Para esta llamada de API se utilizan parámetros de consulta adicionales para devolver el último lote correcto en lugar de una lista de lotes pertenecientes a su organización. Para devolver lotes adicionales, aumente el número del parámetro de consulta limit a la cantidad que desee que se devuelva. Para obtener más información sobre los tipos de parámetros de consulta disponibles, consulte la guía sobre el filtrado de datos del catálogo utilizando parámetros de consulta.

Formato de API

GET /batches?&dataSet={DATASET_ID}&createdClient=acp_foundation_push&status=success&orderBy=desc:created&limit=1
Parámetro Descripción
{DATASET_ID} ID del conjunto de datos disponible en el cuadro de diálogo "Puntuaciones de acceso".

Solicitud

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}'

Respuesta

Una respuesta correcta devuelve una carga útil que contiene un objeto de ID de lote. En este ejemplo, el valor de clave del objeto devuelto es el ID de lote 01E5QSWCAASFQ054FNBKYV6TIQ. Copie su ID de lote para utilizarlo en la siguiente llamada de API.

NOTA

La siguiente respuesta ha tenido el objeto tags reforzado para facilitar la lectura.

{
    "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"
    }
}

Recupere la siguiente llamada de API con su ID de lote

Una vez que tenga su ID de lote, podrá realizar una nueva solicitud de GET a /batches. La solicitud devuelve un vínculo que se utiliza como la siguiente solicitud de API.

Formato de API

GET batches/{BATCH_ID}/files
Parámetro Descripción
{BATCH_ID} El ID de lote que se recuperó en el paso anterior recupere su ID de lote.

Solicitud

Con su propio ID de lote, realice la siguiente solicitud.

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}'

Respuesta

Una respuesta correcta devuelve una carga útil que contiene un objeto _links. Dentro del objeto _links hay un href con una nueva llamada de API como valor. Copie este valor para continuar con el paso siguiente.

{
    "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
    }
}

Recupere los archivos

Utilizando el valor href que obtuvo en el paso anterior como una llamada de API, realice una nueva solicitud de GET para recuperar el directorio de archivos.

Formato de API

GET files/{DATASETFILE_ID}
Parámetro Descripción
{DATASETFILE_ID} El ID dataSetFile se devuelve en el valor href del paso anterior. También es accesible en la matriz data bajo el tipo de objeto dataSetFileId.

Solicitud

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}'

Respuesta

La respuesta contiene una matriz de datos que puede tener una sola entrada o una lista de archivos pertenecientes a ese directorio. El ejemplo siguiente contiene una lista de archivos y se ha condensado para facilitar la lectura. En esta situación, debe seguir la dirección URL de cada archivo para acceder al archivo.

{
    "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
    }
}
Parámetro Descripción
_links.self.href La URL de solicitud de GET utilizada para descargar un archivo en su directorio.

Copie el valor href de cualquier objeto de archivo de la matriz data y, a continuación, continúe con el paso siguiente.

Descargar los datos del archivo

Para descargar los datos del archivo, realice una solicitud de GET al valor "href" que copió en el paso anterior para recuperar los archivos.

NOTA

Si realiza esta solicitud directamente en la línea de comandos, es posible que se le pida que añada un resultado después de los encabezados de solicitud. El siguiente ejemplo de solicitud utiliza --output {FILENAME.FILETYPE}.

Formato de API

GET files/{DATASETFILE_ID}?path={FILE_NAME}
Parámetro Descripción
{DATASETFILE_ID} El ID dataSetFile se devuelve en el valor href de un paso anterior.
{FILE_NAME} Nombre del archivo.

Solicitud

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'
SUGERENCIA

Asegúrese de que está en el directorio o carpeta correcto en el que desea guardar el archivo antes de realizar la solicitud de GET.

Respuesta

La respuesta descarga el archivo solicitado en en el directorio actual. En este ejemplo, el nombre de archivo es "file.parquet".

Terminal

Las puntuaciones descargadas estarán en formato Parquet y necesitarán un Spark-shell o un lector de parquet para ver las puntuaciones. Para la visualización de puntuación sin procesar, puede utilizar Apache Parquet tools. Las herramientas de parquet pueden analizar los datos con Spark.

Pasos siguientes

Este documento describía los pasos necesarios para descargar puntuaciones de Attribution AI. Para obtener más información sobre los resultados de puntuación, consulte la documentación Attribution AI input and output.

Acceso a las puntuaciones mediante el Snowflake

IMPORTANTE

Póngase en contacto con attributionai-support@adobe.com para obtener más información sobre el acceso a puntuaciones con el Snowflake.

Puede acceder a las puntuaciones de Attribution AI agregadas a través del Snowflake . Actualmente, debe enviar por correo electrónico a la asistencia de Adobe a attributionai-support@adobe.com para configurar y recibir las credenciales de Snowflake en su cuenta de lector.

Una vez que la asistencia de Adobe ha procesado su solicitud, se le proporcionará una URL para la cuenta de lector al Snowflake y las credenciales correspondientes a continuación:

  • URL del Snowflake
  • Nombre de usuario
  • Contraseña
NOTA

La cuenta de lector es para consultar los datos usando clientes sql, hojas de cálculo y soluciones de BI que admiten el conector JDBC.

Una vez que tenga las credenciales y la dirección URL, puede consultar las tablas del modelo, agregadas por fecha del punto de contacto o fecha de conversión.

Búsqueda del esquema en el Snowflake

Con las credenciales proporcionadas, inicie sesión en el Snowflake. Haga clic en la ficha Hojas de cálculo en la navegación principal superior izquierda y, a continuación, vaya al directorio de la base de datos en el panel izquierdo.

Hojas de cálculo y navegación

A continuación, haga clic en Seleccionar esquema en la esquina superior derecha de la pantalla. En la ventana emergente que aparece, confirme que tiene seleccionada la base de datos correcta. A continuación, haga clic en la lista desplegable Schema y seleccione uno de los esquemas enumerados. Puede realizar consultas directamente desde las tablas de puntuación enumeradas en el esquema seleccionado.

buscar un esquema

Conexión de PowerBI al Snowflake (opcional)

Las credenciales del Snowflake se pueden usar para configurar una conexión entre las bases de datos de PowerBI Desktop y Snowflake.

En primer lugar, en el cuadro Servidor, escriba la dirección URL del Snowflake. A continuación, en Warehouse, escriba "XSMALL". A continuación, escriba su nombre de usuario y contraseña.

ejemplo de POWERBI

Una vez establecida la conexión, seleccione la base de datos del Snowflake y, a continuación, seleccione el esquema adecuado. Ahora puede cargar todas las tablas.

En esta página