Configura autenticazione per le API Adobe Target

In Adobe Admin Console, assicurati che all’account utente Adobe sia stato concesso l’accesso di livello Amministratore prodotto e Sviluppatore a Target.

In Adobe Developer Console, seleziona la organizzazione Experience Cloud per la quale desideri creare questa integrazione. È probabile che tu abbia accesso a una sola organizzazione Experience Cloud.

Fare clic su Crea nuovo progetto.

Fai clic su Aggiungi API per aggiungere un’API REST al progetto per accedere ai servizi e ai prodotti Adobe.

Selezionare Adobe Target come servizio Adobe da integrare con. Fai clic sul pulsante Avanti visualizzato.

Selezionare un’opzione per associare le chiavi pubbliche e private all’integrazione dell’account del servizio che si sta creando per Target. Per questo esempio, seleziona Opzione 1: genera una coppia di chiavi e fai clic su Genera coppia di chiavi.

Come indicato, prendere nota del file di configurazione scaricato automaticamente (config), che contiene la chiave privata. Fai clic su Avanti.

Nel file system verificare il percorso di config, ovvero il file di configurazione compresso creato nel passaggio precedente. Anche in questo caso, il file config contiene la chiave privata, che sarà necessaria in seguito. La posizione esatta all’interno del file system potrebbe essere diversa da quella mostrata qui.

In Adobe Developer Console, seleziona i profili di prodotto corrispondenti alle proprietà in cui utilizzi Adobe Recommendations. Se non si utilizzano le proprietà, selezionare l’opzione Default Workspace. Fai clic su Salva API configurata.

Fare clic su Crea integrazione. Dovresti ricevere un messaggio temporaneo che indica che l’API è stata configurata correttamente.

Come ultimo passaggio, rinomina il progetto con un nome più significativo dell’originale Project 1. A tale scopo, passare al progetto utilizzando il percorso di navigazione come mostrato, fare clic su Modifica progetto per accedere al modale Modifica progetto e rinominare il progetto.

Sempre in Adobe Developer Console, passa a visualizzare le credenziali dell’account di servizio del nuovo progetto. Utilizza la navigazione a sinistra o la sezione Credenziali come mostrato.

In Dettagli credenziali, tieni presente che puoi visualizzare le tue Chiavi pubbliche, ID client e altre informazioni relative al tuo account di servizio.

Fare clic per passare alle informazioni sull’API Adobe Target. Utilizza la navigazione a sinistra o la sezione Prodotti e servizi connessi come mostrato.

Fai clic su Scarica per Postman > Account di servizio (JWT) per creare un file JSON che acquisisce le informazioni di autenticazione per un ambiente Postman.

Prendi nota del file JSON nel file system.

In Postman, fai clic sull’icona a forma di ingranaggio per gestire gli ambienti, quindi fai clic su Importa per importare il file JSON (ambiente).

Scegli il tuo file e fai clic su Apri.

Nella finestra modale Gestisci ambienti di Postman, fai clic sul nome dell’ambiente appena importato per esaminarlo. (Il nome dell’ambiente potrebbe essere diverso da quello mostrato qui. Modifica il nome come desiderato. Non deve necessariamente corrispondere al nome del progetto Adobe.)

I valori delle note CLIENT_SECRET e API_KEY (insieme ad altre variabili) sono precompilati, presi dall’integrazione definita in Adobe Developer Console. La variabile Postman CLIENT_SECRET deve corrispondere alle credenziali Adobe CLIENT SECRET visualizzate in Developer Console e API_KEY in Postman deve corrispondere a CLIENT ID in Developer Console. Le note PRIVATE_KEY, JWT_TOKEN e ACCESS_TOKEN sono invece vuote. Iniziamo fornendo il valore PRIVATE_KEY.

Dal file system, aprire il file config e aprire il file di chiave private.

Selezionare e copiare l’intero contenuto del file di chiave private.

In Postman, incolla il valore della chiave privata nei campi VALORE INIZIALE e VALORE CORRENTE.

Fai clic su Aggiorna e chiudi la finestra modale Ambienti.

Passa alle chiamate di esempio dell’API di Adobe Identity Management Service.

Fare clic sulla raccolta Postman di generazione token di accesso Adobe I/O.

Ottieni il JSON non elaborato per questa raccolta facendo clic su Raw, quindi copiando il JSON risultante negli Appunti. In alternativa, puoi salvare il file JSON non elaborato come file .json.

In Postman, importa la raccolta incollando e inviando il JSON non elaborato dagli Appunti. In alternativa, puoi caricare il file .json salvato. Fate clic su Continue (Continua).

Seleziona la richiesta IMS: JWT Generate + Auth via User Token nella raccolta Postman di generazione dei token di accesso di Adobe I/O, assicurati che l’ambiente sia selezionato e fai clic su Send per generare il token.

Apri nuovamente la finestra modale Manage Environments (Gestisci ambienti) e seleziona l’ambiente.

Nota: i valori ACCESS_TOKEN e JWT_TOKEN sono ora compilati.

Importa la Adobe Target raccolta Postman API amministratore. Segui tutti i prompt finché la raccolta non viene importata in Postman.

Espandere la raccolta e prendere nota della richiesta Attività elenco.

Variabili come {{access_token}} inizialmente non risolte. È possibile risolvere il problema in diversi modi, ad esempio definendo una nuova variabile di raccolta denominata {{access_token}}. In questa guida verrà invece modificata la richiesta API per sfruttare l’ambiente Postman utilizzato in precedenza. Questo consentirà all’ambiente di continuare a fungere da consolidamento unico e coerente di tutte le variabili comuni tra le API di Adobe.

Digitare per sostituire {{access_token}} con {{ACCESS_TOKEN}}.

Digitare per sostituire {{api_key}} con {{API_KEY}}.

Digitare per sostituire {{tenant}} con {{TENANT_ID}}. Nota {{TENANT_ID}} non ancora riconosciuta.

Apri la finestra modale Manage Environments (Gestisci ambienti) e seleziona l’ambiente.

Digitare per aggiungere una nuova variabile di ambiente {{TENANT_ID}}. Copia e incolla il valore ID tenant nei campi VALORE INIZIALE e VALORE CORRENTE per la nuova variabile di ambiente TENANT_ID.

Invia la richiesta, dopo aver verificato di aver selezionato l’ambiente corretto. Dovresti ricevere una risposta contenente l’elenco delle attività.