Sur cette page : découvrez comment les administrateurs configurent, testent et activent les intégrations externes qui connectent Adobe Journey Optimizer à des API tierces, afin que les marketeurs puissent les utiliser pour créer du contenu dynamique personnalisé dans les canaux sortants.
Vue d’ensemble overview
La fonctionnalité Intégrations relie Adobe Journey Optimizer à des systèmes tiers dont vous gérez déjà les données et le contenu composable ailleurs. Vous pouvez mettre ce contenu à disposition pendant la création et au moment de l’envoi, ce qui permet d’offrir des expériences plus réactives et personnalisées sur les canaux que vous utilisez dans Journey Optimizer.
Vous pouvez utiliser cette fonctionnalité pour accéder à des données externes et extraire du contenu à partir d’outils tiers tels que :
- Points de récompense issus des systèmes de fidélité.
- Informations sur les prix pour les produits.
- Recommandations de produits à partir des moteurs de recommandation.
- Mises à jour logistiques comme le statut de la diffusion.
Pour commencer à utiliser les intégrations, les utilisateurs et 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
-
Dans le produit Autorisations, accédez à l’onglet Rôles et sélectionnez le Rôle de votre choix.
-
Cliquez sur Modifier pour modifier les autorisations.
-
Ajoutez la ressource Configuration de l’intégration AJO, puis sélectionnez les autorisations d’intégrations appropriées dans le menu déroulant.
-
Cliquez sur Enregistrer pour appliquer vos modifications.
Les autorisations des personnes déjà affectées à ce rôle seront automatiquement mises à jour.
-
Pour attribuer ce rôle à de nouvelles personnes, accédez à l’onglet Utilisateurs et utilisatrices du tableau de bord Rôles et cliquez sur Ajouter un utilisateur ou une utilisatrice.
-
Saisissez le nom de la personne, son adresse e-mail ou choisissez dans la liste, puis cliquez sur Enregistrer.
Si le profil de l’utilisateur ou de l’utilisatrice n’a pas été créé auparavant, consultez cette documentation.
Comparaison entre Standard et Navigation standard-browsing
Lorsque vous accédez au menu Intégrations, la page est divisée en deux onglets : Standard et Navigation. Comprendre la différence entre les deux vous permet de choisir la configuration appropriée à votre cas d’utilisation.
-
Les intégrations standard connectent Journey Optimizer directement à une API tierce afin d’extraire des données ou du contenu pour les personnaliser au moment de la création ou de l’envoi. Les valeurs de paramètre sont des constantes fixes ou résolues à partir de variables que vous mappez dans votre campagne ou parcours.
➡️ Voir Création d’intégrations standard
-
Les intégrations Navigation permettent aux marketeurs de rechercher, de parcourir et de paginer dans une liste d’éléments renvoyés par une API externe, puis de sélectionner un élément spécifique directement dans l’expérience de création au lieu de saisir une valeur. Une intégration de navigation est liée à un paramètre d’intégration standard, de sorte que la valeur sélectionnée par les marketeurs est automatiquement transmise à l’appel API.
Pas à pas set-up
La configuration d’une intégration implique les administrateurs et les spécialistes marketing, chacun jouant un rôle distinct, de la configuration à la personnalisation du contenu.
-
Assurez-vous de disposer des autorisations Gérer la configuration de l’intégration AJO et Afficher la configuration de l’intégration AJO avant de commencer.
-
En tant qu’administrateur, créez une intégration Standard et éventuellement liez-la à une intégration Navigation afin que les spécialistes marketing puissent sélectionner des éléments au lieu de saisir manuellement des valeurs.
Voir Création d’intégrations standard et Création d’intégrations de navigation.
-
En tant que spécialiste marketing, appliquez vos intégrations configurées pour personnaliser le contenu des e-mails, des messages mobiles et des notifications push.
Voir Utilisation d’intégrations externes pour la personnalisation
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 explains how administrators configure, test, activate, and manage external integrations that connect Adobe Journey Optimizer to third-party APIs to pull JSON or HTML content for personalized, dynamic content in outbound channels.
Intents:
- Assign the Manage and View AJO integration configuration permissions
- Create an integration by defining URL, path template, HTTP method, headers, query parameters, authentication, and policy configuration
- Validate an endpoint with Send test connection before activating
- Map a sample JSON response and expose selected fields for personalization
- Understand send-time limits, throttling, cache, retry, and message validity behavior
- Update or archive an existing integration and review where it is used with Explore references
Glossary:
- Integrations: Feature that links Journey Optimizer to third-party systems to surface external data and composable content during authoring and at send time (product-specific)
- Path Template: Configuration of Name and Default value for each
{{placeholder}}added in the URL; the Name is a marketer-facing label in the editor only and is not sent on the API request (product-specific) - Policy configuration: Settings for API requests including Timeout, throttling, cache, and retry (product-specific)
- Response payload: Field that defines the expected response for authoring; marketers may reference only exposed fields, and tokens for other paths fail validation in the editor (product-specific)
- Send test connection: Action that validates the endpoint URL, authentication, and request structure against the target API prior to activation (product-specific)
- Explore references: Menu used to review usage of a configuration, including journeys and campaigns that depend on it (product-specific)
- MessageValidityExclusion: Event emitted when a queued message sits past its validity window (TTL) and is discarded (product-specific)
Guardrails:
- This integration feature is restricted to outbound channels (Email, Mobile message, and Push) and supports pulling JSON or HTML.
- Users need the Manage AJO integration configuration and View AJO integration configuration permissions.
- The Name field cannot contain spaces.
- With throttling enabled, supported rates are 50 to 5000 TPS; limits apply to the integration, not each API endpoint.
- With retry enabled, other failures retry three times by default, with 200 ms, 400 ms, and 800 ms between attempts.
- For mandatory Variable parameters, if no value is resolved at runtime and no default is provided, request generation fails with an error and the outbound API call is not made.
- At send time, responses may be up to 4 MB by default; anything larger is treated as an integration error, and retries are not attempted when the failure is caused by response size.
- If cache is enabled, only successful responses are stored and reused until the cache TTL expires; failed responses are never cached.
- Update applies only to Authentication details and Policy configuration, and those updates apply to live journeys and campaigns.
Terminology:
- Canonical name: Integrations — Acronym: n/a — variants: external integrations, AJO integration configuration
- Synonyms: “Manage” (from the Integrations card) = entry point to “Create Integration”
- Do not confuse: “Send test connection” (validates the configuration before activation) ≠ “Activate” (makes the integration usable by marketers)
- Do not confuse: “Update” (changes Authentication and Policy configuration only) ≠ “Archive” (archives an integration configuration)
FAQ:
- Q: Which channels and formats does this feature support? — It is restricted to outbound channels (Email, Mobile message, and Push) and supports pulling JSON or HTML.
- Q: What permissions are required? — The Manage AJO integration configuration and View AJO integration configuration permissions.
- Q: What throttling rates are supported? — With throttling enabled, 50 to 5000 TPS, applied to the integration rather than each API endpoint.
- Q: What happens if a send-time response is too large? — Responses over 4 MB by default are treated as an integration error, and retries are not attempted when the failure is caused by response size.
- Q: What can I change on an active integration? — Only Authentication details and Policy configuration; those updates apply to live journeys and campaigns.
- Q: What is a MessageValidityExclusion event? — It is emitted when a queued message sits past its validity window (TTL) and the system discards it.
Personas:
- marketer: Can apply configured Standard and Browsing integrations to personalize Email, Mobile message, and Push content. Can select items instead of entering values manually when a Browsing integration is linked to a Standard integration. The page states that marketers may reference only exposed fields, and tokens for other paths fail validation in the editor. Where: “Step-by-step”.
Onboarding:
- Level: Beginner
- First minimal step: Make sure you have the Manage AJO integration configuration and View AJO integration configuration permissions before you start.
- Success check: Users already assigned to this role have their permissions automatically updated.
- Previous: Grant the Manage AJO integration configuration and View AJO integration configuration permissions: Manage users and roles (administration/permissions.md)
- Next: Create a Standard integration, optionally linked to a Browsing integration: Create Standard integrations (integrations/integrations-create.md); Apply configured integrations to personalize Email, Mobile message, and Push content: Using External Integrations (integrations/integrations-personalization.md)