Utilisation des intégrations standard external-sources

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.

{modal="regular"}

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.

Saisissez l’URL du point d’entrée de l’API.

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 Paramètre de chemin.

Sélectionnez Activer la navigation pour lier une intégration de navigation active, de sorte que ses champs de réponse puissent être mappés à des variables dans les en-têtes, les paramètres de requête et de chemin, ainsi que la payload.

➡️ Voir Création d’intégrations de navigation

{modal="regular"}

Configurez le Paramètre de chemin 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 responsables marketing dans l’éditeur uniquement. Il n’est pas envoyé sur la requête API.

{modal="regular"}

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 **: l’en-tête ou le nom du paramètre de requête, comme attendu par l’API.

• Nom : libellé adapté aux responsables marketing pour ce paramètre. Les créateurs et créatrices 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é.

{modal="regular"}

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 pour configurer ou mettre à jour la payload.

{modal="regular"}

Définissez la Configuration de la politique telle que le délai d’expiration pour les requêtes API et choisissez d’activer la limitation, la mise en cache et/ou la reprise.

Pour une méthode POST, configurez le Payload en choisissant un Type de corps :

• JSON : cliquez sur l’icône et collez la payload de votre requête JSON. Mappez les variables à remplir dans la payload.

• ​​: collez votre requête GraphQL. Journey Optimizer génère automatiquement un Nom de l’opération et vous permet de mapper les variables de requête correspondantes.

  Payload GraphQL {modal="regular"}

Choisissez le Type de réponse entre JSON et HTML.

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 et collez un exemple de payload de réponse JSON pour détecter automatiquement les types de données.

Choisissez les champs à exposer pour la personnalisation et spécifiez leurs types de données correspondants.

{modal="regular"}

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é.

{modal="regular"}

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, consultez 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.

{modal="regular"}

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.

{modal="regular"}

Une fois la validation effectuée, cliquez sur Activer.

Accédez à l’intégration que vous venez de créer pour effectuer ce qui suit :

• Mettre à jour : modifiez uniquement les détails Authentification et Configuration de la politique. Les mises à jour s’appliquent aux parcours et aux campagnes actifs. 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.

  {modal="regular"}

Après l’activation, cliquez sur l’icône pour accéder au menu Explorer les références et passer en revue l’utilisation de cette configuration, y compris les parcours et les campagnes qui en dépendent.

{modal="regular"}