Integración con Adobe Campaign Classic

Adobe Campaign permite administrar el contenido y los formularios de envío de correo electrónico directamente en Adobe Experience Manager.

Para utilizar ambas soluciones al mismo tiempo, primero debe configurarlas para conectarse entre sí. Esto implica pasos de configuración tanto en Adobe Campaign como en Adobe Experience Manager. Estos pasos se describen en detalle en este documento.

Trabajar con Adobe Campaign en AEM incluye la capacidad de enviar correos electrónicos a través de Adobe Campaign y se describe en Trabajo con Adobe Campaign. También incluye el uso de formularios en páginas AEM para manipular datos.

Además, los siguientes temas pueden ser de interés al integrar AEM con Adobe Campaign:

• Prácticas recomendadas para plantillas de correo electrónico
• Solución de problemas de la integración de Adobe Campaign

Si está ampliando la integración con Adobe Campaign, es posible que desee ver las páginas siguientes:

• Creación de extensiones personalizadas
• Creación de asignaciones de formularios personalizados

Flujo de trabajo de integración de AEM y Adobe Campaign

En esta sección se describe un flujo de trabajo típico entre AEM y Adobe Campaign al crear campañas y distribuir contenido.

El flujo de trabajo típico incluye lo siguiente y se describe en detalle:

1. Inicio que crea su campaña (tanto en Adobe Campaign como en AEM).
2. Antes de vincular el contenido y el envío, personalice el contenido en AEM y cree un envío en Adobe Campaign.
3. Vincule contenido y envío en Adobe Campaign.

Inicio generando su campaña

Inicios construir una campaña en cualquier momento. Antes de vincular el contenido, AEM y CA son independientes. Esto significa que los especialistas en marketing pueden crear inicios para crear sus campañas y objetivos en Adobe Campaign, mientras que los creadores de contenido están trabajando en el diseño en AEM.

Antes de vincular contenido y envío

Antes de vincular el contenido y crear un mecanismo de envío, debe hacer lo siguiente:

En AEM

• Personalice con los campos de personalización del componente Texto y personalización

En Adobe Campaign

• Cree un envío de tipo aemContent

Vinculación de contenido y configuración de envío

Una vez que haya preparado el contenido para la vinculación y el envío, determinará exactamente cómo y dónde se vinculará el contenido.

Todos estos pasos se completan en Adobe Campaign.

1. Especifique qué instancia AEM utilizar.
2. Para sincronizar el contenido, haga clic en el botón Sincronizar.
3. Abra el selector de contenido para elegir el contenido.

Si es nuevo en AEM

Si es nuevo en AEM, puede encontrar los siguientes vínculos útiles para comprender AEM:

• AEM de inicio
• Explicación de los agentes de replicación
• Búsqueda y trabajo con archivos de registro
• Introducción a la Plataforma AEM

Configuración de Adobe Campaign

La configuración de Adobe Campaign implica lo siguiente:

1. Instalación del paquete de integración de AEM en Adobe Campaign.
2. Configuración de una cuenta externa.
3. Comprobando que AEMResourceTypeFilter está configurado correctamente.

Además, hay configuraciones avanzadas que puede realizar, entre las que se incluyen:

• Administración de bloques de contenido
• Administración de campos de personalización

Consulte Configuraciones avanzadas.

Requisitos previos

Asegúrese de que tiene los siguientes elementos de antemano:

• Una instancia de creación de AEM
• Una instancia de publicación AEM
• Una instancia de Adobe Campaign Classic, que incluye un cliente y un servidor
• Internet Explorer 11

Instalación del paquete de integración de AEM

Debe instalar el paquete Integración de AEM en Adobe Campaign. Para ello:

1. Vaya a la instancia de Adobe Campaign con la que desea establecer el vínculo AEM.

2. Seleccione Herramientas > Avanzadas > Importar paquete….

   

3. Haga clic en Instalar un paquete estándar y, a continuación, seleccione el paquete Integración de AEM.

   

4. Haga clic en Siguiente y luego en Inicio.

   Este paquete contiene el operador aemserver que se utilizará para conectar el servidor de AEM a Adobe Campaign.

   PRECAUCIÓN

   De forma predeterminada, no hay ninguna zona de seguridad configurada para este operador. Para conectarse a Adobe Campaign mediante AEM, debe seleccionar uno.

   En el archivo serverConf.xml, el atributo allowUserPassword de la zona de seguridad seleccionada debe establecerse en true para autorizar a AEM a conectar Adobe Campaign mediante inicio de sesión o contraseña.

   Recomendamos encarecidamente crear una zona de seguridad dedicada a AEM para evitar cualquier problema de seguridad. Para obtener más información sobre esto, consulte la Guía de instalación.

   

Configuración de una cuenta externa de AEM

