Questions fréquentes sur les intégrations vendor-integration-faq

À quoi servent les intégrations dans Journey Optimizer ?

Elles connectent des sources de données externes à Journey Optimizer afin que vous puissiez extraire du contenu et des données de systèmes tiers dans vos campagnes et parcours, et personnaliser les messages à l’aide de ces données.

➡️ En savoir plus sur la présentation des intégrations

Qui configure les intégrations et qui les utilise dans le contenu ?

Les administrateurs et administratrices créent et activent la configuration technique (Configurations > Intégrations > Gérer > Créer une intégration). Les responsables marketing utilisent Ajouter une personnalisation dans les composants Texte ou HTML, ouvrent Intégrations, choisissent une intégration active, puis mappent les attributs.

➡️ En savoir plus sur les workflows d’administration et de marketing

Où puis-je créer ou gérer des intégrations dans l’interface d’utilisation en tant qu’administrateur ou administratrice ?

Accédez à la section Configurations dans le menu de gauche, ouvrez Gérer dans la carte Intégrations, puis sélectionnez Créer une intégration.

➡️ En savoir plus sur la création d’intégrations

Quels sont les cas d’utilisation les plus courants des intégrations ?

Il s’agit par exemple des points de récompense des systèmes de fidélité, des informations sur les prix des produits, des recommandations des moteurs de recommandation et des mises à jour logistiques telles que le statut de la diffusion.

➡️ En savoir plus sur les exemples de données provenant de systèmes tiers

➡️ En savoir plus sur les exemples d’intégration de fournisseur

Comment configurer une intégration à un haut niveau en tant qu’administrateur ou administratrice ?

Vous indiquez un nom et une description, une URL de point d’entrée d’API (éventuellement avec des variables de chemin d’accès), des valeurs de modèle de chemin d’accès, GET ou POST, des en-têtes facultatifs et des paramètres de requête, une méthode d’authentification, des paramètres de politique (tels que le délai d’expiration et un cache ou une nouvelle tentative facultatifs) et un exemple de réponse JSON pour mapper des champs. Vous exécutez ensuite Envoyer une connexion de test et Activer, le cas échéant.

➡️ En savoir plus sur la configuration des intégrations

Quels types d’authentification sont pris en charge ?

Les types d’authentification suivants sont disponibles : Aucune authentification, Clé API, Authentification de base et OAuth 2.0 (avec la configuration de la payload pour OAuth, le cas échéant).

➡️ En savoir plus sur les types d’authentification

Dans quel cas l’étape de payload de réponse est-elle utilisée ?

Collez un exemple de réponse JSON afin que le système puisse détecter les types de données et que vous puissiez choisir les champs exposés pour la personnalisation dans les messages. Vous pouvez contrôler les champs disponibles pour les responsables marketing lors de la création.

➡️ En savoir plus sur le mappage de la payload de réponse

Comment les responsables marketing ajoutent-ils une intégration à un message ?

Dans le contenu de campagne ou de parcours, utilisez Ajouter une personnalisation sur un composant Texte ou HTML, accédez à Intégrations, sélectionnez une intégration et enregistrez. Grâce au mode Cadres de l’éditeur de personnalisation, vous pouvez mapper des valeurs à des variables de configuration (comme les paramètres d’en-tête ou de requête, ou les variables de chemin d’accès dans l’URL).

➡️ En savoir plus sur la personnalisation avec les intégrations

Puis-je utiliser des intégrations dans les parcours et les campagnes ?

Oui. Cette fonctionnalité est disponible pour les parcours et les campagnes pour les canaux sortants (par exemple, les e-mails, les SMS et les notifications push), dans les limites des produits actuels.

➡️ En savoir plus sur les parcours et les campagnes

Puis-je utiliser des intégrations dans des fragments réutilisables ?

La fonctionnalité Intégrations est prise en charge dans les fragments.

➡️ En savoir plus sur les fragments

Quels canaux prennent en charge les intégrations ?

Les canaux sortants (e-mail, SMS et notifications push) sont pris en charge.

➡️ En savoir plus sur les canaux pris en charge

Quels formats de réponse d’API sont pris en charge ?

Pour les réponses d’appel API, les formats JSON et HTML sont pris en charge pour le mappage des champs. La sortie d’image binaire brute et les formats autres que JSON ne sont pas disponibles pour ce workflow.

➡️ En savoir plus sur les formats JSON et de réponse

À quels modèles d’API puis-je me connecter ?

Les API de récupération qui ciblent un contenu spécifique sont prises en charge. Les API de liste (liste large ou modèles de pagination) ne sont pas prises en charge pour ce modèle d’intégration.

➡️ En savoir plus sur les API de récupération et de liste

De quelles autorisations ai-je besoin pour configurer les intégrations ?

Pour commencer à utiliser les intégrations, les utilisateurs et les utilisatrices doivent disposer des autorisations Gérer la configuration de l’intégration AJO et Afficher la configuration de l’intégration AJO.

