Integrazione con Adobe Target tramite IMS

L’integrazione di AEM con Adobe Target tramite l’API di Target Standard richiede la configurazione di Adobe IMS (Identity Management System) tramite Adobe Developer Console.

NOTA

Il supporto per l’API Adobe Target Standard è stato introdotto nella AEM 6.5. L’API di Target Standard utilizza l’autenticazione IMS.

L’utilizzo dell’API Adobe Target Classic in AEM è ancora supportato per la compatibilità con le versioni precedenti. La L’API di Target Classic utilizza l’autenticazione delle credenziali utente.

La selezione API è guidata dal metodo di autenticazione utilizzato per l’integrazione AEM/Target.
Vedi anche ID tenant e codice client sezione .

Prerequisiti

Prima di avviare questa procedura:

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

    • Console Adobe
    • Console per sviluppatori di Adobe
    • Adobe Target 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 all’interno di Adobe Developer Console.
    • 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 Target.

  5. Attiva Crea nuovo certificato e immettere 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 quando configurazione di IMS per l’integrazione di Adobe Target con AEM.

    ATTENZIONE

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

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

Utilizzando Adobe Developer Console è necessario creare un progetto (integrazione) con Adobe Target che AEM utilizzare, quindi assegnare i privilegi richiesti.

Creazione del progetto

Apri Adobe Developer Console per creare un progetto con Adobe Target 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:

  4. Seleziona Adobe Target, quindi Successivo:

    NOTA

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

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

  6. Rivedi le credenziali e continua con Successivo:

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

    NOTA

    I profili di prodotto visualizzati con dipendono dall’esistenza o meno di:

    • Adobe Target Standard - Solo Area di lavoro predefinita è disponibile
    • Adobe Target Premium : vengono elencate tutte le aree di lavoro disponibili, come illustrato di seguito

  8. La creazione 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 Target - <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 per sviluppatori di Adobe - Progetti è disponibile un elenco di tutti i progetti di integrazione:

Seleziona Visualizza (a destra di una voce specifica del progetto) 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 Target

Alcune di queste sono necessarie per completare l’integrazione di Adobe Target in AEM in base a IMS.

Completamento della configurazione IMS in AEM

Di nuovo AEM puoi completare la configurazione IMS aggiungendo i valori richiesti dall’integrazione Adobe Developer Console per Target:

  1. Torna a Configurazione IMS aperta in AEM.

  2. Seleziona Avanti.

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

    • Titolo: Testo.
    • Server autorizzazioni: Copia/incolla questo da aud della linea Payload sezione seguente, ad esempio https://ims-na1.adobelogin.com nell'esempio seguente
    • Chiave API: Copia questo da Panoramica sezione
    • Segreto client: Genera questo in Panoramica sezione e copia
    • Payload: Copia questo da Genera JWT sezione

  4. Conferma con Crea.

  5. La configurazione di Adobe Target 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, seguita da Controlla.

  4. In caso di esito positivo, verrà visualizzato il messaggio:

Configurazione dell’Cloud Service Adobe Target

