Este tutorial trata el proceso de activación de un conjunto de datos con capacidades de "actualización" para realizar actualizaciones en los datos del perfil del cliente en tiempo real. Esto incluye pasos para crear un nuevo conjunto de datos y configurar un conjunto de datos existente.
El flujo de trabajo de actualización solo funciona para la ingesta por lotes. La ingesta de transmisión es not compatible.
Este tutorial requiere una comprensión práctica de varios servicios de Adobe Experience Platform involucrados en la administración de conjuntos de datos con perfil habilitado. Antes de comenzar este tutorial, revise la documentación de estas Platform servicios:
Las secciones siguientes proporcionan información adicional que debe conocer para realizar llamadas correctamente a las API de Platform.
Este tutorial proporciona llamadas de API de ejemplo para demostrar cómo dar formato a las solicitudes. Estas incluyen rutas de acceso, encabezados necesarios y cargas de solicitud con el formato correcto. También se proporciona el JSON de muestra devuelto en las respuestas de API. Para obtener información sobre las convenciones utilizadas en la documentación para las llamadas de API de ejemplo, consulte la sección sobre cómo leer llamadas de API de ejemplo en el Experience Platform guía de solución de problemas.
Para realizar llamadas a Platform API, primero debe completar la variable tutorial de autenticación. Al completar el tutorial de autenticación, se proporcionan los valores para cada uno de los encabezados necesarios en todos los Experience Platform Llamadas de API, como se muestra a continuación:
Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}
Todas las solicitudes que contienen una carga útil (POST, PUT, PATCH) requieren un Content-Type
encabezado. El valor correcto de este encabezado se muestra en las solicitudes de muestra donde es necesario.
Todos los recursos de Experience Platform están aisladas para entornos limitados virtuales específicos. Todas las solicitudes a Platform Las API requieren un x-sandbox-name
encabezado que especifica el nombre del simulador de pruebas en el que se realizará la operación. Para obtener más información sobre los entornos limitados en Platform, consulte la documentación general de entorno limitado.
Al crear un nuevo conjunto de datos, puede habilitar ese conjunto de datos para Perfil y habilitar las capacidades de actualización en el momento de la creación.
Para crear un nuevo conjunto de datos habilitado para Perfil, debe conocer el ID de un esquema XDM existente que esté habilitado para Perfil. Para obtener información sobre cómo buscar o crear un esquema habilitado para perfil, consulte el tutorial en creación de un esquema mediante la API del Registro de esquemas.
Para crear un conjunto de datos habilitado para Perfil y actualizaciones, utilice una solicitud de POST para /dataSets
punto final.
Formato de API
POST /dataSets
Solicitud
Al incluir ambas unifiedIdentity
y unifiedProfile
under tags
en el cuerpo de la solicitud, el conjunto de datos se habilitará para Profile al crearlo. Dentro de unifiedProfile
matriz, adición isUpsert:true
agregará la capacidad para que el conjunto de datos admita actualizaciones.
curl -X POST \
https://platform.adobe.io/data/foundation/catalog/dataSets \
-H 'Content-Type: application/json' \
-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}' \
-d '{
"name": "Sample dataset",
"description: "A sample dataset with a sample description.",
"fields": [],
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/31670881463308a46f7d2cb09762715",
"contentType": "application/vnd.adobe.xed-full-notext+json; version=1"
},
"tags": {
"unifiedIdentity": [
"enabled: true"
],
"unifiedProfile": [
"enabled: true",
"isUpsert: true"
]
}
}'
Propiedad | Descripción |
---|---|
schemaRef.id |
El ID de la variable Profileesquema habilitado para , en el que se basará el conjunto de datos. |
{TENANT_ID} |
El espacio de nombres dentro de la variable Schema Registry que contiene recursos pertenecientes a su organización. Consulte la TENANT_ID de la sección Schema Registry guía para desarrolladores para obtener más información. |
Respuesta
Una respuesta correcta muestra una matriz que contiene el ID del conjunto de datos recién creado en forma de "@/dataSets/{DATASET_ID}"
.
[
"@/dataSets/5b020a27e7040801dedbf46e"
]
Los siguientes pasos tratan sobre cómo configurar un conjunto de datos habilitado para Perfil existente para la funcionalidad de actualización (actualización).
Para configurar un conjunto de datos habilitado para el perfil existente para la actualización, primero debe deshabilitar el conjunto de datos para el perfil y luego volver a habilitarlo junto con la variable isUpsert
etiqueta. Si el conjunto de datos existente no está habilitado para Perfil, puede continuar directamente con los pasos de activación del conjunto de datos para Perfil y actualizar. Si no está seguro, los siguientes pasos le muestran cómo comprobar si el conjunto de datos ya está habilitado.
Al usar la variable Catalog API, puede inspeccionar un conjunto de datos existente para determinar si está habilitado para usarse en Real-Time Customer Profile. La siguiente llamada recupera los detalles de un conjunto de datos por ID.
Formato de API
GET /dataSets/{DATASET_ID}
Parámetro | Descripción |
---|---|
{DATASET_ID} |
El ID de un conjunto de datos que desea inspeccionar. |
Solicitud
curl -X GET 'https://platform.adobe.io/data/foundation/catalog/dataSets/5b020a27e7040801dedbf46e' \
-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
{
"5b020a27e7040801dedbf46e": {
"name": "{DATASET_NAME}",
"imsOrg": "{ORG_ID}",
"tags": {
"adobe/pqs/table": [
"unifiedprofileingestiontesteventsdataset"
],
"unifiedIdentity": [
"enabled:true"
],
"unifiedProfile": [
"enabled:true"
]
},
"lastBatchId": "{BATCH_ID}",
"lastBatchStatus": "success",
"dule": {},
"statsCache": {
"startDate": null,
"endDate": null
},
"namespace": "ACP",
"state": "DRAFT",
"version": "1.0.1",
"created": 1536536917382,
"updated": 1539793978215,
"createdClient": "{CLIENT_CREATED}",
"createdUser": "{CREATED_BY}",
"updatedUser": "{CREATED_BY}",
"viewId": "{VIEW_ID}",
"status": "enabled",
"transforms": "@/dataSets/5b020a27e7040801dedbf46e/views/5b020a27e7040801dedbf46f/transforms",
"files": "@/dataSets/5b020a27e7040801dedbf46e/views/5b020a27e7040801dedbf46f/files",
"schema": "{SCHEMA}",
"schemaMetadata": {
"primaryKey": [],
"delta": [],
"dule": []
},
"schemaRef": {
"id": "https://ns.adobe.com/xdm/context/experienceevent",
"contentType": "application/vnd.adobe.xed+json"
}
}
}
En el tags
puede ver que unifiedProfile
está presente con el valor enabled:true
. Por lo tanto, Real-Time Customer Profile está habilitado para este conjunto de datos.
Para configurar un conjunto de datos habilitado para perfiles para actualizaciones, primero debe deshabilitar la variable unifiedProfile
y unifiedIdentity
y vuelva a activarlas junto con la variable isUpsert
etiqueta. Esto se realiza mediante dos solicitudes de PATCH, una para deshabilitar y otra para volver a habilitar.
Los datos introducidos en el conjunto de datos mientras está deshabilitado no se incorporarán en el Almacenamiento de perfiles. Debe evitar la ingesta de datos en el conjunto de datos hasta que se vuelva a habilitar para Perfil.
Formato de API
PATCH /dataSets/{DATASET_ID}
Parámetro | Descripción |
---|---|
{DATASET_ID} |
El ID del conjunto de datos que desea actualizar. |
Solicitud
El primer cuerpo de solicitud del PATCH incluye un path
a unifiedProfile
y path
a unifiedIdentity
, configurando la variable value
a enabled:false
para ambas rutas con el fin de deshabilitar las etiquetas.
curl -X PATCH https://platform.adobe.io/data/foundation/catalog/dataSets/5b020a27e7040801dedbf46e \
-H 'Content-Type:application/json-patch+json' \
-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}' \
-d '[
{
"op": "replace",
"path": "/tags/unifiedProfile",
"value": ["enabled:false"]
},
{
"op": "replace",
"path": "/tags/unifiedIdentity",
"value": ["enabled:false"]
}
]'
Respuesta
Una solicitud de PATCH correcta devuelve el estado HTTP 200 (OK) y una matriz que contiene el ID del conjunto de datos actualizado. Este ID debe coincidir con el enviado en la solicitud del PATCH. La variable unifiedProfile
y unifiedIdentity
las etiquetas de ahora se han desactivado.
[
"@/dataSets/5b020a27e7040801dedbf46e"
]
Se puede habilitar un conjunto de datos existente para las actualizaciones de perfiles y atributos mediante una única solicitud de PATCH.
Al habilitar el conjunto de datos para Perfil, asegúrese de que el esquema al que está asociado el conjunto de datos sea also Habilitado para perfiles. Si el esquema no está habilitado para Perfil, el conjunto de datos not aparece como habilitado para perfiles en la interfaz de usuario de Platform.
Formato de API
PATCH /dataSets/{DATASET_ID}
Parámetro | Descripción |
---|---|
{DATASET_ID} |
El ID de un conjunto de datos que desea actualizar. |
Solicitud
El cuerpo de la solicitud incluye un path
a unifiedProfile
configurar la variable value
para incluir el enabled
y isUpsert
etiquetas, ambas configuradas como true
y path
a unifiedIdentity
configurar la variable value
para incluir el enabled
etiqueta establecida en true
.
curl -X PATCH https://platform.adobe.io/data/foundation/catalog/dataSets/5b020a27e7040801dedbf46e \
-H 'Content-Type:application/json-patch+json' \
-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}' \
-d '[
{
"op": "add",
"path": "/tags/unifiedProfile",
"value": [
"enabled:true",
"isUpsert:true"
]
},
{
"op": "add",
"path": "/tags/unifiedIdentity",
"value": [
"enabled:true"
]
}
]'
Respuesta
Una solicitud de PATCH correcta devuelve el estado HTTP 200 (OK) y una matriz que contiene el ID del conjunto de datos actualizado. Este ID debe coincidir con el enviado en la solicitud del PATCH. La variable unifiedProfile
y unifiedIdentity
ahora se han habilitado y configurado para las actualizaciones de atributos.
[
"@/dataSets/5b020a27e7040801dedbf46e"
]
Los flujos de trabajo de ingesta por lotes ahora pueden usar su conjunto de datos habilitado para perfiles y servidores para realizar actualizaciones en los datos de perfil. Para obtener más información sobre la ingesta de datos en Adobe Experience Platform, comience por leer la información general sobre la ingesta de datos.