Enviar actualizaciones parciales de fila a Real-Time Customer Profile mediante Data Prep

Use actualizaciones de flujo continuo en Data Prep para enviar actualizaciones de fila parciales a los datos de Real-Time Customer Profile, a la vez que crea y establece nuevos vínculos de identidad con una sola solicitud de API.

Al transmitir las actualizaciones, puede conservar el formato de los datos mientras los traduce a Real-Time Customer Profile solicitudes de PATCH durante la ingesta. En función de las entradas que proporcione, Data Prep le permite enviar una sola carga útil de API y traducir los datos tanto a Real-Time Customer Profile PATCH como a Identity Service solicitudes CREATE.

Data Prep usa parámetros de encabezado para distinguir entre inserciones y actualizaciones. Todas las filas que utilicen actualizaciones deben tener un encabezado. Puede utilizar actualizaciones con o sin descriptores de identidad. Si usa actualizaciones con identidades, debe seguir los pasos de configuración descritos en la sección de configuración del conjunto de datos de identidad. Si utiliza actualizaciones sin identidades, no necesita proporcionar configuraciones de identidad en la solicitud. Lea la sección sobre actualizaciones de transmisión sin identidades para obtener más información.

Este documento proporciona información sobre cómo transmitir actualizaciones en Data Prep.

Introducción

Esta descripción general requiere una comprensión práctica de los siguientes componentes de Adobe Experience Platform:

Usar actualizaciones de flujo continuo en Data Prep streaming-upserts-in-data-prep

Flujo de trabajo de alto nivel de actualizaciones de streaming

La transmisión de actualizaciones en Data Prep funciona de la siguiente manera:

Configuración del conjunto de datos de identidad configure-the-identity-dataset

Si se deben vincular nuevas identidades, debe crear y pasar un conjunto de datos adicional en la carga útil entrante. Al crear un conjunto de datos de identidad, debe asegurarse de que se cumplan los siguientes requisitos:

Campos obligatorios en los esquemas asociados al conjunto de datos de identidad identity-dataset-required-fileds

Si el esquema contiene campos obligatorios, la validación del conjunto de datos debe suprimirse para permitir que Identity Service solo reciba las identidades. Puede suprimir la validación aplicando el valor disabled al parámetro acp_validationContext. Consulte el ejemplo siguiente:

curl -X POST 'https://platform.adobe.io/data/foundation/catalog/dataSets/62257bef7a75461948ebcaaa' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
    "tags": {
        "acp_validationContext": [
            "disabled"
        ],
        "unifiedProfile": [
            "enabled:false"
        ],
        "unifiedIdentity": [
            "enabled:true"
        ]
    }
}'

Estructura de carga útil entrante

A continuación se muestra un ejemplo de una estructura de carga útil entrante que establece nuevos vínculos de identidad.

Carga útil con configuración de identidad

{
  "header": {
    "flowId": "923e2ac3-3869-46ec-9e6f-7012c4e23f69",
    "imsOrgId": "{ORG_ID}",
    "datasetId": "621fc19ab33d941949af16c8",
    "operations": {
        "data": "create" (default)/"merge"/"delete",
        "identity": "create",
        "identityDatasetId": "621fc19ab33d941949af16d9"
    }
  }
... //The raw data attributes are included here as the key/value pairs of the "body" property.
}

Operaciones compatibles

Real-Time Customer Profile admite las siguientes operaciones:

Identity Service admite las siguientes operaciones:

Carga útil sin configuración de identidad payload-without-identity-configuration

Si no es necesario vincular nuevas identidades, puede omitir los parámetros identity y identityDatasetId en las operaciones. Al hacerlo, se envían datos solamente a Real-Time Customer Profile y se omite Identity Service. Consulte la carga útil siguiente para ver un ejemplo:

{
  "header": {
    "flowId": "923e2ac3-3869-46ec-9e6f-7012c4e23f69",
    "imsOrgId": "{ORG_ID}",
    "datasetId": "621fc19ab33d941949af16c8",
    "operations": {
        "data": "create"/"merge"/"delete",
    }
  }
... //The raw data attributes are included here as the key/value pairs of the "body" property.
}

