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, selezionare Experience Cloud Organization per cui si desidera creare questa integrazione. Si noti che è probabile che si abbia accesso solo a un singolo Experience Cloud Organization.

Fare clic su Create new project.

Fare clic su Add 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. Fare clic sul pulsante Next 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, selezionare Option 1: Generate a key pair e fare clic su Generate keypair.

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

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. Fare clic su Save configured API.

Fare clic su Create Integration. 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 questo scopo, accedi al progetto utilizzando il percorso di navigazione come mostrato, fai clic su Edit project per accedere al modale Edit Project e rinomina il progetto.

Sempre in Adobe Developer Console, passa a visualizzare le credenziali Service Account (JWT) del nuovo progetto. Utilizzare la barra di navigazione a sinistra o la sezione Credentials come illustrato.

In Credential details, si noti che è possibile visualizzare Public key(s), Client ID e altre informazioni relative all'account del 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 Download for Postman > Service Account (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 Import per importare il file JSON (ambiente).

Scegli il tuo file e fai clic su Open.

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 alla credenziale di Adobe CLIENT SECRET come visualizzata 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 INITIAL VALUE e CURRENT VALUE.

Fare clic su Update e chiudere la finestra modale Ambienti.

Passa alle chiamate di Adobe dell'API del servizio Identity Management.

Fare clic su Adobe I/O Access Token Generation Postman collection.

Ottenere il JSON non elaborato per questa raccolta facendo clic su Raw e 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. Fare clic su Continue.

Selezionare la richiesta IMS: JWT Generate + Auth via User Token nell'insieme Postman di generazione token di accesso Adobe I/O, verificare che l'ambiente sia selezionato e fare 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 List activities.

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 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 INITIAL VALUE e CURRENT VALUE 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à.