El informe de superposición de conjuntos de datos proporciona visibilidad sobre la composición de la Profile almacene exponiendo los conjuntos de datos que contribuyen más a su audiencia direccionable (perfiles).
Además de proporcionar perspectivas sobre los datos, este informe puede ayudarle a realizar acciones para optimizar el uso de las licencias, como establecer un límite para la vida útil de ciertos datos.
Este tutorial describe los pasos necesarios para generar el informe de superposición de conjuntos de datos mediante la variable Real-time Customer Profile e interprete los resultados de su organización.
Para utilizar las API de Adobe Experience Platform, primero debe completar la tutorial de autenticación para recopilar los valores necesarios para los encabezados necesarios. Para obtener más información sobre las API de Experience Platform, consulte la introducción a la documentación de las API de Platform.
Los encabezados requeridos para todas las llamadas a la API en este tutorial son:
Authorization: Bearer {ACCESS_TOKEN}
: La variable Authorization
el encabezado 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}
: La variable 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}
: La variable IMS Org
también se conoce como Organization ID
y 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 de cliente en tiempo real.
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 de GET a /previewsamplestatus/report/dataset/overlap
.
Solicitud
La siguiente solicitud utiliza la variable date
para devolver el informe más reciente de 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 a devolver. Si se ejecutaron 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 un 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 data
, que contiene listas de conjuntos de datos separados por comas y su respectivo recuento de perfiles. Para obtener más información 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"
}
Postman es una plataforma colaborativa para el desarrollo de API y resulta útil para visualizar llamadas de API. Se puede descargar gratis desde el Sitio web de Postman y proporciona una interfaz de usuario fácil de usar para realizar llamadas de 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:
KEY
column:
Authorization
x-api-key
x-gw-ims-org-id
VALUE
column, replacing the braces ({{ }}
) and any content within the braces.date
parámetro:https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap
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 a devolver. Si se ejecutaron 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 un 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 completado el tipo de solicitud, los encabezados, los valores y la ruta, 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 data
, que contiene listas de conjuntos de datos separados por comas y su respectivo recuento de perfiles. Para obtener más información 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.
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 coma. En las secciones siguientes se proporciona información adicional sobre los componentes del informe.
La variable reportTimestamp
coincide con la fecha proporcionada en la solicitud de API o, si no se proporcionó ninguna fecha, la marca de tiempo del informe más reciente.
La variable data
incluye combinaciones únicas de ID de conjuntos de datos como listas separadas por coma con el recuento de perfiles respectivo para esa combinación de conjuntos de datos.
La suma de todos los recuentos de perfil asociados con cada fila del informe de superposición de conjuntos de datos debe ser igual al número total de perfiles de la organización.
Para interpretar los resultados del informe, considere el siguiente ejemplo:
"5d92921872831c163452edc8,5da7292579975918a851db57,5eb2cdc6fa3f9a18a7592a98": 123,
"5d92921872831c163452edc8,5eb2cdc6fa3f9a18a7592a98": 454412,
"5eeda0032af7bb19162172a7": 107
Este informe proporciona la siguiente información:
5d92921872831c163452edc8
, 5da7292579975918a851db57
, 5eb2cdc6fa3f9a18a7592a98
.5d92921872831c163452edc8
y 5eb2cdc6fa3f9a18a7592a98
.5eeda0032af7bb19162172a7
.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, comience por leer la Documentación de información general del perfil.