Transferir identidades principales de forma dinámica

Para las actualizaciones de XDM, el esquema debe estar habilitado para Profile y contener una identidad principal. Puede especificar la identidad principal de un esquema XDM de dos formas:

Designar un campo estático como campo de identidad principal en el esquema XDM

En el ejemplo siguiente, state, homePhone.number y otros atributos se actualizan con sus respectivos valores dados en Profile con la identidad principal de sampleEmail@gmail.com. A continuación, el componente Data Prep de flujo continuo genera un mensaje de actualización de entidad XDM. Real-Time Customer Profile confirma ese mensaje de actualización de XDM para actualizar el registro de perfil.

curl -X POST 'https://dcs.adobedc.net/collection/9aba816d350a69c4abbd283eb5818ec3583275ffce4880ffc482be5a9d810c4b' \
  -H 'Content-Type: application/json' \
  -H 'x-adobe-flow-id: d5262d48-0f47-4949-be6d-795f06933527' \
  -d '{
    "header": {
        "flowId" : "d5262d48-0f47-4949-be6d-795f06933527",
        "imsOrgId": "{ORG_ID}",
        "datasetId": "62259f817f62d71947929a7b",
        "operations": {
         "data": "create"
     }
    },
    {
        "body": {
        "homeAddress": {
            "country": "US",
            "state": "GA",
            "region": "va7"
        },
        "homePhone": {
            "number": "123.456.799"
        },
        "identityMap": {
            "Email": [{
                "id": "sampleEmail@gmail.com",
                "primary": true
            }]
        },
      "personalEmail": {
            "address": "sampleEmail@gmail.com",
            "primary": true
       },
      "personID": "346576345",
      "_id": "346576345",
      "timestamp": "2021-05-05T17:51:45.1880+02",
      "workEmail": "sampleWorkEmail@gmail.com"
  }
}'

Designe uno de los campos de identidad como identidad principal a través del grupo de campos de mapa de identidad en el esquema XDM

En este ejemplo, el encabezado contiene el atributo operations con las propiedades identity y identityDatasetId. Esto permite combinar datos con Real-Time Customer Profile y también pasar identidades a Identity Service.

curl -X POST 'https://dcs.adobedc.net/collection/9aba816d350a69c4abbd283eb5818ec3583275ffce4880ffc482be5a9d810c4b' \
  -H 'Content-Type: application/json' \
  -H 'x-adobe-flow-id: d5262d48-0f47-4949-be6d-795f06933527' \
  -d '{
    "header": {
        "flowId" : "d5262d48-0f47-4949-be6d-795f06933527",
        "imsOrgId": "{ORG_ID}",
        "datasetId": "62259f817f62d71947929a7b",
        "operations": {
            "data": "merge",
            "identity": "create",
            "identityDatasetId": "6254a93b851ecd194b64af9e"
      }
    },
    {
       "body": {
        "homeAddress": {
            "country": "US",
            "state": "GA",
            "region": "va7"
        },
        "homePhone": {
            "number": "123.456.799"
        },
        "identityMap": {
            "Email": [{
                "id": "sampleEmail@gmail.com",
                "primary": true
            }]
        },
      "personalEmail": {
            "address": "sampleEmail@gmail.com",
            "primary": true
       },
      "personID": "346576345",
      "_id": "346576345",
      "timestamp": "2021-05-05T17:51:45.1880+02",
      "workEmail": "sampleWorkEmail@gmail.com"
  }
 }'

Limitaciones conocidas y consideraciones clave

A continuación se describe una lista de limitaciones conocidas que deben tenerse en cuenta al transmitir actualizaciones con Data Prep:

Pasos siguientes

Al leer este documento, debería haber comprendido cómo transmitir actualizaciones de filas en Data Prep para enviar actualizaciones de filas parciales a los datos de Real-Time Customer Profile, a la vez que crea y vincula identidades con una sola solicitud de API. Para obtener más información sobre otras características de Data Prep, lea la Data Prep descripción general. Para obtener información sobre cómo usar conjuntos de asignaciones en la API Data Prep, lea la Data Prep guía para desarrolladores.