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 di Analytics Standard richiede la configurazione di Adobe IMS (Identity Management System). La configurazione viene realizzata con Adobe Developer Console.

NOTA

Il supporto per l’API Adobe Analytics Standard 2.0 è una novità di AEMaaCS 2022.2.0. Questa versione dell’API supporta l’autenticazione IMS.

La selezione API è guidata dal metodo di autenticazione utilizzato per l’integrazione AEM/Analytics.

Ulteriori informazioni sono disponibili al seguente indirizzo: Migrazione alle API 2.0.

Prerequisiti

Prima di avviare questa procedura:

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

    • Console Adobe
    • Console per sviluppatori di Adobe
    • Adobe Analytics e
    • Adobe IMS (sistema Identity Management)
  • L’amministratore di sistema della tua organizzazione deve utilizzare l’Admin Console per aggiungere gli sviluppatori necessari nella tua organizzazione 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.

Configurazione di una configurazione IMS - Generazione di una chiave pubblica

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

  1. AEM aprire Strumenti menu.

  2. In Sicurezza selezione della sezione Configurazioni Adobe IMS.

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

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

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

  6. Conferma con Crea certificato.

    Crea certificato

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

    ATTENZIONE

    Tieni aperta questa configurazione, sarà necessaria di nuovo quando Completamento della configurazione IMS in AEM.

    Scarica certificato

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

Utilizzando la console Adobe Developer è necessario creare un progetto (integrazione) con Adobe Analytics (per AEM utilizzare), quindi assegnare i privilegi richiesti.

Creazione del progetto

Apri Adobe Developer Console per creare un progetto con Adobe Analytics che AEM utilizzare:

  1. Apri Adobe Developer Console 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.

      Crea nuovo progetto - Primo progetto

    • Se disponi già di progetti esistenti, questi verranno elencati e Crea nuovo progetto sarà in alto a destra.

      Crea nuovo progetto - Più progetti

  3. Seleziona Aggiungi a progetto seguito da API:

    Guida introduttiva al nuovo progetto

  4. Seleziona Adobe Analytics, quindi Successivo:

    NOTA

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

    Aggiungere un’API

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

    Selezionare il tipo di autenticazione

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

    Carica la chiave pubblica

  7. Rivedi le credenziali e continua con Successivo:

    Verificare le credenziali

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

    Selezionare i profili di prodotto richiesti

  9. La configurazione verrà confermata.

Assegnazione di privilegi all'integrazione

Ora devi assegnare i privilegi richiesti all’integrazione:

  1. Apri l’Adobe Admin Console:

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

  3. Seleziona Profili di prodotto, quindi l’area di lavoro richiesta dall’elenco presentato. 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 Adobe Developer Console Integration Project

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

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

  • Panoramica del progetto
  • Approfondimenti
  • Credenziali
    • Account di 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 in base a 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 la dettagli dalla configurazione del progetto nella console Adobe Developer:

    Dettagli di configurazione di IMS AEM

  4. Conferma con Crea.

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

    Configurazione IMS

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, seguita da Controlla.

    Configurazione IMS - Verifica stato

  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 il Integrazione con Adobe Analytics.

In questa pagina