Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Integrazione con Adobe Marketing Agent
<a name="adobe-integration"></a>

Con il connettore di azione di Adobe Marketing Agent, puoi lavorare con i dati di marketing e AI-powered le funzionalità di marketing di Adobe Experience Platform direttamente in Amazon Quick tramite il linguaggio naturale.

Amazon Quick supporta diversi metodi di autenticazione per Adobe Marketing Agent. Scegli il metodo più adatto ai requisiti di sicurezza della tua organizzazione.
+ App **OAuth predefinita: utilizza un'applicazione** OAuth AWS gestita. Non sono necessarie credenziali aggiuntive. Gli utenti si autenticano direttamente con il proprio account Adobe.
+ App **OAuth personalizzata: utilizza un'applicazione** gestita dal cliente registrata in Adobe Developer Console. Questa opzione offre all'organizzazione il pieno controllo sulla configurazione OAuth.
+ **Service-to-Service OAuth**: utilizza le credenziali del client per l'autenticazione da server a server senza l'interazione dell'utente. Adatto per flussi di lavoro automatizzati.
+ **Chiave API**: utilizza una chiave API per l'autenticazione. Adatto per modelli di accesso agli account di servizio.

Per ulteriori informazioni sui metodi di autenticazione supportati da Amazon Quick, consulta[Metodi di autenticazione](quick-action-auth.md).

## Prima di iniziare
<a name="adobe-integration-prerequisites"></a>

Assicurati di disporre di quanto segue prima di configurare l'integrazione.
+ Un account Adobe attivo con accesso ad Adobe Marketing Agent.
+ Per **l'app OAuth personalizzata** o **Service-to-Service OAuth**: accesso ad [Adobe Developer Console sul sito Web di Adobe](https://developer.adobe.com/console) per creare un'app e ottenere le credenziali del cliente.
+ Per **chiave API: una Adobe-issued chiave API** con gli ambiti di accesso ai dati di marketing richiesti.
+ Per i requisiti di abbonamento ad Amazon Quick, consulta[Configura le integrazioni nella console](integration-console-setup-process.md).

## Configurazione di Adobe
<a name="adobe-source-setup"></a>

