Integración con Adobe Target mediante E/S de Adobe

La integración de AEM con Adobe Target mediante la API de Target Standard requiere la configuración de IMS de Adobe (Identity Management System) y E/S de Adobe.

Nota

La compatibilidad con la API de Adobe Target Standard es nueva en AEM 6.5. La API de Target Standard utiliza la autenticación IMS.

El uso de la API de Adobe Target Classic en AEM sigue siendo compatible con versiones anteriores. La API de Destinatario Classic utiliza la autenticaciónde las credenciales de usuario.

La selección de la API está impulsada por el método de autenticación utilizado para la integración de AEM/Destinatario.

Requisitos previos

Antes de iniciar este procedimiento:

  • La asistencia para Adobes debe aprovisionar su cuenta para:

    • Consola de Adobe
    • E/S Adobe
    • Adobe Target y
    • Adobe IMS (sistema Identity Management)
  • El administrador de sistemas de su organización debe utilizar el Admin Console para agregar los desarrolladores requeridos de su organización a los perfiles de productos relevantes.

    • Esto proporciona a los desarrolladores específicos permisos para habilitar integraciones dentro de la E/S de Adobe.
    • Para obtener más información, consulte Administrar desarrolladores.

Configuración de IMS - Generación de una clave pública

La primera etapa de la configuración es crear una configuración de IMS en AEM y generar la clave pública.

  1. En AEM, abra el menú Herramientas .

  2. En la sección Seguridad , seleccione Configuraciones de IMS de Adobe.

  3. Seleccione Crear para abrir la configuración de la cuenta técnica de IMS de Adobe.

  4. Con el menú desplegable en Configuración de nube, seleccione Adobe Target.

  5. Active Crear nuevo certificado e introduzca un nuevo alias.

  6. Confirme con Crear certificado.

  7. Seleccione Descargar (o Descargar clave pública) para descargar el archivo en la unidad local, de modo que esté listo para utilizarse al configurar la integración de Adobe I/O para Adobe Target con AEM.

    PRECAUCIÓN

    Mantenga esta configuración abierta, será necesaria de nuevo al completar la configuración de IMS en AEM.

Configuración de la integración de E/S de Adobe para Adobe Target con AEM

Debe crear el proyecto de E/S de Adobe (integración) con Adobe Target que AEM utilizará y, a continuación, asignar los privilegios necesarios.

Creación del proyecto

Abra la consola de E/S de Adobe para crear un proyecto de E/S con Adobe Target que AEM:

Nota

Consulte también los tutoriales de E/S deAdobe.

  1. Abra la consola de E/S de Adobe para proyectos:

    https://console.adobe.io/projects

  2. Se mostrarán todos los proyectos que tenga. Seleccione Crear nuevo proyecto : la ubicación y el uso dependerán de:

    • Si todavía no tiene ningún proyecto, Crear nuevo proyecto será central e inferior.

      Crear nuevo proyecto: primer proyecto

    • Si ya tiene proyectos existentes, estos se enumerarán y Crear nuevo proyecto se mostrará en la parte superior derecha.

      Crear nuevo proyecto - Varios proyectos

  3. Seleccione Añadir al proyecto seguido de la API:

  4. Seleccione Adobe Target y, a continuación, Siguiente:

    Nota

    Si está suscrito a Adobe Target, pero no lo ve en la lista, debe comprobar los requisitos previos.

  5. Cargue la clave pública y, cuando termine, continúe con Siguiente:

  6. Revise las credenciales y continúe con Siguiente:

  7. Seleccione los perfiles de producto necesarios y continúe con Guardar API configurada:

    Nota

    Los perfiles del producto mostrados dependen de si tiene:

    • Adobe Target Standard: solo está disponible el espacio de trabajo ​predeterminado
    • Adobe Target Premium: se muestran todos los espacios de trabajo disponibles, como se muestra a continuación

  8. Se confirmará la creación.

Asignación de privilegios a la integración

Ahora debe asignar los privilegios necesarios a la integración:

  1. Abra el Admin Console de Adobe:

  2. Vaya a Productos (barra de herramientas superior) y, a continuación, seleccione Adobe Target - <su inquilino-id> (en el panel izquierdo).

  3. Seleccione Perfiles de producto y, a continuación, el espacio de trabajo necesario en la lista presentada. Por ejemplo, Espacio de trabajo predeterminado.

  4. Seleccione Integraciones y luego la configuración de integración requerida.

  5. Seleccione Editor como función de producto; en lugar de Observador.

Detalles almacenados para el proyecto de integración de E/S de Adobe

Desde la consola Proyectos de E/S de Adobe puede ver una lista de todos los proyectos de integración:

Seleccione Vista (a la derecha de una entrada de proyecto específica) para mostrar más detalles sobre la configuración. Entre estas características se incluyen:

  • Información general del proyecto
  • Perspectivas
  • Credenciales
    • Cuenta de servicio (JWT)
      • Detalles de credenciales
      • Generar JWT
  • API
    • Por ejemplo, Adobe Target

Algunas de ellas deberán completar la integración de E/S de Adobe para Destinatario en AEM.

