Exportación de matrices, mapas y objetos desde Real-Time CDP export-arrays-cloud-storage

Aprenda a exportar matrices, asignaciones y objetos de Real-Time CDP a destinos de almacenamiento en la nube. Además, puede exportar campos de tipo mapa a destinos empresariales y destinos de personalización edge limitados. Lea este documento para comprender el flujo de trabajo de exportación, los casos de uso habilitados por esta funcionalidad y las limitaciones conocidas. Consulte la tabla siguiente para comprender las funcionalidades disponibles por tipo de destino.

Considere esta página como su lugar de referencia para todo lo que desee saber acerca de la exportación de matrices, mapas y otros tipos de objetos de Experience Platform.

Línea inferior delante

Obtenga la información más importante acerca de la funcionalidad de esta sección y continúe a las demás secciones del documento para obtener información detallada.

Matrices y otros tipos de objetos en Experience Platform arrays-strings-other-objects

En Experience Platform, puede usar esquemas XDM para administrar diferentes tipos de campos. Antes de añadir compatibilidad con las exportaciones de matrices, podía exportar campos de tipo de par clave-valor simples, como cadenas, desde Experience Platform a los destinos deseados. Un ejemplo de un campo de este tipo que se admitía para la exportación anteriormente es personalEmail.address:johndoe@acme.org.

Otros tipos de campo en Experience Platform incluyen campos de matriz. Obtenga más información acerca de administrar campos de matriz en la interfaz de usuario de Experience Platform. Ahora puede exportar objetos de matriz, como en el ejemplo siguiente.

organizations = [{
  id: 123,
  orgName: "Acme Inc",
  founded: 1990,
  latestInteraction: "2024-02-16"
}, {
  id: 456,
  orgName: "Superstar Inc",
  founded: 2004,
  latestInteraction: "2023-08-25"
}, {
  id: 789,
  orgName: 'Energy Corp',
  founded: 2021,
  latestInteraction: "2024-09-08"
}]

Además de las matrices, también puede exportar mapas y objetos de Experience Platform al destino de almacenamiento en la nube deseado. Obtenga más información sobre mapas y objetos en Experience Platform.

Requisitos previos prerequisites

Conéctese a un destino de almacenamiento en la nube deseado, avance en los pasos de activación para los destinos de almacenamiento en la nube y vaya al paso asignación. Al conectarse al destino de nube deseado, debe seleccionar la opción Exportar matrices, mapas, objetos. Obtenga más información en la sección siguiente.

Exportar matrices, mapas, objetos o alternar export-arrays-maps-objects-toggle

Al conectarse a un destino de almacenamiento en la nube basado en archivos, puede activar o desactivar Exportar matrices, mapas, objetos.

Establezca esta configuración en on (activada) para habilitar la exportación de matrices, mapas y objetos a archivos JSON o Parquet. Puede seleccionar estos tipos de objeto en la vista del campo de origen del paso de asignación al activar audiencias en destinos de almacenamiento en la nube. Sin embargo, con esta configuración activada, no se puede utilizar la opción de campos calculados para transformar los datos al activarlos.

Si esta opción está desactivada, puede usar la opción de campos calculados y aplicar varias funciones de transformación de datos al activar públicos. Sin embargo, no puede exportar matrices, mapas y objetos a archivos JSON o Parquet y debe configurar un destino independiente para ese fin.

Exportar matrices, mapas, objetos, alternar en export-arrays-maps-objects-toggle-on

Con esta configuración activada, puede exportar objetos completos (por ejemplo person.name) y matrices seleccionándolos a través del selector del campo de origen en el paso de asignación del flujo de trabajo de activación.

Con esta opción seleccionada, la interfaz de usuario impide que los usuarios usen campos calculados y el control Agregar campos calculados está deshabilitado, como se muestra a continuación. Para utilizar campos calculados para transformaciones de datos, configure una conexión de destino con la opción desactivada.

Exportar matrices, mapas, objetos desactivar off export-arrays-maps-objects-toggle-off

Con esta opción establecida en off, puede utilizar la opción de campos calculados y aplicar varias funciones de transformación de datos al activar audiencias. Sin embargo, no puede exportar matrices, mapas y objetos a archivos JSON o Parquet y debe configurar un destino independiente para ese fin.

puede exportar matrices, asignaciones y objetos a archivos CSV mediante la funcionalidad de campos calculados y concatenarlos en una cadena mediante la función array_to_string. Más información sobre cómo usar esa función.

Obtenga más información sobre cómo trabajar con campos calculados para realizar transformaciones en los datos exportados a destinos de almacenamiento en la nube.

Archivos exportados de muestra sample-exported-files

Con esta funcionalidad, puede exportar archivos Parquet y JSON donde los datos conservan la estructura de Experience Platform. Vea a continuación un ejemplo de un archivo JSON exportado.

{
  "person_name_firstName": "John",
  "person_name_lastName": "Smith",
  "_acmeinc_customer_hs_main_address_scalar": "Oak Avenue No 12",
  "_acmeinc_customer_hs_locations_array": [
    "home address 12",
    "office address 12"
  ],
  "_acmeinc_customer_hs_date_array": [
    "2024-11-14",
    "2024-11-15"
  ],
  "_acmeinc_customer_hs_customer_obj_emails_array0": "john.smith@example.com",
  "_acmeinc_customer_hs_customer_obj": {
    "emails_array": [
      "john.smith@example.com",
      "j.smith@example.com"
    ],
    "name_scalar": "John Smith"
  },
  "_acmeinc_customer_hs_addresses_array_obj": [
    {
      "is_primary": true,
      "streetName_scalar": "Maple Street",
      "streetNo_int": 12
    },
    {
      "is_primary": false,
      "streetName_scalar": "Pine Road",
      "streetNo_int": 45
    }
  ],
  "_acmeinc_customer_hs_addresses_array_obj0": {
    "is_primary": true,
    "streetName_scalar": "Maple Street",
    "streetNo_int": 12
  }
}