Integrazione con Adobe Target utilizzando 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.

NOTA

Il supporto per Adobe Target Standard API è 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. 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.

Prerequisiti

Prima di avviare la procedura:

  • Adobe Support deve fornire il proprio account per:

    • Console Adobe
    • Adobe I/O
    • Adobe Target e
    • Adobe IMS ( Identity Management System)
  • L'amministratore di sistema della tua organizzazione deve utilizzare il Admin Console per aggiungere gli sviluppatori richiesti nella tua organizzazione ai profili di prodotto pertinenti.

    • Questo fornisce agli sviluppatori specifici le autorizzazioni per abilitare le integrazioni all'interno Adobe I/O.
    • Per ulteriori dettagli, vedere Gestione degli 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 il menu Strumenti.

  2. Nella sezione Sicurezza selezionare Configurazioni IMS Adobe.

  3. Selezionare Crea per aprire il Adobe IMS Technical Account Configuration.

  4. Nell'elenco a discesa in Configurazione cloud, selezionare Adobe Target.

  5. Attivate Create un nuovo certificato e immettete un nuovo alias.

  6. Confermare con Crea certificato.

  7. Selezionare Scarica (o Scarica chiave pubblica) per scaricare il file nell'unità locale, in modo che sia pronto per essere utilizzato quando si configura Adobe I/O per 'integrazione Adobe Target con AEM](#configuring-adobe-i-o-for-adobe-target-integration-with-aem).[

    ATTENZIONE

    Tenere aperta questa configurazione, sarà necessario di nuovo quando Completamento della configurazione IMS in AEM.

Configurazione Adobe I/O per integrazione Adobe Target con AEM

È necessario creare il progetto Adobe I/O (integrazione) con Adobe Target che AEM utilizzare, quindi assegnare i privilegi richiesti.

Creazione del progetto

Aprite la console Adobe I/O per creare un progetto I/O con Adobe Target che AEM utilizzare:

NOTA

Vedere anche le esercitazioni Adobe I/O.

  1. Aprite la console Adobe I/O per Progetti:

    https://console.adobe.io/projects

  2. Vengono visualizzati tutti i progetti che avete. Selezionare 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 hai già dei progetti esistenti, questi saranno elencati e Crea nuovo progetto sarà in alto a destra.

      Crea nuovo progetto - Più progetti

  3. Selezionare Aggiungi a progetto seguito da API:

  4. Selezionare Adobe Target, quindi Next:

    NOTA

    Se si è iscritti Adobe Target, ma non lo si vede nell'elenco, è necessario controllare i Prequistes.

  5. Carica la tua chiave pubblica e, al termine, continua con Avanti:

  6. Rivedete le credenziali e continuate con Next:

  7. Selezionate i profili di prodotto richiesti e continuate con Salva API configurata:

    NOTA

    I profili di prodotto visualizzati dipendono dal fatto che:

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

  8. La creazione verrà confermata.

Assegnazione di privilegi all'integrazione

È ora necessario assegnare i privilegi richiesti all'integrazione:

  1. Aprire l'Adobe Admin Console:

  2. Andate a Products (barra degli strumenti superiore), quindi selezionate Adobe Target - <your-tenant-id> (dal pannello a sinistra).

  3. Selezionare Profili di prodotto, quindi l'area di lavoro desiderata dall'elenco. Ad esempio, Area di lavoro predefinita.

  4. Selezionare Integrations, quindi la configurazione di integrazione richiesta.

  5. Selezionare Editor come ruolo prodotto; anziché Observer.

Dettagli memorizzati per progetto di integrazione Adobe I/O

Dalla console Progetti Adobe I/O potete visualizzare un elenco di tutti i progetti di integrazione:

Selezionare 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 credenziali
      • Genera JWT
  • APIS
    • Ad esempio, Adobe Target

Alcuni di questi sono necessari per completare l'integrazione Adobe I/O per Target in AEM.

Completamento della configurazione IMS in AEM

Per AEM potete completare la configurazione IMS aggiungendo i valori richiesti dall'integrazione Adobe I/O per Target:

  1. Tornate alla configurazione IMS aperta in AEM.

  2. Seleziona Avanti.

  3. Qui è possibile utilizzare i dettagli da Adobe I/O:

    • Titolo: Testo.
    • Server autorizzazioni: Copiare/incollare questo dalla "aud" riga della sezione ​Payloadsection seguente, ad esempio "https://ims-na1.adobelogin.com" nell’esempio seguente
    • Chiave API: Copiatela dalla sezione Panoramica dell'integrazione Adobe I/O per Target
    • Segreto cliente: Generate questo nella sezione Panoramica dell'integrazione Adobe I/O per Target, e copiate
    • Payload: Copiatela dalla sezione Genera JWT dell'integrazione Adobe I/O per Target

  4. Confermare con Create.

  5. La configurazione 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. Selezionare Controlla stato dalla barra degli strumenti, seguita da Controlla.

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

Configurazione del Cloud Service Adobe Target

Ora è possibile fare riferimento alla configurazione per un Cloud Service per utilizzare l'API di Target Standard:

  1. Aprire il menu Strumenti. Quindi, nella sezione Cloud Services, selezionare Cloud Services precedenti.

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

    Viene aperta la finestra di dialogo Crea configurazione.

  3. Immettere un Titolo e, se lo si desidera, un Nome (se lasciato vuoto, questo verrà generato dal titolo).

    Potete anche selezionare il modello richiesto (se sono disponibili più modelli).

  4. Confermare con Create.

    Viene aperta la finestra di dialogo Modifica componente.

  5. Immettere i dettagli nella scheda Adobe Target Settings:

    • Autenticazione: IMS

    • ID tenant: l'ID tenant IMS del Adobe

      NOTA

      Per IMS questo valore deve essere recuperato direttamente da Target. Potete accedere a Target ed estrarre l'ID tenant dall'URL.

      Ad esempio, se l’URL è:

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

      Quindi si utilizza yourtenantid.

    • Configurazione IMS: selezionate il nome della configurazione IMS

    • Tipo API: REST

    • Configurazione 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 visualizzate la configurazione cloud, consultate la nota in Configurazione A4T configurazione Analytics Cloud.

    • 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 che segue.

    • Sincronizzare i segmenti da Adobe Target: Selezionate questa opzione per scaricare i segmenti definiti in Target per 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 termine "audience" 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), Lancio Adobe 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.

    NOTA

    La configurazione di un Cloud Service per l'utilizzo dell' API di Target Classic è obsoleta (utilizza la scheda Impostazioni Adobe Recommendations).

    Esempio:

  6. Fate clic su Connetti a Target per inizializzare la connessione con Adobe Target.

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

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

  8. Ora potete procedere all'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.

In questa pagina

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free