Integración con Adobe Campaign Classic integrating-with-adobe-campaign-classic
Adobe Campaign permite administrar el contenido y los formularios de entrega por correo electrónico directamente en Adobe Experience Manager.
Para utilizar ambas soluciones juntas 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 Uso de 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 amplía la integración con Adobe Campaign, es posible que desee ver las páginas siguientes:
Flujo de trabajo de integración de AEM y Adobe Campaign aem-and-adobe-campaign-integration-workflow
En esta sección se describe un flujo de trabajo típico entre AEM y Adobe Campaign al crear campañas y entregar contenido.
El flujo de trabajo típico implica lo siguiente y se describe en detalle:
- Empiece a crear la campaña (tanto en Adobe Campaign como en AEM).
- Antes de vincular el contenido y la entrega, personalice el contenido en AEM y cree una entrega en Adobe Campaign.
- Vincule contenido y envío en Adobe Campaign.
Comenzar a crear la campaña start-building-your-campaign
Empiece a crear una campaña en cualquier momento. Antes de vincular el contenido, AEM y AC son independientes. Esto significa que los especialistas en marketing pueden empezar a crear sus campañas y segmentación 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 before-linking-content-and-delivery
Antes de vincular el contenido y crear un mecanismo de envío, debe hacer lo siguiente:
En AEM
- Personalice utilizando los campos de personalización de la variable Texto y personalización componente
En Adobe Campaign
- Creación de una entrega de tipo aemContent
Vinculación de contenido y configuración de envíos linking-content-and-setting-delivery
Después de preparar el contenido para la vinculación y el envío, determina exactamente cómo y dónde se debe vincular el contenido.
Todos estos pasos se completan en Adobe Campaign.
- Especifique qué instancia AEM usar.
- Sincronice el contenido haciendo clic en el botón Synchronize .
- Abra el selector de contenido para elegir el contenido.
Si es nuevo en AEM if-you-are-new-to-aem
Si es nuevo en AEM, puede que encuentre útiles los siguientes vínculos para comprender AEM:
Configuración de Adobe Campaign configuring-adobe-campaign
La configuración de Adobe Campaign implica lo siguiente:
- Instalación del paquete de integración de AEM en Adobe Campaign.
- Configuración de una cuenta externa.
- Comprobando que AEMResourceTypeFilter está configurado correctamente.
Además, hay configuraciones avanzadas que puede realizar, como:
- Administración de bloques de contenido
- Administración de campos personalizados
Consulte Configuraciones avanzadas.
Requisitos previos prerequisites
Asegúrese de tener los siguientes elementos previamente:
- Una instancia de creación de AEM
- Una instancia de publicación AEM
- Una instancia de Adobe Campaign Classic : incluye un cliente y un servidor
- Internet Explorer 11
Instalación del paquete de integración de AEM installing-the-aem-integration-package
Debe instalar el Integración AEM en Adobe Campaign. Para ello, haga lo siguiente:
-
Vaya a la instancia de Adobe Campaign con la que desee vincular AEM.
-
Select Herramientas > Avanzadas > Importar paquete….
-
Haga clic en Instalación de un paquete estándar y, a continuación, seleccione Integración AEM paquete.
-
Haga clic en Siguiente y luego Inicio.
Este paquete contiene el aemserver operador que se utilizará para conectar el servidor de AEM a Adobe Campaign.
note caution CAUTION De forma predeterminada, no hay ninguna zona de seguridad configurada para este operador. Para conectarse a Adobe Campaign mediante AEM, debe seleccionar una. En el serverConf.xml archivo, la variable allowUserPassword del área de seguridad seleccionada debe estar configurada en true para autorizar a AEM a conectar Adobe Campaign mediante inicio de sesión o contraseña. Recomendamos encarecidamente que cree una zona de seguridad dedicada a AEM para evitar problemas de seguridad. Para obtener más información, consulte Guía de instalación.
Configuración de una cuenta externa AEM configuring-an-aem-external-account
Debe configurar una cuenta externa que le permita conectar Adobe Campaign a la instancia de AEM.
- Al instalar el Integración AEM , se crea una cuenta de AEM externa. Puede configurar la conexión a la instancia de AEM desde ella o crear una nueva.
- En AEM, asegúrese de establecer la contraseña para el usuario remoto de la campaña. Debe establecer esta contraseña para conectar Adobe Campaign con AEM. Inicie sesión como administrador y, en la consola de administración de usuarios, busque el usuario remoto de la campaña y haga clic en Establecer contraseña.
Para configurar una cuenta de AEM externa:
-
Vaya a la Administración > Plataforma > Cuentas externas nodo .
-
Cree una nueva cuenta externa y seleccione la opción AEM tipo .
-
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 campaign-api es la misma que la del usuario remoto de campaign para la que se ha establecido una contraseña en AEM.
note note NOTE Asegúrese de que la dirección del servidor not termine con una barra diagonal. Por ejemplo, introduzca https://yourserver:4502
en lugar dehttps://yourserver:4502/
-
Asegúrese de que la variable Habilitado está seleccionada.
Verificación de la opción AEMResourceTypeFilter verifying-the-aemresourcetypefilter-option
La variable AEMResourceTypeFilter se utiliza para filtrar tipos de recursos de AEM que se pueden utilizar en Adobe Campaign. Esto permite a Adobe Campaign recuperar AEM contenido específicamente diseñado 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 el AEMResourceTypeFilter está configurada:
-
Vaya a Plataforma >Opciones.
-
En el AEMResourceTypeFilter , compruebe que las rutas son correctas. Este campo debe contener el valor:
mcm/campaign/components/newsletter,mcm/campaign/components/campaign_newsletterpage,mcm/neolane/components/newsletter
O, en algunos casos, el valor es el siguiente:
mcm/campaign/components/newsletter
Configuración de Adobe Experience Manager configuring-adobe-experience-manager
Para configurar AEM, debe hacer lo siguiente:
- Configure la replicación entre instancias.
- Conecte AEM a Adobe Campaign mediante Cloud Services.
- Configure el externalizador.
Configuración de la replicación entre instancias AEM configuring-replication-between-aem-instances
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.
URL pública: com.day.cq.mcm.campaign.impl.IntegrationConfigImpl#aem.mcm.campaign.publicUrl
Este paso también es necesario para replicar ciertas configuraciones de instancia 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 autor y haga clic en Agente predeterminado.
note note NOTE 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 estén en el mismo equipo. -
Toque o haga clic Editar a continuación, seleccione la Transporte pestaña .
-
Configure el URI reemplazando localhost con la dirección IP o la dirección de la instancia de publicación de AEM.
Conexión de AEM a Adobe Campaign connecting-aem-to-adobe-campaign
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.
-
Select Logotipo de AEM > Herramientas icono > Implementación > Cloud Services, luego Configurar ahora en la sección Adobe Campaign .
-
Cree una nueva configuración introduciendo una Título y haga clic en Crear o elija la configuración existente que desea vincular con la instancia de Adobe Campaign.
-
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 Adobe Campaign AEM se utiliza 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 de este operador directamente en Adobe Campaign.
- Punto final de API: URL de instancia de Adobe Campaign.
-
Select Conectarse a Adobe Campaign y haga clic en OK.
note note NOTE Tras cree su correo electrónico y publíquelo, debe volver a publicar la configuración en la instancia de publicación.
- Puede encontrar un problema de certificado al utilizar una conexión segura a una instancia de Adobe Campaign (https). Deberá añadir el certificado de instancia de Adobe Campaign al cacerías del JDK de su instancia de AEM.
- Se debe configurar una zona de seguridad para la variable operador aemserver en Adobe Campaign. Además, en el serverConf.xml archivo, la variable allowUserPassword de la zona de seguridad debe establecerse en true para autorizar AEM conexión a Adobe Campaign mediante el modo de inicio de sesión/contraseña.
Configuración del externalizador configuring-the-externalizer
Debe configurar el externalizador en AEM en la instancia de autor. El externalizador es un servicio OSGi que permite transformar una ruta de recurso en una dirección URL externa y absoluta. Este servicio proporciona un lugar central para configurar esas direcciones URL externas y crearlas.
Consulte Configuración del externalizador para 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 apunte a localhost:4503
pero a un servidor al que se pueda acceder desde la consola de Adobe Campaign.
Si señala a localhost:4503
o cualquier otro servidor al que Adobe Campaign no pueda acceder, las imágenes no aparecerán en la consola de Adobe Campaign.
Configuraciones avanzadas advanced-configurations
También puede realizar algunas configuraciones avanzadas, como:
- Administrar campos y bloques personalizados.
- Desactivar un bloque personalizado.
- Administre los datos de extensión de destino.
Administración de campos y bloques personalizados managing-personalization-fields-and-blocks
Adobe Campaign administra los campos y bloques disponibles para añadir personalización al contenido del correo electrónico en AEM.
Se proporciona una lista predeterminada, pero se puede modificar. También puede añadir u ocultar campos y bloques personalizados.
Adición de un campo personalizado adding-a-personalization-field
Para añadir un nuevo campo de personalización a los que ya están disponibles, debe ampliar Adobe Campaign nms:seedMember esquema como se indica a continuación:
-
Vaya a la Administración > Configuración > Esquemas de datos en la navegación de Adobe Campaign.
-
Select Nuevo.
-
En la ventana emergente, seleccione Ampliación de los datos de la tabla mediante un esquema de extensión y haga clic en Siguiente.
-
Introduzca los diferentes parámetros del esquema ampliado:
- Esquema: seleccione nms:seedMember esquema. Los demás campos de la ventana se completan automáticamente.
- Área de nombres: personalice el área de nombres del esquema extendido.
-
Edite el código XML del esquema para especificar el campo que desea añadir allí. Para obtener más información sobre la ampliació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 la variable Herramientas > Avanzadas > Actualizar estructura de base de datos en la consola.
-
Desconéctese y vuelva a conectarse a la consola de Adobe Campaign para guardar los cambios. El nuevo campo aparece ahora en la lista de campos personalizados disponibles en AEM.
Ejemplo example
Para agregar un Número de registro , debe tener los siguientes elementos:
- La variable nms:recipient extensión de esquema denominada cus:recipient 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 variable nms:seedMember extensión de esquema denominada cus:seedMember 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>
La variable Número de registro ahora forma parte de los campos personalizados disponibles:
Ocultar un campo personalizado hiding-a-personalization-field
Para ocultar un campo de personalización entre los que ya están disponibles, debe ampliar Adobe Campaign nms:seedMember como se detalla en la sección Adición de un campo personalizado para obtener más información. Siga estos pasos:
-
Copie el campo que desea extraer de la variable nms:seedMember esquema en el esquema extendido (cus:seedMember por ejemplo).
-
Agregue la variable advanced="true" Atributo XML al campo. Ya no aparece en la lista de campos personalizados disponibles en AEM.
Por ejemplo, para ocultar la variable Segundo nombre , el campo cud:seedMember El esquema debe contener el siguiente elemento:
code language-xml <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 personalizado deactivating-a-personalization-block
Para desactivar un bloque personalizado entre los disponibles:
-
Vaya a la Recursos > Campaign Management > Bloques personalizados en la navegación de Adobe Campaign.
-
Seleccione el bloque personalizado que desea desactivar en AEM.
-
Borre la variable Visible en los menús de personalización y guarde los cambios. El bloque ya no aparece en la lista de bloques personalizados disponibles en Adobe Campaign.
Administración de datos de extensión de destino managing-target-extension-data
También puede insertar datos de extensión de destino para personalizarlos. Los datos de extensión de Target (también denominados "datos de Target") proceden de enriquecer o añadir datos en una consulta en un flujo de trabajo de campaña, por ejemplo. Para obtener más información, consulte Creación de consultas y Enriquecimiento de datos secciones.