Integración con Adobe Analytics mediante IMS

Última actualización: 2023-09-14

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

NOTA

La compatibilidad con la API de Adobe Analytics Standard AEM 2.0 es nueva en la versión 6.5.12.0 de. Esta versión de la API admite la autenticación IMS.

El uso de la API de Adobe Analytics AEM Classic 1.4 en el modo de la aplicación sigue siendo compatible con la compatibilidad con versiones anteriores. El La API de Analytics 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/Analytics.

También puede obtenerse más información en Migración a las API 2.0.

Requisitos previos

Antes de iniciar este procedimiento:

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

    • Adobe Console
    • Adobe Developer Console
    • Adobe Analytics 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

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

  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 Analytics con AEM.

    PRECAUCIÓN

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

    Cuadro de diálogo de información para añadir la clave al Adobe I/O

Configuración de IMS para la integración de Adobe Analytics con AEM

Con la consola de Adobe Developer, cree un proyecto (integración) con Adobe Analytics AEM (para su uso por parte de los usuarios) y, a continuación, asigne los privilegios necesarios.

Creación del proyecto

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

PRECAUCIÓN

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 se encuentra en la esquina superior derecha.

      Creación de un nuevo proyecto: varios proyectos

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

    Introducción a su nuevo proyecto

  4. Seleccione Adobe Analytics y, luego, Siguiente:

    NOTA

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

    Añada una API

  5. Seleccionar Cuenta de servicio (JWT) como el tipo de autenticación y, a continuación, continúe con Siguiente:

    Seleccione el tipo de autenticación

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

    Cargar la clave pública

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

    Revisar credenciales

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

    Seleccionar perfiles de producto necesarios

  9. La configuración se ha confirmado.

Asignación de privilegios a la integración

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 Analytics: <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

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

Para mostrar más detalles acerca de la configuración, seleccione 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 Analytics

En algunos de estos casos, debe completar la integración de Adobe Analytics AEM en la documentación de.

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

AEM Al volver a la configuración de, puede completar la configuración de IMS añadiendo los valores necesarios desde el proyecto de integración para Analytics:

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

  2. Seleccione Siguiente.

  3. Aquí puede usar la variable Detalles almacenados para el proyecto de integración de la consola de Adobe Developer:

    Detalles de configuración de IMS de AEM

  4. Confirme con Crear.

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

    Configuración de IMS

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.

    Configuración de IMS: Comprobar estado

  4. Si se ejecuta correctamente, verá un mensaje de confirmación.

Configuración del servicio de Adobe Analytics Cloud

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

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

  2. Desplácese hacia abajo hasta Adobe Analytics 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 Analytics pestaña:

    • Autenticación: IMS

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

  6. Para inicializar la conexión con Adobe Analytics, haga clic en Conectar con Analytics.

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

  7. Seleccionar OK en el mensaje.

  8. Complete otros parámetros según sea necesario, seguidos de OK en el cuadro de diálogo para poder confirmar la configuración.

  9. Ahora puede continuar con Adición de un marco de Analytics para configurar parámetros que se envían a Adobe Analytics.

En esta página