Show Menu
TEMAS×

Importación de datos

Tenga en cuenta los límites de almacenamiento SFTP, Almacenamiento de base de datos y perfil activo según el contrato de AdobeCampaign mientras utiliza esta funcionalidad.

Recopilación de datos

Uso de datos de una lista: Lista de lectura

Los datos enviados en un flujo de trabajo pueden provenir de listas, por lo que los datos se han preparado y estructurado previamente.
Esta lista puede haberse creado directamente en Adobe Campaign o importado mediante la opción Import a list . Para obtener más información, consulte esta página .
Para obtener más información sobre el uso de la actividad de la lista de lectura en un flujo de trabajo, consulte Lista de lectura .

Carga de datos de un archivo

Los datos procesados en un flujo de trabajo se pueden extraer de un archivo estructurado para que se puedan importar en Adobe Campaign.
Puede encontrar una descripción de la actividad de datos de carga en la sección Data loading (file) .
Ejemplo de archivo estructurado para importar:
lastname;firstname;birthdate;email;crmID
Smith;Hayden;23/05/1989;hayden.smith@example.com;124365
Mars;Daniel;17/11/1987;dannymars@example.com;123545
Smith;Clara;08/02/1989;hayden.smith@example.com;124567
Durance;Allison;15/12/1978;allison.durance@example.com;120987

Descompresión o desencriptado de un archivo antes de procesarlo

Acerca de las etapas de preprocesamiento

Adobe Campaign permite importar archivos comprimidos o encriptados. Antes de que se puedan leer en una actividad Data loading (file) , puede definir un procesamiento previo para descomprimir o desencriptar el archivo.
Para poder hacerlo:
  1. Utilice el Panel de control de Campaign para generar un par de claves pública y privada.
    Panel de control de Campaign está disponible para todos los clientes alojados en AWS (excepto para los clientes que alojan sus instancias de marketing in situ).
  2. Si la instalación de Adobe Campaign está alojada en Adobe, póngase en contacto con el Servicio de atención al cliente de Adobe para que le instalen las utilidades necesarias en el servidor.
  3. Si la instalación de Adobe Campaign está in situ, instale la utilidad que desee utilizar (por ejemplo: GPG, GZIP) así como las claves necesarias (clave de cifrado) en el servidor de aplicaciones.
A continuación, puede utilizar los comandos de preprocesamiento deseados en los flujos de trabajo:
  1. Add and configure a File transfer activity in your workflow.
  2. Add a Data loading (file) activity and define the file format.
  3. Marque la opción Pre-process the file .
  4. Especifique el comando de preprocesamiento que desee aplicar.
  5. Añada otras actividades para administrar los datos que provengan del archivo.
  6. Guarde y ejecute el flujo de trabajo.
A continuación se muestra un ejemplo en el caso de uso.
Temas relacionados:

Caso de uso: Importación de datos cifrados con una clave generada por Panel de control de Campaign

En este caso de uso, crearemos un flujo de trabajo para importar datos cifrados en un sistema externo, utilizando una clave generada en el Panel de control de Campaign.
En esta sección también hay disponible un vídeo de tutorial que muestra cómo utilizar una clave GPG para descifrar datos.
Los pasos para realizar este caso de uso son los siguientes:
  1. Utilice el Panel de control de Campaign para generar un par de claves (público/privado). Encontrará pasos detallados en la documentación de Panel de control de Campaign.
    • La clave pública se compartirá con el sistema externo, que la utilizará para cifrar los datos que se enviarán a la Campaña.
    • El Campaign Classic utilizará la clave privada para descifrar los datos cifrados entrantes.
  2. En el sistema externo, utilice la clave pública descargada del Panel de control de Campaign para cifrar los datos que se van a importar a Campaign Classic.
  3. En Campaign Classic, cree un flujo de trabajo para importar los datos cifrados y descifrarlos con la clave privada que se ha instalado mediante el Panel de control de Campaign. Para ello, crearemos un flujo de trabajo de la siguiente manera:
    • File transfer actividad: Transfiere el archivo de un origen externo a un Campaign Classic. En este ejemplo, queremos transferir el archivo desde un servidor SFTP.
    • Data loading (file) actividad: Carga los datos del archivo en la base de datos y los descifra utilizando la clave privada generada en el Panel de control de Campaign.
  4. Abra la File transfer actividad y especifique la cuenta externa desde la que desea importar el archivo .gpg cifrado.
    Los conceptos globales sobre cómo configurar la actividad están disponibles en esta sección .
  5. Abra la Data loading (file) actividad y configúrela según sus necesidades. Los conceptos globales sobre cómo configurar la actividad están disponibles en esta sección .
    Añada una etapa de preprocesamiento a la actividad para descifrar los datos entrantes. Para ello, seleccione la Pre-process the file opción y copie y pegue este comando de descifrado en el Command campo :
    gpg --batch --passphrase passphrase --decrypt <%=vars.filename%>
    En este ejemplo, utilizamos la frase de contraseña utilizada de forma predeterminada por Panel de control de Campaign, que es "frase de contraseña".
    Si ya ha instalado claves GPG en su instancia a través de una solicitud del Servicio de atención al cliente en el pasado, la frase de contraseña puede haber cambiado y ser diferente de la predeterminada.
  6. Haga clic en OK para confirmar esta configuración.
  7. Ahora puede ejecutar el flujo de trabajo. Una vez ejecutada, puede registrar en los registros de flujo de trabajo que el descifrado se ha ejecutado y que los datos del archivo se han importado.