➡️ En savoir plus sur les autorisations relatives aux intégrations

Les intégrations remplacent-elles les connecteurs Adobe Journey Optimizer vers les sources Experience Platform ?

Non. Les intégrations concernent les champs de personnalisation du contenu des messages que vous générez à partir des API. Les sources et d’autres fonctionnalités d’ingestion de données ont des objectifs différents (par exemple, l’ingestion de données par lots et l’enrichissement des profils). Utilisez chaque fonctionnalité dans le contexte approprié.

➡️ En savoir plus sur l’utilité des intégrations

➡️ En savoir plus sur les sources Experience Platform

Pourquoi la connexion de test échoue-t-elle ou reste-t-elle non valide ?

Vérifiez l’URL du point d’entrée, la méthode HTTP, les modèles de chemin, les en-têtes et les paramètres de requête, l’authentification et le délai d’expiration de la politique. Cliquez sur Envoyer une connexion de test après avoir effectué les réglages. En cas de problèmes liés à la payload, assurez-vous que l’exemple correspond à un JSON valide et que les champs sélectionnés correspondent à ce que l’API renvoie.

➡️ En savoir plus sur les tests de connexion et la validation de la payload

Pourquoi les responsables marketing ne voient-ils pas mon intégration dans le sélecteur ?

Les intégrations doivent être activées après un test réussi. Seules les intégrations actives s’affichent lorsque les responsables marketing ouvrent les intégrations. Si l’intégration est toujours en version brouillon ou inactive, activez-la.

➡️ En savoir plus sur les tests de connexion et l’activation

Quels exemples de fournisseurs sont disponibles et qui sécurise l’API ?

Vous pouvez vous connecter à n’importe quelle plateforme tierce qui expose un point d’entrée d’API compatible. Les exemples illustratifs de modèles de fournisseurs et de configuration peuvent vous aider à modéliser des API compatibles. La responsabilité de la sécurisation des points d’entrée incombe à la plateforme tierce et à votre équipe.

➡️ En savoir plus sur les procédures d’intégration des fournisseurs

AI Knowledge Reference

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

• TL;DR: This page answers frequently asked questions about Integrations in Adobe Journey Optimizer, covering configuration, authentication, supported channels and formats, API patterns, permissions, and troubleshooting.

Intents:

• Understand what Integrations do and who configures versus uses them
• Learn how administrators configure and marketers add an integration to message content
• Determine which channels, response formats, and API patterns are supported
• Find the permissions required to configure Integrations
• Troubleshoot a failing test connection or an integration missing from the marketer picker

Glossary:

• Integrations: Feature that connects external data sources so you can pull content and data from third-party systems into campaigns and journeys and personalize messages (product-specific)
• Add personalization: Action on a Text or HTML component that marketers use to open Integrations, choose an active integration, and map attributes (product-specific)
• Pills mode: Personalization editor mode used to map values to variables in the configuration, such as header or query parameters or path variables in the URL (product-specific)
• Retrieval APIs: APIs that target specific content, which are supported for this integration model (product-specific)
• Listing APIs: Broad list or pagination patterns, which are not supported for this integration model (product-specific)

Guardrails:

• Outbound channels are supported (for example email, SMS, and push).
• For API call responses, JSON and HTML are supported for field mapping; raw binary image output and formats that are not JSON are not available.
• Retrieval APIs that target specific content are supported; Listing APIs (broad list or pagination patterns) are not supported.
• To configure Integrations, users need the Manage AJO integration configuration and View AJO integration configuration permissions.
• Only active integrations appear when marketers open Integrations; the integration must be activated after a successful test.
• Supported authentication types: No Authentication, API key, Basic Auth, and OAuth 2.0.
• The Integrations feature is supported in Fragments.

Terminology:

• Canonical name: Integrations — Acronym: n/a — variants: external integrations, third-party integrations
• Synonyms: administrators “create and activate the technical configuration” = the setup marketers later select via “Add personalization”
• Do not confuse: “Integrations” (personalization fields in message content driven from APIs) ≠ “Sources” (Experience Platform data ingestion, such as batch ingestion and profile enrichment)
• Do not confuse: “Retrieval” APIs (supported) ≠ “Listing” APIs (not supported)

FAQ:

• Q: Which channels support Integrations? — Outbound channels (for example email, SMS, and push).
• Q: Which API response formats are supported? — JSON and HTML; raw binary image output and non-JSON formats are not available.
• Q: Which API patterns can I connect to? — Retrieval APIs that target specific content; Listing (broad list or pagination) APIs are not supported.
• Q: Can I use Integrations in reusable fragments? — Yes, the feature is supported in Fragments.
• Q: Do Integrations replace Experience Platform Sources? — No; Integrations drive personalization fields from APIs, while Sources handle data ingestion such as batch ingestion and profile enrichment.
• Q: Why do marketers not see my integration in the picker? — Integrations must be activated after a successful test; only active integrations appear.