Debe configurar una cuenta externa que le permita conectar Adobe Campaign a la instancia de AEM.

Para configurar una cuenta de AEM externa:

1. Vaya al nodo Administración > Plataforma > Cuentas externas.

2. Cree una nueva cuenta externa y seleccione el tipo AEM.

3. Introduzca los parámetros de acceso para la instancia de creación de AEM: la dirección del servidor, así como el ID y la contraseña utilizados para conectarse a esta instancia. La contraseña de la cuenta de usuario de la API de campaña es la misma que la del usuario remoto de campaña para el que se ha establecido una contraseña en AEM.

   NOTA

   Asegúrese de que la dirección del servidor no termina en una barra diagonal final. Por ejemplo, escriba https://yourserver:4502 en lugar de https://yourserver:4502/

   

4. Asegúrese de que la casilla Habilitado está seleccionada.

Verificación de la opción AEMResourceTypeFilter

La opción AEMResourceTypeFilter se utiliza para filtrar los tipos de recursos de AEM que se pueden usar en Adobe Campaign. Esto permite que Adobe Campaign recupere AEM contenido que están específicamente diseñados para utilizarse solo en Adobe Campaign.

Esta opción debe estar preconfigurada; sin embargo, si cambia esta opción, puede provocar que la integración no funcione.

Para verificar la opción AEMResourceTypeFilter está configurada:

1. Vaya a Plataforma >Opciones.

2. En la opción AEMResourceTypeFilter, compruebe que las rutas son correctas. Este campo debe contener el valor:

   mcm/campaña/componentes/newsletter,mcm/campaña/componentes/campaña_newsletterpage,mcm/neolane/components/newsletter

   O, en algunos casos, el valor es el siguiente:

   mcm/campaña/componentes/newsletter

   

Configuración de Adobe Experience Manager

Para configurar AEM, debe hacer lo siguiente:

• Configure la replicación entre instancias.
• Conectar AEM a Adobe Campaign mediante Cloud Services.
• Configure el externalizador.

Configuración de la replicación entre instancias de AEM

El contenido creado a partir de la instancia de creación de AEM se envía primero a la instancia de publicación. Debe publicar para que las imágenes de la newsletter estén disponibles en la instancia de publicación y para los destinatarios de la newsletter. Por lo tanto, el agente de replicación debe configurarse para replicarse desde la instancia de creación de AEM a la instancia de publicación de AEM.

Este paso también es necesario para replicar determinadas configuraciones de instancias de creación en la instancia de publicación.

Para configurar la replicación entre instancias de AEM:

1. En la instancia de creación, seleccione logotipo de AEM Herramientas icono > Implementación > Replicación > Agentes en el autor, luego haga clic en Agente predeterminado.

   

   NOTA

   Evite utilizar localhost (es decir, una copia local de AEM) al configurar la integración con Adobe Campaign, a menos que la instancia de publicación y de autor se encuentre en el mismo equipo.

2. Toque o haga clic en Editar y luego seleccione la ficha Transporte.

3. Configure el URI reemplazando localhost por la dirección IP o la dirección de la instancia de publicación AEM.

   

Conexión de AEM a Adobe Campaign

Antes de poder usar AEM y Adobe Campaign juntos, debe establecer el vínculo entre ambas soluciones para que puedan comunicarse.

1. Conéctese a la instancia de creación de AEM.

2. Seleccione logotipo de AEM > Herramientas icono > Implementación > Cloud Services, luego Configurar ahora en la sección Adobe Campaign.

   

3. Cree una nueva configuración ingresando un Título y haga clic en Crear, o elija la configuración existente que desee vincular con la instancia de Adobe Campaign.

4. Edite la configuración para que coincida con los parámetros de la instancia de Adobe Campaign.

   • Nombre de usuario: aemserver, el operador de paquete de integración de AEM de Adobe Campaign utilizado para establecer el vínculo entre las dos soluciones.
   • Contraseña: Contraseña del operador de Adobe Campaign aemserver. Es posible que tenga que volver a especificar la contraseña para este operador directamente en Adobe Campaign.
   • Punto final de API: URL de instancia de Adobe Campaign.

5. Seleccione Conectar a Adobe Campaign y haga clic en Aceptar.

   

   NOTA

   Después de crear el correo electrónico y publicarlo, debe volver a publicar la configuración en la instancia de publicación.

   

Además, consulte Solución de problemas de la integración de AEM/Adobe Campaign.

Configuración del externalizador

Debe configurar el externalizador en AEM en la instancia de creación. Externalizador es un servicio OSGi que permite transformar una ruta de recursos en una dirección URL externa y absoluta. Este servicio proporciona un lugar central para configurar esas direcciones URL externas y generarlas.

