View a markdown version of this page

Intégration d'Adobe Marketing Agent - Amazon Quick
Avant de commencerConfiguration d'AdobeConfiguration du connecteur dans Amazon QuickActions disponiblesGestion et résolution des problèmes

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Intégration d'Adobe Marketing Agent

Grâce au connecteur d'action Adobe Marketing Agent, vous pouvez utiliser les données marketing et les fonctionnalités AI-powered marketing d'Adobe Experience Platform directement dans Amazon Quick via le langage naturel.

Amazon Quick prend en charge plusieurs méthodes d'authentification pour Adobe Marketing Agent. Choisissez la méthode qui répond le mieux aux exigences de sécurité de votre entreprise.

  • Application OAuth par défaut — Utilise une application OAuth AWS gérée. Aucune information d'identification supplémentaire n'est requise. Les utilisateurs s'authentifient directement avec leur compte Adobe.

  • Application OAuth personnalisée : utilise une application gérée par le client enregistrée dans Adobe Developer Console. Cette option donne à votre organisation le contrôle total de la configuration OAuth.

  • Service-to-Service OAuth — Utilise les informations d'identification du client pour l'authentification de serveur à serveur sans interaction avec l'utilisateur. Convient aux flux de travail automatisés.

  • Clé d'API — Utilise une clé d'API pour l'authentification. Convient aux modèles d'accès aux comptes de service.

Pour plus d'informations sur les méthodes d'authentification prises en charge par Amazon Quick, consultezMéthodes d’authentification.

Avant de commencer

Assurez-vous de disposer des éléments suivants avant de configurer l'intégration.

  • Un compte Adobe actif avec accès à Adobe Marketing Agent.

  • Pour l'application OAuth personnalisée ou Service-to-Service OAuth : accès à Adobe Developer Console sur le site Web d'Adobe pour créer une application et obtenir les informations d'identification du client.

  • Pour la clé d'API : une clé d' Adobe-issued API avec les étendues d'accès aux données marketing requises.

  • Pour connaître les exigences relatives à l'abonnement Amazon Quick, consultezConfiguration des intégrations dans la console.

Configuration d'Adobe

Si vous utilisez l'authentification par défaut de l'application OAuth, ignorez cette section et passez à. Configuration du connecteur dans Amazon Quick

Pour une application OAuth personnalisée ou une authentification Service-to-Service OAuth, enregistrez une application dans Adobe Developer Console sur le site Web d'Adobe et ajoutez l'URL https://{region}.quicksight.aws.amazon.com/sn/oauthcallback de rappel Amazon Quick en tant qu'URI de redirection. Remplacez {region} par votre AWS région (par exemple,us-east-1). Enregistrez l'ID client et le secret du client. Vous en aurez besoin pour configurer Amazon Quick. Pour l'authentification par clé d'API, générez une clé d'API à partir de votre compte Adobe.

Configuration du connecteur dans Amazon Quick

Se connecter depuis l'onglet Disponible

Si vous souhaitez utiliser l'authentification par défaut de l'application OAuth, vous pouvez vous connecter directement depuis l'onglet Disponible sans configuration supplémentaire.

  1. Dans la console Amazon Quick, choisissez Connectors.

  2. Dans l'onglet Disponible, recherchez Adobe Marketing Agent et choisissez Connect.

  3. Terminez le flux de connexion Adobe et accordez les autorisations demandées.

Pour configurer un connecteur avec l'une des autres méthodes d'authentification, utilisez l'onglet Créer pour votre équipe, comme décrit ci-dessous.

Créez à partir de l'onglet Créer pour votre équipe

  1. Dans la console Amazon Quick, choisissez Connectors.

  2. Choisissez l'onglet Créer pour votre équipe.

  3. Recherchez et choisissez Adobe Marketing Agent.

  4. Entrez un nom pour votre connecteur. Choisissez éventuellement + Ajouter une description pour ajouter une description.

  5. Pour Type de connexion, sélectionnez Réseau public.

  6. Pour la configuration OAuth, choisissez l'une des méthodes d'authentification suivantes et configurez les champs obligatoires.

    1. Pour l'application OAuth par défaut :

      Aucune information d'identification supplémentaire n'est requise. Choisissez Next (Suivant) pour continuer.

    2. Pour l'application OAuth personnalisée, configurez les champs suivants :

      • ID client : ID client de votre application Adobe Developer Console.

      • Client OAuth public (facultatif) : sélectionnez cette option si votre application Adobe Developer Console est configurée en tant que client public (aucun secret client).

      • Secret client : secret client de votre application Adobe Developer Console.

      • URL du jeton : point de terminaison du jeton. Valeur par défaut : https://aep-ai-ama.adobe.io/token

      • URL d'autorisation : point de terminaison d'autorisation. Valeur par défaut : https://aep-ai-ama.adobe.io/authorize

      • URL de redirection : Pre-filled avec l'URL de rappel Amazon Quick.

    3. Pour Service-to-ServiceOAuth, configurez les champs suivants :

      • ID client : ID client indiqué dans vos informations d' Server-to-Server identification Adobe Developer Console.

      • Secret du client : secret du client contenu dans vos informations d' Server-to-Server identification Adobe Developer Console.

      • URL du jeton : point de terminaison du jeton. Valeur par défaut : https://aep-ai-ama.adobe.io/token

    4. Pour la clé d'API, configurez les champs suivants :

      • Clé d'API : clé d'API Adobe.

      • E-mail (facultatif) : adresse e-mail associée à la clé d'API.

  7. Choisissez Suivant.

  8. Si vous avez choisi l'application OAuth par défaut ou l'application OAuth personnalisée, une fenêtre d'autorisation Adobe s'ouvre. Vérifiez les autorisations demandées et choisissez Autoriser.

  9. Sur la page Révision, passez en revue les actions disponibles pour le connecteur. Choisissez Suivant.

  10. Sur la page Publier, choisissez qui peut accéder au connecteur. Vous pouvez autoriser l'accès à tous les membres de votre organisation ou rechercher des équipes ou des groupes spécifiques.

  11. Choisissez Publier.

Actions disponibles

Une fois le connecteur configuré, les actions présentées par Adobe Marketing Agent sont disponibles. Pour voir l'ensemble d'actions actuel pour votre connecteur, accédez à la vue Actions disponibles du connecteur dans la console Amazon Quick.

Gestion et résolution des problèmes

Pour modifier, partager ou supprimer votre connecteur, consultezGestion des intégrations existantes.

Problèmes d’authentification

  • Sign-in échoue (application OAuth par défaut ou application OAuth personnalisée) : vérifiez que votre compte Adobe est actif et que vous pouvez vous connecter directement à Adobe. Pour l'application OAuth personnalisée, vérifiez que l'URI de redirection dans votre application Adobe Developer Console correspond à l'URL de rappel Amazon Quick.

  • Informations d'identification client non valides (application OAuth personnalisée ou Service-to-Service OAuth) : vérifiez que l'ID client et le secret du client correspondent aux valeurs de votre application Adobe Developer Console.

  • L'authentification par clé d'API échoue : vérifiez que la clé d'API n'a pas été révoquée et qu'elle possède les étendues requises pour les opérations que vous souhaitez effectuer.