È ora possibile fare riferimento alla configurazione affinché un Cloud Service utilizzi l’API di Target Standard:

  1. Apri Strumenti menu. Quindi, all'interno del Cloud Services sezione , seleziona Cloud Services legacy.

  2. Scorri verso il basso fino a Adobe Target e seleziona Configura ora.

    La Crea configurazione si aprirà la finestra di dialogo .

  3. Inserisci un Titolo e, se volete, un Nome (se lasciato vuoto, verrà generato dal titolo).

    È inoltre possibile selezionare il modello richiesto (se sono disponibili più modelli).

  4. Conferma con Crea.

    La Modifica componente si aprirà la finestra di dialogo .

  5. Immetti i dettagli nella Impostazioni di Adobe Target scheda:

    • Autenticazione: IMS

    • ID tenant: l’ID tenant di Adobe IMS. Vedi anche ID tenant e codice client sezione .

      NOTA

      Per IMS questo valore deve essere tratto da Target stesso. Puoi accedere a Target ed estrarre l’ID tenant dall’URL.

      Ad esempio, se l’URL è:

      https://experience.adobe.com/#/@yourtenantid/target/activities

      Poi userebbe yourtenantid.

    • Codice client: Consulta la sezione ID tenant e codice client sezione .

    • Configurazione IMS: seleziona il nome della configurazione IMS

    • Tipo di API: REST

    • Configurazione di A4T Analytics Cloud: Seleziona la configurazione cloud di Analytics utilizzata per gli obiettivi e le metriche delle attività di destinazione. È necessario se utilizzi Adobe Analytics come origine per la generazione di rapporti durante il targeting del contenuto. Se la configurazione cloud non viene visualizzata, consulta la nota in Configurazione della configurazione di A4T Analytics Cloud.

    • Utilizzare targeting accurato: Per impostazione predefinita questa casella di controllo è selezionata. Se questa opzione è selezionata, la configurazione del servizio cloud attenderà il caricamento del contesto prima di caricare il contenuto. Vedi la nota che segue.

    • Sincronizzare segmenti da Adobe Target: Seleziona questa opzione per scaricare i segmenti definiti in Target e utilizzarli in AEM. Devi selezionare questa opzione quando la proprietà Tipo API è REST, perché i segmenti in linea non sono supportati e devi sempre utilizzare i segmenti da Target. Il termine AEM "segmento" è equivalente al "pubblico" di Target.

    • Libreria client: Seleziona se desideri la libreria client AT.js o mbox.js (obsoleto).

    • Utilizza Tag Management System per distribuire la libreria client: Utilizza DTM (obsoleto), Adobe Launch o qualsiasi altro sistema di gestione dei tag.

    • AT.js personalizzato: Lascia vuoto se hai selezionato la casella Gestione tag o per utilizzare il file AT.js predefinito. In alternativa, carica il tuo AT.js personalizzato. Viene visualizzato solo se è stato selezionato AT.js.

    NOTA

    Configurazione di un Cloud Service per l’utilizzo dell’API di Target Classic è stato dichiarato obsoleto (utilizza la scheda Impostazioni di Adobe Recommendations ).

  6. Fai clic su Connettersi a Target per inizializzare la connessione con Adobe Target.

    Se la connessione ha esito positivo, viene visualizzato il messaggio Connessione riuscita viene visualizzato.

  7. Seleziona OK sul messaggio, seguito da OK nella finestra di dialogo per confermare la configurazione.

  8. Ora puoi procedere con Aggiunta di un framework di Target per configurare i parametri ContextHub o di ClientContext che verranno inviati a Target. Questo potrebbe non essere necessario per esportare AEM frammenti esperienza in Target.

ID tenant e codice client

Con Adobe Experience Manager 6.5.8.0, il campo Codice client è stato aggiunto alla finestra di configurazione di Target.

Durante la configurazione dei campi ID tenant e Codice client, tieni presente quanto segue:

  1. Per la maggior parte dei clienti, l’ID tenant e il codice client sono gli stessi. Ciò significa che entrambi i campi contengono le stesse informazioni e sono identici. Assicurati di inserire l’ID tenant in entrambi i campi.
  2. Per scopi precedenti, puoi anche immettere valori diversi nei campi ID tenant e Codice client .

In entrambi i casi, tieni presente che:

  • Per impostazione predefinita, anche il codice client (se aggiunto per primo) viene copiato automaticamente nel campo ID tenant.
  • Hai la possibilità di modificare il set di ID tenant predefinito.
  • Di conseguenza, le chiamate di backend a Target saranno basate sull’ID tenant e le chiamate lato client a Target saranno basate sul codice client.

Come indicato in precedenza, il primo caso è il più comune per AEM 6.5. In entrambi i casi, assicurati entrambi i campi contengono le informazioni corrette a seconda dei requisiti.

NOTA

Per modificare una configurazione di destinazione esistente:

  1. Immetti nuovamente l'ID tenant.
  2. Riconnettersi a Target.
  3. Salva la configurazione.

In questa pagina