Consulte Configuración del externalizador para obtener instrucciones generales. Para la integración con Adobe Campaign, asegúrese de configurar el servidor de publicación en https://<host>:<port>/system/console/configMgr/com.day.cq.commons.impl.ExternalizerImplno señale a localhost:4503 sino a un servidor al que se pueda acceder desde la consola de Adobe Campaign.

Si apunta a localhost:4503 u otro servidor al que Adobe Campaign no pueda acceder, las imágenes no aparecerán en la consola de Adobe Campaign.

Configuraciones avanzadas

También puede realizar algunas configuraciones avanzadas, a saber:

• Administrar campos de personalización y bloques.
• Desactivar un bloque de personalización.
• Administrar datos de extensión de grupo de destinatarios.

Administración de campos de personalización y bloques

Adobe Campaign administra los campos y los bloques disponibles para agregar personalización al contenido de su correo electrónico en AEM.

Se proporciona una lista predeterminada, pero se puede modificar. También puede agregar u ocultar campos de personalización y bloques.

Añadir un campo de personalización

Para agregar un nuevo campo de personalización a los que ya están disponibles, debe extender el esquema de Adobe Campaign nms:startupMember de la siguiente manera:

1. Vaya al nodo Administración > Configuración > esquemas de datos en la navegación de Adobe Campaign.

2. Seleccione Nuevo.

   

3. En la ventana emergente, seleccione Extender los datos de la tabla con un esquema de extensión y haga clic en Siguiente.

   

4. Introduzca los distintos parámetros del esquema extendido:

   • Esquema: seleccione el esquema nms: semillaMemberschema. Los demás campos de la ventana se completan automáticamente.
   • Área de nombres: personalizar la Área de nombres del esquema extendido.

5. Edite el código XML del esquema para especificar el campo que desea agregar allí. Para obtener más información sobre la extensión de esquemas en Adobe Campaign, consulte la Guía de configuración.

6. Guarde el esquema y, a continuación, actualice la estructura de la base de datos de Adobe Campaign mediante el menú Herramientas > Avanzadas > Actualizar estructura de la base de datos de la consola.

7. Desconecte y vuelva a conectar con la consola de Adobe Campaign para guardar los cambios. El nuevo campo aparece ahora en la lista de campos de personalización disponibles en AEM.

Ejemplo

Para agregar un campo Número de registro, debe tener los siguientes elementos:

• La extensión de esquema nms:destinatario denominada cus:destinatario contiene:

<element desc="Recipient table (profiles)" img="nms:recipient.png" label="Recipients" labelSingular="Recipient" name="recipient">

  <attribute dataPolicy="smartCase" desc="Recipient registration number" 
  label="Registration Number"
  length="50" name="registrationNumber" type="string"/>

</element>

La extensión de esquema nms:inicializaciónMember con el nombre cus:startupMember contiene:

<element desc="Seed to insert in the export files" img="nms:unknownad.png" label="Seed addresses" labelSingular="Seed" name="seedMember">

  <element name="custom_nms_recipient">
    <attribute name="registrationNumber" 
    template="cus:recipient:recipient/@registrationNumber"/>
  </element>

</element>

El campo Número de registro ahora forma parte de los campos de personalización disponibles:

Ocultar un campo de personalización

Para ocultar un campo de personalización entre los que ya están disponibles, debe extender el esquema de Adobe Campaign nms:foundationMember como se detalla en la sección Añadir un campo de personalización. Siga estos pasos:

1. Copie el campo que desea tomar del esquema nms:semismiembro en el esquema extendido (cus:semillaMember por ejemplo).

2. Añada el atributo advanced="true" XML al campo. Ya no aparece en la lista de campos de personalización disponibles en AEM.

   Por ejemplo, para ocultar el campo Nombre medio, el esquema cud:startingMember debe contener el siguiente elemento:

   <element desc="Seed to insert in the export files" img="nms:unknownad.png" label="Seed addresses" labelSingular="Seed" name="seedMember">
   
     <element name="custom_nms_recipient">
       <attribute advanced="true" name="middleName"/>
     </element>
   
   </element>
   

Desactivación de un bloque de personalización

Para desactivar un bloque de personalización entre los disponibles:

1. Vaya al nodo Resources > Gestión de la campaña > Bloques de personalización en la navegación de Adobe Campaign.

2. Seleccione el bloque de personalización que desea desactivar en AEM.

3. Desactive la casilla Visible en los menús de personalización y guarde los cambios. El bloque ya no aparece en la lista de bloques de personalización disponibles en Adobe Campaign.

   

Administración de datos de extensión de grupo de destinatarios

También puede insertar datos de extensión de grupo de destinatarios para su personalización. Los datos de extensión de grupo de destinatarios (también llamados "datos de Destinatario") provienen, por ejemplo, de enriquecer o agregar datos en una consulta de un flujo de trabajo de campaña. Para obtener más información, consulte las secciones Creación de consultas y Enriquecimiento de datos.