Esta documentación describe cómo integrar AEM con Adobe Campaign Classic, la solución local. Si utiliza Adobe Campaign Standard, consulte Integración con Adobe Campaign Standard para obtener estas instrucciones.
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:
Si está ampliando la integración con Adobe Campaign, es posible que desee ver las páginas siguientes:
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:
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 el contenido y crear un mecanismo de envío, debe hacer lo siguiente:
En AEM
En Adobe Campaign
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.
Si es nuevo en AEM, puede encontrar los siguientes vínculos útiles para comprender AEM:
La configuración de Adobe Campaign implica lo siguiente:
Además, hay configuraciones avanzadas que puede realizar, entre las que se incluyen:
Consulte Configuraciones avanzadas.
Para realizar estas operaciones, debe tener la función administración en Adobe Campaign.
Asegúrese de que tiene los siguientes elementos de antemano:
Si está ejecutando una versión anterior a Adobe Campaign Classic compilación 8640, consulte la documentación de actualización para obtener más información. Tenga en cuenta que tanto el cliente como la base de datos deben actualizarse a la misma compilación.
Las operaciones detalladas en las secciones Configuración de Adobe Campaign y Configuración de Adobe Experience Manager son necesarias para que las funcionalidades de integración entre AEM y Adobe Campaign funcionen correctamente.
Debe instalar el paquete Integración de AEM en Adobe Campaign. Para ello:
Vaya a la instancia de Adobe Campaign con la que desea establecer el vínculo AEM.
Seleccione Herramientas > Avanzadas > Importar paquete….
Haga clic en Instalar un paquete estándar y, a continuación, seleccione el paquete Integración de AEM.
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.
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.
Debe configurar una cuenta externa que le permita conectar Adobe Campaign a la instancia de AEM.
Para configurar una cuenta de AEM externa:
Vaya al nodo Administración > Plataforma > Cuentas externas.
Cree una nueva cuenta externa y seleccione el tipo AEM.
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.
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/
Asegúrese de que la casilla Habilitado está seleccionada.
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:
Vaya a Plataforma >Opciones.
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
Para configurar AEM, debe hacer lo siguiente:
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.
Si no desea utilizar la URL de replicación pero en su lugar utiliza la URL de cara al público, puede establecer la URL pública en la siguiente configuración en OSGi (logotipo de AEM > Herramientas icono > Operaciones > Consola Web > 10/>Configuración de OSGi > Integración de Campaña de AEM - Configuración ):
URL pública: com.day.cq.mcm.campaña.impl.IntegrationConfigImpl#aem.mcm.campaña.publicUrl
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:
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.
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.
Toque o haga clic en Editar y luego seleccione la ficha Transporte.
Configure el URI reemplazando localhost por la dirección IP o la dirección de la instancia de publicación AEM.
Antes de poder usar AEM y Adobe Campaign juntos, debe establecer el vínculo entre ambas soluciones para que puedan comunicarse.
Conéctese a la instancia de creación de AEM.
Seleccione logotipo de AEM > Herramientas icono > Implementación > Cloud Services, luego Configurar ahora en la sección Adobe Campaign.
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.
Edite la configuración para que coincida con los parámetros de la instancia de Adobe Campaign.
Seleccione Conectar a Adobe Campaign y haga clic en Aceptar.
Después de crear el correo electrónico y publicarlo, debe volver a publicar la configuración en la instancia de publicación.
Si la conexión falla, asegúrese de comprobar lo siguiente:
Además, consulte Solución de problemas de la integración de AEM/Adobe Campaign.
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.ExternalizerImpl
no 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.
También puede realizar algunas configuraciones avanzadas, a saber:
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.
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:
El campo que debe agregar ya debe haberse agregado mediante una extensión de esquema de destinatario (nms:destinatario). Para obtener más información, consulte la guía Configuration.
Vaya al nodo Administración > Configuración > esquemas de datos en la navegación de Adobe Campaign.
Seleccione Nuevo.
En la ventana emergente, seleccione Extender los datos de la tabla con un esquema de extensión y haga clic en Siguiente.
Introduzca los distintos parámetros del esquema extendido:
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.
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.
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.
Para agregar un campo Número de registro, debe tener los siguientes elementos:
<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:
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:
Copie el campo que desea tomar del esquema nms:semismiembro en el esquema extendido (cus:semillaMember por ejemplo).
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>
Para desactivar un bloque de personalización entre los disponibles:
Vaya al nodo Resources > Gestión de la campaña > Bloques de personalización en la navegación de Adobe Campaign.
Seleccione el bloque de personalización que desea desactivar en AEM.
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.
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.
Los datos del destinatario solo están disponibles si el contenido AEM está sincronizado con un envío de Adobe Campaign. Consulte Sincronización de contenido creado en AEM con un envío de Adobe Campaign.