Descargar puntuaciones en Customer AI

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

Primeros pasos

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

Además, para acceder a las puntuaciones de Customer AI, debe tener disponible una instancia de servicio con un estado de ejecución correcto. Para crear una nueva instancia de servicio, visite Configuración de una instancia de Customer 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.

Actualmente, hay dos formas de descargar puntuaciones de Customer AI:

  1. Si desea descargar las puntuaciones en el nivel individual o no tiene habilitado el Perfil del cliente en tiempo real, vaya a búsqueda del ID del conjunto de datos.
  2. Si tiene el perfil habilitado y desea descargar segmentos configurados mediante Customer AI, navegue hasta descargar un segmento configurado con Customer AI.

Búsqueda del ID del conjunto de datos

En la instancia de servicio para la información de Customer AI, haga clic en el botón Más acciones en la navegación superior derecha y 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 deseada que desee que se devuelva. Para obtener más información sobre los tipos de parámetros de consulta disponibles, visite la guía de filtrado de datos del 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
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=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}'

Respuesta

Una respuesta correcta devuelve una carga útil que contiene un objeto de ID de lote. En este ejemplo, el valor clave del objeto devuelto es el ID del lote 01E5QSWCAASFQ054FNBKYV6TIQ. Copie su ID de lote para utilizarlo en la siguiente llamada de 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"
    }
}

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 recuperado en el paso anterior recuperar el 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/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}'

Respuesta

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

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

Recupere los archivos

Al usar la variable href en el paso anterior como llamada a la 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 la variable href del paso anterior. También se puede acceder a ella desde la data matriz bajo el tipo de objeto dataSetFileId.

Solicitud

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

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

Copie el href para cualquier objeto de archivo de la variable 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 a la "href" valor que ha copiado en el paso anterior recuperación de 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 la variable href de un paso anterior.
{FILE_NAME} Nombre del archivo.

Solicitud

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'
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 "filename.parquet".

Terminal

Descargar un segmento configurado con Customer AI

Una forma alternativa de descargar los datos de puntuación es exportar la audiencia a un conjunto de datos. Después de que un trabajo de segmentación se haya completado correctamente (el valor de la variable status es "SUCCEEDED"), puede exportar la audiencia a un conjunto de datos en el que se pueda acceder a él y actuar en consecuencia. Para obtener más información sobre la segmentación, visite información general sobre segmentación.

IMPORTANTE

Para utilizar este método de exportación, es necesario habilitar el perfil del cliente en tiempo real para el conjunto de datos.

La variable exportación de segmentos en la guía de evaluación de segmentos cubre los pasos necesarios para exportar un conjunto de datos de audiencia. La guía describe y proporciona ejemplos de lo siguiente:

  • Crear un conjunto de datos de destino: Cree el conjunto de datos para incluir miembros de audiencia.
  • Genere perfiles de audiencia en el conjunto de datos: Rellene el conjunto de datos con Perfiles individuales XDM basándose en los resultados de un trabajo de segmento.
  • Monitorizar el progreso de exportación: Compruebe el progreso actual del proceso de exportación.
  • Leer datos de audiencia: Recupere los perfiles individuales XDM resultantes que representan a los miembros de su audiencia.

Pasos siguientes

Este documento describe los pasos necesarios para descargar puntuaciones de Customer AI. Ahora puede seguir explorando el otro Servicios inteligentes y guías que se ofrecen.

En esta página