Prácticas recomendadas al importar datos

Tenga cuidado y siga las sencillas reglas detalladas debajo, ya que le pueden ayudar a garantizar la coherencia de los datos en la base de datos y a evitar errores comunes durante la actualización o las exportaciones de datos.

Uso de plantillas de importación

La mayoría de los flujos de trabajo de importación deben contener las siguientes actividades: Data loading (file) , Enrichment , Split , Deduplication , Update data .
El uso de plantillas de importación facilita la preparación de importaciones similares y la coherencia de los datos en la base de datos. Consulte cómo puede crear plantillas de flujo de trabajo en la sección Workflow templates .
En muchos proyectos, las importaciones se crean sin actividad de Deduplication porque los archivos utilizados en el proyecto no tienen duplicados. Los duplicados aparecen en ocasiones al importar archivos diferentes. En este caso, la deduplicación resulta difícil. Por lo tanto, la deduplicación es una buena precaución en todos los flujos de trabajo de importación.
No dé por hecho que los datos entrantes son coherentes y correctos, o que el departamento de TI o el iniciador de Adobe Campaign se pueden encargar de ello. Durante el proyecto, tenga en cuenta la limpieza de los datos. Deduplique, reconcilie y mantenga la coherencia al importar datos.
Hay un ejemplo de plantilla de importación disponible en la sección Setting up a recurring import .

Uso de formatos de archivo plano

El formato más eficaz para las importaciones es un archivo plano. Los archivos planos se pueden importar en modo masivo a nivel de base de datos.
Por ejemplo:
  • Separador: tabulación o punto y coma
  • Primera línea con encabezados
  • Sin delimitador de cadenas
  • Formato de fecha: AAAA/MM/DD HH:mm:SS
Adobe Campaign no puede importar archivos XML utilizando actividades estándar de importación de archivos. Es posible importar archivos XML utilizando JavaScript, pero solo con volúmenes pequeños: menos de 10 000 registros por archivo.

Uso de compresión y encriptación

Utilice archivos comprimidos para importar y exportar cuando sea posible.
En Linux, es posible descomprimir un archivo e importarlo al mismo tiempo mediante una línea de comandos. Por ejemplo:
zcat nl6/var/vp/import/filename.gz

También es recomendable encriptar los archivos enviados a través de la red si el proceso no es seguro. Se puede utilizar GPG para esto.

Carga de datos en lote desde archivos

La carga de datos en lote desde un archivo es más eficaz que cargar las líneas de una en una y en tiempo real (por ejemplo, a través de un servicio Web).
La importación mediante servicios Web no es eficiente. Es mejor utilizar archivos siempre que sea posible.
La llamada a los servicios Web externos para enriquecer perfiles en tiempo real también causa problemas de rendimiento y pérdidas de memoria, ya que funciona al nivel de línea.
Si necesita importar datos, es mejor hacerlo en lote mediante un flujo de trabajo en vez de hacerlo en tiempo real, mediante una aplicación Web o un servicio Web.

Uso de la gestión de datos

