Configurazione di Adobe I/O per i trigger Adobe Experience Cloud

ATTENZIONE

Se utilizzi una versione precedente dell’integrazione Triggers tramite autenticazione oAuth, devi passare ad Adobe I/O come descritto di seguito.
Tieni presente che durante questo passaggio Adobe I/O, alcuni trigger in arrivo potrebbero essere persi.

La modalità di autenticazione oAuth legacy con Campaign è stata ritirata il 20 ottobre 2021. Gli ambienti in hosting beneficiano di un’estensione fino a 25 maggio 2022. In qualità di cliente on-premise o ibrido, contatta l’Assistenza clienti Adobe per estendere il supporto a Maggio 2022. Devi fornire l’AppID dell’applicazione OAuth all'Adobe.

Prerequisiti

Questa integrazione si applica solo a partire da Campaign Classic 20.2.4 e versioni successive, 19.1.8 e Gold Standard 11.

Prima di avviare questa implementazione, controlla di avere:

  • valido Identificatore organizzazione: l’identificatore dell’organizzazione IMS (Identity Management System) è l’identificatore univoco all’interno di Adobe Experience Cloud, utilizzato ad esempio per il servizio VisitorID e per l’accesso singolo IMS (SSO). Ulteriori informazioni
  • a Accesso per sviluppatori alla tua organizzazione. L’amministratore di sistema dell’organizzazione IMS deve seguire le Aggiungere sviluppatori a un singolo profilo di prodotto dettagliato in questa pagina per fornire agli sviluppatori l'accesso ai Analytics - {tenantID} Profilo di prodotto del prodotto Adobe Analytics associato ai trigger.

Passaggio 1: Crea/aggiorna progetto di Adobe I/O

  1. Accesso Adobe I/O e accedi con l’accesso Developer dell’organizzazione IMS.

    NOTA

    Assicurati di aver effettuato l'accesso al portale organizzazione corretto.

  2. Estrai l'identificatore client esistente (ID client) dal file di configurazione dell'istanza ims/authIMSTAClientId. L'attributo non esistente o vuoto indica che l'identificatore client non è configurato.

    NOTA

    Se l'identificatore client è vuoto, puoi direttamente Create a New project Adobe I/O.

  3. Identifica il progetto esistente utilizzando l’identificatore client estratto. Cerca progetti esistenti con lo stesso ID client di quello estratto nel passaggio precedente.

  4. Seleziona + Add to Project e scegli API.

  5. In Add an API finestra, seleziona Adobe Analytics.

  6. Scegli Service Account (JWT) come tipo di autenticazione.

  7. Se l'ID client era vuoto, seleziona Generate a key pair per creare una coppia di chiavi pubblica e privata.

    Le chiavi vengono quindi scaricate automaticamente con una data di scadenza predefinita di 365 giorni. Una volta scaduta, dovrai creare una nuova coppia di chiavi e aggiornare l’integrazione nel file di configurazione. Utilizzando l'opzione 2, puoi scegliere di creare e caricare manualmente il tuo Public key con una data di scadenza più lunga.

    ATTENZIONE

    È necessario salvare il file config.zip quando viene visualizzato il prompt di download, poiché non sarà più possibile scaricarlo di nuovo.

  8. Fai clic su Next.

  9. Scegli qualsiasi Product profile oppure creane uno nuovo, se necessario. Non è necessaria alcuna autorizzazione Product profile. Per ulteriori informazioni su Analytics Product Profiles, fare riferimento a Documentazione di Adobe Analytics.

    Quindi, fai clic su Save configured API.

  10. Dal progetto, seleziona Adobe Analytics e copia le seguenti informazioni in Service Account (JWT):

    • Client ID
    • Client Secret
    • Technical account ID
    • Organization ID

ATTENZIONE

Il certificato di Adobe I/O scade dopo 12 mesi. Devi generare una nuova coppia di chiavi ogni anno.

Passaggio 2: Aggiungere le credenziali del progetto in Adobe Campaign

NOTA

Questo passaggio non è necessario se l'identificatore client non è vuoto in Passaggio 1: Crea/aggiorna progetto di Adobe I/O.

La chiave privata deve essere codificata in formato UTF-8 base64. Per eseguire questa operazione:

  1. Utilizza la chiave privata generata nel Passaggio 1: Crea/aggiorna la sezione Progetto di Adobe I/O. La chiave privata deve essere la stessa utilizzata per creare l’integrazione.

  2. Codifica la chiave privata utilizzando il seguente comando: base64 ./private.key > private.key.base64. In questo modo il contenuto base64 verrà salvato in un nuovo file private.key.base64.

    NOTA

    Talvolta è possibile aggiungere automaticamente righe extra quando si copia/incolla la chiave privata. Ricorda di rimuoverlo prima di codificare la chiave privata.

  3. Copia il contenuto dal file private.key.base64.

  4. Accedi tramite SSH a ciascun contenitore in cui è installata l’istanza Adobe Campaign e aggiungi le credenziali Progetto in Adobe Campaign eseguendo il seguente comando come neolane utente. Verrà inserito il Technical Account nel file di configurazione dell'istanza.

    nlserver config -instance:<instance name> -setimsjwtauth:Organization_Id/Client_Id/Technical_Account_ID/<Client_Secret>/<Base64_encoded_Private_Key>

Passaggio 3: Aggiorna tag pipeline

NOTA

Questo passaggio non è necessario se l'identificatore client non è vuoto in Passaggio 1: Crea/aggiorna progetto di Adobe I/O.

Per aggiornare pipelined tag, devi aggiornare il tipo di autenticazione in Adobe I/O project nel file di configurazione config-< instance-name >.xml come segue:

<pipelined ... authType="imsJwtToken"  ... />

Esegui quindi un config -reload e il riavvio del pipelined delle modifiche da prendere in considerazione.

In questa pagina