12.2 Définition d’une source de données externe

Dans cet exercice, vous allez créer une source de données externe personnalisée à l’aide de Adobe Journey Optimizer.

Connectez-vous à Adobe Journey Optimizer en vous rendant à Adobe Experience Cloud. Cliquez sur Journey Optimizer.

ACOP

Vous serez redirigé vers la vue Accueil dans Journey Optimizer.

ACOP

Tout d’abord, assurez-vous d’utiliser l’environnement de test approprié. L’environnement de test à utiliser est appelé --aepSandboxId--. Pour passer d’un environnement de test à un autre, cliquez sur Production Prod (VA7) et sélectionnez l’environnement de test dans la liste. Dans cet exemple, l’environnement de test est nommé AEP Enablement FY21.

ACOP

Vous vous trouvez ensuite dans la vue Accueil de votre environnement de test --aepSandboxId--.

ACOP

Dans le menu de gauche, faites défiler l’écran vers le bas et cliquez sur Configurations. Cliquez ensuite sur le bouton Gérer sous Sources de données.

Démonstration

Vous verrez ensuite la liste Sources de données.
Cliquez sur Créer une source de données pour commencer à ajouter votre source de données.

Démonstration

Une fenêtre contextuelle de source de données vide s’affiche.

Démonstration

Avant de pouvoir commencer la configuration, vous aurez besoin d’un compte avec le service Open Weather Map. Pour créer votre compte et obtenir votre clé d’API, procédez comme suit.

Accédez à https://openweathermap.org/. Sur la page d’accueil, cliquez sur Se connecter.

WeatherMap

Cliquez sur Créer un compte.

WeatherMap

Renseignez les détails.

WeatherMap

Cliquez sur Créer un compte.

WeatherMap

Vous serez ensuite redirigé vers la page de votre compte.

WeatherMap

Dans le menu, cliquez sur Clés API pour récupérer votre clé API, que vous devrez configurer votre source de données externe personnalisée.

WeatherMap

Une clé API ressemble à ceci : b2c4c36b6bb59c3458d6686b05311dc3.

Vous trouverez la documentation de l’API pour la météo actuelle ici.

Dans notre cas d’utilisation, nous mettrons en oeuvre la connexion avec la carte météorologique ouverte en fonction de la ville où se trouve le client.

WeatherMap

Revenez à Adobe Journey Optimizer, dans la fenêtre contextuelle Source de données externe vide.

Démonstration

En tant que nom de la source de données, utilisez ldapWeatherApi et remplacez Ldap par votre LDAP. Dans cet exemple, le nom de la source de données est vangeluwWeatherApi .

Définissez la description sur : Access to the Open Weather Map.

L’URL de l’API Open Weather Map est la suivante : http://api.openweathermap.org/data/2.5/weather?units=metric

Démonstration

Ensuite, vous devez sélectionner l’authentification à utiliser.

Utilisez les variables suivantes :

Champ Valeur
Type Clé API
Nom APPID
Valeur votre clé API
Emplacement Paramètre de requête

Démonstration

Enfin, vous devez définir un FieldGroup, qui est essentiellement la demande que vous enverrez à l’API météorologique. Dans notre cas, nous voulons utiliser le nom de la ville pour demander la météo actuelle pour cette ville.

Démonstration

Selon la documentation de l’API de météo, nous devons envoyer un paramètre q=City.

Démonstration

Pour correspondre à la requête API attendue, configurez votre FieldGroup comme suit :

IMPORTANT

Le nom du groupe de champs doit être unique. Utilisez cette convention d’affectation des noms : ldapWeatherByCity donc dans ce cas, le nom doit être vangeluwWeatherByCity

Démonstration

Pour la payload de réponse, vous devez coller un exemple de la réponse qui sera envoyée par l’API de météo.

Vous trouverez la réponse JSON de l’API attendue sur la page de documentation de l’API ici.

Démonstration

Vous pouvez également copier la réponse JSON à partir de cet emplacement :

{"coord": { "lon": 139,"lat": 35},
  "weather": [
    {
      "id": 800,
      "main": "Clear",
      "description": "clear sky",
      "icon": "01n"
    }
  ],
  "base": "stations",
  "main": {
    "temp": 281.52,
    "feels_like": 278.99,
    "temp_min": 280.15,
    "temp_max": 283.71,
    "pressure": 1016,
    "humidity": 93
  },
  "wind": {
    "speed": 0.47,
    "deg": 107.538
  },
  "clouds": {
    "all": 2
  },
  "dt": 1560350192,
  "sys": {
    "type": 3,
    "id": 2019346,
    "message": 0.0065,
    "country": "JP",
    "sunrise": 1560281377,
    "sunset": 1560333478
  },
  "timezone": 32400,
  "id": 1851632,
  "name": "Shuzenji",
  "cod": 200
}

Copiez la réponse JSON ci-dessus dans le presse-papiers, puis accédez à l’écran de configuration de la source de données personnalisée.

Cliquez sur l’icône Modifier la charge utile .

Démonstration

Une fenêtre contextuelle s’affiche, dans laquelle vous devez maintenant coller la réponse JSON ci-dessus.

Démonstration

Collez votre réponse JSON, puis vous verrez ceci. Cliquez sur Enregistrer.

Démonstration

La configuration de votre source de données personnalisée est maintenant terminée. Faites défiler la page vers le haut et cliquez sur Enregistrer.

Démonstration

Votre source de données a été créée avec succès et fait partie de la liste Sources de données.

Démonstration

Étape suivante : 12.3 Définition d’une action personnalisée

Revenir au module 12

Revenir à tous les modules

Sur cette page