Se utilizzi l'autenticazione **predefinita dell'app OAuth**, salta questa sezione e procedi con. [Configurazione del connettore in Amazon Quick](#adobe-quicksuite-setup)

Per l'app OAuth personalizzata o l'autenticazione Service-to-Service OAuth, registra un'app in [Adobe Developer Console](https://developer.adobe.com/console) sul sito Web di Adobe e aggiungi l'URL `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback` di callback Amazon Quick come URI di reindirizzamento. Sostituisci {{{region}}} con la tua AWS regione (ad esempio,). `us-east-1` Registra l'ID cliente e il segreto del cliente: ti servono quando configuri Amazon Quick. Per l'autenticazione tramite chiave API, genera una chiave API dal tuo account Adobe.

## Configurazione del connettore in Amazon Quick
<a name="adobe-quicksuite-setup"></a>

### Connect dalla scheda Available
<a name="adobe-quick-connect"></a>

Se desideri utilizzare l'autenticazione predefinita dell'app OAuth, puoi connetterti direttamente dalla scheda **Disponibile** senza configurazioni aggiuntive.

1. Nella console Amazon Quick, scegli **Connettori**.

1. Nella scheda **Disponibile**, trova **Adobe Marketing Agent** e scegli **Connect**.

1. Completa il flusso di accesso ad Adobe e concedi le autorizzazioni richieste.

Per configurare un connettore con uno degli altri metodi di autenticazione, usa la scheda **Crea per il tuo team** come descritto di seguito.

### Crea dalla scheda Crea per il tuo team
<a name="adobe-full-setup"></a>

1. Nella console Amazon Quick, scegli **Connettori**.

1. Scegli la scheda **Crea per il tuo team**.

1. Trova e scegli **Adobe Marketing Agent**.

1. Inserisci un **nome** per il connettore. Facoltativamente, scegli **\+ Aggiungi descrizione** per aggiungere una descrizione.

1. Per **Tipo di connessione**, scegli **Rete pubblica**.

1. Per la **configurazione OAuth**, scegli uno dei seguenti metodi di autenticazione e configura i campi richiesti.

   1. Per l'app **OAuth predefinita:**

      Non sono necessarie credenziali aggiuntive. Seleziona **Successivo** per continuare.

   1. Per l'**app OAuth personalizzata**, configura i seguenti campi:
      + **ID client**: l'ID client dell'app Adobe Developer Console.
      + **Client OAuth pubblico** (opzionale): seleziona questa opzione se l'app Adobe Developer Console è configurata come client pubblico (nessun client segreto).
      + **Segreto del client**: il segreto del client dell'app Adobe Developer Console.
      + **URL del token**: l'endpoint del token. Impostazione predefinita: `https://aep-ai-ama.adobe.io/token`
      + **URL di autorizzazione: l'**endpoint di autorizzazione. Impostazione predefinita: `https://aep-ai-ama.adobe.io/authorize`
      + URL **di reindirizzamento: Pre-filled con l'URL** di callback di Amazon Quick.

   1. Per **Service-to-ServiceOAuth**, configura i seguenti campi:
      + **ID client: l'ID** client ricavato dalla tua credenziale di Adobe Developer Console Server-to-Server .
      + **Segreto del cliente**: il segreto del client contenuto nelle Server-to-Server credenziali di Adobe Developer Console.
      + **URL del token: l'**endpoint del token. Impostazione predefinita: `https://aep-ai-ama.adobe.io/token`

   1. Per **API Key**, configura i seguenti campi:
      + **Chiave API**: la chiave API di Adobe.
      + **Email** (opzionale): l'indirizzo e-mail associato alla chiave API.

1. Scegli **Next (Successivo)**.

1. Se hai scelto l'app **OAuth predefinita o l'app** **OAuth personalizzata, si apre una finestra** di autorizzazione Adobe. **Controlla le autorizzazioni richieste e scegli Consenti.**

1. Nella pagina **Revisione**, esamina le azioni disponibili per il connettore. Scegli **Next (Successivo)**.

1. Nella pagina **Pubblica**, scegli chi può accedere al connettore. Puoi abilitare l'accesso per tutti i membri dell'organizzazione o cercare team o gruppi specifici.

1. Seleziona **Pubblica**.

## Operazioni disponibili
<a name="adobe-integration-actions"></a>

Dopo aver configurato il connettore, sono disponibili le azioni esposte da Adobe Marketing Agent. Per visualizzare l'attuale set di azioni per il tuo connettore, vai alla visualizzazione **Azioni disponibili** del connettore nella console Amazon Quick.

## Gestione e risoluzione dei problemi
<a name="adobe-integration-troubleshooting"></a>

Per modificare, condividere o eliminare il connettore, consulta[Gestione delle integrazioni esistenti](integration-workflows.md#managing-existing-integrations).

### Problemi di autenticazione
<a name="adobe-troubleshooting-auth"></a>
+ **Sign-in fallisce (app OAuth predefinita o app OAuth personalizzata)**: verifica che il tuo account Adobe sia attivo e che tu possa accedere direttamente ad Adobe. Per l'app OAuth personalizzata, verifica che l'URI di reindirizzamento nell'app Adobe Developer Console corrisponda all'URL di callback Amazon Quick.
+ **Credenziali client non valide (app OAuth personalizzata o Service-to-Service OAuth)**: verifica che l'ID client e il segreto del client corrispondano ai valori dell'app Adobe Developer Console.
+ **L'autenticazione della chiave API non riesce**: verifica che la chiave API non sia stata revocata e che abbia gli ambiti richiesti per le operazioni che desideri eseguire.