Finalización de la configuración de IMS en AEM

Si vuelve a AEM, puede completar la configuración de IMS agregando los valores necesarios de la integración de E/S de Adobe para Destinatario:

  1. Vuelva a la configuración de IMS abierta en AEM.

  2. Seleccione Siguiente.

  3. Aquí puede utilizar los detalles de E/Sde Adobe:

    • Título: Tu texto.
    • Servidor de autorización: Copie o pegue esto desde la "aud" línea de la sección Carga siguiente, por ejemplo "https://ims-na1.adobelogin.com" en el ejemplo siguiente
    • Clave de API: Copie esto desde la sección Información general de la integración de E/S de Adobe para Destinatario
    • Secreto del cliente: Genere esto en la sección Información general de la integración de E/S de Adobe para Destinatario y copie
    • Carga útil: Copie esto de la sección Generar JWT de la integración de E/S de Adobe para Destinatario

  4. Confirme con Crear.

  5. La configuración de Adobe Target se mostrará en la consola de AEM.

Confirmación de la configuración de IMS

Para confirmar que la configuración está funcionando según lo esperado:

  1. Abra:

    • https://localhost<port>/libs/cq/adobeims-configuration/content/configurations.html

    Por ejemplo:

    • https://localhost:4502/libs/cq/adobeims-configuration/content/configurations.html
  2. Seleccione la configuración.

  3. Seleccione Comprobar estado en la barra de herramientas, seguido de Comprobación.

  4. Si se realiza correctamente, verá el mensaje:

Configuración del Cloud Service de Adobe Target

Ahora se puede hacer referencia a la configuración para que un Cloud Service utilice la API de Target Standard:

  1. Abra el menú Herramientas . A continuación, en la sección Cloud Services , seleccione Cloud Services ​preexistentes.

  2. Desplácese hacia abajo hasta Adobe Target y seleccione Configurar ahora.

    The Create Configuration dialog will open.

  3. Introduzca un Título y, si lo desea, un Nombre (si se deja en blanco, se generará a partir del título).

    También puede seleccionar la plantilla requerida (si hay más de una disponible).

  4. Confirme con Crear.

    Se abrirá el cuadro de diálogo Editar componente .

  5. Introduzca los detalles en la ficha Configuración de Adobe Target:

    • Autenticación: IMS

    • ID del inquilino: ID de inquilino de IMS de Adobe

      Nota

      Para IMS, este valor debe tomarse del propio Destinatario. Puede iniciar sesión en Destinatario y extraer el ID del inquilino de la dirección URL.

      Por ejemplo, si la dirección URL es:

      https://experience.adobe.com/#/@yourtenantid/target/activities

      Entonces usarías yourtenantid.

    • Configuración de IMS: seleccione el nombre de la configuración de IMS

    • Tipo de API: REST

    • Configuración de A4T Analytics Cloud: Seleccione la configuración de nube de Analytics que se utiliza para las métricas y los objetivos de actividad de destinatario. Esto es necesario si utiliza Adobe Analytics como fuente de sistema de informes al destinar contenido. Si no ve la configuración de nube, consulte la nota en Configuraciónde A4T Analytics Cloud.

    • Usar objetivos precisos: De forma predeterminada, esta casilla de verificación está activada. Si se selecciona, la configuración del servicio en la nube esperará a que se cargue el contexto antes de cargar el contenido. Véase la nota siguiente.

    • Sincronizar segmentos desde Adobe Target: Seleccione esta opción para descargar los segmentos definidos en Destinatario y utilizarlos en AEM. Debe seleccionar esta opción cuando la propiedad Tipo de API sea REST, ya que los segmentos en línea no son compatibles y siempre debe utilizar segmentos de Destinatario. (Tenga en cuenta que el término AEM de 'segmento' equivale al Destinatario 'audiencia').

    • Biblioteca de cliente: Seleccione si desea la biblioteca de cliente de AT.js o mbox.js (desaprobada).

    • Utilice el sistema de administración de etiquetas para entregar la biblioteca del cliente: Utilice DTM (desaprobada), Inicio de Adobe o cualquier otro sistema de administración de etiquetas.

    • AT.js personalizado: Deje en blanco si ha marcado la casilla Administración de etiquetas o si desea utilizar AT.js predeterminado. Como alternativa, cargue su AT.js personalizado. Solo aparece si ha seleccionado AT.js.

    Nota

    La configuración de un Cloud Service para utilizar la API de Destinatario Classic ha quedado obsoleta (utiliza la ficha Configuración de Adobe Recommendations).

    Por ejemplo:

  6. Haga clic en Conectar a Destinatario para inicializar la conexión con Adobe Target.

    Si la conexión se realiza correctamente, se muestra el mensaje Conexión correcta .

  7. Seleccione Aceptar en el mensaje, seguido de Aceptar en el cuadro de diálogo para confirmar la configuración.

  8. Ahora puede proceder a Añadir un Destinatario Framework para configurar los parámetros de ContextHub o ClientContext que se enviarán a Destinatario. Tenga en cuenta que esto puede no ser necesario para exportar fragmentos de experiencia AEM a Destinatario.

En esta página