View a markdown version of this page

Integração com o Adobe Marketing Agent - Amazon Quick
Antes de começarConfigurando a AdobeConfigurando o conector no Amazon QuickAções disponíveisGerenciamento e solução de problemas

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Integração com o Adobe Marketing Agent

Com o conector de ação do Adobe Marketing Agent, você pode trabalhar com dados de marketing e AI-powered recursos de marketing da Adobe Experience Platform diretamente no Amazon Quick por meio de linguagem natural.

O Amazon Quick oferece suporte a vários métodos de autenticação para o Adobe Marketing Agent. Escolha o método mais adequado aos requisitos de segurança da sua organização.

  • Aplicativo OAuth padrão — usa um aplicativo OAuth AWS gerenciado. Nenhuma credencial adicional é necessária. Os usuários se autenticam diretamente com sua conta da Adobe.

  • Aplicativo OAuth personalizado — usa um aplicativo gerenciado pelo cliente registrado no Adobe Developer Console. Essa opção dá à sua organização controle total sobre a configuração do OAuth.

  • Service-to-Service OAuth — usa credenciais do cliente para autenticação de servidor a servidor sem interação com o usuário. Adequado para fluxos de trabalho automatizados.

  • Chave de API — usa uma chave de API para autenticação. Adequado para padrões de acesso à conta de serviço.

Para obter mais informações sobre os métodos de autenticação compatíveis com o Amazon Quick, consulteMétodos de autenticação.

Antes de começar

Verifique se você tem o seguinte antes de configurar a integração.

  • Uma conta ativa da Adobe com acesso ao Adobe Marketing Agent.

  • Para aplicativo OAuth personalizado ou Service-to-Service OAuth: acesso ao Adobe Developer Console no site da Adobe para criar um aplicativo e obter as credenciais do cliente.

  • Para chave de API: uma chave de Adobe-issued API com os escopos de acesso aos dados de marketing necessários.

  • Para obter os requisitos de assinatura do Amazon Quick, consulteConfigurar integrações no console.

Configurando a Adobe

Se você estiver usando a autenticação padrão do aplicativo OAuth, pule esta seção e continue até. Configurando o conector no Amazon Quick

Para um aplicativo OAuth personalizado ou autenticação Service-to-Service OAuth, registre um aplicativo no Adobe Developer Console no site da Adobe e adicione o URL https://{region}.quicksight.aws.amazon.com/sn/oauthcallback de retorno de chamada do Amazon Quick como um URI de redirecionamento. {region}Substitua pela sua AWS região (por exemplo,us-east-1). Registre o ID do cliente e o segredo do cliente — você precisa deles ao configurar o Amazon Quick. Para a autenticação da chave de API, gere uma chave de API da sua conta da Adobe.

Configurando o conector no Amazon Quick

Conecte-se a partir da guia Disponível

Se quiser usar a autenticação padrão do aplicativo OAuth, você pode se conectar diretamente da guia Disponível sem configuração adicional.

  1. No console do Amazon Quick, escolha Conectores.

  2. Na guia Disponível, localize o Adobe Marketing Agent e escolha Connect.

  3. Conclua o fluxo de login da Adobe e conceda as permissões solicitadas.

Para configurar um conector com um dos outros métodos de autenticação, use a guia Criar para sua equipe, conforme descrito abaixo.

Crie a partir da guia Criar para sua equipe

  1. No console do Amazon Quick, escolha Conectores.

  2. Escolha a guia Criar para sua equipe.

  3. Encontre e escolha o Adobe Marketing Agent.

  4. Insira um nome para seu conector. Opcionalmente, escolha + Adicionar descrição para adicionar uma descrição.

  5. Em Tipo de conexão, escolha Rede pública.

  6. Para Configuração do OAuth, escolha um dos métodos de autenticação a seguir e configure os campos obrigatórios.

    1. Para o aplicativo OAuth padrão:

      Nenhuma credencial adicional é necessária. Escolha Próximo para continuar.

    2. Para o aplicativo OAuth personalizado, configure os seguintes campos:

      • ID do cliente — A ID do cliente do seu aplicativo Adobe Developer Console.

      • Cliente OAuth público (opcional) — Selecione essa opção se o aplicativo Adobe Developer Console estiver configurado como um cliente público (sem segredo do cliente).

      • Segredo do cliente — O segredo do cliente do seu aplicativo Adobe Developer Console.

      • URL do token — O endpoint do token. Padrão: https://aep-ai-ama.adobe.io/token

      • URL de autorização — O endpoint de autorização. Padrão: https://aep-ai-ama.adobe.io/authorize

      • URL de redirecionamento — Pre-filled com o URL de retorno de chamada do Amazon Quick.

    3. Para Service-to-ServiceOAuth, configure os seguintes campos:

      • ID do cliente — A ID do cliente da sua Server-to-Server credencial do Adobe Developer Console.

      • Segredo do cliente — O segredo do cliente da sua Server-to-Server credencial do Adobe Developer Console.

      • URL do token — O endpoint do token. Padrão: https://aep-ai-ama.adobe.io/token

    4. Para a chave de API, configure os seguintes campos:

      • Chave de API — A chave de API da Adobe.

      • E-mail (opcional) — O endereço de e-mail associado à chave de API.

  7. Escolha Próximo.

  8. Se você escolher o aplicativo OAuth padrão ou o aplicativo OAuth personalizado, uma janela de autorização da Adobe será aberta. Revise as permissões solicitadas e escolha Permitir.

  9. Na página Revisar, revise as ações disponíveis para o conector. Escolha Próximo.

  10. Na página Publicar, escolha quem pode acessar o conector. Você pode habilitar o acesso para todos em sua organização ou pesquisar equipes ou grupos específicos.

  11. Selecione Publish.

Ações disponíveis

Depois de configurar o conector, as ações expostas pelo Adobe Marketing Agent estarão disponíveis. Para ver o conjunto atual de ações do seu conector, acesse a visualização de ações disponíveis do conector no console do Amazon Quick.

Gerenciamento e solução de problemas

Para editar, compartilhar ou excluir seu conector, consulteGerenciando integrações existentes.

Problemas de autenticação

  • Sign-in falha (aplicativo OAuth padrão ou aplicativo OAuth personalizado) — Verifique se sua conta da Adobe está ativa e se você pode entrar diretamente na Adobe. Para o aplicativo OAuth personalizado, confirme se o URI de redirecionamento em seu aplicativo Adobe Developer Console corresponde ao URL de retorno de chamada do Amazon Quick.

  • Credenciais de cliente inválidas (aplicativo OAuth personalizado ou Service-to-Service OAuth) — Verifique se a ID do cliente e o segredo do cliente correspondem aos valores em seu aplicativo Adobe Developer Console.

  • Falha na autenticação da chave de API — verifique se a chave de API não foi revogada e se ela tem os escopos necessários para as operações que você deseja realizar.