Generar el informe de superposición de conjuntos de datos

El informe de superposición de conjuntos de datos proporciona visibilidad sobre la composición del almacén de Profile de su organización al exponer los conjuntos de datos que más contribuyen a su audiencia a la que se puede dirigir (perfiles).

Además de proporcionar perspectivas sobre sus datos, este informe puede ayudarle a tomar medidas para optimizar el uso de la licencia, como establecer un límite en la duración de ciertos datos.

Este tutorial describe los pasos necesarios para generar el informe de superposición de conjuntos de datos mediante la API Real-Time Customer Profile e interpretar los resultados de su organización.

Introducción

Para usar las API de Adobe Experience Platform, primero debe completar el tutorial de autenticación para recopilar los valores que necesita para los encabezados requeridos. Para obtener más información sobre las API de Experience Platform, consulte la documentación sobre cómo empezar a usar las API de plataforma.

Los encabezados necesarios para todas las llamadas de API de este tutorial son:

  • Authorization: Bearer {ACCESS_TOKEN}: el encabezado Authorization requiere un token de acceso precedido de la palabra Bearer. Se debe generar un nuevo valor de token de acceso cada 24 horas.
  • x-api-key: {API_KEY}: API Key también se conoce como Client ID y es un valor que solo necesita generarse una vez.
  • x-gw-ims-org-id: {ORG_ID}: el identificador de organización solo debe generarse una vez.

Después de completar el tutorial de autenticación y recopilar los valores de los encabezados necesarios, está listo para empezar a realizar llamadas a la API del cliente en tiempo real.

Generar informe de superposición de conjuntos de datos mediante la línea de comandos

GET Si está familiarizado con el uso de la línea de comandos, puede utilizar la siguiente solicitud cURL para generar el informe de superposición de conjuntos de datos realizando una solicitud a /previewsamplestatus/report/dataset/overlap.

Solicitud

La siguiente solicitud usa el parámetro date para devolver el informe más reciente para la fecha especificada.

curl -X GET \
  https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap?date=2021-04-19 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
Parámetro
Descripción
date
Especifique la fecha del informe que desea devolver. Si se han ejecutado varios informes en la fecha, se devuelve el informe más reciente de esa fecha. Si no existe un informe para la fecha especificada, se devuelve el error de estado HTTP 404 (no encontrado). Si no se especifica ninguna fecha, se devuelve el informe más reciente. Formato: AAAA-MM-DD. Ejemplo: date=2024-12-31

Respuesta

Una solicitud correcta devuelve el estado HTTP 200 (OK) y el informe de superposición de conjuntos de datos. El informe incluye un objeto data, que contiene listas de conjuntos de datos separados por comas y su respectivo recuento de perfiles. Para obtener detalles sobre cómo leer el informe, consulte la sección sobre interpretación de los datos del informe de superposición de conjuntos de datos más adelante en este tutorial.

{
    "data": {
        "5d92921872831c163452edc8,5da7292579975918a851db57,5eb2cdc6fa3f9a18a7592a98": 123,
        "5d92921872831c163452edc8,5eb2cdc6fa3f9a18a7592a98": 454412,
        "5eeda0032af7bb19162172a7": 107
    },
    "reportTimestamp": "2021-04-19T19:55:31.147"
}

Generar informe de superposición de conjuntos de datos mediante Postman

Postman es una plataforma colaborativa para el desarrollo de API y resulta útil para visualizar llamadas a la API. Se puede descargar gratis desde el sitio web de Postman y ofrece una interfaz de usuario fácil de usar para realizar llamadas API. Las siguientes capturas de pantalla utilizan la interfaz de Postman.

Solicitud

Para solicitar el informe de superposición de conjuntos de datos mediante Postman, complete los siguientes pasos:

  • En el menú desplegable, seleccione GET como tipo de solicitud.

  • Escriba los encabezados requeridos en la columna KEY:

    • Authorization
    • x-api-key
    • x-gw-ims-org-id
  • Escriba los valores que generó durante la autenticación en la columna VALUE, reemplazando las llaves ({{ }}) y cualquier contenido dentro de las llaves.

  • Escriba la ruta de solicitud con o sin el parámetro date opcional:
    https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap
    o
    https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap?date=YYYY-MM-DD

Parámetro
Descripción
date
Especifique la fecha del informe que desea devolver. Si se han ejecutado varios informes en la fecha, se devuelve el informe más reciente de esa fecha. Si no existe un informe para la fecha especificada, se devuelve el error de estado HTTP 404 (no encontrado). Si no se especifica ninguna fecha, se devuelve el informe más reciente.
Formato: AAAA-MM-DD. Ejemplo: date=2024-12-31

Una vez completados el tipo de solicitud, los encabezados, los valores y la ruta de acceso, seleccione Enviar para enviar la solicitud de API y generar el informe.

Respuesta

Una solicitud correcta devuelve el estado HTTP 200 (OK) y el informe de superposición de conjuntos de datos. El informe incluye un objeto data, que contiene listas de conjuntos de datos separados por comas y su respectivo recuento de perfiles. Para obtener detalles sobre cómo leer el informe, consulte la sección sobre interpretación de los datos del informe de superposición de conjuntos de datos.

Interpretación de los datos del informe de superposición de conjuntos de datos interpret-the-report

El informe de superposición de conjuntos de datos generado proporciona una marca de tiempo que muestra la fecha y la hora del informe y un objeto de datos que incluye combinaciones únicas de ID de conjuntos de datos como listas separadas por comas. En las secciones siguientes se proporciona información adicional sobre los componentes del informe.

Marca de tiempo del informe

El reportTimestamp coincide con la fecha proporcionada en la solicitud de API o, si no se proporcionó ninguna fecha, con la marca de tiempo del informe más reciente.

Lista de ID de conjuntos de datos

El objeto data incluye combinaciones únicas de ID de conjuntos de datos como listas separadas por comas con el recuento de perfiles respectivo para esa combinación de conjuntos de datos.

NOTE
La suma de todos los recuentos de perfiles asociados a cada fila del informe de superposición de conjuntos de datos debe ser igual al número total de perfiles de su organización.

Para interpretar los resultados del informe, observe el siguiente ejemplo:

  "5d92921872831c163452edc8,5da7292579975918a851db57,5eb2cdc6fa3f9a18a7592a98": 123,
  "5d92921872831c163452edc8,5eb2cdc6fa3f9a18a7592a98": 454412,
  "5eeda0032af7bb19162172a7": 107

Este informe proporciona la siguiente información:

  • Hay 123 perfiles compuestos de datos procedentes de los siguientes conjuntos de datos: 5d92921872831c163452edc8, 5da7292579975918a851db57, 5eb2cdc6fa3f9a18a7592a98.
  • Hay 454.412 perfiles compuestos de datos procedentes de estos dos conjuntos de datos: 5d92921872831c163452edc8 y 5eb2cdc6fa3f9a18a7592a98.
  • Hay 107 perfiles que están compuestos solamente de datos del conjunto de datos 5eeda0032af7bb19162172a7.
  • Hay un total de 454.642 perfiles en la organización.

Pasos siguientes

Después de completar este tutorial, ahora puede generar el informe de superposición de conjuntos de datos mediante la API de perfil del cliente en tiempo real. Para obtener más información sobre cómo trabajar con los datos de perfil en la API y en la interfaz de usuario del Experience Platform, lea la documentación de descripción general del perfil.

recommendation-more-help
54550d5b-f1a1-4065-a394-eb0f23a2c38b