Integración con Adobe Target mediante IMS integration-with-adobe-target-using-ims

AEM La integración de la con Adobe Target mediante la API de Target Standard requiere la configuración de Adobe IMS (Identity Management System) mediante la consola de Adobe Developer.

NOTE
La compatibilidad con la API de Adobe Target AEM Standard es nueva en la versión 6.5 de. La API de Target Standard utiliza la autenticación IMS.
El uso de la API de Adobe Target AEM Classic en la sigue siendo compatible con la compatibilidad con versiones anteriores. El 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 de AEM/Target.
Consulte también la ID de inquilino y código de cliente sección.

Requisitos previos prerequisites

Antes de iniciar este procedimiento:

  • El Soporte de Adobe debe aprovisionar su cuenta para lo siguiente:

    • Adobe Console
    • Adobe Developer Console
    • Adobe Target y
    • Adobe IMS (Identity Management System)
  • El administrador del sistema de su organización debe utilizar Admin Console para añadir los desarrolladores necesarios de su organización a los perfiles de producto relevantes.

    • Esto proporciona a los desarrolladores específicos permisos para habilitar integraciones en Adobe Developer Console.
    • Consulte Administrar desarrolladores.

Configuración de IMS: generación de una clave pública configuring-an-ims-configuration-generating-a-public-key

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

  2. En el Seguridad , seleccione Configuraciones de IMS de Adobe.

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

  4. En la lista desplegable debajo de Configuración de nube, seleccione Adobe Target.

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

  6. Confirme con Crear certificado.

    Asistente de configuración de cuenta técnica de IMS de Adobe

  7. Seleccione Descargar (o Descargar clave pública) para descargar el archivo en la unidad local, de modo que esté listo para usarse cuando configure IMS para la integración de Adobe Target con AEM.

    note caution
    CAUTION
    Mantenga esta configuración abierta; es necesaria de nuevo cuando AEM Finalización de la configuración de IMS en la.

    Mensaje de información para agregar un certificado en Adobe I/O

Configuración de IMS para la integración de Adobe Target con AEM configuring-ims-for-adobe-target-integration-with-aem

Con la consola de Adobe Developer, cree un proyecto (integración) con Adobe Target AEM que pueda utilizar y, a continuación, asigne los privilegios necesarios.

Creación del proyecto creating-the-project

Para crear un proyecto con Adobe Target AEM que pueda utilizar, abra la consola de Adobe Developer:

CAUTION
Actualmente, Adobe solo admite el de la consola de Adobe Developer Cuenta de servicio (JWT) tipo de credencial.
No use el Servidor a servidor OAuth tipo de credencial, que se admitirá en el futuro.
  1. Abra Adobe Developer Console para proyectos:

    https://developer.adobe.com/console/projects

  2. Se muestran todos los proyectos que tenga. Seleccionar Crear nuevo proyecto - la ubicación y el uso dependen de lo siguiente:

    • Si todavía no tiene ningún proyecto, Crear nuevo proyecto está en el centro, abajo.

      Creación de un nuevo proyecto: primer proyecto

    • Si ya tiene proyectos existentes, estos se enumeran y Crear nuevo proyecto está en la esquina superior derecha.

      Creación de un nuevo proyecto: varios proyectos

  3. Seleccione Añadir a proyecto seguido de API:

    Adobe Developer Console

  4. Seleccione Adobe Target y, luego, Siguiente:

    note note
    NOTE
    Si se ha suscrito a Adobe Target, pero no lo ve en la lista, debe comprobar los Requisitos previos.

    Haga clic en siguiente

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

    Adición de integraciones mediante Developer Console

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

    Creación de un proyecto

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

    note note
    NOTE
    Los perfiles de producto mostrados dependen de si tiene lo siguiente:
    • Adobe Target Standard: solo está disponible el Espacio de trabajo predeterminado
    • Adobe Target Premium: se enumeran todos los espacios de trabajo disponibles, como se muestra a continuación

    Selección de una API para añadir

  8. La creación se ha confirmado.

Asignación de privilegios a la integración assigning-privileges-to-the-integration

Ahora asigne los privilegios necesarios a la integración:

  1. Abra la Adobe Admin Console:

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

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

  4. Seleccione Credenciales de API y la configuración de integración requerida.

  5. Seleccione Editor como la Función del producto, en lugar de Observador.

