Utiliser des intégrations external-sources
Vue d’ensemble
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 surfacer ce contenu 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 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, puis sélectionnez les autorisations d’intégration 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.
Configurer votre intégration configure
En tant qu’administrateur ou administratrice, vous pouvez configurer des intégrations externes en procédant comme suit :
-
Accédez à la section Configurations dans le menu de gauche, puis cliquez sur Gérer dans la carte Intégrations.
Cliquez ensuite sur Créer une intégration pour démarrer une nouvelle configuration.
-
Vous pouvez éventuellement coller une commande cURL pour remplir automatiquement l’URL, la méthode HTTP, les en-têtes et les paramètres de requête.
-
Indiquez un nom et une description pour votre intégration.
note NOTE Le champ Nom ne peut pas contenir d’espaces. -
Saisissez le point d’entrée de l’API URL.
Pour les variables de chemin d’accès, placez un libellé entre accolades doubles dans l’URL, par exemple
https://api.example.com/v1/products/{{productId}}, puis définissez chaque espace réservé dans Modèle de chemin d’accès. -
Configurez le Modèle de chemin d’accès avec Nom et Valeur par défaut pour chaque espace réservé ajouté dans l’URL.
Notez que le Nom est un libellé destiné aux professionnels du marketing dans l’éditeur uniquement. Il n’est pas envoyé sur la requête API.
-
Sélectionnez la méthode HTTP entre GET et POST.
-
Cliquez sur Ajouter un en-tête et/ou Ajouter des paramètres de requête selon les besoins de votre intégration. Pour chaque paramètre, fournissez les détails suivants :
-
Paramètre : nom réel de l’en-tête ou du paramètre de requête comme attendu par l’API.
-
Nom : libellé convivial pour les professionnels du marketing pour ce paramètre, les auteurs et autrices le sélectionnent lors du mappage des valeurs dans les campagnes.
-
Type : choisissez Constante pour une valeur fixe ou Variable pour une entrée dynamique.
-
Valeur : saisissez directement la valeur pour les constantes ou sélectionnez un mappage de variables.
-
Obligatoire : indiquez si ce paramètre est obligatoire. Pour les paramètres Variable obligatoires, si aucune valeur n’est résolue au moment de l’exécution et qu’aucune valeur par défaut n’est fournie, la génération de la requête échoue avec une erreur et l’appel API sortant n’est pas effectué.
-
-
Choisissez un type d’authentification :
-
Aucune authentification : pour les API ouvertes qui ne nécessitent aucune information d’identification.
-
Clé API : authentifiez les requêtes à l’aide d’une clé API statique. Saisissez votre nom de clé API , la valeur de la clé API et spécifiez votre emplacement.
-
Authentification de base : utilisez l’authentification HTTP de base standard. Saisissez le nom d’utilisateur et le mot de passe.
-
OAuth 2.0 : authentifiez-vous à l’aide du protocole OAuth 2.0. Cliquez sur l’icône
-
-
Définissez la Configuration de la politique comme le Délai d’expiration pour les requêtes API et choisissez d’activer le ralentissement, la mise en cache et/ou la reprise.
note NOTE Lorsque la limitation est activée, les taux pris en charge sont compris entre 50 et 5 000 TPS. Les limites s’appliquent à l’intégration, et non à chaque point d’entrée de l’API. Lorsque la reprise est activée, d’autres échecs réessayent trois par défaut, avec 200 ms, 400 ms et 800 ms entre les tentatives. -
Avec le champ payload de réponse, vous pouvez déterminer quels champs de l’exemple de sortie doivent être utilisés pour la personnalisation des messages.
Cliquez sur l’icône
-
Choisissez les champs à exposer pour la personnalisation et spécifiez leurs types de données correspondants.
note NOTE La configuration Payload de réponse définit la réponse attendue pour la création, y compris tout schéma appliqué à cette étape. Les marketeurs peuvent référencer uniquement les champs exposés. Les jetons pour d’autres chemins ne sont pas validés dans l’éditeur. -
Utilisez Envoyer une connexion de test pour valider l’intégration. En savoir plus sur la manière de tester votre connexion
Une fois la validation effectuée, cliquez sur Activer.
-
Accédez à l’intégration que vous venez de créer pour :
- Mise à jour : modifiez uniquement les détails Authentification et Configuration de la stratégie. Les mises à jour s’appliquent aux parcours et aux campagnes en direct. Avant d’enregistrer les modifications, utilisez le menu Explorer les références pour confirmer où l’intégration est utilisée.
- Archiver : archivez une configuration d’intégration.
Après l’activation, cliquez sur l’icône
Limites de l’heure d’envoi et comportement configure-send-time
Au moment de l’envoi, les réponses de l’API externe peuvent être jusqu’à 4 Mo par défaut. Toute valeur supérieure est traitée comme une erreur d’intégration et aucune tentative n’est effectuée lorsque l’échec est dû à la taille de la réponse.
Les appels respectent le taux de limitation que vous avez configuré : Journey Optimizer planifie les tentatives jusqu’à cette limite même lorsque le système externe est en panne ou renvoie des erreurs. Si le cache est activé, seules les réponses réussies sont stockées et réutilisées jusqu’à l’expiration du cache TTL que vous avez défini ; les réponses en échec ne sont jamais mises en cache.
Chaque message mis en file d’attente comporte également une fenêtre de validité (TTL). Si le traitement prend du retard et qu’un message reste au-delà de cette fenêtre, le système ignore et émet un événement MessageValidityExclusion afin que le travail obsolète soit effacé de la file d’attente et que les ressources restent disponibles.
Test de votre connexion connection
Envoyer la connexion de test valide l’URL du point d’entrée, l’authentification et la structure de requête par rapport à l’API cible avant l’activation, ce qui réduit le risque d’échecs d’exécution pendant le traitement des messages.
-
Lorsque l’URL, la méthode HTTP, les en-têtes et les paramètres de requête sont définis, cliquez sur Envoyer la connexion de test pour exécuter un test de connectivité et confirmer la configuration.
-
Dans la boîte de dialogue Envoyer la connexion de test, saisissez les valeurs par défaut des espaces réservés Variable dans le chemin d’accès de l’URL, les en-têtes et les paramètres de requête.
Ces valeurs sont incluses dans la requête de test. Journey Optimizer appelle le point d’entrée et indique si la connexion a réussi ou échoué.
-
Si le test renvoie une réponse réussie, sélectionnez Utiliser comme payload de réponse pour copier le corps de la réponse dans le champ Payload de réponse, voir l’étape 10 sous Configurer votre intégration, où les types de données peuvent être détectés et les champs peuvent être sélectionnés pour la personnalisation.
-
Si le test échoue, développez le menu déroulant Erreur pour consulter les détails de l’échec, mettez à jour la configuration de l’intégration si nécessaire et exécutez à nouveau Envoyer la connexion de test.
Une fois le test réussi, sélectionnez Activer dans la configuration de l’intégration. Voir Configuration de votre intégration.