La carga en modo iterativo (línea a línea) con JavaScript debe limitarse a los volúmenes pequeños.
For better efficiency, always use the Data Loading (File) activity in data management workflows.

Importación en modo Delta

Las importaciones regulares deben realizarse en modo delta. Esto significa que solo se envían datos modificados o nuevos a Adobe Campaign, en lugar de toda la tabla de una sentada.
Las importaciones completas deben utilizarse únicamente para la carga inicial.
Importación de datos mediante la gestión de datos en lugar de JavaScript.

Mantenimiento de la coherencia

Para mantener la coherencia de los datos en la base de datos de Adobe Campaign, siga los principios siguientes:
  • Si los datos importados coinciden con una tabla de referencia de Adobe Campaign, se deben reconciliar con esa tabla en el flujo de trabajo. Los registros que no coinciden deben ser rechazados.
  • Asegúrese de que los datos importados siempre estén “normalizados” (correo electrónico, número de teléfono, dirección de correo postal) y que esta normalización sea fiable y no cambie con los años. Si no es así, es probable que algunos duplicados aparezcan en la base de datos y, como Adobe Campaign no proporciona herramientas para establecer correspondencias “difusas”, resulta muy difícil administrarlos y eliminarlos.
  • Los datos de transacciones deben tener una clave de reconciliación y se deben reconciliar con los datos existentes para evitar la creación de duplicados.
  • Importación de archivos relacionados en orden .
    Si la importación está compuesta por varios archivos que dependen unos de otros, el flujo de trabajo debe asegurar que los archivos se importen en el orden correcto. Si un archivo falla, los demás archivos no se importan.
  • Deduplique , reconcilie y mantenga la coherencia al importar datos.

Configuración de una importación recurrente

