v7

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

Prerequisiti

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

Prima di iniziare questa implementazione, verifica di disporre di:

• un valore valido Identificatore organizzazione: l’ID organizzazione è l’identificatore univoco all’interno di Adobe Experience Cloud, utilizzato ad esempio per il servizio VisitorID e l’accesso Single Sign-On (SSO) di IMS. Ulteriori informazioni
• a Accesso per sviluppatori alla tua organizzazione. L’amministratore di sistema dell’organizzazione deve seguire la procedura Aggiungere sviluppatori a un singolo profilo di prodotto procedura dettagliata in questa pagina per fornire agli sviluppatori l'accesso per Analytics - {tenantID} Profilo prodotto del prodotto Adobe Analytics associato a Triggers.

Passaggio 1: creare/aggiornare un progetto di Adobe I/O

1. Accesso Adobe I/O e accedi con l’accesso per sviluppatori della tua organizzazione. Assicurarsi di aver effettuato l'accesso al portale dell'organizzazione corretto.

2. Estrai l’identificatore client di integrazione (ID client) esistente 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 in Adobe I/O.

3. Identifica il progetto esistente utilizzando l’identificatore client estratto. Cerca i progetti esistenti con lo stesso identificatore 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 è vuoto, seleziona Generate a key pair per creare una coppia di chiavi pubblica e privata.

   Le chiavi verranno 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 Public key con una data di scadenza più lunga.

   Per una guida dettagliata su come sostituire le coppie di chiavi di certificato in scadenza, consulta questa pagina.

   ATTENZIONE

   È consigliabile salvare il file config.zip quando viene visualizzato il prompt di download, in quanto non sarà più possibile scaricarlo.

   

8. Fai clic su Next.

   

9. Scegli un elemento esistente Product profile o creane uno nuovo, se necessario. Non è richiesta alcuna autorizzazione per questo 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

    

Passaggio 2: aggiungere le credenziali del progetto in Adobe Campaign

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

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

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

   NOTA

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

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

4. Accedi tramite SSH a ogni contenitore in cui è installata l’istanza di Adobe Campaign e aggiungi le credenziali del progetto in Adobe Campaign eseguendo il seguente comando come neolane utente. Verrà inserito il Technical Account credenziali 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: aggiornare il tag pipeline

Da aggiornare pipelined , devi aggiornare il tipo di autenticazione a progetto Adobe I/O nel file di configurazione config-< nome-istanza >.xml come segue:

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

Quindi, esegui una config -reload e il riavvio del pipelined affinché le modifiche siano prese in considerazione.