Show Menu
ARGOMENTI×

Integrazione con Adobe Target tramite Adobe I/O

L'integrazione di AEM con Adobe Target tramite l'API di Target Standard richiede la configurazione di Adobe IMS (Identity Management System) e Adobe I/O.
Il supporto per l'API Adobe Target Standard è una novità in AEM 6.5. L'API di Target Standard utilizza l'autenticazione IMS.
L'utilizzo dell'API Adobe Target Classic in AEM è ancora supportato per garantire la compatibilità con le versioni precedenti. L'API Target Classic utilizza l'autenticazione delle credenziali utente.
La selezione API è guidata dal metodo di autenticazione utilizzato per l'integrazione AEM/Target.

Prerequisiti

Prima di avviare questa procedura, Adobe Support deve fornire l'account per:
  • Adobe Console
  • I/O Adobe
  • Adobe Target e
  • Adobe IMS (Identity Management System)

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. In AEM aprite il menu Strumenti .
  2. Nella sezione Sicurezza , selezionate Configurazioni Adobe IMS .
  3. Selezionate Crea per aprire la Configurazione account tecnico Adobe IMS.
  4. Nell'elenco a discesa Configurazione cloud, seleziona Adobe Target .
  5. Attiva Crea nuovo certificato e immetti un nuovo alias.
  6. Conferma con Crea certificato .
  7. Selezionate Scarica (o Scarica chiave pubblica) per scaricare il file nell'unità locale, in modo che sia pronto per essere utilizzato per configurare l'I/O Adobe per l'integrazione di Adobe Target con AEM .
    Tenete aperta questa configurazione, sarà necessaria di nuovo al completamento della configurazione IMS in AEM .

Configurazione di Adobe I/O per l'integrazione di Adobe Target con AEM

Devi creare l'integrazione Adobe I/O con Adobe Target che verrà utilizzata da AEM, quindi assegnare i privilegi richiesti.

Creazione dell'integrazione

Aprite la console Adobe I/O per creare un'integrazione I/O con Adobe Target che verrà utilizzata da AEM:
Consultate anche le esercitazioni I/O di Adobe.
  1. Apri la console Adobe I/O per le integrazioni:
  2. Selezionate Nuova integrazione :
    Se disponete già di integrazioni esistenti, queste verranno elencate e il pulsante Nuova integrazione sarà in alto a destra.
  3. Selezionate Accesso a un'API seguito da Continua :
  4. Selezionate Adobe Target , quindi Continua :
  5. Aggiungete i dettagli richiesti per la configurazione di integrazione:
    • Nome
      Immettete il nome.
    • Descrizione
      Una descrizione è facoltativa.
    • Certificato di chiave pubblica
      Caricare il file di chiave pubblica; come generato in Configurazione di una configurazione IMS - Generazione di una chiave pubblica.
      Una volta caricato il certificato, verrà elencato in Certificati .
    • Profili di prodotto
      I profili di prodotto corrispondono alle aree di lavoro in Target che AEM può utilizzare per l’esportazione dei contenuti e la creazione di offerte. Per impostazione predefinita, l'area di lavoro predefinita di Target è selezionata. Selezionate qualsiasi altro profilo/area di lavoro da visualizzare in AEM come destinazione di esportazione. Esempio:
  6. Conferma con l’integrazione Create.
  7. La creazione verrà confermata, ora potete continuare con i dettagli di integrazione; sono necessarie per completare la configurazione IMS in AEM .

Assegnazione di privilegi all'integrazione

È ora necessario assegnare i privilegi richiesti all'integrazione:
  1. Apri Adobe Admin Console :
  2. Andate a Prodotti (barra degli strumenti in alto), quindi selezionate Adobe Target - < your-tenant-id > (dal pannello a sinistra).
  3. Selezionate Profili di prodotto, quindi l’area di lavoro desiderata dall’elenco. Ad esempio, Area di lavoro predefinita.
  4. Selezionate Integrazioni , quindi la configurazione di integrazione richiesta.
  5. Selezionate Editor come ruolo prodotto; invece di Observer .

Dettagli memorizzati per l'integrazione I/O di Adobe

Dalla console Integrazioni I/O di Adobe potete vedere un elenco di tutte le integrazioni:
Selezionate Visualizza (a destra di una specifica voce di integrazione) per visualizzare ulteriori dettagli sulla configurazione. Comprendono:
  • Panoramica
  • Approfondimenti
  • Servizi
  • Eventi
  • JWT (token Web JSON)