La utilización de una plantilla de importación es una práctica recomendada si necesita importar con regularidad archivos con la misma estructura.
Este ejemplo muestra cómo se puede predefinir un flujo de trabajo para reutilizarlo a la hora de importar perfiles provenientes de un CRM en la base de datos de Adobe Campaign. Para obtener más información sobre todos los ajustes posibles de cada actividad, consulte esta sección .
  1. Create a new workflow template from Resources > Templates > Workflow templates .
  2. Añada las siguientes actividades:
    • Data loading (file) : Defina la estructura esperada del archivo que contiene los datos que se van a importar.
    • Enrichment : Reconcilie los datos importados con los datos de la base de datos.
    • Split : Cree filtros para procesar registros de formas diferentes, dependiendo de si se podrían reconciliar o no.
    • Deduplication : Deduplique los datos del archivo entrante antes de insertarlos en la base de datos.
    • Update data : Actualice la base de datos con los perfiles importados.
  3. Configure the Data Loading (file) activity:
    • Cargue un archivo de muestra para definir la estructura que desee. El archivo de muestra debe contener tan solo unas pocas líneas, pero todas las columnas necesarias para la importación. Compruebe y edite el formato del archivo para asegurarse de que el tipo de cada columna está correctamente definido: texto, fecha, entero, etc. Por ejemplo:
      lastname;firstname;birthdate;email;crmID
      Smith;Hayden;23/05/1989;hayden.smith@mailtest.com;123456
      
      
    • En la Name of the file to load sección, seleccione Upload a file from the local machine y deje el campo en blanco. Cada vez que cree un nuevo flujo de trabajo a partir de esta plantilla, puede especificar aquí el archivo que desee, siempre que se corresponda con la estructura definida.
      Puede utilizar cualquiera de las opciones, pero debe modificar la plantilla según corresponda. For example, if you select Specified in the transition , you can add a File Transfer activity before to retrieve the file to import from a FTP/SFTP server. Con la conexión S3 o SFTP, también puede importar datos de segmentos a Adobe Campaign con la plataforma de datos del cliente en tiempo real de Adobe. Para obtener más información, consulte Documentación .
  4. Configure the Enrichment activity. El objetivo de esta actividad en este contexto es identificar los datos entrantes.
    • En la pestaña Enrichment , seleccione Add data y defina un vínculo entre los datos importados y la dimensión objetivo de los destinatarios. En este ejemplo, el campo personalizado CRM ID se utiliza para crear la condición de unión. Utilice el campo o la combinación de campos que necesite siempre que permita identificar registros únicos.
    • En la Reconciliation ficha, deje la Identify the document from the working data opción sin marcar.
  5. Configure la actividad Split para recuperar los destinatarios reconciliados en una transición, y los destinatarios que no pudieron ser reconciliados, pero que tengan datos suficientes en una segunda transición.
    La transición con los destinatarios reconciliados se puede utilizar después para actualizar la base de datos. La transición con destinatarios desconocidos se puede utilizar para crear nuevas entradas de destinatario en la base de datos si en el archivo hay un conjunto mínimo de información disponible.
    Los destinatarios que no se pueden reconciliar y no tienen datos suficientes se seleccionan en una transición saliente de complemento y se pueden exportar en un archivo independiente, o sencillamente se ignoran.
    • In the General tab of the activity, select Use the additional data only as filtering setting and make sure that the Targeting dimension is automatically set to Enrichment .
      Marque la opción Generate complement para ver si algún registro no se puede insertar en la base de datos. Si lo necesita, puede seguir procesando los datos complementarios: exportación de archivo, actualización de lista, etc.
    • En el primer subconjunto de la pestaña Subsets , añada una condición de filtrado a la población entrante para seleccionar solo los registros cuya clave principal del destinatario sea distinta a 0. De esta forma, los datos del archivo que se reconcilien con los destinatarios de la base de datos se seleccionan dentro de ese subconjunto.
    • Añada un segundo subconjunto que seleccione registros no reconciliados con datos suficientes como para poder insertarlos en la base de datos. Por ejemplo: dirección de correo electrónico, nombre y apellidos.
      Los subconjuntos se procesan por orden de creación, lo que significa que cuando se procesa este segundo subconjunto, todos los registros que ya existen en la base de datos están seleccionados en el primer subconjunto.
    • Todos los registros que no están seleccionados en los dos primeros subconjuntos se seleccionan en la Complement .
  6. Configure la actividad Update data ubicada después de la primera transición saliente de la actividad Split configurada anteriormente.
    • Seleccione Update como Operation type , ya que la transición de entrada solo contiene destinatarios ya presentes en la base de datos.
    • In the Record identification section, select Using reconciliation keys and define a key between the targeting dimension and the link created in the Enrichment . En este ejemplo, se utiliza el campo personalizado CRM ID .
    • En la sección Fields to update , indique los campos de la dimensión de destinatarios que desea actualizar con el valor de la columna correspondiente del archivo. Si los nombres de las columnas del archivo son idénticos o casi idénticos a los nombres de los campos de dimensión de los destinatarios, puede utilizar el botón de varita mágica para hacer coincidir automáticamente los diferentes campos.
  7. Configure la actividad Deduplication ubicada después de la transición que contiene los destinatarios no reconciliados:
    • Seleccione Edit configuration y establezca la dimensión objetivo en el esquema temporal generado a partir de la actividad Enrichment del flujo de trabajo.
    • En este ejemplo, el campo de correo electrónico se utiliza para buscar perfiles únicos. Puede utilizar cualquier campo que esté rellenado y que forme parte de una combinación única.
    • In the Deduplication method screen, select Advanced parameters and check the Disable automatic filtering of 0 ID records option to make sure records that have a primary key equal to 0 (which should be all records of this transition) are not excluded.
  8. Configure the Update data activity located after the Deduplication activity configured previously.
    • Seleccione Insert como Operation type , ya que la transición entrante solo contiene destinatarios que no están presentes en la base de datos.
    • En la Record identification sección, seleccione Directly using the targeting dimension y elija la Recipients dimensión.
    • En la sección Fields to update , indique los campos de la dimensión de destinatarios que desea actualizar con el valor de la columna correspondiente del archivo. Si los nombres de las columnas del archivo son idénticos o casi idénticos a los nombres de los campos de dimensión de los destinatarios, puede utilizar el botón de varita mágica para hacer coincidir automáticamente los diferentes campos.
  9. After the third transition of the Split activity, add a Data extraction (file) activity and a File transfer activity if you want to keep track of data not inserted in the database. Configure las actividades para exportar la columna que necesite y para transferir el archivo en un servidor FTP o SFTP desde donde pueda recuperarlo.
  10. Añada una actividad End y guarde la plantilla de flujo de trabajo.
Ahora la plantilla se puede utilizar y está disponible para cada nuevo flujo de trabajo. All is needed is then to specify the file containing the data to import in the Data loading (file) activity.