Configurazione IMS da utilizzare per l’integrazione con Adobe Analytics

L’integrazione di Adobe Experience Manager as a Cloud Service (AEMaaCS) con Adobe Analytics tramite l’API Analytics Standard richiede la configurazione di Adobe IMS (Identity Management System). La configurazione viene realizzata con la console Adobe Developer.

Prerequisiti

Prima di iniziare questa procedura:

• Il Supporto Adobe deve effettuare il provisioning del tuo account per:

  • Console Adobe
  • Console per sviluppatori di Adobe
  • Adobe Analytics e
  • Adobe IMS (Identity Management System)

• L’amministratore di sistema della tua organizzazione deve utilizzare l’Admin Console per aggiungere gli sviluppatori necessari ai profili di prodotto pertinenti.

  • Questo fornisce agli sviluppatori specifici le autorizzazioni per abilitare le integrazioni tramite la console Adobe Developer.
  • Per maggiori dettagli vedi Gestire gli sviluppatori.

Impostare una configurazione IMS - Generare una chiave pubblica

La prima fase consiste nel creare una configurazione IMS in AEM e generare la chiave pubblica.

1. In AEM apri il menu Strumenti.

2. Nella sezione Sicurezza seleziona Configurazioni Adobe IMS.

3. Seleziona Crea per aprire Configurazione dell’account tecnico Adobe IMS.

4. Dal menu a discesa in Configurazione cloud, seleziona Adobe Analytics.

5. Attiva Crea nuovo certificato e inserisci un nuovo alias.

6. Conferma con Crea certificato.

   

7. Seleziona Scarica (o Scarica chiave pubblica) per scaricare il file sull'unità locale, in modo che sia pronto per l'uso durante la configurazione di IMS per l’integrazione di Adobe Analytics con AEM.

   ATTENZIONE

   Tieni aperta questa configurazione, sarà necessaria di nuovo quando completerai la configurazione IMS in AEM.

   

Configurazione di IMS per l’integrazione di Adobe Analytics con AEM

Utilizzando Adobe Developer Console è necessario creare un progetto (integrazione) con Adobe Analytics (affinché AEM lo possa utilizzare) e assegnare i privilegi richiesti.

Creazione del progetto

Apri la console Adobe Developer per creare un progetto con Adobe Analytics che AEM utilizzerà:

1. Apri la console Adobe Developer per progetti:

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

2. Verranno visualizzati tutti i progetti che hai. Seleziona Crea nuovo progetto; la posizione e l’utilizzo dipenderanno da:

   • Se non hai ancora un progetto, Crea nuovo progetto sarà al centro, in basso.
     
   • Se disponi già di progetti esistenti, questi verranno elencati e Crea nuovo progetto sarà in alto a destra.
     

3. Seleziona Aggiungi a progetto seguito da API:

   

4. Seleziona Adobe Analytics, quindi Successivo:

   NOTA

   Se sei abbonato a Adobe Analytics ma non lo vedi nell’elenco, controlla nei Prerequisiti.

   

5. Seleziona Account di servizio (JWT) come tipo di autenticazione, quindi continua con Successivo:

   

6. Carica la chiave pubblica, e una volta fatto, continua con Successivo:

   

7. Controlla le credenziali e continua con Successivo:

   

8. Seleziona i profili di prodotto richiesti e continua con Salva API configurata:

   

9. La configurazione verrà confermata.

Assegnazione di privilegi all'integrazione

Ora devi assegnare i privilegi richiesti all’integrazione:

1. Apri l’Admin Console Adobe:

   • https://adminconsole.adobe.com

2. Passa a Prodotti (barra degli strumenti in alto), quindi seleziona Adobe Analytics - <tuo-id-tenant> (dal pannello a sinistra).

3. Seleziona Profili di prodotto, quindi l’area di lavoro richiesta dall’elenco mostrato. Ad esempio, Area di lavoro predefinita.

4. Seleziona Credenziali API, quindi la configurazione di integrazione richiesta.

5. Seleziona Editor come Ruolo del prodotto; anziché Osservatore.

Dettagli memorizzati per il progetto di integrazione della console Adobe Developer

Dalla Console Adobe Developer - Progetti è disponibile un elenco di tutti i progetti di integrazione:

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

Seleziona una voce di progetto specifica per visualizzare ulteriori dettagli sulla configurazione. Comprendono:

• Panoramica del progetto
• Approfondimenti
• Credenziali
  • Account servizio (JWT)
    • Dettagli delle credenziali
    • Genera JWT
• API
  • Ad esempio, Adobe Analytics

Alcune di queste sono necessarie per completare l’integrazione di Adobe Analytics in AEM basato su IMS.

Completamento della configurazione IMS in AEM

Per AEM è possibile completare la configurazione IMS aggiungendo i valori richiesti dall’integrazione IMS per Analytics:

1. Torna a Configurazione IMS aperta in AEM.

2. Seleziona Avanti.

3. Qui puoi utilizzare i dettagli dalla configurazione del progetto in Adobe Developer Console:

   • Titolo: testo.
   • Server di autorizzazione: copia/incolla questo dato dalla riga aud della sezione Payload sottostante, ad esempio https://ims-na1.adobelogin.com nell’esempio seguente
   • Chiave API: copia questo dato dalla sezione Credenziali della Panoramica del progetto
   • Segreto cliente: generalo nella scheda Segreto cliente della sezione Account di servizio (JWT) e copialo
   • Payload: copia questo dato dalla scheda Genera JWT della sezione Account di servizio (JWT)

   

4. Conferma con Crea.

5. La configurazione di Adobe Analytics verrà visualizzata nella console AEM.

   

Conferma della configurazione IMS

Per confermare che la configurazione funziona come previsto:

1. Apri:

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

   Esempio:

   • https://localhost:4502/libs/cq/adobeims-configuration/content/configurations.html

2. Seleziona la configurazione.

3. Seleziona Verifica stato dalla barra degli strumenti, seguito da Verifica.

   

4. In caso di esito positivo, verrà visualizzato un messaggio di conferma.

Completare l’integrazione con Adobe Analytics

Ora puoi utilizzare questa configurazione IMS per completare l'Integrazione con Adobe Analytics.

Risorse Business.Adobe.com