Alcuni di questi sono necessari per completare l'integrazione di I/O Adobe per Target in AEM.
  1. Panoramica :
  2. JWT :

Completamento della configurazione IMS in AEM

Per tornare ad AEM, puoi completare la configurazione IMS aggiungendo i valori richiesti dall’integrazione I/O di Adobe per Target:
  1. Tornate alla configurazione IMS aperta in AEM .
  2. Seleziona Avanti .
  3. Qui potete usare i dettagli dall'I/O di Adobe:
    • Titolo : Testo.
    • Server autorizzazioni: Copiate/incollate questo dalla "aud" riga della sezione Payload seguente, ad esempio "https://ims-na1.adobelogin.com" nell'esempio seguente
    • Chiave API: Copiatela dalla sezione Panoramica dell'integrazione I/O di Adobe per Target
    • Segreto cliente: Generare questo valore nella sezione Panoramica dell'integrazione I/O di Adobe per Target e copiare
    • Payload : Copiatela dalla sezione JWT dell'integrazione I/O di Adobe per Target
  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. Selezionate la configurazione.
  3. Selezionate Controlla stato dalla barra degli strumenti, quindi Controlla .
  4. In caso di esito positivo, verrà visualizzato il messaggio:

Configurazione del servizio Adobe Target Cloud

Ora è possibile fare riferimento alla configurazione per un servizio Cloud per utilizzare l'API di Target Standard:
  1. Aprire il menu Strumenti . Quindi, nella sezione Servizi Cloud, seleziona Servizi cloud legacy.
  2. Scorri verso il basso fino ad Adobe Target e seleziona Configura ora .
    Viene visualizzata la finestra di dialogo Crea configurazione .
  3. Inserite un Titolo e, se lo desiderate, un Nome (se lasciato vuoto questo verrà generato dal titolo).
    Potete anche selezionare il modello richiesto (se sono disponibili più modelli).
  4. Conferma con Crea .
    Viene aperta la finestra di dialogo Modifica componente .
  5. Immettete i dettagli nella scheda Impostazioni di Adobe Target:
    • Codice client: l’ID tenant di Adobe IMS
      L'ID tenant Adobe IMS deve essere immesso nel campo Codice cliente.
    • Autenticazione : IMS
    • Configurazione IMS: selezionate il nome della configurazione IMS
    • Tipo API: REST
    • Configurazione di A4T Analytics Cloud: Seleziona la configurazione cloud di Analytics utilizzata per gli obiettivi e le metriche dell'attività di destinazione. Questo è necessario se utilizzate Adobe Analytics come origine di reporting quando eseguite il targeting del contenuto. Se non visualizzi la configurazione cloud, consulta la nota in Configurazione della configurazione cloud di Analytics A4T.
    • Utilizzate targeting accurato: Per impostazione predefinita questa casella di controllo è selezionata. Se selezionata, la configurazione del servizio cloud attende il caricamento del contesto prima di caricare il contenuto. Vedere la nota seguente.
    • Sincronizzare i segmenti da Adobe Target : Selezionate questa opzione per scaricare i segmenti definiti in Target da usare 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' equivale al termine 'pubblico' di Target).
    • Libreria client: Selezionate se la libreria client AT.js deve essere obsoleta oppure mbox.js.
    • Utilizzate Tag Management System per distribuire la libreria client: Usa DTM (obsoleto), Adobe Launch o qualsiasi altro sistema di gestione tag.
    • AT.js personalizzato: Lasciate vuoto se avete selezionato la casella Gestione tag o per utilizzare il file AT.js predefinito. In alternativa, caricate il vostro AT.js personalizzato. Viene visualizzato solo se avete selezionato AT.js.
    La configurazione di un servizio Cloud per l'utilizzo dell'API Target Classic è stata rimossa (utilizza la scheda Impostazioni Adobe Recommendations).
    Esempio:
  6. Fate clic su Connect to Target per inizializzare la connessione con Adobe Target.
    Se la connessione ha esito positivo, viene visualizzato il messaggio Connessione riuscita .
  7. Selezionate OK sul messaggio, quindi OK nella finestra di dialogo per confermare la configurazione.
  8. Ora potete procedere all' aggiunta di un framework Target per configurare i parametri ContextHub o ClientContext che verranno inviati a Target. Questo potrebbe non essere necessario per l'esportazione di frammenti esperienza AEM in Target.