Integración con Adobe Target mediante Adobe I/O

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

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 Target Classic utiliza la autenticación de credenciales de usuario.

La selección de la API se basa en el método de autenticación utilizado para la integración AEM/Target.
Consulte también la sección ID de inquilino y código de cliente .

Requisitos previos

Antes de iniciar este procedimiento:

  • El soporte de Adobe debe aprovisionar su cuenta para:

    • Consola Adobe
    • Adobe I/O
    • Adobe Target y
    • Adobe IMS (sistema Identity Management)
  • El administrador del sistema de su organización debe utilizar el Admin Console para agregar los desarrolladores necesarios de su organización a los perfiles de producto relevantes.

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

Configuración de IMS: generación de una clave pública

El primer paso 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ú Tools.

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

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

  4. Con la lista desplegable en Cloud Configuration, 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 usar cuando configure el Adobe I/O para la integración de Adobe Target con AEM.

    PRECAUCIÓN

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

Configuración del Adobe I/O para la integración de Adobe Target con AEM

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

Creación del proyecto

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

NOTA

Consulte también los tutoriales de Adobe I/O.

  1. Abra la consola Adobe I/O 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, inferior.

      Crear nuevo proyecto: primer proyecto

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

      Crear nuevo proyecto: varios proyectos

  3. Seleccione Agregar al proyecto seguido de API:

  4. Seleccione Adobe Target y luego 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 de producto mostrados con dependen de si tiene:

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

  8. La creación se confirmará.

Asignación de privilegios a la integración

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

  1. Abra el Adobe Admin Console:

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

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

  4. Seleccione Integrations y, a continuación, la configuración de integración requerida.

  5. Seleccione Editor como Product Role; en lugar de Observador.

Detalles almacenados para el proyecto de integración de Adobe I/O

Desde la consola Proyectos de Adobe I/O puede ver una lista de todos sus proyectos de integración:

Seleccione View (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 la credencial
      • Generar JWT
  • API
    • Por ejemplo, Adobe Target

En algunos de estos casos, deberá completar la integración de Adobe I/O para Target en AEM.

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

Al volver a AEM puede completar la configuración de IMS añadiendo los valores necesarios desde la integración de Adobe I/O para Target:

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

  2. Seleccione Siguiente.

  3. Aquí puede usar los detalles del Adobe I/O:

    • Título: El texto.
    • Servidor de autorización: Copie o pegue esto desde la "aud" línea de la sección ​Carga útil 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 Adobe I/O para Target
    • Secreto del cliente: Genere esto en la 🔗 sección Información general de la integración de Adobe I/O para Target y copie
    • Carga útil: Copie esto desde la sección Generate JWT de la integración de Adobe I/O para Target

  4. Confirme con Crear.

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

Confirmación de la configuración de IMS

Para confirmar que la configuración funciona 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 Comprobar.

  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ú Tools. A continuación, en la sección Cloud Services, seleccione Cloud Services heredados.

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

    Se abrirá el cuadro de diálogo Crear configuración.

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

    También puede seleccionar la plantilla necesaria (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 pestaña Configuración de Adobe Target:

    • Autenticación: IMS

    • ID del inquilino: el ID del inquilino de Adobe IMS. Consulte también la sección ID de inquilino y código de cliente .

      NOTA

      Para IMS, este valor debe tomarse del propio Target. Puede iniciar sesión en Target 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

      A continuación, debe utilizar yourtenantid.

    • Código de cliente: Consulte el ID del inquilino y el código del cliente.

    • 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 las actividades de Target. Lo necesita si utiliza Adobe Analytics como fuente de informes al segmentar contenido. Si no ve la configuración de nube, consulte la nota en Configuración de A4T Analytics Cloud.

    • Use objetivos precisos: De forma predeterminada, esta casilla de verificación está seleccionada. Si se selecciona, la configuración del servicio de nube esperará a que el contexto se cargue 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 Target 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 necesita utilizar segmentos de Target. (Tenga en cuenta que el AEM término "segmento" equivale a la "audiencia" de Target).

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

    • Utilice el sistema de Tag Management para entregar la biblioteca de cliente: Utilice DTM (obsoleto), Launch de Adobe o cualquier otro sistema de administración de etiquetas.

    • AT.js personalizado: Deje en blanco si ha marcado la casilla Tag Management o para utilizar el 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 Target Classic ha quedado obsoleta (utiliza la pestaña Configuración de Adobe Recommendations ).

  6. Haga clic en Connect to Target para inicializar la conexión con Adobe Target.

    Si la conexión se realiza correctamente, aparece el mensaje Connection success.

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

  8. Ahora puede continuar con Agregar un marco de destino para configurar los parámetros de ContextHub o ClientContext que se enviarán a Target. Tenga en cuenta que esto puede no ser necesario para exportar AEM fragmentos de experiencias a Target.

ID de inquilino y código de cliente

Con Adobe Experience Manager 6.5.8.0, el campo Código de cliente se había agregado a la ventana de configuración de Target.

Al configurar los campos ID de inquilino y Código de cliente, tenga en cuenta lo siguiente:

  1. Para la mayoría de los clientes, el ID del inquilino y el código de cliente son los mismos. Esto significa que ambos campos contienen la misma información y son idénticos. Asegúrese de introducir el ID del inquilino en ambos campos.
  2. Para fines heredados, también puede introducir valores diferentes en los campos ID de inquilino y Código de cliente .

En ambos casos, tenga en cuenta que:

  • De forma predeterminada, el código de cliente (si se agrega primero) también se copia automáticamente en el campo ID de inquilino.
  • Tiene la opción de cambiar el conjunto de ID de inquilino predeterminado.
  • En consecuencia, las llamadas de servidor a Target se basarán en el ID del inquilino y las llamadas del lado del cliente a Target se basarán en el código del cliente.

Como se ha indicado anteriormente, el primer caso es el más común para AEM 6.5. De cualquier modo, asegúrese de que ambos contienen la información correcta según sus necesidades.

NOTA

Si desea cambiar una configuración de Target existente:

  1. Vuelva a introducir el ID del inquilino.
  2. Vuelva a conectarse a Target.
  3. Guarde la configuración.

En esta página