Integrazione con Adobe Analytics tramite IMS integration-with-adobe-analytics-using-ims
L’integrazione dell’AEM con Adobe Analytics tramite l’API Analytics Standard richiede la configurazione di Adobe IMS (Identity Management System) tramite la console Adobe Developer.
Prerequisiti prerequisites
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 all’interno della console Adobe Developer.
- Consulta Gestisci sviluppatori.
Impostare una configurazione IMS - Generare una chiave pubblica configuring-an-ims-configuration-generating-a-public-key
La prima fase consiste nel creare una configurazione IMS in AEM e generare la chiave pubblica.
-
In AEM apri il menu Strumenti.
-
In Sicurezza sezione, seleziona Configurazioni Adobe IMS.
-
Seleziona Crea per aprire Configurazione dell’account tecnico Adobe IMS.
-
Dal menu a discesa in Configurazione cloud, seleziona Adobe Analytics.
-
Attiva Crea nuovo certificato e immetti un nuovo alias.
-
Conferma con Crea certificato.
-
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.
note caution CAUTION Tieni aperta questa configurazione; sarà necessaria di nuovo quando Completamento della configurazione IMS in AEM.
Configurazione di IMS per l’integrazione di Adobe Analytics con AEM configuring-ims-for-adobe-analytics-integration-with-aem
Utilizzando la console Adobe Developer, crea un progetto (integrazione) con Adobe Analytics (affinché l’AEM possa utilizzarlo), quindi assegna i privilegi richiesti.
Creazione del progetto creating-the-project
Per creare un progetto con Adobe Analytics che possa essere utilizzato dall’AEM, apri la console Adobe Developer:
-
Apri la console Adobe Developer per progetti:
-
Vengono visualizzati tutti i tuoi progetti. Seleziona Crea nuovo progetto - la localizzazione e l'utilizzo dipendono dai seguenti elementi:
-
Se non hai ancora un progetto, Crea nuovo progetto si trova in basso al centro.
-
Se disponi già di progetti esistenti, questi vengono elencati e Crea nuovo progetto si trova in alto a destra.
-
-
Seleziona Aggiungi a progetto seguito da API:
-
Seleziona Adobe Analytics, quindi Successivo:
note note NOTE Se sei abbonato a Adobe Analytics ma non lo vedi nell’elenco, controlla nei Prerequisiti. -
Seleziona Account di servizio (JWT) come tipo di autenticazione, quindi continua con Successivo:
-
Carica la chiave pubblica, e una volta fatto, continua con Successivo:
-
Controlla le credenziali e continua con Successivo:
-
Seleziona i profili di prodotto richiesti e continua con Salva API configurata:
-
La configurazione viene confermata.
Assegnazione di privilegi all'integrazione assigning-privileges-to-the-integration
Ora assegna i privilegi richiesti all’integrazione:
-
Apri l’Admin Console Adobe:
-
Passa a Prodotti (barra degli strumenti in alto), quindi seleziona Adobe Analytics - <tuo-id-tenant> (dal pannello a sinistra).
-
Seleziona Profili di prodotto, quindi l’area di lavoro richiesta dall’elenco mostrato. Ad esempio, Area di lavoro predefinita.
-
Seleziona Credenziali API, quindi la configurazione di integrazione richiesta.
-
Seleziona Editor come Ruolo del prodotto; anziché Osservatore.
Dettagli memorizzati per il progetto di integrazione della console Adobe Developer details-stored-for-the-ims-integration-project
Dalla Progetti di Adobe Developer Console è disponibile un elenco di tutti i progetti di integrazione:
Per visualizzare ulteriori dettagli sulla configurazione, seleziona una voce di progetto specifica. 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 nell’AEM.
Completamento della configurazione IMS in AEM completing-the-ims-configuration-in-aem
Tornando a AEM, puoi completare la configurazione IMS aggiungendo i valori richiesti dal progetto di integrazione per Analytics:
-
Torna a Configurazione IMS aperta in AEM.
-
Seleziona Avanti.
-
Qui puoi utilizzare il Dettagli memorizzati per il progetto di integrazione della console Adobe Developer:
- Titolo: il tuo testo.
- Server di autorizzazione: copia/incolla questo dato dalla riga
aud
della sezione Payload sottostante, ad esempiohttps://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)
-
Conferma con Crea.
-
La configurazione di Adobe Analytics viene visualizzata nella console AEM.
Conferma della configurazione IMS confirming-the-ims-configuration
Per confermare che la configurazione funziona come previsto:
-
Apri:
https://localhost<port>/libs/cq/adobeims-configuration/content/configurations.html
Esempio:
https://localhost:4502/libs/cq/adobeims-configuration/content/configurations.html
-
Seleziona la configurazione.
-
Seleziona Verifica stato dalla barra degli strumenti, seguito da Verifica.
-
In caso di esito positivo, viene visualizzato un messaggio di conferma.
Configurazione del servizio Adobe Analytics Cloud configuring-the-adobe-analytics-cloud-service
È ora possibile fare riferimento alla configurazione affinché un Cloud Service utilizzi l’API Analytics Standard:
-
Apri Strumenti menu. Quindi, all'interno del Cloud Service sezione, seleziona Cloud Service legacy.
-
Scorri verso il basso fino a Adobe Analytics e seleziona Configura ora.
Il Crea configurazione viene visualizzata.
-
Immetti un Titolo e, se lo desideri, un Nome (se lasciato vuoto, viene generato dal titolo).
Puoi anche selezionare il modello richiesto (se ne è disponibile più di uno).
-
Conferma con Crea.
Il Modifica componente viene visualizzata.
-
Inserisci i dettagli in Impostazioni di Analytics scheda:
-
Autenticazione: IMS
-
Configurazione IMS: seleziona il nome della configurazione IMS
-
-
Per inizializzare la connessione con Adobe Analytics, fai clic su Connetti ad Analytics.
Se la connessione ha esito positivo, viene visualizzato il messaggio Connessione riuscita.
-
Seleziona OK sul messaggio.
-
Completa gli altri parametri come richiesto, seguito da OK nella finestra di dialogo, in modo da poter confermare la configurazione.
-
Ora puoi passare a Aggiunta di un framework Analytics per configurare i parametri inviati ad Adobe Analytics.