Integración con Adobe Analytics mediante IMS

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

Requisitos previos

Antes de iniciar este procedimiento:

• Compatibilidad con Adobe debe aprovisionar su cuenta para:

  • Consola Adobe
  • Adobe Developer Console
  • Adobe Analytics 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 la consola del desarrollador de Adobe.
  • 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 Herramientas para abrir el Navegador.

2. En el Seguridad sección seleccionar Configuraciones de IMS de Adobe.

3. Select Crear para abrir el Configuración de cuenta técnica de Adobe IMS.

4. Uso de la lista desplegable debajo de Configuración de nube, seleccione Adobe Analytics.

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

6. Confirme con Crear certificado.

   

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

   PRECAUCIÓN

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

   

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

Con la consola de desarrollador de Adobe, debe crear un proyecto (integración) con Adobe Analytics (para AEM uso) y, a continuación, asignar los privilegios necesarios.

Creación del proyecto

Abra Adobe Developer Console para crear un proyecto con Adobe Analytics que AEM:

1. Abra Adobe Developer Console para proyectos:

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

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

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

     

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

     

3. Select Agregar a proyecto seguido de API:

   

4. Select Adobe Analytics, luego Siguiente:

   NOTA

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

   

5. Select Cuenta de servicio (JWT) como tipo de autenticación, continúe con Siguiente:

   

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

   

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

   

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

   

9. La configuració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:

   • https://adminconsole.adobe.com

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

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

4. Select Credenciales de API, luego la configuración de integración requerida.

5. Select Editor como el Función del producto; en lugar de Observador.

Detalles almacenados para el proyecto de integración de Adobe Developer Console

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

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

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

En algunos de estos casos, deberá completar la integración de Adobe Analytics 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 del 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 Adobe Developer Console:

   • Título: El texto.
   • Servidor de autorización: Copie/pegue esto desde el aud línea del Carga útil a continuación, p. ej. https://ims-na1.adobelogin.com en el ejemplo siguiente
   • Clave de API: Copie esto desde el Credenciales de la sección Información general del proyecto
   • Secreto del cliente: Genere esto en el Pestaña Secreto del cliente de la sección Cuenta de servicio (JWT)y copie
   • Carga útil: Copie esto desde el Ficha Generar JWT de la sección Cuenta de servicio (JWT)

   

4. Confirme con Crear.

5. La configuración de Adobe Analytics 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. Select Comprobar estado en la barra de herramientas, seguido de Marque.

   

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

Configuración del servicio 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 para abrir el Navegador. A continuación, dentro de la función Cloud Services , seleccione Cloud Services heredados.

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

   La variable Crear configuración se abrirá.

3. Escriba un Título y, si lo desea, una Nombre (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.

   La variable Editar componente se abrirá.

5. Introduzca los detalles en la Configuración de análisis pestaña:

   • Autenticación: IMS

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

6. Haga clic en Conectarse a Analytics para inicializar la conexión con Adobe Analytics.

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

7. Select OK en el mensaje.

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

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