Integración con Adobe Campaign Classic

NOTA

En esta documentación se 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 estas instrucciones.

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

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:

  1. Empiece a crear la campaña (tanto en Adobe Campaign como en AEM).
  2. Antes de vincular el contenido y la entrega, personalice el contenido en AEM y cree una entrega en Adobe Campaign.
  3. Vincule contenido y envío en Adobe Campaign.

Comenzar a crear la campaña

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

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

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.

  1. Especifique qué instancia AEM usar.
  2. Sincronice el contenido haciendo clic en el botón Synchronize .
  3. Abra el selector de contenido para elegir el contenido.

Si es nuevo en AEM

Si es nuevo en AEM, puede que encuentre útiles los siguientes vínculos para comprender 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, como:

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

Consulte Configuraciones avanzadas.

NOTA

Para realizar estas operaciones, debe tener la variable administración en Adobe Campaign.

Requisitos previos

Asegúrese de tener los siguientes elementos previamente:

NOTA

Si está ejecutando una versión anterior a la versión 8640 de Adobe Campaign Classic, 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.

PRECAUCIÓN

Operaciones detalladas en la 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.

Instalación del paquete de integración de AEM

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

  1. Vaya a la instancia de Adobe Campaign con la que desee vincular AEM.

  2. Select Herramientas > Avanzadas > Importar paquete….

    chlimage_1-132

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

    chlimage_1-133

  4. 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.

    PRECAUCIÓN

    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.

    chlimage_1-134

Configuración de una cuenta externa AEM

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

NOTA
  • 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:

  1. Vaya a la Administración > Plataforma > Cuentas externas nodo .

  2. Cree una nueva cuenta externa y seleccione la opción AEM tipo .

  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 campaign-api es la misma que la del usuario remoto de campaign para la que se ha establecido una contraseña en AEM.

    NOTA

    Asegúrese de que la dirección del servidor not termine con una barra diagonal. Por ejemplo, introduzca https://yourserver:4502 en lugar de https://yourserver:4502/

    chlimage_1-135 chlimage_1-136

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

Verificación de la opción AEMResourceTypeFilter

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:

  1. Vaya a Plataforma >Opciones.

  2. 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

    chlimage_1-137

Configuración de 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

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.

NOTA

Si no desea utilizar la URL de replicación y, en su lugar, utiliza la URL de cara al público, puede establecer la variable URL pública en el siguiente ajuste de configuración en OSGi (Logotipo de AEM > Herramientas icono > Operaciones > Consola web > Configuración de OSGi > Integración de AEM Campaign: Configuración):
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:

  1. 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.

    chlimage_1-138

    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 estén en el mismo equipo.

  2. Toque o haga clic Editar a continuación, seleccione la Transporte pestaña .

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

    chlimage_1-139

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. Select Logotipo de AEM > Herramientas icono > Implementación > Cloud Services, luego Configurar ahora en la sección Adobe Campaign .

    chlimage_1-140

  3. 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.

  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 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.
  5. Select Conectarse a Adobe Campaign y haga clic en OK.

    chlimage_1-141

    NOTA

    Tras cree su correo electrónico y publíquelo, debe volver a publicar la configuración en la instancia de publicación.

    chlimage_1-142

NOTA

Si la conexión falla, asegúrese de comprobar lo siguiente:

  • 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 la 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.
    Además, consulte Resolución de problemas de integración de AEM/Adobe Campaign.

Configuración del externalizador

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.ExternalizerImplno 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.

chlimage_1-143

Configuraciones avanzadas

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

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

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:

PRECAUCIÓN

El campo que debe añadir ya debe haberse añadido a través de una extensión de esquema de destinatario (nms:recipient). Para obtener más información, consulte la Configuración guía.

  1. Vaya a la Administración > Configuración > Esquemas de datos en la navegación de Adobe Campaign.

  2. Select Nuevo.

    chlimage_1-144

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

    chlimage_1-145

  4. 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.
  5. 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.

  6. 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.

  7. 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

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:

chlimage_1-146

Ocultar un campo personalizado

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:

  1. Copie el campo que desea extraer de la variable nms:seedMember esquema en el esquema extendido (cus:seedMember por ejemplo).

  2. 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:

    <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

Para desactivar un bloque personalizado entre los disponibles:

  1. Vaya a la Recursos > Campaign Management > Bloques personalizados en la navegación de Adobe Campaign.

  2. Seleccione el bloque personalizado que desea desactivar en AEM.

  3. 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.

    chlimage_1-147

Administración de datos de extensión de destino

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.

NOTA

Los datos del destino solo están disponibles si el contenido AEM se sincroniza con un envío de Adobe Campaign. Consulte Sincronización del contenido creado en AEM con un envío de Adobe Campaign.

chlimage_1-148

En esta página