Puntuaciones de descarga en Attribution AI
Este documento sirve como guía para descargar puntuaciones para su Attribution AI.
Introducción
Attribution AI permite descargar puntuaciones en formato de archivo Parquet. Este tutorial requiere que haya leído y finalizado la sección de descarga de puntuaciones de Attribution AI en la guía de 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 del Attribution AI. Si ha creado recientemente una instancia de servicio que aún se está entrenando y puntuando, espere 24 horas para que finalice la ejecución.
Búsqueda del ID del conjunto de datos dataset-id
En la instancia de servicio para Attribution AI Insights, haga clic en el menú desplegable Más acciones en la barra de navegación superior derecha y luego seleccione Puntuaciones de acceso.
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 de la instancia actual. Copie el ID del conjunto de datos en el portapapeles y continúe con el siguiente paso.
Recupere su ID de lote retrieve-your-batch-id
Con el ID del conjunto de datos del paso anterior, debe realizar una llamada a la API de catálogo para recuperar un ID de lote. Se utilizan parámetros de consulta adicionales para esta llamada de API a fin de 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 deseada que desea que se devuelva. Para obtener más información sobre los tipos de parámetros de consulta disponibles, visite la guía sobre filtrado de datos de catálogo mediante parámetros de consulta.
Formato de API
GET /batches?&dataSet={DATASET_ID}&createdClient=acp_foundation_push&status=success&orderBy=desc:created&limit=1
{DATASET_ID}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: {ORG_ID}' \
-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 la clave del objeto devuelto es el identificador de lote 01E5QSWCAASFQ054FNBKYV6TIQ. Copie su ID de lote para utilizarlo en la siguiente llamada de API.
tags para mayor legibilidad.{
"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 retrieve-the-next-api-call-with-your-batch-id
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 siguiente solicitud de API.
Formato de API
GET batches/{BATCH_ID}/files
{BATCH_ID}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: {ORG_ID}' \
-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 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
}
}
Recuperación de archivos retrieving-your-files
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}
{DATASETFILE_ID}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: {ORG_ID}' \
-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 que pertenecen a ese directorio. El ejemplo siguiente contiene una lista de archivos y se ha condensado para facilitar la lectura. En este caso, 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
}
}
_links.self.hrefCopie 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 recuperar los archivos.
--output {FILENAME.FILETYPE}.Formato de API
GET files/{DATASETFILE_ID}?path={FILE_NAME}
{DATASETFILE_ID}href de un paso anterior.{FILE_NAME}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: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-O 'file.parquet'
Respuesta
La respuesta descarga el archivo solicitado en en el directorio actual. En este ejemplo, el nombre de archivo es "file.parquet".
Las puntuaciones descargadas estarán en formato Parquet y necesitarán un Spark-shell o un lector de Parquet para verlas. Para ver la puntuación sin procesar, puedes usar herramientas de Apache Parquet. Las herramientas de Parquet pueden analizar los datos con Spark.
Pasos siguientes
Este documento describe los pasos necesarios para descargar las puntuaciones de Attribution AI. Para obtener más información sobre las salidas de puntuación, visite la documentación de Entrada y salida de inteligencia artificial aplicada a la atribución.
Acceso a puntuaciones mediante el Snowflake
Puede acceder a las puntuaciones de Attribution AI agregadas a través de Snowflake. En este momento, debe enviar un correo electrónico al equipo de asistencia de Adobe a attributionai-support@adobe.com para configurar y recibir las credenciales en su cuenta de Reader para Snowflake.
Una vez que la asistencia técnica de Adobe haya procesado su solicitud, se le proporcionará una URL para la cuenta de Reader al Snowflake y las credenciales correspondientes a continuación:
- URL del Snowflake
- Nombre de usuario
- Contraseña
Una vez que tenga las credenciales y la dirección URL, puede consultar las tablas del modelo, agregadas por fecha de punto de contacto o fecha de conversión.
Búsqueda del esquema en Snowflake
Con las credenciales proporcionadas, inicie sesión en el Snowflake. Haga clic en la ficha Hojas de cálculo en la barra de navegación principal superior izquierda y, a continuación, vaya al directorio de la base de datos en el panel izquierdo.
A continuación, haga clic en Seleccionar esquema en la esquina superior derecha de la pantalla. En la ventana emergente que aparece, confirme que ha seleccionado la base de datos correcta. A continuación, haga clic en el menú desplegable Esquema y seleccione uno de los esquemas de la lista. Puede realizar consultas directamente desde las tablas de puntuación enumeradas en el esquema seleccionado.
Conexión de Power BI al Snowflake (opcional)
Las credenciales de Snowflake se pueden utilizar para configurar una conexión entre PowerBI Desktop y las bases de datos de Snowflake.
Primero, en el cuadro Servidor, escriba la dirección URL del Snowflake. A continuación, en Almacén, escriba "XSMALL". A continuación, escriba su nombre de usuario y contraseña.
Una vez establecida la conexión, seleccione la base de datos de Snowflake y, a continuación, seleccione el esquema adecuado. Ahora puede cargar todas las tablas.