Detalles almacenados para el proyecto de integración de Adobe Developer Console details-stored-for-the-ims-integration-project

Desde Adobe Developer Console y Proyectos, puede ver una lista de todos sus proyectos de integración:

Para mostrar más detalles acerca de la configuración, seleccione Ver (a la derecha de una entrada de proyecto específica). 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, debe completar la integración de Adobe Target AEM en basado en IMS y en el código de tiempo de la aplicación de la plataforma de datos de.

Finalización de la configuración de IMS en AEM completing-the-ims-configuration-in-aem

AEM Al volver a la configuración de, puede completar la configuración de IMS añadiendo los valores necesarios desde la integración de la consola de Adobe Developer para Target:

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

  2. Seleccione Siguiente.

  3. Aquí puede usar los detalles de la configuración del proyecto en Adobe Developer Console:

    • Título: el texto.
    • Servidor de autorización: copie/pegue esto desde la línea aud de la sección Carga útil a continuación, por ejemplo, https://ims-na1.adobelogin.com en el ejemplo siguiente
    • Clave de API: copie esto desde el Información general sección
    • Secreto del cliente: genere esto en la Información general sección, y copiar
    • Carga útil: copie esto desde la sección Generar JWT

    Configuración de cuenta técnica

  4. Confirme con Crear.

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

    Configuración de cuenta técnica de IMS de Adobe

Confirmación de la configuración de IMS confirming-the-ims-configuration

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.

    Configuraciones de IMS de Adobe

  4. Si se ejecuta correctamente, verá el siguiente mensaje:

    Comprobación de una configuración

Configuración del Cloud Service de Adobe Target configuring-the-adobe-target-cloud-service

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

  1. Abra el Herramientas menú. A continuación, dentro de Cloud Service , seleccione Cloud Service heredados.

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

    El Crear configuración se abre el cuadro de diálogo.

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

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

  4. Confirme con Crear.

    El Editar componente se abre el cuadro de diálogo.

  5. Introduzca los detalles en la Configuración de Adobe Target pestaña:

    • Autenticación: IMS

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

      note note
      NOTE
      Para IMS, este valor debe tomarse del propio Target. Puede iniciar sesión en Target y extraer el ID de 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 la ID de inquilino y código de cliente sección.

    • 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 Analytics Cloud que se utiliza para los objetivos y las métricas 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.

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

    • Sincronizar segmentos de Adobe Target AEM : seleccione esta opción para poder descargar segmentos definidos en Target y utilizarlos en el servicio de segmentos de la aplicación de la interfaz de usuario de. Seleccione 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 Target. AEM (El término de de "segmento" equivale a la "audiencia" de Target).

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

    • Utilizar el sistema Tag Management para ofrecer la biblioteca de cliente: utilice DTM (en desuso), Adobe Launch o cualquier otro sistema de administración de etiquetas.

    • AT.js personalizado: Déjelo en blanco si marcó la casilla Tag Management o para usar el AT.js predeterminado. También puede cargar su archivo AT.js personalizado. Solo aparece si ha seleccionado AT.js.

    note note
    NOTE
    Configuración de un Cloud Service para utilizar la API de Target Classic ha quedado obsoleto (utiliza la pestaña Configuración de Adobe Recommendations ).
  6. Clic Conectar con Target para inicializar la conexión con Adobe Target.

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

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

  8. Ahora puede continuar con Agregar un marco de trabajo de Target para configurar ContextHub o los parámetros de ClientContext que se envían a Target. AEM Tenga en cuenta que esto puede no ser necesario para exportar fragmentos de experiencia de la a Target.

ID de inquilino y código de cliente tenant-client

Con Adobe Experience Manager 6.5.8.0, el campo Código de cliente se ha añadido 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 de 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 de 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 lo siguiente:

  • De forma predeterminada, el código de cliente (si se agrega primero) también se copia automáticamente en el campo ID de inquilino.
  • Si lo desea, puede cambiar el conjunto de ID de inquilino predeterminado.
  • Por lo tanto, las llamadas de servidor a Target se basan en el ID de inquilino y las llamadas del lado del cliente a Target se basan en el código de cliente.

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

NOTE
Si desea cambiar una configuración de Target existente:
  1. Vuelva a introducir el ID de inquilino.
  2. Volver a conectar con Target.
  3. Guarde la configuración.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2